Índice
Visão Geral
O Agent do TReports tem o objetivo de facilitar a instalação e atualização do TReports, pois se trata de um gerenciador para a instalação e um controlador para atualização automática de versões.
Sua instalação é simples e rápida, utiliza uma interface Web amigável ao usuário com um assistente que realiza a configuração do TReports.
O Agent realiza um monitoramento onde são realizadas verificações recorrentes no servidor de gerenciador de atualizações. Caso exista alguma nova versão, o download é automaticamente realizado e a nova versão é instalada.
Tudo isso é gerenciado pelo Agent de forma que o Administrador do sistema não precise realizar nenhuma ação.
Informações |
---|
No instalador do Agent, é necessário apenas informar o diretório da instalação. O Agent será instalado e o Serviço iniciado, assim prosseguindo para as configurações do TReports. |
O Agent seguirá para um assistente, que é a interface responsável por efetuar a instalação e configuração do TReports, contendo as etapas:
Configuração do provedor de segurança
Configuração do servidor de licenças
Configuração do SGDB à ser usado
O TReports Agent possui uma interface de diagnóstico com seguintes ações:
- Monitoramento da Versão Atual
O Agent identifica qual é a versão atual que esta sendo utilizada e monitora se o TReports esta Iniciado ou Parado - Gerenciamento de parâmetros e Configurações do TReports
Informa o endereço usado para acesso Web ao TReports
Onde estão as pastas de instalação e de log
E quais são os parâmetros configurados para o TReports
- Monitoramento de Versões Instaladas
Mantem as três últimas versões instaladas
Permite escolher qual versão a ser utilizada e parar ou iniciar o TReports
- Histórico de Atualizações
Mantém um registro do monitoramento automático de atualizações
Identifica se foi encontrada nova versão e se foi ou não atualizada
Dica |
---|
O Agent roda como serviço podendo ser iniciado automaticamente pelo boot do SO, quando o computador é ligado e não precisa de um usuário logado para ser executado, no Windows e no Linux, ficando exposto por padrão na porta 7019, podendo ser acessado pelo endereço local, http://localhost:7019. Esta porta poderá ser configurada usando o arquivo appsettings.Production.json , adicionando apenas a variável que configura a porta, exe: "urls": "http://*:7019" |
Download do arquivo de instalação
Realize o download no link: [a ser definido]
Instalação no Windows
Instalação simplificada
- Faça download do Instalador do TReports clicando neste link;
- Extrair todo o conteúdo do arquivo zip e execute o arquivo
Estado |
---|
subtle | true |
---|
title | TReports.AgentInstaller.exe |
---|
|
; Selecione o diretório de instalação e prossiga para a proxima etapa. Recomendamos que a instalação seja feita no
diretório diretório Estado |
---|
subtle | true |
---|
title | C:\TOTVS\TReports |
---|
|
;
- Após conclusão, o TReports já está configurado se encontra disponível em seu ambiente e já pode ser configurado pelo via navegador no endereço
Estado |
---|
| |
---|
subtle | true |
---|
colour | Blue |
---|
title | http://localhost:7019 |
---|
|
.
Instalação manual
- Faça download do Agent do TReports clicando neste link;
Extrair todo o conteúdo do arquivo zip para o diretório de instalação. Recomendamos que a instalação seja feita no diretório Estado |
---|
subtle | true |
---|
title | C:\TOTVS\TReports |
---|
|
;
- Abra o Powershell ou Prompt de comando com permissão de Administrador;
Execute o seguinte comando abaixo para criar o serviço do TReports Agent;
Bloco de código |
---|
|
sc.exe create TReports.Agent binpath={path-do-arquivo}\TReports.Agent.exe start=demand |
Estado |
---|
Showcase |
---|
description | Substitua pelo caminho da pasta de instalação, ex.: C:\TOTVS\TReports |
---|
title | {path-do-arquivo} |
---|
|
{path-do-arquivo} substitua Substitua este texto pelo caminho da pasta de instalação, exe: C. Ex.: Estado |
---|
subtle | true |
---|
title | C:\TOTVS\TReports |
---|
|
;
Execute o próximo comando abaixo para iniciar o serviço;
Bloco de código |
---|
|
sc.exe start TReports.Agent |
- Pronto
o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, - ! O TReports já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço
Estado |
---|
| |
---|
subtle | true |
---|
colour | Blue |
---|
title | http://localhost:7019 |
---|
|
.
Informações |
---|
Para todas as operações poderá ser necessário que o usuário tenha privilégios de Administrador. |
Instalação no Linux
Para todas as operações será necessário que o usuário tenha acesso ao arquivo/pasta mencionado, utilizar o chmod para fazer tais alterações.
Copie o arquivo zip de instalação para a pastapasta
Bloco de código |
---|
|
/usr/sbin/treports |
Pode ser necessário utilizar o comando, chmod
- Realize a extração do conteúdo do arquivo na raiz desta pasta
- Criação e configuração do serviço
Crie o seguinte arquivo
Bloco de código |
---|
|
/etc/systemd/system/treports-agent.service |
Adicione a configuração abaixo:
Bloco de código |
---|
|
[Unit]
Description=treports-agent
[Service]
Type=notify
Environment="DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1"
WorkingDirectory=/usr/sbin/treports
ExecStart=/usr/sbin/treports/TReports.Agent
[Install]
WantedBy=multi-user.target
|
4. Atualize a lista de serviços do SO com o comando
Bloco de código |
---|
|
sudo systemctl daemon-reload |
5. Inicie o serviço
Bloco de código |
---|
|
sudo systemctl start treports-agent |
6. Execute o comando para conferir o status
Bloco de código |
---|
|
sudo systemctl status treports-agent |
Pronto o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, http://localhost:7019.
Informações |
---|
Para todas as operações poderá ser necessário que o usuário tenha privilégios de Administrador. |
Liberação de portas
As seguintes portas deverão ser liberadas para utilização do TReports
- 7019, porta utilizada pelo TReports Agent
Porta padrão usada para acessar a interface Web de configuração, atualização e diagnóstico do TReports
Aviso |
---|
Essa porta não realiza permissionamento, portanto ela não deve ser acessível publicamente na rede por questões de segurança. Esta interface Web do Agent não realiza login, assim qualquer usuário com acesso a esta porta poderá abrir o Agent. Deverá ser exposta apenas dentro do próprio servidor onde foi realizada a instalação. Deve ser acessível apenas pelo Administrador do TReports, pois da acesso gerencial as funcionalidades de configuração, atualização e diagnóstico do TReports. |
- 7017, utilizada pelo TReports
Porta padrão utilizada para acesso o TReports.
Deve ser exposta para toda rede, onde todos usuários poderão acessar e realizar o login.
- Porta definida para o Servidor de Licenças da TOTVS
No assistente de configuração são informados o servidor e porta para o License Server, que é o servidor de licença da TOTVS.
Esta porta deverá ser liberada para a comunicação do TReports.
- Porta para a integração com o Protheus
Também no assistente são informados os endpoints para integração com o Protheus, portanto a porta informada deverá ser liberada para a comunicação do TReports.