Linha Datasul

Árvore de páginas

O Migrador Unicoo x TOTVS12 utiliza a ferramenta open source Jenkins para administrar a chamada aos processos.

Como instalar essa ferramenta:

  1. Baixar a versão mais atual do Jenkins: https://jenkins.io/download/. Recomenda-se utilizar a versão "Long-term Support (LTS)", pois tende a ser mais estável. Basta escolher a opção conforme o seu sistema operacional, conforme o exemplo:


  2. Instalar o Jenkins seguindo instruções default da tela. 
    1. Atenção para a porta a ser utilizada: o default é 8080, mas se já estiver sendo usada por outro serviço, alterar para uma porta livre (ex: 8180, 8280, etc). Como trocar a porta?
      1. No arquivo Arquivo: "C:\Program Files (x86)\Jenkins\jenkins.xml"
      2. Alterar a porta na linha (no exemplo a porta foi alterada para 8180): <arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dhudson.util.ProcessTree.disable=true -jar "%BASE%\jenkins.war" --httpPort=8180 --webroot="%BASE%\war"</arguments>

  3. Artefatos da pasta .../Jenkins/ (obtida junto aos demais artefatos do instalador) a serem copiados para a pasta onde o Jenkins foi instalado (por default: "C:\Program Files (x86)\Jenkins"):
    1. Arquivo config.xml (copiar sobrepondo a versão anterior).
    2. Pasta Jobs: copiar com todo o seu conteúdo, sobrepondo a anterior, caso exista.

  4. Carregar o serviço do Jenkins (no Windows, existirá o serviço em SERVICES.MSC).

  5. Acessar pela primeira vez em um navegador web. Por defaut: localhost:8080 (atenção caso você tenha trocado a porta, conforme explicado anteriormente).

  6. No primeiro acesso, caso seja solicitado, selecione instalação de plugins default, e crie o usuário administrador.

Configurações necessárias antes de executar qualquer processo pelo Jenkins:

Existem variáveis de ambiente que precisam ser configuradas dentro do Jenkins para correto funcionamento dos processos. Como acessar a tela para essa configuração?

  1. Entrar no Jenkins com o usuário Administrador;
  2. Na tela principal, entrar em Gerenciar Jenkins e em seguida em Configurar o Sistema (ou usar esse link: http://localhost:8080/manage):





Variáveis de ambiente a serem configuradas:

NomeValor (exemplo - para cada cliente/ambiente deverá ser revisto)Observações
_PROGRESSC:\DLC116\bin\_progres.exeLocal onde está o executável do Progress
CLIENTLOG_CONF-clearlog -logginglevel 2 -logentrytypes 4GLMessages 4GLTrace DB.Connects FileID -clientlogParâmetros de configuração de Clientlog para os processos Progress
CONN_EMS505UNICOO

owner/senha@instancia

Parâmetros de conexão ao owner EMS506UNICOO (pode ser obtido no .pf)

Exemplo: ems506unicoo/ems506unicoo@totvsgp

CONN_UNICOOGPSowner/senha@instancia

Parâmetros de conexão ao owner UNICOOGPS (pode ser obtido no .pf)

Exemplo: unicoogps/unicoogps@totvsgp

CSS_RELATORIOS_MIGRACAO\\totvs-prod-testes\ERPGP\migracao\style.css
DT_CONTABIL_ACRSYSDATEData contábil para considerar que um título está em aberto.
DT_CONTABIL_APBSYSDATEData contábil para considerar que um título está em aberto.
EVENTO_FATURAS_MIGRADAS1Código do evento (previamente cadastrado no GPS) que será atribuído às Faturas migradas.
INIC:\TOTVS\datasul\dts-gp\ERP\scripts\dtsgp_migracao\datasul-progress.ini
PASTA_STATUS_MIGRACAO\\totvs-prod-testes\ERPGP\migracao\__STATUS_MIGRACAO
PATH_SCRIPTS_EMS5C:\TOTVS\datasul\dts-gp\ERP\migracao\_scripts_migracao_ems5_JK
PATH_SCRIPTS_GPSC:\TOTVS\datasul\dts-gp\ERP\migracao\_scripts_migracao_gps_JK
PFC:\TOTVS\datasul\dts-gp\ERP\scripts\dtsgp_migracao\datasul.pf
PQT_GUIAS_POR_CICLO10000Visto que a tendência é que essa tabela possua milhões de registros, o valor informado nesse parâmetro corresponderá à quantidade de registros que serão processados a cada ciclo do Extrator de Guias de Autorização, para amenizar o impacto de processamento.
PROWIN32C:\DLC116\bin\prowin32.exe
QT_FILAS_IMPORTACAO_BENEFICIARIOS20
QT_FILAS_IMPORTACAO_CLIENTES10
QT_FILAS_IMPORTACAO_FATURAS20
QT_FILAS_IMPORTACAO_FORNECEDORES5
QT_FILAS_IMPORTACAO_GUIAS20
QT_FILAS_IMPORTACAO_PROPOSTAS20
QT_FILAS_IMPORTACAO_TIT_ACR20
QT_FILAS_IMPORTACAO_TIT_APB10
SENHAmigracaoEsse usuário e senha deve ser previamente criado para o TOTVS12, com permissão total (mesmo nível que o super).
USUARIOmigracaoEsse usuário e senha deve ser previamente criado para o TOTVS12, com permissão total (mesmo nível que o super).




Atenção especial na Instalação do Jenkins:

  1. GUILHERME: SE A EXECUÇÃO DA CAMADA PROGRESS FUNCIONAR NA 61, RETIRAR TODO ESSE PARAGRAFO!!!!!

  2. após realizar a instalação padrão do Jenkins e antes de subir o serviço, realizar a seguinte alteração no arquivo ...<instalação_jenkins>/jenkins/jenkins.xml:

Na linha original:

<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -jar "%BASE%\jenkins.war" --httpPort=8180 --webroot="%BASE%\war"</arguments>

Acrescentar a instrução: -Dhudson.util.ProcessTree.disable=true

Exemplo:

<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dhudson.util.ProcessTree.disable=true -jar "%BASE%\jenkins.war" --httpPort=8180 --webroot="%BASE%\war"</arguments>



  • Sem rótulos