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

No instalador do Agent, é necessário apenas informar o diretório da instalação. O Agent será instalado e o Serviço iniciado, assim prosseguindo para as configurações do TReports.


       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

       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" 

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  ;

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

  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 . 

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 ;

  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;

    sc.exe create TReports.Agent binpath={path-do-arquivo}\TReports.Agent.exe start=demand

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

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

    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 . 


    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 

    /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:

     /etc/systemd/system/treports-agent.service

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

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

    sudo systemctl daemon-reload

  6. Inicie o serviço criado

    sudo systemctl start treports-agent

  7. Execute o comando para conferir o status

    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 .


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


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

Essa porta não realiza permissionamento, portanto ela não deve ser acessível publicamente na rede por questões de segurança.
Esta interface Web do Agent não realiza login, assim qualquer usuário com acesso a esta porta poderá abrir o Agent.
Deverá ser exposta apenas dentro do próprio servidor onde foi realizada a instalação.
Deve ser acessível apenas pelo Administrador do TReports, pois da acesso gerencial as funcionalidades 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.

Produto: Framework

Processo: TReports Agent - Instalação

Status: Rascunho

Data:  

Autores
 Adriano Diniz Agrizzi

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)