Este documento objetiva detalhar processo de instalação da aplicação SP através do Podman.
Índice |
---|
Etapa 1 - Preparação ambiente para instalação da imagem da aplicação
Esta etapa objetiva preparar um diretório no servidor onde será instalada e executada a imagem do SP Cloud.
Nota | ||
---|---|---|
| ||
Caso já tenha havido processo de preparação de ambiente para o servidor, os passos abaixo podem ser ignorados. Se as recomendações desta foram seguidas, basta verificar se existe diretório com nomenclatura container-linx no diretório /home. |
INFORMAÇÕES | EXEMPLO | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
1 - Criação de diretório Sugerimos a criação de um diretório exclusivo para receber a imagem da aplicação. Dessa forma, sugerimos que seja criado diretório containers-linx, no /home . Na coluna ao lado estão os exemplos de comandos a serem executados o sistema operacional linux |
| |||||||||
2 - Concessão de Permissões Conceder permissão completa para diretório acima definido, a fim de habilitar as ações de leitura, escrita e execução da aplicação. Na coluna ao lado está detalhado comando CHMOD. |
|
Etapa 2 - Download da Imagem do SP
Esta etapa objetiva explicar processo de download da release do SP que está disponível no RCA Azure Linx.
Aviso | ||
---|---|---|
| ||
Para a sequencia dessa etapa é mandatório que usuário tenha o acesso mencionado na seção pré-requisitos. |
INFORMAÇÕES | EXEMPLO | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1- Iniciar um novo TERMINAL e executar comando para processo de autenticação no Azure. Após a execução do comando, será solicitada a digitação do usuário e senha. |
| ||||||||||||||||||
2 - Realizar download da imagem da aplicação. Neste passo, deve ser informada a versão do release desejado no formato XX.XX.XX. No exemplo ao lado está sendo considerada a versão 1.0.0 do SP da Tim. Após execução do comando, download será iniciado. |
|
Etapa 3 -Configurando o Container (Podman) para Execução
Nesse passo vamos detalhar processo de configuração para execução do container (Podman) contendo a aplicação do SP
Principal objetivo é detalhar as instruções para prover as configurações necessárias para funcionamento da aplicação como:
- Apontamentos e credenciais de banco de dados
- Definições de tunning de memória da JVM
- Configurações de volumes externos ao contêiner onde haverá uma visibilidade para informações necessárias do cotidiano como: acesso aos logs e arquivos de configuração e persistência da aplicação.
INFORMAÇÕES | EXEMPLO | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1- Criação de diretório raiz para armazenar as configurações de todas as lojas Sugerimos a criação do diretório p2ksp em /home/containers-linx .
|
| ||||||||||||||||||||||||||||||||||||
2 - Criação de um diretório por loja, de forma que os logs, dados e configurações estejam segregados. A criação dos volumes é importante principalmente para que os dados sejam preservados, mesmo que o contêiner não esteja mais ativo. Sugerimos a criação do diretório sp_lj<numero_loja> em /home/containers-linx/p2ksp. Por exemplo: /home/containers-linx/p2ksp/sp_lj0038 |
| ||||||||||||||||||||||||||||||||||||
3 - Após a criação da pasta da loja (vamos usar como exemplo a loja 0038), é necessário criar uma pasta para cada artefato que deseja compartilhar com o contêiner. No caso, a seguinte estrutura é desejada: /home/containers-linx/p2ksp/sp_lj0038/atualizacaoComponente Para tal, a seguinte cadeia de comandos ao lado deve ser executada. |
| ||||||||||||||||||||||||||||||||||||
4 - Além das pastas, há também arquivos de log do sistema. Como eles estão localizados na basta bin e há vários arquivos outros arquivos que não devem ser expostos, deve-se criar apenas os arquivos, para posteriormente realizar um bind entre a máquina host e pods. /home/containers-linx/p2ksp/sp_lj0038/bin/CSIDebugFile.txt Observação: Vamos usar como exemplo a loja 0038. Observação: Vamos usar como exemplo a loja 0038. Observação: O conteúdo do arquivo versaoSP.dat deve ser a versão correspondente à imagem instalada. Exemplo: VERSAO_SP = 16.38.00. |
| ||||||||||||||||||||||||||||||||||||
5 - Por fim, a partir da pasta /home/containers-linx/p2ksp, é o momento de dar permissões para todas as pastas e arquivos criados para a loja. Observação: Vamos usar como exemplo a loja 0038. |
| ||||||||||||||||||||||||||||||||||||
6- Definir as configurações por linha de comando Uma vez realizados os processos acima, deve ser executado comando abaixo para configuração da base de dados necessário para funcionamento do Servidor de Estoque. podman run --name storex-sp --privileged --restart always -dit -p 4023:4023 -p 4068:4068 -e MEM_MS=512m -e MEM_MX=512m -e MEM_MAX_PERM=1024 -e MEM_MAX_HEAP=1024m -e LOJA=<numero_loja> -e EPSERVER=<IP do EP> -v ./p2ksp/sp_lj<numero_loja>/batch:/usr/p2ksp/sp_lj9999/batch -v ./p2ksp/sp_lj<numero_loja>/database:/usr/p2ksp/sp_lj9999/database -v ./p2ksp/sp_lj<numero_loja>/filetransfer/download:/usr/p2ksp/sp_lj9999/filetransfer/download -v ./p2ksp/sp_lj<numero_loja>/temp:/usr/p2ksp/sp_lj9999/temp -v ./p2ksp/sp_lj<numero_loja>/bin/componentes:/usr/p2ksp/sp_lj9999/bin/componentes -v ./p2ksp/sp_lj<numero_loja>/bin/debug_P2K:/usr/p2ksp/sp_lj9999/bin/debug_P2K -v ./p2ksp/sp_lj<numero_loja>/bin/filaTr1:/usr/p2ksp/sp_lj9999/bin/filaTr1 -v ./p2ksp/sp_lj<numero_loja>/atualizacaoComponente:/usr/p2ksp/sp_lj9999/atualizacaoComponente Os itens marcados em vermelho precisam ser substituídos pelos valores definidos do ambiente onde o servidor será executado. Abaixo uma tabela com o detalhamentos desses parâmetros:
Adicionalmente, para uma melhor compreensão do comando, segue abaixo uma tabela com detalhamento das informações:
podman run --name storex-sp --privileged --restart always -dit -p 4023:4023 -p 4068:4068 -e MEM_MS=512m -e MEM_MX=512m -e MEM_MAX_PERM=1024 -e MEM_MAX_HEAP=1024m -e LOJA=0038 -e EPSERVER=10.4.229.31 -v ./p2ksp/sp_lj9999/batch:/usr/p2ksp/sp_lj9999/batch -v ./p2ksp/sp_lj0038/database:/usr/p2ksp/sp_lj9999/database -v ./p2ksp/sp_lj0038/filetransfer:/usr/p2ksp/sp_lj9999/filetransfer -v ./p2ksp/sp_lj0038/temp:/usr/p2ksp/sp_lj9999/temp -v ./p2ksp/sp_lj0038/bin/componentes:/usr/p2ksp/sp_lj9999/bin/componentes -v ./p2ksp/sp_lj0038/bin/debug_P2K:/usr/p2ksp/sp_lj9999/bin/debug_P2K -v ./p2ksp/sp_lj0038/bin/filaTr1:/usr/p2ksp/sp_lj9999/bin/filaTr1 -v ./p2ksp/sp_lj0038/atualizacaoComponente:/usr/p2ksp/sp_lj9999/atualizacaoComponente |