Á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:

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ça
Configuração do servidor de licenças
Configuração do SGDB à ser usado
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, 
  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
    title
  1. http://localhost:7019
  1.  
    (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
    ;

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

  2. Abra o Powershell ou Prompt de comando com permissão de Administrador;
  3. Execute o seguinte comando abaixo para criar o serviço do TReports AgentSmart View;

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

    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
    ;


  4. Execute o próximo comando abaixo para iniciar o serviço;

    Bloco de código
    languagetextpowershell
    themeRDark
    sc.exe start TReportsSmartView.Agent
  5. Pronto

o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, 
  1. ! 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 no Linux
  1. 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 

  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]
    Description=
    treports
    smart-view-agent
    
    [Service]
    Type=notify
    Environment="DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1"
    WorkingDirectory=/usr/sbin/
    treports
    smart-view
    ExecStart=/usr/sbin/
    treports
    smart-view/TReports.Agent --urls http://*:7019
    
    [Install]
    WantedBy=multi-user.target
    
    
4. Atualize
  1. Atualize 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
  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.

Pronto o TReports Agent foi instalado e poderá ser acessado agora pelo endereço local, 
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.

      

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 TReports
Porta definida para o Servidor de Licenças da TOTVS
  • Porta para a integração com o Protheus
  •      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
    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

    .


    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