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


TReports Agent tem o objetivo de facilitar a instalação e atualização do TReports.

Sua instalação é simples e rápida, utiliza uma interface Web que é um assistente para realizar 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, exexe: 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

    , ex:

    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
    1. Crie o seguinte arquivo

      ,

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


    2. 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, sudo systemctl

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


5. Inicie o serviço, sudo systemctl start

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


6. Execute o comando para conferir o status, sudo systemctl 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, 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
titleImportante

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.




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