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

       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
  

Instalação no Windows

Instalação simplificada

1. Faça download do Instalador do TReports clicando neste link;
2. Extrair todo o conteúdo do arquivo zip e execute o arquivo 

   Estado
   subtle true title TReports.AgentInstaller.exe

    ;

3. Selecione o diretório de instalação e prossiga para a proxima etapa. Recomendamos que a instalação seja feita no diretório 

   Estado
   subtle true title C:\TOTVS\TReports

   ;

4. Após conclusão, 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

   . 

Instalação manual

1. Faça download do Agent do TReports clicando neste link;

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

   ;

3. Abra o Powershell ou Prompt de comando com permissão de Administrador;

4. Execute o comando abaixo para criar o serviço do TReports;

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

   Estado
   title {path-do-arquivo}

     Substitua este texto pelo caminho da pasta de instalação. Ex.: 

   Estado
   subtle true title C:\TOTVS\TReports

   ;
   
   

5. Execute o comando abaixo para iniciar o serviço;

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

6. Pronto! 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

   . 

   
   

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

Instalação no Linux

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. Crie o arquivo do serviço na rota e com o nome abaixo:

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

4. Abra o arquivo criado e adicione as configurações 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

5. Atualize a lista de serviços do SO com o comando

   Bloco de código
   language text theme RDark
   sudo systemctl daemon-reload

6. Inicie o serviço criado

   Bloco de código
   language text theme RDark
   sudo systemctl start treports-agent

7. Execute o comando para conferir o status

   Bloco de código
   language text theme RDark
   sudo systemctl status treports-agent

8. Pronto! 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

   .

   
   

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

Liberação de Portas & Rotas

Porta 7019

O TReports disponibiliza uma interface para configuração, atualização e diagnóstico. Esta interface pode ser acessada pela porta 7019 e não é possível alteração da mesma..

Porta 7017

Esta porta deve ser acessível por todos os usuários da rede, pois é através dela que se acessa o sistema. Esta porta pode ser alterada via interface de configuração disponibilizada atrav

Servidor de Licenças TOTVS

O TReports depende do servidor de licença TOTVS para seu funcionamento, ou seja, é necessário liberar no servidor o acesso ao License Server TOTVS. O TReports quando utilizado através de sua interface consome a licença "TOTVS I". Ao gerar um relatório pelo Produto TOTVS (ERP), a licença é abonada de acordo com a rotina do produto.

Integração com o Produto

Para que a integração com o Produto TOTVS (ERP) seja possível, o TReports precisa se comunicar com os endpoints do produto. O acesso a estes endpoints devem estar liberados para que o TReports possa estabelecer comunicação com o produto.

Atualização do Sistema

O TReports busca sua atualizações diretamente no servidor TOTVS. Para que sistema se matenha atualizado, é necessário que o acesso ao domínio