Árvore de páginas

Índice


Visão Geral


       Para realizar a instalação e configuração do Smart 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 Smart 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.

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,

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

Instalação no Windows


Para integração com TOTVS Agro Bionergia e TOTVS Agro Multicultivo, faça o download da versão 3.5 do Agent ( Windows, Linux ) siga os passos da Instalação manual e configure conforme descrito em Configurações do Sistema (Versões 3.5 e Anteriores).

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 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 C:\TOTVS;

  4. O instalador irá realizar a instalação na pasta SMART-VIEW, criada automaticamente no diretório selecionado;
  5. Caso o diretório 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 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 C:\TOTVS\SMART-VIEW;

  3. Abra o Powershell ou Prompt de comando com permissão de Administrador;
  4. Execute o comando abaixo para criar o serviço do Smart View;

    sc.exe create SmartView.Agent binpath="{path-do-arquivo}\TReports.Agent.exe --urls http://*:7019" start=auto

    {PATH-DO-ARQUIVO}  Substitua este texto pelo caminho da pasta de instalação. Ex.: C:\TOTVS\SMART-VIEW;

  5. Execute o comando abaixo para iniciar o serviço;

    sc.exe start SmartView.Agent
  6. Pronto! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço HTTP://LOCALHOST:7019 (ver Configurações do Smart View). 

    • Para todas as operações poderá ser necessário que o usuário tenha privilégios de Administrador.

Instalação no Linux


  1. Copie o arquivo zip de instalação para a pasta 

    /usr/sbin/smart-view

    Pode ser necessário utilizar o comando, chmod 

  2. Realize a extração do conteúdo do arquivo na raiz desta pasta
  3. Crie o arquivo do serviço na rota e com o nome abaixo:

     /etc/systemd/system/smart-view-agent.service
  4. Abra o arquivo criado e adicione as configurações abaixo:

    [Unit]
    Description=smart-view-agent
    
    [Service]
    Type=notify
    WorkingDirectory=/usr/sbin/smart-view
    ExecStart=/usr/sbin/smart-view/TReports.Agent --urls http://*:7019
    
    [Install]
    WantedBy=multi-user.target
    
    
  5. Atualize a lista de serviços do SO com o comando

    sudo systemctl daemon-reload
  6. Inicie o serviço criado

    sudo systemctl start smart-view-agent
  7. Execute o comando para conferir o status

    sudo systemctl status smart-view-agent
  8. Pronto! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço HTTP://LOCALHOST:7019 (ver Configurações do Smart View).


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

    Para utilizar alguns relatórios padrões desenvolvidos pela TOTVS, é necessário que alguns pacotes de fontes estejam instalados. Para mais detalhes, consulte a página Instalação de Pacote de Fontes em Linux.

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.

       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.

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

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, 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":


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  HTTPS://SMART-VIEW.TOTVS.APP/ seja liberado no servidor.

Produto: Framework

Processo: Smart View Agent - Instalação