Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice


Índice
exclude.*ndice

Objetivo:


Visão Geral


TReports Agent tem o objetivo de facilitar a instalação e atualização do TReports, ele é um gerenciador para a instalação do TReports 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.

Visão Geral

O TReports Agent é um gerenciador para a instalaçã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.

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
    Monitora se o TReports esta Iniciado ou Parado

  • Gerenciamento de parâmetros e configurações do TReports
    Qual é o endereço usado para acesso Web ao TReports
    Onde estão as pastas de instalação e de log
    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


Possui um assistente, que é uma interface responsável por efetuar a instalação e configuração do TReports:

  • Configuração do provedor de segurança

  • Configuração do servidor de licenças

  • Configuração do SGDB à ser usado


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" 


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

    Bloco de código
    languagetext
    themeRDark
    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


  5. Execute o próximo comando para iniciar o serviço

    Bloco de código
    languagetext
    themeRDark
    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.


  1. Copie o arquivo zip de instalação para a pasta

    Bloco de código
    languagetext
    themeRDark
    /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. Criação e configuração do serviço

    Crie o seguinte arquivo

    Bloco de código
    languagetext
    themeRDark
     /etc/systemd/system/treports-agent.service


    Adicione a configuração abaixo:

    Bloco de código
    languagetext
    themeRDark
    [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

Bloco de código
languagetext
themeRDark
sudo systemctl daemon-reload


5. Inicie o serviço

Bloco de código
languagetext
themeRDark
 sudo systemctl start treports-agent


6. Execute o comando para conferir o status

Bloco de código
languagetext
themeRDark
 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

Porta padrão usada para acessar a interface Web de configuração, atualização e diagnóstico do TReports

Aviso

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.




Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Processo: TReports Agent - Instalação

Informações
iconfalse
Informações
iconfalse

Status: Rascunho

Informações
iconfalse

Data:  

Informações
iconfalse

Autores Adriano Diniz Agrizzi