Índice

Visão Geral

       O Agent do TReports tem o objetivo de facilitar  Para realizar a instalação e atualização configuração do TReportsSmart View,  pois se trata de um gerenciador para a instalação e um controlador para atualização automática de versões.       Sua instalação é deve-se utilizar o seu Agent, o qual é de simples e rápida instalação, utiliza possuindo uma interface Web web amigável ao usuário com um assistente que realiza a configuração do TReports.

       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.

       Possui  Após sua instalação, o Agent seguirá para um assistente, que é uma a interface responsável por efetuar a instalação e configuração do TReports:

Smart View,

       O TReports Smart View 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 Smart View está Iniciado ou Parado
• Gerenciamento de parâmetros e Configurações do TReportsSmart View
  Informa o endereço usado para acesso Web ao TReportsSmart View
  Onde estão as pastas de instalação e de log
  E quais são os são os parâmetros configurados para configurados para o TReportsSmart View
• 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 TReportso Smart View
• 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

       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

Instalação no Windows

Instalação simplificada

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
   subtle true title SmartView.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
   subtle true title C:\TOTVS

   ;

4. O instalador irá realizar a instalação na pasta

   Estado
   subtle true title smart-view

   , criada automaticamente no diretório selecionado;
5. Caso o diretório

   Estado
   subtle true title smart-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
   subtle true colour Blue title http://localhost:7019

    (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
   subtle true title C:\TOTVS\smart-view

   ;
   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

3. Abra o Powershell ou Prompt de comando com permissão de Administrador;

4. Execute o seguinte comando abaixo para criar o serviço do TReports AgentSmart View;

   Bloco de código
   language textpowershell theme RDark
   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
   subtle true title C:\TOTVS\

   TReports

   smart-view

   ;
   
   

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

   Bloco de código
   language textpowershell theme RDark
   sc.exe start TReportsSmartView.Agent

6. Pronto

1. ! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço

   Estado
   subtle true colour Blue title http://localhost:7019

   (ver Configurações do Smart View). 

1. Nota
   Para todas as operações

1. poderá ser necessário que o usuário tenha

1. privilégios de Administrador.

   Informações
   title Downloads
   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
   language text theme RDark
   /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
   language text theme RDark
   /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
   language text theme RDark
   [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

1. Atualize a lista de serviços do SO com o comando

   Bloco de código
   language text theme RDark
   sudo systemctl daemon-reload

1. Inicie o serviço criado

   Bloco de código
   language text theme RDark

1. sudo systemctl start

1. smart-view-agent

1. Execute o comando para conferir o status

   Bloco de código
   language text theme RDark

1. sudo systemctl status

1. smart-view-agent

2. Pronto

1. ! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço

   Estado
   subtle true colour Blue title http://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
   title Download
   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:

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:

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:

nano ~/.bashrc		

Adicione as seguintes linhas ao final do arquivo:

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.

            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.

sc.exe create SmartView.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls {protocolo-desejado}://{dominio-desejado}:{porta-desejada}" start=auto

sc.exe create SmartView.Agent binpath="c:\DiretorioDeInstalacao\TReports.Agent.exe --urls https://*:9077" start=auto

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

• 7017, utilizada pelo TReports

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 

• Porta definida para o Servidor de Licenças da TOTVS

• 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.