Á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 como objetivo de facilitar a instalação e atualização do TReports,  pois pois se trata de um gerenciador para a de instalação e um controlador para atualização automática de versões.

       Sua instalação é simples e rápida, pois 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

Instalação no Windows


Instalação simplificada

  1. Faça download do Instalador do TReports Agent clicando neste 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 & Rotas


Porta 7019

O TReports disponibiliza uma interface para configuração, atualização e diagnóstico. Esta interface pode ser acessada pela porta 7019.

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. Para acesso ao ambiente de diagnóstico, basta acessar a rota http://localhost:7019/diagnostic.

       Caso seja necessário a substituição da porta padrão, basta localizar o arquivo “appsettings.json”, dentro da pasta de instalação, e alterar a porta da propriedade urls”. Para que a alteração entre em vigor, é necessário reiniciar o serviço do TReports. 

Bloco de código
languagetext
themeRDark
{
    "urls": "http://*:7019"
}
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.

Porta 7017

Esta é a porta padrão de acesso ao TReports e por isso deve ser acessível por todos os usuários da rede , pois é através dela que se acessa o sistema. Esta porta pode ser alterada via interface de configuração disponibilizada atrav. Caso seja necessário sua alteração, basta utilizar a interface de configuração disponibilizada através da tela de diagnóstico no endereço 

Estado
subtletrue
colourBlue
titlehttp://localhost:7019/diagnostic
. Para alterar, deve-se clicar no item "Alterar endereço Web" do campo "Porta do Servidor", conforme imagem abaixo:

Botão para edição da porta do servidorImage Added


Servidor de Licenças TOTVS

O TReports depende do servidor de licença TOTVS para seu funcionamento, ou seja, é necessário liberar no servidor o acesso ao License Server TOTVS. O TReports quando utilizado através de sua interface consome a licença "TOTVS I". Ao gerar um relatório pelo Produto TOTVS (ERP), a licença é abonada de acordo com a rotina do produto.

Integração com o Produto

Para que a integração com o Produto TOTVS (ERP) seja possível, o TReports precisa se comunicar com os endpoints do produto. O acesso a estes endpoints devem estar liberados para que o TReports possa estabelecer comunicação com o produto.

Atualização do Sistema

O TReports busca sua atualizações diretamente no servidor TOTVS. Para que sistema se matenha mantenha atualizado, é necessário que o acesso ao domínio  domínio 

Estado
subtletrue
colourBlue
titlehttps://treports.totvs.app/
 seja liberado no servidor.


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

Cesar Henrique Silva Rodrigues_ 

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)

Wemerson Marcelo Martins Guimaraes