Á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


       Para realizar TReports Agent tem o objetivo de facilitar a instalação e atualização do TReports.Sua instalação é configuração do Smart View, deve-se utilizar o seu Agent, o qual é de simples e rápida instalação, 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 possuindo uma interface web amigável ao usuário.

O        Além disso, o Agent realiza um monitoramento onde são realizadas verificações recorrentes no servidor de gerenciador de atualizações . Caso e, caso exista alguma nova versão do Smart View, 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 Smart View.

       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 Smart View,

       O Smart View Agent possui também O TReports Agent possui uma interface de diagnóstico com seguintes ações:

  • Monitoramento da versão atualVersão Atual
    O Agent identifica qual é a versão atual que esta sendo utilizada
    Monitora e monitora se o TReports esta Smart View está Iniciado ou Parado
  • Gerenciamento de parâmetros e configurações Configurações do TReportsSmart View
    Qual é Informa o endereço usado para acesso Web ao TReportsSmart View
    Onde estão as pastas de instalação e de log
    Quais são os parâmetros configurados para o TReportsE quais são os parâmetros configurados para o Smart View
  • Monitoramento de versões instaladasVersões Instaladas
    Mantem as três últimas versões instaladas
    Permite escolher qual versão a ser utilizada e parar ou iniciar o TReportso Smart View
  • Histórico de atualizaçõesAtualizaçõ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:

Instalação no Windows


Aviso

Para integração com TOTVS Agro Bionergia e TOTVS Agro Multicultivo, faça o download da versão 3.5 do Agent ( (link), siga os passos da Instalação manual e configure conforme descrito em Configurações do Sistema (Versões 3.5 e Anteriores).

Instalação simplificada

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, 
  1. Faça download do Instalador do Smart View Agent clicando neste link;
  2. Extrair todo o conteúdo do arquivo zip e execute o arquivo 
    Estado
    subtletrue
    titleSmartView.AgentInstaller.exe
     ;
  3. Selecione o diretório de instalação e prossiga para a próxima etapa. Recomendamos que a instalação seja feita no diretório

    Estado
    subtletrue
    titleC:\TOTVS
    ;

  4. O instalador irá realizar a instalação na pasta
    Estado
    subtletrue
    titlesmart-view
    , criada automaticamente no diretório selecionado;
  5. Caso o diretório
    Estado
    subtletrue
    titlesmart-view
    já exista, o instalador perguntará se deseja sobrescrever a instalação anterior, caso não queira, um novo diretório deverá ser informado; 
  6. Após conclusão, o Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço
    Estado
    subtletrue
    colourBlue
    title
  1. http://localhost:7019
  1.  
    (ver Configurações do Smart View).

Instalação manual

  1. Faça download do Agent do Smart View 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\smart-view
    ;

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 
    Realize a extração do conteúdo do arquivo na raiz desta pasta

  2. Abra o Powershell ou Prompt de comando com permissão de Administrador;
  3. Execute o seguinte comando abaixo para criar o serviço do TReports AgentSmart View;

    Bloco de código
    languagetextpowershell
    themeRDark
    sc.exe create TReportsSmartView.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls http://*:7019" start=demandauto

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


  4. Execute o próximo comando abaixo para iniciar o serviço;

    Bloco de código
    languagetextpowershell
    themeRDark
    sc.exe start TReportsSmartView.Agent
  5. Pronto

o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, 
  1. ! O Smart View 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 Smart View). 

Instalação no Linux
  1. Nota
    • Para todas as operações
será
    • poderá ser necessário que o usuário tenha
