Essa lista apresenta passo a passo as ações a serem realizadas para a correta instalação do Migrador UNICOO x TOTVS.

A explicação considera que a instalação está sendo realizada no mesmo servidor onde o TOTVS12 já está instalado.


MóduloSeqPassoObservaçõesProgramaResponsávelData InícioData FinalObs.:Status
GERAL0Baixar o arquivo instalacao_migrador.zip

O arquivo instalacao_migrador.zip contém os artefatos mencionados nas etapas a seguir.

Descompacte o arquivo em uma pasta temporária e siga as instruções abaixo.

N/A




EMS51

Criar o owner EMS506UNICOO através do script "1.0.1-create_owner_EMS506UNICOO.sql"

Owner que conterá as tabelas temporárias da migração de dados do módulo Financeiro do Unicoo para o EMS5 (cliente, fornecedor, títulos, etc).

Nesse momento deve ser decidido pelo cliente se a instalação ocorrerá na mesma instância do Unicoo ou na mesma instância do TOTVS12, e providenciados os DBLinks correspondentes. Exemplo de criação de DBLINK no arquivo "1.0.4-exemplo_criacao_DBLINK.sql".

O script cria o owner e concede os grants necessários.

PL/SQL




EMS52Criar o Schema Holder para acesso ao EMS506UNICOO à partir do ProgressSeguir passo a passo dos itens à seguirProgress




EMS52.1

Copiar os artefatos da pasta "1.0.4-Schema Holder" para a mesma pasta dos bancos de dados Progress na instalação do TOTVS12 (normalmente c:\totvs\datasul\dts-0\erp\database-8080\):

1. Shunimed.b1
2. Shunimed.d1
3. Shunimed.db
4. datasul.st

Essa ação irá criar o banco de dados Progress SHUNIMED, que possibilitará acesso às tabelas temporárias da migração que estão no owner EMS506UNICOO do Oracle à partir da camada Progress.Progress




EMS52.2

Executar os scripts para Reparar e Truncar os bancos de dados (pasta ...\database-8080\scripts):

1. ReparaBancos.bat
2. TruncaBancos.bat

(Obs: esses arquivos não fazem parte desse pacote. Já existem na instalação padrão do TOTVS12).

Atenção: antes de executar ReparaBancos.bat, verificar se .../database-8080/datasul.st está configurado com a pasta correta (caminho completo de rede onde o arquivo está gravado).

Essa ação habilita o banco SHUNIMED para ser acessado à partir de uma sessão Progress. 
Progress




EMS5/GPS2.3

Criar atalho de Editor Progress para o Migrador.

Modelo na pasta "1.5-Editor (modelo)"

Esse editor será usado para executar processos que necessitem estar conectados ao Schema Holder SHUNIMED.Progress




EMS52.4Configurar SHUNIMED no .pf associando ao owner EMS506UNICOO

Exemplo da linha a ser adicionada no .pf (tomar como base a linha já existente para o EMSFND):

-db \\<servidor>\ERP\database-8180\shunimed   -RO -ld shunimed -db unimed     -ld unimed    -U ems506unicoo/ems506unicoo@HOMOLOGA -c 10000

Obs: trocar "HOMOLOGA" pela referência à instância do Oracle que está sendo utilizada.

Progress




EMS52.5Configurar SHUNIMED na tabela EMSFND.BCO_EMPRES (opção "Manutenção Bancos x Empresa" no menu do TOTVS12)

Mesmo raciocínio do item anterior. À partir dessa ação torna-se possível acessar as tabelas do owner EMS506UNICOO à partir de uma sessão Progress.

Exemplo no anexo "BCO_EMPRES.png" da pasta 1.4-Anexos.
O teste do Schema Holder somente poderá ser realizado após a criação da camada Oracle (a seguir).

Progress




EMS53Conceder GRANTS (permissões de acesso) no owner do EMS5 através do script "1.0.2-grants_EMS5.sql", informando "EMS506UNICOO" no prompt que será solicitado em tela. Atenção para conectar ao owner do EMS5 antes de executar essa ação.

Será necessário conceder GRANTS sobre o banco EMS5 do TOTVS12 para possibilitar a execução dos processos de migração.
PL/SQL




EMS55

Criar a PCK que contém as tabelas e procedures do EMS506UNICOO através do script "EMS506UNICOO_INSTALACAO.sql" que se encontra na pasta "1.0.4-EMS506UNICOO".

Atenção antes de iniciar essa etapa:

1. Conectar ao owner EMS506UNICOO antes de prosseguir;

