Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Pré-condições
Não há.
Inicializar o serviço do Integrador e d IntegradorInterface na aba de serviços do windows.
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”)
Image Modified
Em https://www.oracle.com/database/technologies/instant-client/winx64-64-
Image Modified
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
Image Removed
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
Image Removed
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:\2 – Criando o Diretório
Na raiz do C:\ criar o diretório integrador-idd.
E no diretório (pasta) colocar os arquivos do integrador nela, após dezipar.
OBS: Colocar direto na C:\integrador-idb e não deixar C:\integrador-idb\integrador-idb
Image Added
3 - Instalação de dependências Python
Acesse o diretório c:\Na pasta integrador-idb, pelo cmd, digite o comando para instalar as dependências do projeto python (arquivo requirements.txt pode ser visualizado dentro da pasta do projetointegrador-idb):
pip install -r requirements.txt
4
- Rodando migrações de Banco de DadosAinda c:\integrador-
idb , execute o comando abaixo:python manage.py migrate
5 – Configurando arquivoConfigurando arquivos de parâmetros
Em c:\
- No diretório do integrador-idb, crie o arquivo “.env_temp” executando o seguinte comanado:
- Image Removed
- temp” com as variáveis abaixo.
CRIANDO O ARQUIVO .ENV_TEMP pelo CMD.
No CMD, no diretório integrador-idb digitar ( echo > .env_temp Edite ) conforme imagem abaixo, ele irá criar o arquivo .env_temp copie as linhas a baixo temp no formato correto, se criar na mão direto na pasta, não irá funcionar.
Image Added
- Abra .env_temp e defina os variáveis das variáveis “API_KEY”, “API_URL” e “CX_ORACLE_URL” e o “ESQUEMA_IDB”.
conforme especificado:
API_KEY=chave chave
API_URL=https://api-test.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_preprod
Informações | ||
---|---|---|
| ||
Para o integrador na versão 1.7.0 ou maior, os seguintes campos referente ao IDB precisam ser adicionado no final do arquivo .env_temp:
|
Os valores de cada variável devem ser reatribuídos retribuídos de acordo, onde:
- O o valor “chave” “chave” em API_KEY deve ser substituído pela chave da API do IDB;
- O O valor “https://api-test.leroymerlin.com.br/” em API_URL deve ser substituído pela correspondente url do IDB e;
Informações | ||
---|---|---|
| ||
Para o integrador na versão 1.7.0 ou maior os campos devem ser retribuídos conforme informado abaixo:
|
- 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 :
pythonpython manage.
pypy runscript criptografa_
configuracaoImage Removed
configuracao
Em seguida o arquivo .env será criado com as variáveis criptografadas.
Apague o arquivo .env_temp
Para descriptografar execute o comando : python python manage.py py runscript descriptografa_configuracao
OEm seguida o arquivo .env_temp será criado com as variáveis descriptografadas.
5 - Rodando migrações de Banco de Dados
Ainda pelo prompt, na pasta do projeto, execute:
python manage.py migrate
6 - Criando usuário com status de superuser do Servidor
Abra o CMD e acesse a pasta c:\integrador-idb
Execute o comando abaixo:Pelo prompt, na pasta do projeto, execute:
- python manage.py createsuperuser
Image Removed
- 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
Image Removed7.2 – Selecionar a opção Download(marcada na figura acimaabaixo)
Image Added
7.3 – Tela de download
Image Removed7.4 – Selecionar nssm(marcado na figura
acimaabaixo) para baixar.
Image RemovedImage Added
7.5
– Descompactar– Descompactar o arquivo baixado, colocar a pasta descompactada (nssm-2.24
.zip dentro de c:\) na raiz da pasta integrador-idb
Image Removed--INSTALANDO INTEGRADORINTERFACE—
7.6
- Acesse o diretorio c:\integrador-idb\nssm-2.24\win64 via CMD e execute o comando abaixo- nssm install IntegradorInterface
Image Removed
7.7 - Na Tela da interface do NSSM digite as informações abaixo nos seguintes campos
No campo path digitar :– Pelo prompt acessar a pasta NSSM-2.24 que esta localizada no integrador-idb e ir até a pasta win64.
Image Added
7.7 - No prompt digitar o comando : nssm install IntegradorInterface
Image Added
7.8 - Tela da interface do NSSM
Image Added
7.9 –No campo path digitar : C:\Python\Python39\python.exe
No7.10 – No campo Startup directory digitar: C:\integrador-idb
No7.11 – No campo Arguments digitar: manage.
pypy runserver
Image Removed
7.
812 – Clicar no botão Install service e o serviço será criado.
Image Removed
7.9 - Inicialize o serviço através do Serviço do Windows
Image Removed
7.10 – Acesse o diretório c:\integrador-idb\nssm-2.24\win64 via CMD e execute o comando abaixo
nssm install Integrador
Image Removed
7.11 - Na Tela da interface do NSSM digite as informações abaixo nos seguintes campos
No campo path digitar :--INSTALANDO INTEGRADOR—
7.13 – Pelo prompt acessar a pasta NSSM-2.24 que esta localizada no integrador-idb e ir até a pasta win64.
Image Added
7.14 E executar o comando: nssm install Integrador
Image Added
7.15 – No campo path digitar : C:\Python\Python39\python.exe
No7.16 – No campo Startup directory digitar:
C:\integrador-idb
No7.17 - No campo Arguments
digitardigitar :
managemanage.
py runscriptpyrunscript run_integration
Image Removed
7.
1218 – Clicar no botão Install service e o serviço será criado.
Image Removed
7.13-Inicialize o serviço através do Serviço do Windows
8 - Rodando Servidor Django
Inicializar o serviço do Integrador e do IntegradorInterface na aba de serviços do windows.
ATUALIZANDO OS PARÂMETROS DO SERVIÇO
1 - O servidor do django estará disponível no endereço:http://127.0.0.1:8000/admin/
Ou http://localhost:8000/admin/
2 . Login- - Login (Login foi criado pelo Prompt no processo 6 do manual)
Image Modified
3. Acessar o menu "Parâmetros"
Image Modified- 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 (Para versões anteriores 1.7.0)
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.
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”)Image Removed
Em https://www.oracle.com/database/technologies/instant-client/winx64-64-
Image Removed
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.
Image Removed
No executável baixado, clique com o botão direito e selecione a opção “Run as administrator”.
Image Removed
- Marque a opção "Add Python to PATH"
- Clique em "Customize Installation"
Image Removed
- 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.
Image Removed
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
Image Removed
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
Image Removed
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:
- Image Removed
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
Image Removed
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
Image Removed
- 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
Image Removed
7.2 – Selecionar a opção Download(marcada na figura acima)
7.3 – Tela de download
Image Removed
7.4 – Selecionar nssm (marcado na figura acima) para baixar.
7.5 – Descompactar o arquivo nssm-2.24.zip dentro de c:\integrador-idb
Image Removed
Image Removed
7.6- Acesse a pasta c:\integrador-idb\nssm-2.24\win64
nssm install IntegradorInterface
execute o comando nssm install IntegradorInterface
7.7 - Tela da interface do NSSM
Image RemovedImage Removed
7.8 – No campo path digitar : C:\Python\Python39\python.exe
7.9 – No campo Startup directory digitar : C:\integrador-idb
7.10 – No campo Arguments digitar : manage.py
Image Removed
7.11 – Clicar no botão Install service e o serviço será criado.
7.12 - Inicialize o serviço através do Serviço do Windows
Image Removed
7.13 – Ir para o diretório win64 do nssm via prompt e executar o comando: nssm install Integrador
7.13 – Repetir o procedimento de 7.8 e 7.9
7.14 - No campo Arguments digitar : manage.py runscript run_integration
7.15 – Repetir o procedimento de 7.11
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://127.0.0.1:8000/admin/ 2. LoginImage Removed
Image Removed
Image Removed
Image Removed
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
- Substitua os arquivos da pasta de instalação anterior com os da nova versão do Integrador IDB
- Copiar o arquivo .ENV e a pasta NSSM-2.24 do backup para a pasta de produção (c:\integrador-idb)
- cd c:\integrado-idb
- Rodar via CMD o comando python manage.py runscript descriptografa_configuracao
- Editar arquivo .ENV_temp
- Criar campos no fim do arquivo :
HEADER=
API_IDB_KEY=
API_IDB_URL=
Salvar e rodar o comando : python manage.py runscript criptografa_configuracao - pip install -r requirements.txt
- python manage.py migrate
- inicializar os serviços do integrador.
ATUALIZANDO VERSÃO
1) Parar a aplicação (pare os serviços IntegradorInterface e Integrador)
- Substituir arquivosSubstitua os arquivos da pasta de instalação anterior com os da nova versão do Integrador IDB
- Copiar o arquivo .ENV e a pasta NSSM-2.24 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.