Í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" |
Instalação no WindowsInstalação no Windows
Instalação simplificada
- Faça download do Instalador do TReports Smart View Agent clicando neste neste link;
- Extrair todo o conteúdo do arquivo zip e execute o arquivo
Estado |
---|
subtle | true |
---|
title | TReportsSmartView.AgentInstaller.exe |
---|
|
; Selecione o diretório de instalação e prossiga para a proxima próxima etapa. Recomendamos que a instalação seja feita no diretório diretório Estado |
---|
subtle | true |
---|
title | C:\TOTVS\TReports |
---|
|
;;
- 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 TReports Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço 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 TReports Smart View clicando neste 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\TReportssmart-view |
---|
|
;
- Abra o Powershell ou Prompt de comando com permissão de Administrador;
Execute o comando abaixo para criar o serviço do TReportsSmart 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 este texto pelo caminho da pasta de instalação. Ex.: Estado |
---|
subtle | true |
---|
title | C:\TOTVS\TReportssmart-view |
---|
|
;
Execute o comando abaixo para iniciar o serviço;
Bloco de código |
---|
language | textpowershell |
---|
theme | RDark |
---|
|
sc.exe start TReportsSmartView.Agent |
Pronto!
O TReports O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no
endereço endereço
Estado |
---|
| |
---|
subtle | true |
---|
colour | Blue |
---|
title | http://localhost:7019 |
---|
|
(ver Configurações do Smart View). Nota |
---|
- Para todas as operações poderá ser necessário que o usuário tenha privilégios de Administrador.
|
Instalação no Linux
Copie o arquivo zip de instalação para a pasta
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
Crie o arquivo do serviço na rota e com o nome abaixo:
Bloco de código |
---|
|
/etc/systemd/system/treportssmart-view-agent.service |
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
|
Atualize a lista de serviços do SO com o comando
Bloco de código |
---|
|
sudo systemctl daemon-reload |
Inicie o serviço criado
Bloco de código |
---|
|
sudo systemctl start treportssmart-view-agent |
Execute o comando para conferir o status
Bloco de código |
---|
|
sudo systemctl status treportssmart-view-agent |
- Pronto! O TReports O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço endereço
Estado |
---|
| |
---|
subtle | true |
---|
colour | Blue |
---|
title | http://localhost:7019 |
---|
|
(ver Configurações do Smart View).
Nota |
---|
poderá ser - será necessário que o usuário tenha privilégios de Administrador.
|
Liberação de portas
Por padrão, o TReports diferencia a rota de configuração do sistema da rota de utilização do sistema. São elas:
PORTA 7019
O TReports - É 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
e não é possível alteração da mesma.
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 |
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 controle de acesso via 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. |
PORTA 7017
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.
SERVIDOR DE LICENÇA 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.
INTEGRAÇÃO COM O PRODUTO
Também no assistente são informados os endpoints para integração com o Produto, portanto a rota informada deverá ser liberada para a comunicação do TReports.
ATUALIZAÇÃO DO SISTEMA
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 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 |
---|
| |
---|
subtle | true |
---|
colour | Blue |
---|
title | https://treportsSMART-VIEW.totvs.app/ |
---|
|
seja liberado no servidor.