2. Garantir que o DBLINK esteja criado no Oracle com o mesmo nome que está setado dentro do arquivo 1.0.4-EMS506UNICOO.SQL (talvez você precise editar o script antes de importá-lo).

No exemplo:

"create or replace synonym ABRANGENCIA
  for PRODUCAO.ABRANGENCIA@DBLINK;"

Substituir em todo o arquivo a expressão "@DBLINK" por "@" + nome do DBLINK criado pelo cliente. Caso esteja sendo utilizada uma instância única de Oracle, então não será usado DBLINK. nesse caso, retirar "@DBLINK", ficando assim: "...PRODUCAO.ABRANGENCIA;"

Utilizar uma "Command Window" do PL/SQL.

Obs: essa etapa criará as tabelas e a versão inicial da PCK.

PL/SQL




EMS55.1Atualizar a PCK_EMS506UNICOO com a versão mais atual que existir na pasta "1.0.4-EMS506UNICOO"

Os arquivos seguem a nomenclatura EMS506UNICOO_ATUALIZACAO_VXX, onde XX representa o número da versão.

Não é necessário atualizar um a um. Deve ser considerado apenas o mais atual.

Obs: a atualização contém apenas os programas, sem criação de tabelas.

Como atualizar: executar o código do arquivo na aba "Editor" de uma "Command Window" do PL/SQL.







EMS55.2Testar acesso ao Schema Holder pelo ProgressAbrir uma sessão Progress (à partir do atalho criado no item 2.3) e executar a seguinte lógica:

select count(*) from ti_controle_integracao.

Se apresentar o resultado sem erros, o Schema Holder está correto.
Progress




EMS56Compilar todos os objetos da PCK_EMS506UNICOO
PL/SQL




GPS7Criar o owner UNICOOGPS através do script "2.0.1-create_owner_UNICOOGPS.sql"Owner que conterá as tabelas temporárias da migração de dados do Plano de Saúde do Unicoo para o Gestão de Planos (produtos, coberturas, beneficiários, etc).
Nesse momento deve ser decidido pelo cliente se a instalação ocorrerá na mesma instância do Unicoo ou na mesma instância do TOTVS12, e providenciados os DBLinks correspondentes.

O script cria o owner e concede os grants necessários.

Premissa: se utilizar DBLINK, garantir que a versão do Oracle seja a mesma para todas as instâncias (Unicoo, UNICOOGPS e TOTVS12).
Algumas subversões do Oracle 10 não são compatíveis com Progress 10.2x. Atenção para essa limitação documentada:
http://knowledgebase.progress.com/articles/Article/P134640

Boa prática: criar os owners no mesmo ambiente do Unicoo para não exigir DBLINK, e consequentemente otimizar a performance.
PL/SQL




GPS8

Importar as tabelas e procedures das PCKs PCK_UNICOOGPS e PCK_MIGRACAO_TXT_GP através do script "2.0.2.2-PCK_UNICOOGPS.sql"


Atenção antes de iniciar essa etapa:

1. Conectar ao owner UNICOOGPS antes de prosseguir;

2. Garantir que o DBLINK esteja criado no Oracle com o mesmo nome que está setado dentro do arquivo UNICOOGPS.SQL.

No exemplo:
"create or replace synonym ABRANGENCIA
  for PRODUCAO.ABRANGENCIA@DBLINK;"
Substituir em todo o arquivo a expressão "@DBLINK" por "@" + nome do DBLINK criado pelo cliente. Caso esteja sendo utilizada uma instância única de Oracle, então não será usado DBLINK. nesse caso, retirar "@DBLINK", ficando assim: "...PRODUCAO.ABRANGENCIA;"


Obs: essa etapa criará as tabelas e a versão inicial da PCK.

PL/SQL




GPS8.1Atualizar a PCK_UNICOOGPS com a versão mais atual que existir na pasta "2.0.2.2-UNICOOGPS"

Os arquivos seguem a nomenclatura UNICOOGPS_ATUALIZACAO_VXX, onde XX representa o número da versão.

Não é necessário atualizar um a um. Deve ser considerado apenas o mais atual.

Utilizar uma "Command Window" do PL/SQL.

Obs: a atualização contém apenas os programas, sem criação de tabelas.

Como atualizar: executar o código do arquivo na aba "Editor" de uma "Command Window" do PL/SQL.







EMS58.2Atualizar a PCK_MIGRACAO_TXT_GP com a versão mais atual que existir na pasta "2.0.2.2-UNICOOGPS"

Os arquivos seguem a nomenclatura MIGRACAO_TXT_GP_VXX, onde XX representa o número da versão.

Não é necessário atualizar um a um. Deve ser considerado apenas o mais atual.

