Á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


       Para realizar a instalação e configuração do TReports, deve-se utilizar o seu Agent, o qual é de simples e rápida instalação, possuindo uma interface web amigável ao usuário.

       Além disso, o Agent realiza verificações recorrentes no servidor de gerenciador de atualizações e, caso exista alguma nova versão do TReports, o download é automaticamente realizado e a nova versão é instalada, 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.


       Após sua instalação, 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 também 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 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
     
    (ver Configurações do TReports).

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
    languagetextpowershell
    themeRDark
    sc.exe create TReports.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls http://*:7019" 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
    languagetextpowershell
    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
    (ver Configurações do TReports). 


    Nota

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

    Informações
    titleDownloads

    Baixe aqui a versão para instalação Simplificada

    Baixe aqui a versão para instalação Manual

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 --urls http://*:7019
    
    [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
    (ver Configurações do TReports).


    Nota

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

    Informações
    titleDownload

    Baixe aqui esta versão para instalação

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, não precisando de um usuário logado para ser executado. O Agent fica 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.

Dica
titleAlteração da porta 7019

       Caso seja necessário a substituição da porta padrão do agente, exclua o atual serviço e crie um novo alterando a atual porta pela desejada. Alterações de domínio e tipo de protocolo, http ou https, são realizadas da mesma forma.

Bloco de código
languagetext
themeRDark
sc.exe create TReports.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls {protocolo-desejado}://{dominio-desejado}:{porta-desejada}" start=demand

Bloco de código
languagepowershell
themeRDark
titleExemplo
sc.exe create TReports.Agent binpath="c:\DiretorioDeInstalacao\TReports.Agent.exe --urls https://*:9077" start=demand
Aviso

A interface Web do Agent não realiza controle de acesso via login, assim qualquer usuário com acesso a esta porta terá acesso. Dessa forma, por questões de segurança, essa porta não deve ser acessível publicamente na rede e deverá ser exposta apenas dentro do próprio servidor onde foi realizada a instalação, sendo acessível apenas pelo Administrador 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. 


Dica

Caso seja necessário alterar a porta de acesso ao TReports, basta utilizar a interface de configuração disponibilizada através da interface 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 servidor









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 ERP TOTVS, a licença é abonada de acordo com a rotina do ERP.

Integração com o ERP

Para que a integração com o ERP TOTVS seja possível, o TReports precisa se comunicar com os endpoints do ERP e, por isso, o acesso a estes endpoints devem estar liberados que a comunicação com o ERP possa Ser estabelecida.

Atualização do Sistema

O TReports busca sua atualizações diretamente no servidor TOTVS. Para que sistema se mantenha atualizado, é necessário que o acesso ao 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: Finalizado

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 Guimarães 

Page Tree