Índice
Objetivo:
Orientar com um passo a passo para instalação do TReports Agent
Visão Geral
O TReports Agent é um gerenciador de configurações para a inicialização do TReports e um controlador para atualização automática de versões.
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.
Ou seja, o TReports Agent realiza as seguintes ações:
- Monitoramento de estado do serviço e versão
O Agent identifica qual é a versão atual que esta sendo utilizada
Monitora se o serviço esta Iniciado ou Parado
- Gerenciamento de configurações do TReports
Qual é o endereço de acesso Web ao TReports
Onde estão as pastas de instalação e de log
Quais são variáveis de ambiente e seus conteúdos
- Monitoramento de atualizaçõ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.
- Copie o arquivo zip de instalação para a pasta, ex: C:\TOTVS\TReports
- Realize a extração do conteúdo do arquivo na raiz desta pasta
- Abra o Powershell ou Prompt de comando com permissão de Administrador
- Execute o seguinte comando para criar o serviço do TReports Agent
- 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
- Execute o próximo comando para iniciar o serviço
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.
- Copie o arquivo zip de instalação para a pasta, ex: /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, /etc/systemd/system/treports-agent.service
- 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
Informações |
---|
title | Atenção para as seguintes propriedades |
---|
|
Environment, configura a variável de ambiente para o serviço WorkingDirectory, define a pasta de trabalho do TReports Agent ExecStart, caminho onde o arquivo zip foi instalado |
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, 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
Informações |
---|
|
A porta utilizada pelo Agent que por padrão usa a 7019 não realiza permissionamento, portanto ela não deve ser acessível publicamente na rede por questões de segurança. |