Í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, contendo as etapas:
Configuração do provedor de segurança
Configuração do servidor de licenças
Configuração do SGBD à ser usado
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
Instalação simplificada
Configuração do provedor de segurançaConfiguração do servidor de licençasConfiguração do SGDB à ser usadoO 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, - 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 |
---|
|
. - (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 |
---|
|
;
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.- 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 | powershell |
---|
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 | powershell |
---|
theme | RDark |
---|
|
sc.exe start |
TReportsPronto
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
pasta, ex: pasta
Bloco de código |
---|
|
/usr/sbin/ |
treportsPode 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
na rota e com o nome abaixo:
Crie o seguinte arquivo, treportsAdicione a configuração abaixo: Abra o arquivo criado e adicione as configurações abaixo:
treports
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 |
Informações |
---|
title | Atenção para as seguintes propriedades |
---|
|
Environment, configura a variável de ambiente para o serviço
WorkingDirectory, define a pasta de trabalho do TReports Agent
ExecStart, caminho onde o arquivo zip foi instalado
Atualize a
4. Atualize a lista de serviços do SO com o comando
, Bloco de código |
---|
|
sudo systemctl |
sudo systemctl
5. Inicie Inicie o serviço
, criado
Bloco de código |
---|
|
sudo systemctl start smart-view |
sudo systemctl start treports
6. Execute Execute o comando para conferir o status
, Bloco de código |
---|
|
sudo systemctl status smart-view |
sudo systemctl status 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 |
---|
|
. Liberação de portas
As seguintes portas deverão ser liberadas para utilização do TReports
- 7019, porta utilizada pelo TReports Agent, escopo local
Deverá ser utilizada apenas no próprio servidor onde o TReports foi instalado, para instalação, configuração e diagnóstico- 7017, utilizada pelo TReports, escopo público
Será utilizada por todos usuários do TReportsPorta definida para o Servidor de Licenças da TOTVSPorta para a integração com o Protheus- (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.
|
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 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 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, 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 Informações |
---|
|
A porta utilizada pelo Agent que por padrão usa a 7019 não realiza permissionamento, portanto ela não deve ser acessível publicamente na rede por questões de segurança.