acesso ao arquivo/pasta mencionado, utilizar o chmod para fazer tais alterações.
    • 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 pastapasta 

    Bloco de código
    languagetext
    themeRDark
    /usr/sbin/treportssmart-view

    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

    Crie o arquivo do serviço


    Crie o seguinte arquivona rota e com o nome abaixo:

    Bloco de código
    languagetext
    themeRDark
      /etc/systemd/system/treportssmart-view-agent.service
  4. Adicione a configuração Abra o arquivo criado e adicione as configurações abaixo:

    Bloco de código
    languagetext
    themeRDark
    [Unit]
    Description=treportssmart-view-agent
    
    [Service]
    Type=notify
    Environment="DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1"
    WorkingDirectory=/usr/sbin/treportssmart-view
    ExecStart=/usr/sbin/treportssmart-view/TReports.Agent --urls http://*:7019
    
    [Install]
    WantedBy=multi-user.target
    
    
4. Atualize
  1. Atualize a lista de serviços do SO com o comando

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

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

    Bloco de código
    languagetext
    themeRDark
 sudo
  1. sudo systemctl status 
treports
  1. smart-view-agent
  2. Pronto
o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, 
  1. ! O Smart View 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 Smart View).


    Nota
    • Para todas as operações será necessário que o usuário tenha privilégios de Administrador.
    • É importante que o servidor consiga resolver o nome do host para um endereço IP, garantindo assim a disponibilização correta do endereço público do Smart View.
    Informações
    titleDownload

    Baixe aqui esta versão para instalação

Configuração de Proxy


Caso o servidor onde o Smart View está sendo instalado possua um proxy para acesso à web é necessário realizar uma configuração adicional, conforme indicado abaixo:

Windows


Configurar variáveis de ambiente via terminal (como administrador) executando os comandos abaixo:

Bloco de código
languagebash
setx http_proxy http://username:password@proxyaddress:port /m
setx https_proxy http://username:password@proxyaddress:port /m

Linux


Defina variáveis de ambiente via terminal (como administrador) executando os comandos abaixo:

Bloco de código
languagebash
export http_proxy="http://username:password@proxyaddress:port"
export https_proxy="http://username:password@proxyaddress:port"

Em seguida é necessário tornar as variáveis definidas como persistentes em sessões de terminal futuras. Para isso é necessário adicioná-las ao seu arquivo de configuração do shell  

(~/.bashrc, ~/.bash_profile ou ~/.profile para usuários do Bash).

Exemplo - abra o arquivo com um editor de texto e adicione os comandos export no final:

Bloco de código
languagebash
nano ~/.bashrc		

Adicione as seguintes linhas ao final do arquivo:

Bloco de código
languagebash
export http_proxy="http://username:password@proxyaddress:port"
export https_proxy="http://username:password@proxyaddress:port"

Liberação de Portas & Rotas


Porta 7019


O Smart View 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.

            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 SmartView.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls {protocolo-desejado}://{dominio-desejado}:{porta-desejada}" start=auto
Bloco de código
languagepowershell
themeRDark
titleExemplo
sc.exe create SmartView.Agent binpath="c:\DiretorioDeInstalacao\TReports.Agent.exe --urls https://*:9077" start=auto
Aviso

A interface Web do Agent não realiza controle de acesso via

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á

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

.
Deve ser

, sendo 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.

Smart View. 

Porta 7017


Esta é a porta padrão de acesso ao Smart View e por isso deve ser acessível por todos os usuários da rede. 

Caso seja necessário alterar a porta de acesso ao Smart View, na interface de diagnóstico do Agent, clicar em "Configuração do Smart View" e, na etapa de Configuração da Integração, clicar em "Configurações avançadas" e alterar a porta em "Configuração de Rede":

Image Added


Servidor de Licenças TOTVS


O Smart View precisa comunicar com um servidor de licença TOTVS para seu pleno funcionamento.

Integração com o ERP


Para que a integração com o ERP TOTVS seja possível, o Smart View 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 Smart View 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://SMART-VIEW.totvs.app/
 seja liberado no servidor

  • 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 Smart View Agent - Instalação

Informações
iconfalse
Informações
iconfalse

Status: Rascunho Finalizado

Informações
iconfalse

Data:30062021 

Informações
iconfalse

Autores Autores
 Adriano Diniz Agrizzi

Cesar Henrique Silva Rodrigues_ 

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)

Wemerson Marcelo Martins Guimarães 

Page Tree