Histórico da Página
CONTEÚDO
- Visão geral
- Instalação e configuração DockerInstalação e configuração Windows Service
- Primeiro acesso
- 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:
- 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.
Primeiramente é necessário realizar o download da versão 11 do java JDK. Encontrada em Java Archive Downloads - Java SE 11 | Oracle Brasil.
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.
Uma vez o executável baixado deve-se criar o arquivo xml vazio e renomear o binário WinSW.NET4 com o mesmo nome do xml.
O Xml deverá conter o seguinte conteudo alterando as configurações destacadas de acordo com a instalação:
<service>
<id>biofabrica-muda-pre-brotada</id>
<name>01 TOTVS - Biofabrica Muda Pre Brotada</name>
<description>01 TOTVS - Biofabrica Muda Pre Brotada</description>
<env name="HOME" value="C:\{caminho_do_projeto}\biofabrica-mpb"/>
<executable>C:\{caminho_do_jdk11}\java.exe</executable>
<argument>-Dspring.security.oauth2.resourceserver.jwt.jwk-set-uri=http://{ip_da_aplicacao:porta}/biofabrica/api/auth/realms/{realm_do_biofabrica}/protocol/openid-connect/certs</argument>
<argument>-Dspring.datasource.driver-class-name={application_driver}</argument>
<argument>-Dspring.datasource.url=jdbc:oracle:thin:@{ip:porta}/{servico}</argument>
<argument>-Dspring.datasource.username={user}</argument>
<argument>-Dspring.datasource.password={password}</argument>
<argument>-Dspring.jpa.show-sql=false</argument>
<argument>-Dspring.jpa.properties.hibernate.show_sql=false</argument>
<argument>-Dserver.port=8381</argument>
<argument>-Dserver.servlet.context-path=/biofabrica/api</argument>
<argument>-Dkeycloak.custom.server.keycloak-path=/auth</argument>
<argument>-Dkeycloak.custom.datasource.driverClassName={keycloack_driver}</argument>
<argument>-Dkeycloak.custom.datasource.url={keycloack_database_url}</argument>
<argument>-Dkeycloak.custom.datasource.username={user}</argument>
<argument>-Dkeycloak.custom.datasource.password={password}</argument>
<argument>-Dmpb.frontend.path=C:\{caminho_front_end}\sa-biofabrica-mpb-front</argument>
<argument>-Dlogging.config=C:\{caminho_logback}\logback.xml</argument>
<argument>-jar</argument>
<argument>"C:\{caminho_jar}\biofabrica-mpb-app-0.0.1-SNAPSHOT.jar"</argument>
<download from="http://engenharia.agro.totvs.com.br:8080/download/biofabrica-mpb-app-0.0.1-SNAPSHOT.jar" to="%EXE_BASE%\biofabrica-mpb-app-0.0.1-SNAPSHOT.jar"
auth="basic" unsecureAuth="true" user="eng.agro" password="uehjf80234yt" />
<logmode>none</logmode>
</service>
Onde a presente instalação será instalada conforme:
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:
- 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:
- SQLServer
- Oracle
- Postgres
- 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/LGPDpostgres
- Oracle: jdbc:oracle:thin:@localhost:1521/xe
- MySQL: jdbc:mysql://localhost:3306/LGPD?useSSL=false
...
É importante destacar que a aplicação LGPD Biofabrica MPB precisa de dois schemas/databases. Um schema/database é para os dados do LGPD MPB 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.
...
O arquivo Logback deve ser adicionado conforme:
E seu conteudo:
<configuration>
<include resource="org/springframework/boot/logging/logback/defaults.xml"/>
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>./logs/biofabrica-mpb.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<!-- rollover daily -->
<fileNamePattern>./logs/biofabrica-mpb-%d{yyyy-MM-dd}.%i.txt</fileNamePattern>
<maxFileSize>10MB</maxFileSize>
<totalSizeCap>100MB</totalSizeCap>
</rollingPolicy>
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{5} - %msg%n</pattern>
</encoder>
</appender>
<root level="INFO">
<appender-ref ref="FILE" />
</root>
</configuration>
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
...