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 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
Image Modified
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.
pypy runserver
Image Modified
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
Image Modified
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.
Image Modified
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://127.0.0.1:8000/admin/ 2. Login
- 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.
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 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
Image Modified
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
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
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
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. Login
- 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.