Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Pré-condições
Não há.
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.
- https://pypi.org/
- https://www.python.org/
- https://www.oracle.com/
- https://api-test.leroymerlin.com.br/
- https://support.microsoft.com/
PREPARANDO AMBIENTE
1 - Dependências
Siga Instant Clientpara 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 aquivo linx-integrador-idb-1.4.3.zip na opção que cria uma pasta
Renomeei a pasta linx-integrador-idb-1.4.3 para integrador-idb
Copie a pasta integrador-idb de C:\temp para C:\
3 - Instalação de dependências Python
Acesse o diretório c:\integrador-idb , pelo cmd, e execute o seguinte o comando abaixo :
pip install -r requirements.txt
4 - Rodando migrações de Banco de Dados
Acesse o diretório c:\integrador-idb pelo CMD, e execute o comando abaixo:
- python manage.py migrate
5 – Configurando arquivo de parâmetros
5.1. Acesse o diretório c:\integrador-idb, crie o arquivo “.env_temp” executando o seguinte comando: echo > .env_temp
5.2. 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 retribuí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.
5.3 Acesso diretório c:\integrador-idb e execute o comando abaixo :
python manage.py runscript criptografa_configuracao
5.4 Será criado o arquivo .env com as variáveis criptografadas.
Nota | ||
---|---|---|
| ||
O arquivo .env_temp deverá ser excluido 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
Acesse o diretório c:\integrador-idb e execute o comando abaixo:
python manage.py createsuperuser
Preencha 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 - Em Django administration na opção ETL Clique no botão Add para entrar nas configurações de parâmetros
- Criar parâmetros (formato de tempo: horas:minutos) e salvar
5. Será exibida a mensagem de confirmação da criação do parâmetro.
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 Image Added
Acesse a pasta C:\integrador-idb onde será localizado o 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.
...