Instruções de Atualização

LIBERAR ACESSO ÀS SEGUINTES URLS

O acesso às seguintes URLs deve estar liberado pelo firewall da máquina local para que seja possível fazer o download das dependências do projeto, bem como sua execução.

PREPARANDO AMBIENTE

1 - Dependências

Siga Instant Client para Instalar Oracle caso não esteja instalado, instalar o (Versão 19.6, seguir etapas de manual no fim da página “Instalação do Instant Client para Microsoft Windows 64 bits”)

Em https://www.oracle.com/database/technologies/instant-client/winx64-64-

Localize a pasta onde foram feitos os arquivos, extraia basiclite para a para raiz C:, em seguida extraia sqlplus também para C: (ambos os arquivos ficarão na pasta C:\ instantclient_19_11)

Instalando o Python no windows

Baixe o instalador. Acesse o site oficial neste link e clique em download, como mostrado abaixo.

No executável baixado, clique com o botão direito e selecione a opção “Run as administrator”.

Marque a opção "Add Python to PATH"
Clique em "Customize Installation"

Next em "Optional Features"
Em "Advanced Options", marque a opção "Install for all users"
No campo "Customize install location", o seguinte caminho: C:\Python\Python39

Para verificar se a instalação do Python foi bem-sucedida, pesquise no menu iniciar por "cmd" e clique para abri-lo.

Digite o seguinte comando:

python --version

Este comando retornará a versão do python instalada.

pip --version

Esse comando retornará a versão do pip instalada (gerenciador de pacote do Python).

2- Instalando integrador IDB

Baixe do repositório /Produtos/LINX INTEGRADOR IDB/ a versão mais recente do integrador exemplo linx-integrador-idb-1.4.3.zip para a pasta c:\temp

Descompact o zip para criar a pasta linx-integrador-idb-1.4.3

Renomeei a pasta linx-integrador-idb-1.4.3 para integrador-idb

Copie a pasta integrador-idb para c:\

3 - Instalação de dependências Python

Acesse o diretório c:\integrador-idb , pelo cmd, digite o comando para instalar as dependências do projeto (arquivo requirements.txt pode ser visualizado dentro da pasta do projeto):

pip install -r requirements.txt

4 - Rodando migrações de Banco de Dados

Ainda c:\integrador-idb , execute o comando abaixo:

python manage.py migrate

5 – Configurando arquivo de parâmetros

Em c:\integrador-idb, crie o arquivo “.env_temp” executando o seguinte comanado:

echo > .env_temp

Edite o arquivo .env_temp copie as linhas a baixo e defina os variáveis das variáveis “API_KEY”, “API_URL” e “CX_ORACLE_URL” conforme especificado:

API_KEY=chave

API_URL=https://api.leroymerlin.com.br/

CX_ORACLE_URL=login/senha@ip:porta/banco

API_ENDPOINT_CEP=v2/postal-codes

API_ENDPOINT_CNPJ=v1/partner/nfeio/legalentities/basicInfo

API_ENDPOINT_IE=v1/partner/nfeio/legalentities/stateTaxInfo/SP

API_ENDPOINT_GET_CLIENT=v2/idb/items

API_ENDPOINT_POST_CLIENT=v2/idb/items

API_ENDPOINT_UPDATE_CLIENT=v2/idb/items

ESQUEMA_IDB=lmbr_client

Os valores de cada variável devem ser reatribuídos de acordo, onde:

O valor “chave” em API_KEY deve ser substituído pela chave da API do IDB;
O valor “https://api.leroymerlin.com.br/” em API_URL deve ser substituído pela correspondente url do IDB e;
O valor " login/senha@ip:porta/banco" em CX_ORACLE_URL a url do banco oracle que será consumido.

Execute no prompt do diretorio do integrador(c:\integrador-idb) execute o comando :

python manage.py runscript criptografa_configuracao

Em seguida o arquivo .env será criado com as variáveis criptografadas.

Apague o arquivo .env_temp

Para descriptografar execute o comando : python manage.py runscript descriptografa_configuracao

O arquivo .env_temp será criado com as variáveis descriptografadas.

6 - Criando usuário com status de superuser do Servidor

Abra o CMD e acesse a pasta c:\integrador-idb

Execute o comando abaixo:

python manage.py createsuperuser

Preencher as informações de login, email e senha. (admin2, [email protected], Leroy123)

7 – Criando os serviços

7.1 – Acessar o site http://nssm.cc

7.2 – Selecionar a opção Download(marcada na figura acima)

7.3 – Tela de download

7.4 – Selecionar nssm (marcado na figura acima) para baixar.

7.5 – Descompactar o arquivo nssm-2.24.zip dentro de c:\integrador-idb

7.6 - Acesse o diretorio c:\integrador-idb\nssm-2.24\win64 via CMD e execute o comando abaixo

nssm install IntegradorInterface

7.7 - Na Tela da interface do NSSM digite as informações abaixo nos seguintes campos

No campo path digitar : C:\Python\Python39\python.exe
No campo Startup directory digitar : C:\integrador-idb
No campo Arguments digitar : manage.py runserver

7.8 – Clicar no botão Install service e o serviço será criado.

7.9 - Inicialize o serviço através do Serviço do Windows

7.10 – Acesse o diretório c:\integrador-idb\nssm-2.24\win64 via CMD e execute o comando abaixo

nssm install Integrador

7.11 - Na Tela da interface do NSSM digite as informações abaixo nos seguintes campos

No campo path digitar : C:\Python\Python39\python.exe
No campo Startup directory digitar : C:\integrador-idb
No campo Arguments digitar : manage.py runscript run_integration

7.12 –Clicar no botão Install service e o serviço será criado.

7.13-Inicialize o serviço através do Serviço do Windows

8 - Rodando Servidor Django

Inicializar o serviço IntegradorInterface na aba de serviços do windows.

ATUALIZANDO OS PARÂMETROS DO SERVIÇO

O servidor do django estará disponível no endereço:http://localhost:8000/admin/
Entre com os seguintes dados :
Username = admin2
Password=Leroy123
Acessar o menu "Parâmetros"
Selecionar “ADD PARAMETROS”
Criar parâmetros (formato de tempo: horas:minutos) e salvar

9 - Rodando o script de execução da Integração

Inicializar o serviço Integrador na aba de serviços do windows.

CONSULTANDO LOG DO SISTEMA

Dentro da pasta do serviço haverá um arquivo ‘integrador.log’, onde estará os logs do sistema

ATUALIZANDO VERSÃO

1) Parar a aplicação (pare os serviços IntegradorInterface e Integrador)

Substituir arquivos
Copiar o arquivo .ENV do backup para a pasta de produção (c:\integradoridb\.env)
cd c:\integrado-idb
pip install -r requirements.txt
python manage.py migrate
inicializar os serviços do integrador.