Histórico da Página
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ódulo | Seq | Passo | Observações | Programa |
---|
Responsável |
---|
Data Início | Data Final | Obs.: | Status |
---|
GERAL | 0 | Baixar 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 | |||||
EMS5 | 1 | 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 |
EMS5 | 2 | Criar o Schema Holder para acesso ao EMS506UNICOO à partir do Progress | Seguir passo a passo dos itens à seguir | Progress |
EMS5 | 2.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 | 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 |
EMS5 | 2.2 | Executar os scripts para Reparar e Truncar os bancos de dados (pasta ...\database-8080\scripts): (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/GPS | 2.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 |
EMS5 | 2.4 | Configurar 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): |
Obs: trocar "HOMOLOGA" pela referência à instância do Oracle que está sendo utilizada. | Progress |
EMS5 | 2.5 | Configurar 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. | Progress |
EMS5 | 3 | Conceder 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 |
EMS5 |
5 |
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.
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: |
Utilizar uma "Command Window" do PL/SQL. Obs: essa etapa criará as tabelas e a versão inicial da PCK. | PL/SQL | ||||||||
EMS5 | 5.1 | Atualizar 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. | ||||||
EMS5 | 5.2 | Testar acesso ao Schema Holder pelo Progress | Abrir 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 |
EMS5 | 6 |
Compilar os programas Progress da pasta "EMS5".
Compilar todos os objetos |
da PCK_EMS506UNICOO | PL/SQL |
GPS |
7 | Criar 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 |
GPS |
8 | 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: Obs: essa etapa criará as tabelas e a versão inicial da PCK. | PL/SQL | |||||
GPS | 8.1 | Atualizar 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. | |||||||||
EMS5 | 8.2 | Atualizar 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. | ||||||
PRESTADORES | 9 |
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 | |||||
PRESTADORES |
10 | Importar "2.0.3-Geracao.sql" | Conectado ao owner do Unicoo |
PL/SQL | |||||
PRESTADORES |
11 | criar 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'. Exemplo: -- Create database link: |
PRODUCAO |
totvsgp) -- Create synonym: |
PRODUCAO |
PL/SQL | |||||
PRESTADORES |
12 | Importar "2.0.4-rem_campo.sql" | Conectado ao owner do Unicoo |
PL/SQL | |||||
PRESTADORES |
13 | Importar "2.0.5-rem_informacao.sql" | Conectado ao owner do Unicoo |
PL/SQL | |||||
GPS |
14 | Importar "2.0. |
8-mig_tab_conversao.sql" e "2.0.9-mig_tab_conversao_exp. |
sql" | Conectado ao owner |
UNICOOGPS | PL/SQL | |||||
GPS |
15 | Importar "2.0.7-TM_SEQUENCES.sql" | Conectado ao owner UNICOOGPS |
PL/SQL | |||||||||
GPS | 16 | Compilar todos os objetos da PCK_UNICOOGPS | Conectado ao owner UNICOOGPS | PL/SQL | |||||
GPS | 17 |
Compilar os programas Progress das pastas
Compilar todos os objetos da PCK_MIGRACAO_TXT_GP | Conectado ao owner UNICOOGPS | PL/SQL | |||||||
GPS | 18 | 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 | |||||
EMS5 | 18.1 | Compilar todos os programas Progress da pasta migracao/ems5 | Usar o editor criado no item 2.3, inclusive conectado ao Schema Holder SHUNIMED. | Progress | |||||
GPS | 18.2 | Compilar 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. | ||||||||
GPS | 19 | Configurar 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; | ||||||
GERAL | 20 | Instalação do Jenkins | A 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 |