Índice

Visão Geral

       Para realizar a instalação e configuração do TReports, deve-se utilizar o seu Agent, o qual é de simples e rápida instalação, possuindo uma interface web amigável ao usuário.

       Além disso, o Agent realiza verificações recorrentes no servidor de gerenciador de atualizações e, caso exista alguma nova versão do TReports, o download é automaticamente realizado e a nova versão é instalada, de forma que o Administrador do sistema não precise realizar nenhuma ação.

       Após sua instalaçã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 também 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 Agent 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

    (ver Configurações do TReports).

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 textpowershell theme RDark
   sc.exe create TReports.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls http://*:7019" 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 textpowershell 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

   (ver Configurações do TReports). 

   
   

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

   Informações
   title Downloads
   Baixe aqui a versão para instalação Simplificada Baixe aqui a versão para instalação Manual

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 --urls http://*:7019 [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

   (ver Configurações do TReports).
   

   
   

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

   Informações
   title Download
   Baixe aqui esta versão para instalação

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.

sc.exe create TReports.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls {protocolo-desejado}://{dominio-desejado}:{porta-desejada}" start=demand

sc.exe create TReports.Agent binpath="c:\DiretorioDeInstalacao\TReports.Agent.exe --urls https://*:9077" start=demand

Porta 7017

Esta é a porta padrão de acesso ao TReports e por isso deve ser acessível por todos os usuários da rede. 

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 ERP TOTVS, a licença é abonada de acordo com a rotina do ERP.

Integração com o ERP

Para que a integração com o ERP TOTVS seja possível, o TReports precisa se comunicar com os endpoints do ERP e, por isso, o acesso a estes endpoints devem estar liberados que a comunicação com o ERP possa Ser estabelecida.

Atualização do Sistema

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