Utilizar uma "Command Window" do PL/SQL.

Obs: a atualização contém apenas os programas, sem criação de tabelas.







PRESTADORES9

Se já existir layout 9151 na tabela REM_ARQUIVO (do Unicoo), alterar esse código nos scripts "2.0.3-Geracao.sql" e "2.0.4-rem_campo.sql" antes de processá-los.

Da mesma forma, alterar o código caso já exista REM_DESTINATARIO com código 3000; REM_GRUPO_INFORMACAO com código 'MG';

Esse processo irá popular tabelas do Unicoo com informações para geração do TXT de migração de Prestadores, portanto o código do layout deve ser único.PL/SQL




PRESTADORES10Importar "2.0.3-Geracao.sql"Conectado ao owner do UnicooPL/SQL




PRESTADORES11criar DBLINK e SYONONYM no Unicoo para acesso a uma view no UNICOOGPS

A tarefa anterior cria um layout com a instrução 'select * from v_migracao_prestador'.

Visto que essa VIEW não existe no Unicoo, e sim no owner UNICOOGPS, deve ser criado DBLINK e SYNONYM correspondentes no Unicoo, para que a view do UNICOOGPS fique acessível.

Exemplo:

-- Create database link:
create public database link TOTVS_PRODUCAO
connect to UNICOOGPS identified by unicoogps
using '(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = 10.102.0.200)(PORT = 1521))
)
(CONNECT_DATA =
(SERVICE_NAME = totvsgp)
)
)';

-- Create synonym:
create or replace synonym v_migracao_prestador for unicoogps.v_migracao_prestador@TOTVS_PRODUCAO

PL/SQL




PRESTADORES12Importar "2.0.4-rem_campo.sql"Conectado ao owner do UnicooPL/SQL




PRESTADORES13Importar "2.0.5-rem_informacao.sql"Conectado ao owner do UnicooPL/SQL




GPS14Importar "2.0.8-mig_tab_conversao.sql" e "2.0.9-mig_tab_conversao_exp.sql"Conectado ao owner UNICOOGPSPL/SQL




GPS15Importar "2.0.7-TM_SEQUENCES.sql"Conectado ao owner UNICOOGPSPL/SQL




GPS16Compilar todos os objetos da PCK_UNICOOGPSConectado ao owner UNICOOGPSPL/SQL




GPS17Compilar todos os objetos da PCK_MIGRACAO_TXT_GPConectado ao owner UNICOOGPSPL/SQL




GPS18

Entrar na pasta "Progress" e copiar a pasta "migracao" para o mesmo local onde está instalado o TOTVS (mesmo nível onde se encontram as pastas dos produtos gp, ems2, ems5, hcm, fnd, etc). Pela instalação padrão, a pasta se chama ERP.


Obs: Além dos programas Progress, essa pasta possui subpastas, com scripts que serão utilizados em etapa posterior, durante a migração do Financeiro e GPS:

Scripts de execução manual:

_scripts_migracao_ems5

_scripts_migracao_gps

Scripts consumidos automaticamente pelo Jenkins (explicado mais abaixo):

_scripts_migracao_ems5_JK

_scripts_migracao_gps_JK

Progress




EMS518.1Compilar todos os programas Progress da pasta migracao/ems5Usar o editor criado no item 2.3, inclusive conectado ao Schema Holder SHUNIMED.Progress




GPS18.2Compilar todos os programas Progress das subpastas (api, atp, bosau, cgp, lap, rtp, tep, etc), exceto ems5 que já foi compilado no item anterior.No mesmo editor, desconectar o Schema Holder SHUNIMED pelo "Data Dictionary" antes de prosseguir.





GPS19Configurar o arquivo "migracao/configuracoes-progress.bat"

O arquivo possui variáveis de ambiente que precisam ser configuradas conforme o editor criado no item 2.3:

PROWIN32 - caminho onde se encontra o prowin32.exe na máquina que executará os processos Progress na migração;

PF - caminho onde se encontra o arquivo.pf de conexão aos bancos de dados;

INI - caminho onde se encontra o arquivo.ini. Atenção para adicionar a pasta "migracao"ao início do PROPATH;

CLIENTLOG_CONF - parâmetros de configuração para o CLIENTLOG;

USUARIO - login a ser utilizado nos processos que exigem autenticacao (importação de Clientes, Fornecedores, Títulos, etc);

SENHA - senha do USUARIO;







GERAL20Instalação do JenkinsA importação e atualização de dados de movimentação do Unicoo para o TOTVS12 é realizada através de diversas rotinas, administradas na ferramenta Jenkins





#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))
  • No labels