Índice

Objetivo:

Orientar com um passo a passo para instalação do TReports Agent

Visão Geral

O TReports Agent é gerenciador de configurações para a inicialização do TReports e um controlador para atualização automática de versões.

Possui uma interface responsável por efetuar os passos de instalação do TReports:

• Configuração do provedor de segurança
  
  

• Configuração do servidor de licenças
  
  

• Configuração do SGDB à ser usado
  
  
  

O TReports Agent é uma aplicação que roda como serviço, 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
   1. sc.exe create TReports.Agent binpath={path-do-arquivo}\TReports.Agent.exe start=demand
   2. {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
   1. sc.exe start TReports.Agent

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, ex: /usr/sbin/treports
   1. 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
   1. Crie o seguinte arquivo, /etc/systemd/system/treports-agent.service
      
      
   2. Adicione a configuração abaixo:

[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

Liberação de portas

As seguintes portas deverão ser liberadas para utilização do TReports

• 7019, porta utilizada pelo TReports Agent, escopo local
  • Deverá ser utilizada apenas no próprio servidor onde o TReports foi instalado, para instalação, configuração e diagnóstico
    
    

• 7017, utilizada pelo TReports, escopo público
  • Será utilizada por todos usuários do TReports
    
    

• Porta definida para o Servidor de Licenças da TOTVS
  
  
• Porta para a integração com o Protheus