Histórico da Página

CONTEÚDO

1. Visão geral
2. Instalação e configuração Docker
3. Instalação e configuração Windows Service
4. Primeiro acesso
5. 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:

• 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 as vantagens citadas acima.

02. INSTALAÇÃO E CONFIGURAÇÃO DOCKER

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

...

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.

...

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.

...

Deve ser aberta esta tela:

Image Modified

Clicar em Administration Console.

...

usuário: admin

senha: admin

Image Modified

Depois é necessário clicar em Clients -> lgpd-api

Image Modified

Nesta tela é possível configurar várias opções relacionadas ao protocolo OAuth2, não recomendamos alterar nenhuma opção, poderá causar falha na aplicação. A única opção que deve ser alterada são as URIs de redirecionamento.

Image Modified

Alterar o valor localhost:4200 para o endereço + porta + /lgpd. Exemplo:

...

O próximo passo é cadastrar novos usuários. Clicar no menu Users.

Image Modified

Para adicionar um usuário é preciso clicar em Add user. Será aberto um formulário onde pode ser preenchido apenas o username que é obrigatório;

Image Modified

Depois de salvar você será redirecionado para a tela de edição de usuário, agora é preciso definir uma senha para o usuário, clique em Credentials, digite uma senha e depois Set Password. Se deixar a opção Temporary habilitada, essa senha será temporária e na primeira vez que o usuário realizar o login, ele será redirecionado para alterar a senha.

Image Modified

E por último é necessário definir os papéis deste usuário. No LGPD definimos 2 papéis, um é o gestor que é responsável pelos cadastros da aplicação e o segundo papel é o operador que tem a responsabilidade de anonimizar os registros.

Para definir papéis é preciso clicar em Role Mappings e depois escolher a opção lgpd-api no campo Client Roles.

Image Modified

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

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>