Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice


Índice
exclude.*ndice

Objetivo:

Orientar com um passo a passo para instalação do TReports Agent

Visão Geral

O TReports Agent é gerenciador de configurações para a inicialização do TReports e um controlador para atualização automática de versões.

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.

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 etapasPossui uma interface responsável por efetuar os passos de instalação do TReports:

  • Configuração do provedor de segurança

  • Configuração do servidor de licenças

  • Configuração do

    SGDB

    SGBD à ser usado


O TReports Agent é uma aplicação que roda como serviço, 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.


       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


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 
    Estado
    subtletrue
    titleSmartView.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

    Estado
    subtletrue
    titleC:\TOTVS
    ;

  4. O instalador irá realizar a instalação na pasta
    Estado
    subtletrue
    titlesmart-view
    , criada automaticamente no diretório selecionado;
  5. Caso o diretório
    Estado
    subtletrue
    titlesmart-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
    Estado
    subtletrue
    colourBlue
    titlehttp://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 

    Estado
    subtletrue
    titleC:\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

  3. Abra o Powershell ou Prompt de comando com permissão de Administrador;
  4. Execute o

    seguinte

    comando abaixo para criar o serviço do

    TReports Agent

    Smart View;

    Bloco de código
    languagepowershell
    themeRDark
    sc.exe create
    TReports
     SmartView.Agent binpath="{path-do-arquivo}\TReports.Agent.exe
    start=demand
     --urls http://*:7019" start=auto

    Estado
    title{path-do-arquivo}

    substitua

      Substitua este texto pelo caminho da pasta de instalação

    , exe: C

    . Ex.: 

    Estado
    subtletrue
    titleC:\TOTVS\

    TReports

    smart-view
    ;

  5. Execute o

    próximo

    comando abaixo para iniciar o serviço;

    Bloco de código
    languagepowershell
    themeRDark
    sc.exe start
    TReports
     SmartView.Agent
Instalação no Linux
  1. Pronto! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço

    Estado
    subtletrue
    colourBlue
    titlehttp://localhost:7019
    (ver Configurações do Smart View). 

    Nota

    Para todas as operações

será
  1. poderá ser necessário que o usuário tenha

acesso ao arquivo/pasta mencionado, utilizar o chmod para fazer tais alterações.
  1. privilégios de Administrador.

    Informações
    titleDownloads

    Baixe aqui a versão para instalação Simplificada

    Baixe aqui a versão para instalação Manual

Instalação no Linux


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

    pasta, ex:

    pasta 

    Bloco de código
    languagetext
    themeRDark
    /usr/sbin/
    treports
    smart-view

    Pode ser necessário utilizar o comando,

     chmod 

     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:

    Bloco de código
    languagetext
    themeRDark
     
    Criação e configuração do serviçoCrie o seguinte arquivo, 
    /etc/systemd/system/
    treports
    smart-view-agent.service
    Adicione a configuração
  4. Abra o arquivo criado e adicione as configurações abaixo:

    Bloco de código
    languagetext
    themeRDark
    [Unit]

  1. 
    Description=
treports
  1. smart-view-agent
  1. 
    
    [Service]

  1. 
    Type=notify

  1. 
    Environment="DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1"

  1. 
    WorkingDirectory=/usr/sbin/
treports
  1. smart-view
    ExecStart=/usr/sbin/
treports
  1. smart-view/TReports.Agent
  1.  --urls http://*:7019
    
    [Install]

  1. 
    WantedBy=multi-user.target
Informações
titleAtençã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

  1. 
    
    
  2. Atualize

4. Atualize
  1. a lista de serviços do SO com o comando

,
  1. Bloco de código
    languagetext
    themeRDark
    sudo systemctl 
sudo systemctl
  1. daemon-reload
5. Inicie
  1. Inicie o serviço

,
  1. criado

    Bloco de código
    languagetext
    themeRDark
    sudo systemctl start smart-view
sudo systemctl start treports
  1. -agent
6. Execute
  1. Execute o comando para conferir o status

, sudo systemctl status treports-agent

Liberação de portas

As seguintes portas deverão ser liberadas para utilização do TReports

7019, porta utilizada pelo TReports Agent, escopo localDeverá 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úblicoSerá utilizada por todos usuários do TReports
Porta definida para o Servidor de Licenças da TOTVS
  • Porta para a integração com o Protheus
  • Informações
    titleImportante
    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
    1. Bloco de código
      languagetext
      themeRDark
      sudo systemctl status smart-view-agent
    2. Pronto! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço
      Estado
      subtletrue
      colourBlue
      titlehttp://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.

      Informações
      titleDownload

      Baixe aqui esta versão para instalação

    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
    languagetext
    themeRDark
    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
    languagepowershell
    themeRDark
    titleExemplo
    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:

    Botão para edição da porta do servidorImage 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
    subtletrue
    colourBlue
    titlehttps://SMART-VIEW.totvs.app/
     seja liberado no servidor.


    Informações
    iconfalse
    Informações
    iconfalse

    Produto: Framework

    Informações
    iconfalse

    Processo: TReports Smart View Agent - Instalação

    Informações
    iconfalse
    Informações
    iconfalse

    Status: Rascunho Finalizado

    Informações
    iconfalse

    Data:30062021 

    Informações
    iconfalse

    Autores Autores
     Adriano Diniz Agrizzi

    Cesar Henrique Silva Rodrigues_ 

    Diogo Damiani Ferreira

    Usuário desconhecido (fernando.souza)

    Wemerson Marcelo Martins Guimarães 

    Page Tree