Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

Arquivo em formato excel: 00_MIT053_Roteiro_de_Instalação_Processo_Migração.xlsx

...


MóduloSeqPassoObservaçõesPrograma
BancoPredecessores
(D)  Digitar     ( I ) Importar
Responsável
(Usuário ou Módulo)
Acelerador
Data InícioData FinalObs.:Status
TI
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.

txtTI

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
IDBA





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





EMS52.1

Copiar os

3

artefatos

abaixo (

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
TI





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
TI





EMS5/GPS2.3

Criar atalho de Editor Progress para

Editor Progress

o Migrador.

Modelo na pasta "1.5-Editor (modelo)"

Esse editor será usado para executar
processso
processos que necessitem estar
conectado
conectados ao Schema Holder SHUNIMED.
Modelo no caminho: 1.5-Editor (modelo)
Progress
TI





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
TI





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

Mesmo

racioncínio

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
TI





EMS53Conceder GRANTS (permissões de acesso) no owner do EMS5 através do script "1.0
-Instalação Migração Financeiro (EMS5)\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
TI





EMS5
UNICOOTIEMS55Importar
5
4Criar campos no Unicoo que são utilizados pela migração, através do script "1.0-Instalação Migração Financeiro (EMS5)\1.0.3-Campos Fornecedor e Cliente.sql". Atenção para conectar ao owner do Unicoo antes de executar esse passo.
Irá criar novos campos nas tabelas CLIENTE e FORNECEDOR do Unicoo, utilizados pelo processo da migração.
Não afeta o funcionamento normal do Unicoo.PL/SQL

Criar a PCK que contém as tabelas e procedures do EMS506UNICOO através do script

“1.0-Instalação Migração Financeiro (EMS5)\

"EMS506UNICOO_INSTALACAO.sql" que se encontra na pasta "1.0.4-EMS506UNICOO

.sql

".

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;"

TI

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
TI





EMS56
Copiar todo o conteúdo da pasta "1.3-Processo Migração dados Financeiro" para uma pasta chamada "migracao" que deve ser criada abaixo de "ERP" no servidor.
Compilar os programas Progress da pasta "EMS5".Usar o editor criado acima no item 2.3.ProgressTIEMS57
Compilar todos os objetos
criados no owner
da PCK_EMS506UNICOO
PL/SQL
TI





GPS
6
7Criar o owner UNICOOGPS através do script "2
-Migração Plano Saúde (GPS)\2
.0
-Instalação Migração Plano Saúde (GPS)\2
.
0.
1-create_owner_UNICOOGPS.
txt
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
IDBATI





GPS
7
8

Importar as tabelas e procedures das PCKs PCK_UNICOOGPS e PCK_MIGRACAO_TXT_GP através

dos scripts

do script "2.0.2.2-PCK_UNICOOGPS.sql


2.0.2.3-PCK_MIGRACAO_TXT_GP.sql
que se encontra na pasta “Migracao_Processo\2.0-Instalação Migração Plano Saúde (GPS)\

"

.TIPRESTADORES


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-

Geração

Geracao.

txt

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.
TI
PL/SQL




PRESTADORES10Importar "2.0.3-Geracao.
txt
sql"Conectado ao owner do Unicoo
TI
PL/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 "
TIPRESTADORES
2.0.4-rem_campo.sql"Conectado ao owner do Unicoo
TI
PL/SQL




PRESTADORES13Importar "2.0.5-rem_informacao.sql"Conectado ao owner do Unicoo
TI
PL/SQL




GPS14Importar "2.0.
6
8-
rem
mig_tab_conversao.
txt
sql" e "2.0.9-mig_tab_conversao_exp.sql"Conectado ao owner
do UnicooTI
UNICOOGPSPL/SQL




GPS15Importar "2.0.7-TM_SEQUENCES.sql"Conectado ao owner UNICOOGPS
TIGPSCopiar todo o conteúdo da pasta "2.4-Processo Migração Plano Saúde" para uma pasta chamada "integracao" que deve ser criada abaixo de "ERP" no servidor (mesma pasta já criada em processo anterior, para o EMS5).
Compilar os programas Progress das pastas
PL/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
Criar um Editor acrescentando essa pasta no Propath.TIGPSCompilar todos os objetos criados no owner UNICOOGPSConectado ao owner UNICOOGPS