Índice
Visão Geral
Para realizar a instalação e configuração do TReportsSmart View, deve-se utilizar o seu Agent, o qual é de simples e rápida instalação, possuindo uma interface web amigável ao usuário.
Além disso, o Agent realiza verificações recorrentes no servidor de gerenciador de atualizações e, caso exista alguma nova versão do TReportsSmart View, o download é automaticamente realizado e a nova versão é instalada, 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. |
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 parâmetros 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 TReportsSmart 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
Instalação no Windows
Instalação simplificada
- Faça download do Instalador do TReports Smart View Agent clicando 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 TReportsSmart 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 | powershell |
---|
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 | powershell |
---|
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 TReportsSmart 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 TReportsSmart View).
Nota |
---|
poderá ser - 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 TReports 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. |
Dica |
---|
title | Alteração da 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.
Bloco de código |
---|
|
sc.exe create TReportsSmartView.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls {protocolo-desejado}://{dominio-desejado}:{porta-desejada}" start= demandauto |
Bloco de código |
---|
language | powershell |
---|
theme | RDark |
---|
title | Exemplo |
---|
|
sc.exe create TReportsSmartView.Agent binpath="c:\DiretorioDeInstalacao\TReports.Agent.exe --urls https://*:9077" start= demandauto |
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 TReportsSmart View. |
Porta 7017
Esta é a porta padrão de acesso ao TReports Smart View e por isso deve ser acessível por todos os usuários da rede.
tipCaso seja necessário alterar a porta de acesso ao
TReports, 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: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
Image Removed
Servidor de Licenças TOTVS
O TReports depende do Smart View precisa comunicar com um servidor de licença TOTVS para seu funcionamento, ou seja, é necessário liberar no servidor o acesso ao License Server TOTVS. O TReports quando utilizado através de sua interface consome a licença "TOTVS I". Ao gerar um relatório pelo ERP TOTVS, a licença é abonada de acordo com a rotina do ERP.pleno funcionamento.
Integração com o ERP
Para que a integração com o ERP TOTVS seja possível, o TReports 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 ser estabelecida.
Atualização do Sistema
O TReports 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://treportsSMART-VIEW.totvs.app/ |
---|
|
seja liberado no servidor.