Árvore de páginas

Versões comparadas

Chave

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

Índice


Índice
exclude.*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.

Informações

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

Dica

       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 
    Estado
    subtletrue
    titleTReports.AgentInstaller.exe
     ;
  3. Selecione o diretório de instalação e prossiga para a proxima etapa. Recomendamos que a instalação seja feita no diretório 

    Estado
    subtletrue
    titleC:\TOTVS\TReports
    ;

  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 
    Estado
    subtletrue
    colourBlue
    titlehttp://localhost:7019

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 

    Estado
    subtletrue
    titleC:\TOTVS\TReports
    ;

  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;

    Bloco de código
    languagetext
    themeRDark
    sc.exe create TReports.Agent binpath={path-do-arquivo}\TReports.Agent.exe start=demand

    Estado
    title{path-do-arquivo}
      Substitua este texto pelo caminho da pasta de instalação. Ex.: 
    Estado
    subtletrue
    titleC:\TOTVS\TReports
    ;


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

    Bloco de código
    languagetext
    themeRDark
    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 
    Estado
    subtletrue
    colourBlue
    titlehttp://localhost:7019


    Nota

    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 

    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. Crie o arquivo do serviço na rota e com o nome abaixo:

    Bloco de código
    languagetext
    themeRDark
     /etc/systemd/system/treports-agent.service
  4. Abra o arquivo criado e adicione as configurações 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
    
    
  5. Atualize a lista de serviços do SO com o comando

    Bloco de código
    languagetext
    themeRDark
    sudo systemctl daemon-reload
  6. Inicie o serviço criado

    Bloco de código
    languagetext
    themeRDark
    sudo systemctl start treports-agent
  7. Execute o comando para conferir o status

    Bloco de código
    languagetext
    themeRDark
    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 
    Estado
    subtletrue
    colourBlue
    titlehttp://localhost:7019
    .


    Nota

    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

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.

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

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)