Histórico da Página

CONTEÚDO

1. Visão geral
2. Instalação e configuração DockerInstalação e configuração Windows Service
3. Primeiro acesso
4. Requisitos de hardware

01. VISÃO GERAL

Nesta página serão explicadas as duas formas de se fazer a instalação do TOTVS Agro LGPD:será explicada a forma de instalação do Módulo específico Biofabrica Muda Pré Brotada:

• Docker: Utilizando containers Docker orquestrados e possuindo as seguintes vantagens:
  • Entrega contínua: Atualizações automáticas assim que uma feature é lançada sem downtime da aplicação;
  • Observabilidade: Time TOTVS Agro acompanhando possíveis incidentes no ambiente e atuando de forma pró-ativa.
• Windows Service: Instalação manual por script .bat utilizando serviço windows, o ideal é optar por essa abordagem somente em casos em que não seja possível a utilização do Docker, pois perdemos se perde as vantagens citadas acimade observabilidade e entrega continua.

02.

...

INSTALAÇÃO E CONFIGURAÇÃO

...

WINDOWS SERVICE

A instalação do Biofabrica-MPB via serviço windows ainda não possui um instalador por isso é necessário realizar a instalação manualmente.

Para utilizar o Windows Service Wrapper primeiramente é necessário realizar o download de seus binários, encontrados em: Releases · winsw/winsw (github.com).
Neste tutorial será realizado o Download da ultima versão estável disponível.

        Image Added

Image Added
 

Uma vez o executável baixado ele precisa ser renomeado para o mesmo nome do arquivo xml que deve-se ser criado. Neste caso será  

Banco de Dados: O Biofabrica-MPB tem suporte apenas para os banco de dados PostgreSQL e Oracle DB 

...

Para realizar a instalação do TOTVS Agro LGPD via Docker é necessário seguir os passos abaixo:

• Ter o Docker instalado em algum servidor da rede
  • A aplicação deverá se comunicar com o banco de dados dos produtos On-Premises (TOTVS Agro Bioenergia, TOTVS Agro Multicultivo, etc)
• Ter um banco de dados dos tipos Postgres, Oracle, MySQL ou SQLServer
  • Criar dois databases para serem utilizados pelo LGPD e como banco da aplicação de autenticação (Keycloak). Por exemplo: lgpd e lgpd_auth
• Caso a rede tenha liberação por whitelist, deverá configurar a liberação dos endereços abaixo:
  • https://dev.azure.com/totvstfs
  • https://totvstfs.visualstudio.com/
  • https://docker.totvs.io/
• Entrar em contato com time  Framework TOTVS Agro ([email protected]) com os dados abaixo:
  • Acesso temporário ao servidor que está instalado o Docker (SSH, AnyDesk, TeamViewer, etc.) - Esse acesso poderá ser cortado após a configuração
  • Dados de acesso aos bancos criados (lgpd e lgpd_auth)
  • Dados de acesso ao banco de dados dos produtos (ex: Bioenergia, Multicultivo, etc.) que o LGPD irá atuar (o usuário deverá ter permissão para executar consultas e criar colunas)
  • Endereço e porta do servidor que será instalado o LGPD (DNS ou IP da rede

Com as informações acima, o time vai acessar o servidor e adicioná-lo no pipeline de entrega.

03. INSTALAÇÃO E CONFIGURAÇÃO WINDOWS SERVICE

A instalação via serviço windows irá utilizar um instalador (entrar em contato com o time Framework TOTVS Agro ([email protected]) para obtê-lo.

Com o instalador, descompactar no local que será feita a instalação, executar o script install.bat e seguir os passos conforme indicações abaixo:

Código do Banco de Dados: Informação que será usado para configurar o banco de dados do LGPD e da ferramenta de Autenticação, serão apresentados 4 opções:

1. SQLServer
2. Oracle
3. Postgres
4. MySQL

Obs: Caso informe um código que não esteja na listagem acima o instalador irá cancelar a instalação. 

...

String de conexão JDBC: URL de conexão para a aplicação se conectar com o banco de dados, alguns exemplos de string são:

...

:

...

• Postgres: jdbc:postgresql://localhost:5432/LGPD
• Oracle: jdbc:oracle:thin:@localhost:1521/xe
• MySQL: jdbc:mysql://localhost:3306/LGPD?useSSL=false

*Para o MySQL é preciso ter a configuração useSSL=false junto a String de Conexão;

É importante destacar que a aplicação LGPD Biofabrica MPB precisa de dois schemas/databases. Um schema/database é para os dados do LGPD e o outro é para as informações de autenticação/autorização. Os dois databases devem podem ser ou não do mesmo vendor, ou seja, oracle, postgres, mysql… Mas E não precisam ser a mesma instalação do banco. Podendo estar em duas máquinas diferentes, por exemplo.

Após informar os dados dos dois schemas/databases, será solicitado o endereço(IP ou DNS) para acessar a aplicação, este endereço deve ser sem a porta e com o protocolo (HTTP). Exemplos:

http://192.168.0.10, http://10.0.0.1 ou https://lgpd.com.br.

Depois é necessário informar a porta onde a aplicação irá responder e por último uma label para identificar o serviço, se ele é produção ou homologação por exemplo.

Após a finalização da instalação, será criado um serviço no Windows (TOTVS LGPD) e já iniciado. Caso tenha sido informada algum dado errado, basta parar o serviço e executar novamente o script install.bat.

Inicialização do serviço

Durante a inicialização do serviço, ele faz o download do aplicativo mais recente (lgpd-artifacts.zip) e o executa, para verificar se correu tudo certo com o serviço deve-se verificar o log lgpd-service.wrapper.

Acompanhamento da aplicação

Os logs do aplicativo ficarão no arquivo lgpd.log, nele pode-se verificar se ocorreu algum erro durante a execução.

04. PRIMEIRO ACESSO

Ao término da inicialização da aplicação, será necessário configurar a aplicação de autenticação e cadastrar novos usuários.

...

Escolha o papel do usuário e clique em Add selected.

Acessando a aplicação

Para logar é preciso entrar na aplicação usando o endereço da máquina + porta + /lgpd, exemplo: http://192.168.0.1:8090/lgpd (ou o DNS configurado)

...

Ao logar com um usuário cadastrado, dependendo do seu papel, os menus irão se alternar.

04. REQUISITOS DE HARDWARE

• 2GB Ram
• 5GB espaço em disco disponível

...