Instalação do Jenkins para o Migrador

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

Como instalar essa ferramenta:

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:
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>
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.
Carregar o serviço do Jenkins (no Windows, existirá o serviço em SERVICES.MSC).
Acessar pela primeira vez em um navegador web. Por defaut: localhost:8080 (atenção caso você tenha trocado a porta, conforme explicado anteriormente).
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?

Entrar no Jenkins com o usuário Administrador;
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:

Nome	Valor (exemplo - para cada cliente/ambiente deverá ser revisto)	Observações
_PROGRESS	C:\DLC116\bin\_progres.exe	Local onde está o executável do Progress
CLIENTLOG_CONF	-clearlog -logginglevel 2 -logentrytypes 4GLMessages 4GLTrace DB.Connects FileID -clientlog	Parâmetros de configuração de Clientlog para os processos Progress
CONN_EMS505UNICOO	ems506unicoo/ems506unicoo@totvsgp	Parâmetros de conexão ao owner EMS506UNICOO (pode ser obtido no .pf) Sintaxe: owner/senha@instancia.
CONN_UNICOOGPS	unicoogps/unicoogps@totvsgp	Parâmetros de conexão ao owner UNICOOGPS (pode ser obtido no .pf) Sintaxe: owner/senha@instancia.
CSS_RELATORIOS_MIGRACAO	\\totvs-prod-testes\ERPGP\migracao\style.css
DT_CONTABIL_ACR	SYSDATE	Data contábil para considerar que um título está em aberto.
DT_CONTABIL_APB	SYSDATE	Data contábil para considerar que um título está em aberto.
EVENTO_FATURAS_MIGRADAS	1	Código do evento (previamente cadastrado no GPS) que será atribuído às Faturas migradas.
INI	C:\TOTVS\datasul\dts-gp\ERP\scripts\dtsgp_migracao\datasul-progress.ini
PASTA_STATUS_MIGRACAO	\\totvs-prod-testes\ERPGP\migracao\__STATUS_MIGRACAO
PATH_SCRIPTS_EMS5	C:\TOTVS\datasul\dts-gp\ERP\migracao\_scripts_migracao_ems5_JK
PATH_SCRIPTS_GPS	C:\TOTVS\datasul\dts-gp\ERP\migracao\_scripts_migracao_gps_JK
PF	C:\TOTVS\datasul\dts-gp\ERP\scripts\dtsgp_migracao\datasul.pf
PQT_GUIAS_POR_CICLO	10000	Visto 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.
PROWIN32	C:\DLC116\bin\prowin32.exe
QT_FILAS_IMPORTACAO_BENEFICIARIOS	20
QT_FILAS_IMPORTACAO_CLIENTES	10
QT_FILAS_IMPORTACAO_FATURAS	20
QT_FILAS_IMPORTACAO_FORNECEDORES	5
QT_FILAS_IMPORTACAO_GUIAS	20
QT_FILAS_IMPORTACAO_PROPOSTAS	20
QT_FILAS_IMPORTACAO_TIT_ACR	20
QT_FILAS_IMPORTACAO_TIT_APB	10
SENHA	migracao	Esse usuário e senha deve ser previamente criado para o TOTVS12, com permissão total (mesmo nível que o super).
USUARIO	migracao	Esse 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:

GUILHERME: SE A EXECUÇÃO DA CAMADA PROGRESS FUNCIONAR NA 61, RETIRAR TODO ESSE PARAGRAFO!!!!!
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>