Índice

Visão Geral

TReports Agent tem o objetivo de facilitar a instalação e atualização do TReports, ele é um gerenciador para a instalação do TReports 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.

Uma de suas finalidades é controlar toda a atualização de versão do TReports de forma automática e transparente ao usuário.

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.

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
  Monitora se o TReports esta Iniciado ou Parado
  
  
• Gerenciamento de parâmetros e configurações do TReports
  Qual é o endereço usado para acesso Web ao TReports
  Onde estão as pastas de instalação e de log
  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

Possui um assistente, que é uma interface responsável por efetuar a instalação e configuração do TReports:

• Configuração do provedor de segurança
  
  

• Configuração do servidor de licenças
  
  

• Configuração do SGDB à ser usado
  
  

  
  

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

Para todas as operações poderá ser necessário que o usuário tenha privilégios de Administrador.

1. Copie o arquivo zip de instalação para a pasta, ex: C:\TOTVS\TReports 
   
   
2. Realize a extração do conteúdo do arquivo na raiz desta pasta
   
   
3. Abra o Powershell ou Prompt de comando com permissão de Administrador
   
   

4. Execute o seguinte comando para criar o serviço do TReports Agent

   Bloco de código
   language text theme RDark
   sc.exe create TReports.Agent binpath={path-do-arquivo}\TReports.Agent.exe start=demand

   {path-do-arquivo} substitua pelo caminho da pasta de instalação, exe: C:\TOTVS\TReports
   
   
   

5. Execute o próximo comando para iniciar o serviço

   Bloco de código
   language text theme RDark
   sc.exe start TReports.Agent

   
   
   

Pronto o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, http://localhost:7019. 

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.

1. Copie o arquivo zip de instalação para a pasta

   Bloco de código
   language text theme RDark
   /usr/sbin/treports

   Pode ser necessário utilizar o comando, chmod 
   
   

2. Realize a extração do conteúdo do arquivo na raiz desta pasta
   
   
3. Criação e configuração do serviço
   

   Crie o seguinte arquivo

   Bloco de código
   language text theme RDark
   /etc/systemd/system/treports-agent.service

   
   Adicione a configuração abaixo:
   

   Bloco de código
   language text theme RDark
   [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

sudo systemctl daemon-reload

5. Inicie o serviço

 sudo systemctl start treports-agent

6. Execute o comando para conferir o status

 sudo systemctl status treports-agent

Pronto o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, http://localhost:7019. 

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

• 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.