Í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.
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 TReportsSmart View. |
O 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çaConfiguração do servidor de licençasConfiguração do SGDB à ser usado
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
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" |
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.Instalação no Windows
Instalação simplificada
- Faça download do Instalador do Smart View Agent clicando neste link;
- Extrair todo o conteúdo do arquivo zip e execute o arquivo
Estado |
---|
subtle | true |
---|
title | SmartView.AgentInstaller.exe |
---|
|
; Selecione o diretório de instalação e prossiga para a próxima etapa. Recomendamos que a instalação seja feita no diretório ;
- O instalador irá realizar a instalação na pasta
Estado |
---|
subtle | true |
---|
title | smart-view |
---|
|
, criada automaticamente no diretório selecionado; - 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; - 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
- Faça download do Agent do Smart View clicando neste link;
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- Abra o Powershell ou Prompt de comando com permissão de Administrador;
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 |
substitua Substitua este texto pelo caminho da pasta de instalação, exe: C. Ex.: TReports;
Execute o próximo comando abaixo para iniciar o serviço;
Bloco de código |
---|
language | textpowershell |
---|
theme | RDark |
---|
|
sc.exe start TReportsSmartView.Agent |
Pronto
o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, ! 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 no Linux
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.
|
Instalação no Linux
Copie o arquivo zip de instalação para a pastapasta
Bloco de código |
---|
|
/usr/sbin/treportssmart-view |
Pode ser necessário utilizar o comando, chmod
- Realize a extração do conteúdo do arquivo na raiz desta pasta
- 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 |
---|
|
/etc/systemd/system/treportssmart-view-agent.service |
Adicione a configuração Abra o arquivo criado e adicione as configurações abaixo:
Bloco de código |
---|
|
[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 Atualize a lista de serviços do SO com o comando
Bloco de código |
---|
|
sudo systemctl daemon-reload |
5. Inicie Inicie o serviço criado
sudo
treports
6. Execute Execute o comando para conferir o status
sudo
treports- Pronto
o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, - ! 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.
|
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 |
---|
|
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 |
---|
|
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 |
---|
|
nano ~/.bashrc |
Adicione as seguintes linhas ao final do arquivo:
Bloco de código |
---|
|
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 |
---|
|
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 |
---|
language | powershell |
---|
theme | RDark |
---|
title | Exemplo |
---|
|
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.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, basta utilizar a interface de configuração disponibilizada através da interface de diagnóstico no endereço http://localhost:7019/diagnostic. Para alterar, deve-se clicar no item "Alterar endereço Web" do campo "Porta do Servidor", conforme imagem abaixo:
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 |
---|
| |
---|
subtle | true |
---|
colour | Blue |
---|
title | https://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.