Guia de Converso

PRODUTO DATASUL

De EMS 2, EMS 5, HCM e Gesto de Planos para Datasul 11

Contedo
1. Requisitos do Processo........................................................................................................... 3 2. Instalando o Console e os Pacotes de Converso ................................................................... 4 3. Executando o Console de Converso...................................................................................... 5 4. Configurao do Console ........................................................................................................ 6 4.1. Unificao de Conceitos .................................................................................................... 6 4.1.1. Cenrio 1 Clientes com Gesto de Planos ................................................................. 7 4.1.2. Cenrio 2 Clientes com EMS2, EMS5 e HCM ............................................................ 7 4.1.3. Cenrio 3 Clientes com EMS2 e EMS5 ...................................................................... 7 4.1.4. Cenrio 4 Clientes com EMS5 e HCM........................................................................ 8 4.1.5. Cenrio 5 Clientes com EMS5 ................................................................................... 8 4.1.6. Cenrio 6 Clientes com HCM ..................................................................................... 8 4.1.7. Cenrio 7 Clientes com EMS2 ................................................................................... 8 4.1.8. Cenrio 8 Clientes com EMS2 e HCM........................................................................ 9 4.1.9. Cenrio 9 Clientes com HCM na verso 11.2.*........................................................... 9 4.2. Configurao do Ambiente................................................................................................ 9 4.3. Configurao de Servidores de Aplicao .........................................................................11 4.4. Conexo de Bancos de Dados..........................................................................................12 4.5. Conferncia de Bancos de Dados .....................................................................................12 4.6. Configurao de Acesso Nativo ........................................................................................13 5. Conferncia de Definies .....................................................................................................13 6. Conferncia de Dados ...........................................................................................................14 6.1. EMS 5.05 .........................................................................................................................15 6.2. Troca Empresa do HCM ...................................................................................................15 7. Procedimentos Pr-Converso...............................................................................................15 7.1. Reparao de Segurana do Banco MOVFRO ...............................................................15 7.2. Unificao do Foundation .................................................................................................16 7.3. Matriz de Traduo EMS 5 ..............................................................................................17 7.4. Mdulo de Controle de Acesso .........................................................................................17 7.5. Campos Indicativos do EMS 5 ..........................................................................................18 7.6. EMS 2 financeiro ..............................................................................................................18 7.7. Alterao do Banco de Dados EMSFIN ............................................................................19 7.7.1. Banco de Dados Progress OpenEdge ..........................................................................19 7.7.2. Banco de Dados Oracle ...............................................................................................20 7.8. Componentes Acessrios .................................................................................................21 7.9. Troca Empresa do HCM ...................................................................................................22 7.10. Antecipao de Verso do APS ........................................................................................23 7.11. Mdulo de Produo EMS2 ..............................................................................................23 7.12. Licenas Corporativas ......................................................................................................23 7.13. Audit Trail .........................................................................................................................23 8. Preparao de Dicionrio .......................................................................................................24 8.1. Bancos de Dados Progress OpenEdge .............................................................................25 8.2. Bancos de Dados Oracle ..................................................................................................25 9. Converso de Dados .............................................................................................................25 10. Correo de Dicionrio...........................................................................................................26 11. Execuo de Rotinas Gravadas .............................................................................................27 12. Procedimentos Ps-Converso ..............................................................................................27 12.1. Mdulo de Controle de Acesso .........................................................................................27 12.2. Criao de usurios em bancos com acesso JDBC ..........................................................28 12.3. Substituio dos bancos de dados no sistema destino ......................................................28 12.3.1. Sistemas anteriores ao Datasul para Datasul 11 ..........................................................29 12.3.2. Banco de dados Oracle ...............................................................................................29 12.4. Antecipao de Verso do APS ........................................................................................29 12.5. Unificao de Conceitos ...................................................................................................30 13. Consideraes Finais.............................................................................................................30

TOTVS S.A.

1.

Requisitos do Processo

O processo de converso exige configuraes no ambiente que devem ser observadas antes de inici-lo. Verifique se possui os seguintes requisitos: Se os bancos de dados do sistema de origem forem unificados, essa unificao tem que seguir o padro especificado pela Totvs, conforme documentao disponvel no Portal de Clientes ou com o Suporte a Banco de Dados. O arquivo .pf de conexo aos bancos origem; Em caso de banco unificado, o arquivo de alias para o sistema a ser convertido. Se o banco de dados for Progress, todos os ndices dos bancos de dados devero estar ativos. Em caso de dvidas nessa definio, utilize o comando a seguir:

proutil nome-do-banco C idxanalys > nome-do-banco.idx

Gera relatrio com informaes de ndices em banco Progress Edite o arquivo nome-do-banco.idx gerado. Procure por informaes (inactive). Ative os ndices inativos com o comando a seguir:

proutil nome-do-banco C idxbuild

Comando para ativar os ndices em Progress Se os bancos de dados forem Oracle, o owner dos bancos dever seguir o padro especificado pelo produto Datasul. Este padro foi configurado no arquivo datasul.pf dentro do diretrio scripts do ERP. Caso deseja utilizar outros owners, os deltas do schema-holder devero ser alterados pelo cliente. O sistema Datasul 11 exige que a verso mnima do Progress seja a 10.2B0501. Caso os bancos de dados no estejam nessa verso, converta-os primeiramente para a verso 10.2B0501 e posteriormente proceda com a converso do produto; Sistemas com bancos de dados SQL Server no so suportados. As verses de origem e destino da tabela a seguir, respeitando as indicaes de verso de pacote entre parntesis:

Sistema Origem
EMS 2.04 (F75) EMS 2.06B (B90) EMS 5.05 (C84) EMS 5.06 (C84) GP 1.00 (505.C92 / 506.C89) HCM 2.09 (B03) HCM 2.10 (A58)

Sistema Destino

Datasul 11 (5.0)

Recomendam-se algumas boas prticas para garantir a confiabilidade da converso: Se usar bancos de dados Progress OpenEdge para armazenamento de dados, habilite a opo de arquivos maiores que 2 Gbytes. Se utilizar outros bancos de 3

TOTVS S.A.

dados, confirme se os tablespaces ou file-groups esto preparados para o crescimento do banco.

proutil nome-do-banco C enablelargefiles

Comando para habilitar extenses maiores de 2 Gbytes no Progress OpenEdge Efetuar um backup do banco nos pontos determinados pelo processo. Algumas converses demandam rotinas antes e aps o procedimento de converso padro. Siga as informaes existentes nesse documento. Algumas rotinas especficas para os produtos que sero convertidos podero demandar importao de definies nos bancos de dados, utilizando recursos do prprio sistema gerenciador do banco de dados.

2.

Instalando o Console e os Pacotes de Converso

Um processo de converso obedece aos seguintes passos:

O processo de instalao disponibiliza os pacotes de converso para cada sistema. O diretrio Atualizacao conter os objetos necessrios para a unificao de conceitos. O diretrio Conversao conter os objetos necessrios para a converso. Dentro do diretrio Conversao haver o diretrio char64 com os objetos 64 bits, o diretrio console, que conter o console de converso e um diretrio para cada produto a ser convertido que foi instalado, chamado de diretrio de dados. Em cada diretrio de TOTVS S.A. 4

dados haver um atalho para executar a converso. DICA: Caso seja necessrio efetuar uma nova instalao de alguma converso, ou adicionar uma nova converso ao console j instalado, aponte para o mesmo diretrio j existente. Cada converso ter seus prprios diretrios de dados e o console o mesmo para todas as converses. Alm do atalho, o diretrio de dados conter as seguintes pastas:

Diretrio
cax-verso conf-verso conv-verso dat-verso dfcorr-verso dfprep-verso

Contedo
Arquivos com a imagem das definies padres dos bancos origem Programas de conferncia de dados Programas de converso de dados Arquivos de controle da converso Deltas de correo de dicionrio Deltas de preparao de dicionrio

O processo tambm demandar um arquivo .pf, que dever conter os parmetros para conexo ao banco de dados e o programa de alias utilizado na execuo do sistema origem, caso os bancos de dados origem sejam unificados. O programa de alias dever ser o fonte utilizado (.p) e no o compilado (.r), pois o programa no ser executado, mas sim interpretado durante o processo de converso.

3.

Executando o Console de Converso

O Console de Converso uma interface que acompanha o processo de qualquer converso do produto Datasul, baseado nas configuraes disponveis nos diretrios de dados pr-configurados. A imagem a seguir explica as informaes da tela do console. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. O produto que o console est convertendo. A etapa atual do processo. A ajuda da tela, traz informaes pertinentes a cada etapa do processo. rea de configurao dos dados da etapa atual. Barra de progresso ativada na execuo de cada etapa. Executa a etapa configurada na rea 4. Permite gravar etapas para execuo posterior. Essa opo habilita a prxima etapa sem executar a etapa atual.. Retorna a uma tela de configurao anterior. Abre o arquivo de log da converso. Aps finalizar a ao da tela, o boto Prximo habilitado para passar prxima etapa. Em caso de erro para essa etapa, o boto no ser habilitado.

TOTVS S.A.

4.

Configurao do Console

Aps selecionar o idioma a ser utilizado, as etapas seguintes configuraro a converso a ser executada.

4.1.

Unificao de Conceitos

A atualizao (update) para o produto Datasul 11.5.0 demanda uma atualizao de contas e centros de custo, conhecida por Unificao de Conceitos. Esse processo adequar os produtos EMS2 e HCM aos cadastros do EMS5. Este processo pode ser executado junto com a converso, ou imediatamente aps a converso, conforme dispostos nos cenrios a seguir. ALERTA: obrigatria a atualizao de contas e centros de custo antes de usar o produto Datasul 11.5.0. Se o Produto Datasul for colocado em produo antes dessa atualizao, ser necessrio executar novamente a converso com os bancos originais. Caso opte por executar a Unificao de Conceitos junto com a converso, essa etapa do console apresentar a tela para a escolha dos sistemas origem. O usurio dever selecionar os sistemas que utiliza em seu ambiente, e qual o sistema que converter nessa execuo do console. TOTVS S.A. 6

Se marcar que possui o EMS5 em seu ambiente, a opo de executar a unificao de conceitos ser habilitada. uma opo do cliente, executar ou no a Unificao de Conceitos juntamente com a converso, conforme cenrios apresentados a seguir. Alm da seleo, o cliente dever executar o programa cdp/cd0450 para regularizar os centros de custo. Esse programa dever executar antes da unificao de conceitos. Se for optado pela unificao de conceitos durante a converso, execute o cdp/cd0450 no produto origem. Se for optado pela unificao de conceitos aps a converso, execute o cdp/cd0450 antes de executar o console de atualizao no Datasul 11.5.0. O Guia de Unificao de Conceitos possui os passos de execuo do cdp/cd0450. Sobre a Unificao de Conceitos, existe tambm a FAQ http://tdn.totvs.com/kbm#113552, que deve ser utilizada como apoio neste processo. 4.1.1. Cenrio 1 Clientes com Gesto de Planos

Clientes que utilizam o produto Gesto de Planos devem realizar a converso juntamente com o produto EMS5, conforme os cenrios a seguir. Eles no demandam a atualizao de contas e centros de custo pois ele j tem essas informaes unificadas com o EMS 5. 4.1.2. Cenrio 2 Clientes com EMS2, EMS5 e HCM

possvel migrar o HCM e utiliz-lo no Datasul 11 antes de migrar o EMS2 e o EMS5. Se desejar utilizar o EMS2 ou o EMS5 no Datasul 11, obrigatoriamente os 3 produtos devero ser migrados juntos, convertendo cada um em uma execuo diferente do console. Se o HCM for utilizado antes no Datasul 11, a unificao de conceitos deve ser executada aps migrar o EMS2 e o EMS5. Se os 3 produtos forem migrados juntos, recomenda-se executar a unificao de conceitos juntamente com a converso do produto. Nesse cenrio, a converso do HCM demandar os bancos MGIND do EMS2 e o EMSUNI do EMS5. Os bancos de dados podem ser especificados no .pf de conexo, no programa de alias informado para o console quando os bancos forem unificados, ou ainda especificar os parmetros de conexo na conferncia de bancos do console. Para a converso do EMS2, o banco EMSUNI do EMS5 tambm ser solicitado. Caso no execute a unificao de conceitos junto com a converso, os bancos MGIND e EMSUNI podem ser descartados. 4.1.3. Cenrio 3 Clientes com EMS2 e EMS5

Os dois produtos devem ser migrados juntos para o Datasul 11, cada um em uma execuo diferente do console. Recomenda-se executar a unificao de conceitos juntamente com a converso dos produtos. TOTVS S.A. 7

Para esse cenrio, o banco EMSUNI do EMS5 dever ser conectado para a converso do EMS2. Ele pode ser especificado no .pf de conexo, no programa de alias informado para o console quando os bancos forem unificados, ou ainda especificar os parmetros de conexo na conferncia de bancos do console. 4.1.4. Cenrio 4 Clientes com EMS5 e HCM

possvel migrar o HCM e utiliz-lo no Datasul 11 antes de migrar o EMS5. Se desejar utilizar o EMS5 no Datasul 11, obrigatoriamente os 2 produtos devero ser migrados juntos, convertendo cada um em uma execuo diferente do console. Se o HCM for utilizado antes no Datasul 11, a unificao de conceitos deve ser executada aps migrar o EMS5. Se os 2 produtos forem migrados juntos, recomenda-se executar a unificao de conceitos juntamente com a converso do produto. Nesse cenrio, a converso do HCM demandar os bancos MGIND do EMS2 e o EMSUNI do EMS5. Os bancos de dados podem ser especificados no .pf de conexo, no programa de alias informado para o console quando os bancos forem unificados, ou ainda especificar os parmetros de conexo na conferncia de bancos do console. 4.1.5. Cenrio 5 Clientes com EMS5

Clientes que utilizam apenas o EMS5 no precisam executar a unificao de conceitos. 4.1.6. Cenrio 6 Clientes com HCM

Clientes que utilizam apenas o HCM no precisam executar a unificao de conceitos. Os bancos MGIND e EMSUNI devero ser descartados da conferncia de bancos. 4.1.7. Cenrio 7 Clientes com EMS2

Clientes que utilizam os mdulos de controladoria e finanas no EMS2 devero converter os dados financeiros para o produto EMS5, conforme descrito no captulo 7.6. A implantao do EMS5 pode ser feito na origem, ou aps convertido para o Datasul 11. Ao optar pela implantao do EMS5 antes do processo de converso para o Datasul 11, recomendvel a execuo do processo de converso juntamente com a unificao de conceitos. Se o processo de unificao de conceitos no for executado durante a converso, ele dever ser executado posteriormente atravs do processo de atualizao. Para esse cenrio, o banco EMSUNI do EMS5 dever ser conectado para a converso do EMS2. Ele pode ser especificado no .pf de conexo, no programa de alias informado para o console quando os bancos forem unificados, ou ainda especificar os parmetros de TOTVS S.A. 8

conexo na conferncia de bancos do console. Ao optar pela implantao do EMS5 aps o processo de Converso para o Datasul 11, no possvel executar o processo de converso juntamente com a unificao de conceitos. Neste caso, o processo de unificao de conceitos dever ser executado aps a converso do EMS2 e da implantao do EMS5, utilizando o processo de atualizao. Tambm nesse caso, o banco EMSUNI dever ser descartado da conferncia de bancos. 4.1.8. Cenrio 8 Clientes com EMS2 e HCM

Clientes que possuem os produtos EMS2 e HCM devem obedecer as regras de implantao do EMS5, conforme descrito no cenrio 7. Clientes nesse cenrio tambm podem migrar e utilizar o produto HCM no Datasul 11 antes de migrar o EMS2. De qualquer forma, para esse cenrio recomendado implantar o produto EMS5 no Datasul 11 e executar a unificao de conceitos aps a migrao de todos os produtos. Se optar por implantar o EMS5 antes de converter para o Datasul 11, executando simultaneamente a unificao de conceitos, a converso do HCM demandar os bancos MGIND do EMS2 e o EMSUNI do EMS5. Os bancos de dados podem ser especificados no .pf de conexo, no programa de alias informado para o console quando os bancos forem unificados, ou ainda especificar os parmetros de conexo na conferncia de bancos do console. Para a converso do EMS2, o banco EMSUNI do EMS5 tambm ser solicitado. Caso no execute a unificao de conceitos junto com a converso, os bancos MGIND e EMSUNI podem ser descartados. 4.1.9. Cenrio 9 Clientes com HCM na verso 11.2.*

Para esse cenrio existem duas situaes possveis. A primeira situao para clientes que possuem apenas o produto HCM. Para esse caso, atualize o dicionrio de dados at a verso 11.2.3. Clientes que possuem o HCM na verso 11.2.*, e que desejam converter o EMS2 ou o EMS5 para o Datasul 11.5.0, devero converter o EMS2/EMS5 para o Datasul 11.5.0 sem executar a unificao de conceitos, aplicar os deltas no HCM que levar os bancos para a verso 11.5.0, e ento executar a unificao de conceitos com o atalho da atualizao para a verso 11.5.0. Para converter o EMS2, descarte o banco EMSUNI solicitado na conferncia de bancos.

4.2.

Configurao do Ambiente
9

TOTVS S.A.

Aps selecionar as informaes para a unificao de conceito, o console apresentar o diretrio de trabalho e o produto a ser convertido. A identificao de bancos de dados mono-empresa atende a duplicao de bancos existente no EMS 2, quando o produto utilizado com mais de um estabelecimento e empresa com o mesmo cdigo. Dessa forma, o processo de converso dever ser executado uma vez para cada empresa. Para cada uma das empresas que sero convertidas, deve ser executado o processo de conferncia de dados. Somente quando o processo de conferncia no apresentar nenhum erro para TODAS as empresas, ou seja, estiver 100% (sem erros) para TODAS as empresas que os demais passos da console devem ser efetuados para cada empresa individualmente. Exemplo do procedimento acima descrito: O cliente tem 3 empresas. Ele deve executar o processo de conferncia para cada uma delas at que este processo no apresente mais nenhuma mensagem de erro. Assim que a conferncia estiver 100%, o procedimento ideal seria fazer um backup destes bancos, para que caso ocorra algum imprevisto durante a converso no seja necessrio fazer este procedimento novamente. Aps, os demais procedimentos do console devem ser efetuados para cada empresa (aplicaes de deltas e execuo dos programas de converso). A primeira empresa a ser convertida demanda que todos os bancos de dados sejam convertidos (mono e multi-empresa). Com a primeira empresa convertida, as converses das demais devem ter marcado o campo Somente bancos de dados mono-empresa, para que no seja aplicado novamente o processo de converso nos bancos multiempresa, que j foram convertidos. Desde o EMS 2, o cliente tem a opo de juntar vrios bancos de dados dos produtos em um nico banco, chamado de banco unificado. Caso os bancos origem sejam unificados, essa opo dever ser marcada. ALERTA: A converso do produto no permite mudar o ambiente de bancos nounificados para bancos unificados ou vice-versa. Caso o cliente deseja fazer essa configurao, ela dever ser feita antes de inici-lo ou depois de finaliz-lo. Alm de indicar a unificao dos bancos, tambm necessrio selecionar o sistema gerenciador de banco de dados. O produto EMS disponibilizado para Progress OpenEdge, Oracle e Microsoft SQL Server. At a verso atual, o produto Datasul disponibilizado para Progress OpenEdge e Oracle. IMPORTANTE: Clientes que utilizam o conceito de bancos histricos e que necessitarem ou desejarem converter estes bancos posteriormente, devem manter backups dos bancos do produto origem, bancos de cadastro, para que seja possvel rodar a console posteriormente.

TOTVS S.A.

10

4.3.

Configurao de Servidores de Aplicao

Servidores de aplicao so usados para executar processos em servidores diferentes do utilizado para executar a console. Independente da seleo informada na tela de configurao de servidores de aplicao, cada etapa do processo questionar se dever utilizar os servidores de aplicao cadastrados. Caso no tenha disponibilizado servidores de aplicao para o console, essa opo nas etapas seguintes estar desabilitada. Para os processos de conferncia de definies e dados, preparao de dicionrio e correo de dicionrio, ser utilizado apenas o primeiro servidor de aplicao cadastrado. Assim possvel conectar ao banco de dados em modo monousurio para esses processos. Para a etapa de converso de dados, todos os servidores de aplicao cadastrados sero utilizados simultaneamente, dividindo os programas entre eles. O cadastro dos servidores dever especificar uma entrada para cada agente disponibilizado nos brokers Appserver. O console considera que uma entrada no cadastro um servidor. O balanceamento entre os agentes Appserver, o prprio broker realizar. Caso o servidor de aplicao estiver em um (ou mais) servidor diferente do servidor do console, os seguintes diretrios devero ser copiados para compor o diretrio de dados do console para o Appserver. Se o servidor de aplicao for Unix/Linux, a cpia dever ser via FTP para evitar problemas com terminadores de linha. cvp (FTP binrio); dat-verso (FTP ASCII). conf-verso (FTP binrio): se executar a conferncia de dados usando Appserver; prep-verso (FTP ASCII): se executar a preparao de dicionrio usando Appserver; conv-verso (FTP binrio): se executar a converso de dados usando Appserver; corr-verso (FTP ASCII): se executar a correo de dicionrio usando Appserver.

Se o servidor estiver com Progress 64 bits instalado, o diretrio char64 dentro do diretrio de dados do console dever ser copiado, seguindo as mesmas regras acima. Um broker Appserver deve ser configurado com os seguintes parmetros: Modo de operao: State-Reset; Diretrio de trabalho: Apontar para o diretrio de dados do console copiado para o servidor de aplicao; Parmetros de inicializao do agente: -cpstream ibm850 d dmy numsep 46 numdec 44 ; Intervalo de pooling: Informar a quantidade de agentes que o broker Appserver ir disponibilizar. Cada agente corresponde a um servidor para o console.

Os parmetros de inicializao do agente tambm podem contemplar o parmetro h, especificando o nmero de bancos de dados que sero conectados simultaneamente pelos agentes, e o parmetro Mm, caso a conexo seja em modo cliente-servidor. Os brokers Appserver devem estar disponveis no momento da configurao dos servidores de aplicao no console. Os agentes Appserver que no for possvel conectar TOTVS S.A. 11

ser descartado da converso e informado no log conversao.txt.

4.4.

Conexo de Bancos de Dados

A conexo aos bancos de dados originais deve ser informada atravs de um arquivo .pf existente, para o console identificar os parmetros de conexo. As informaes existentes nesse arquivo podero ser alteradas em cada etapa do processo. Quando for especificado que os bancos de dados conectados no .pf so unificados, devese especificar tambm o fonte do programa que cria os alias para esses bancos de dados. Sero selecionadas do arquivo as linhas que comeam com a sintaxe create alias. As demais instrues do arquivo sero descartadas. Caso tenha sido disponibilizado servidores de aplicao para o console, essa tela disponibilizar a opo de testar a conexo do .pf no primeiro servidor de aplicao cadastrado. Nesse caso, o log da conexo ser trazido para o console e gravado no arquivo conexao.txt dentro do sub-diretrio log-verso do diretrio de dados do console. Se for optado por executar a unificao de conceitos juntamente com a converso, os bancos MGIND do EMS2 e EMSUNI do EMS5 devero estar conectados, conforme cenrios descritos no captulo 4.1. Os sistemas Totvs Datasul utilizam segurana a nvel de produto, ficando a segurana do banco de dados por opo do cliente. Como o processo de converso importar deltas de definies, necessrio especificar um usurio e senha com acesso administrativo aos bancos de dados com segurana aplicada. Caso seus bancos de dados possuam um dbauthkey aplicado, ser necessrio tambm aplicar o rcodekey nos programas dos diretrios conv-verso e conf-verso, do diretrio de dados da converso.

4.5.

Conferncia de Bancos de Dados

A tela de conferncia de parmetros de conexo aos bancos de dados ser apresentada entre cada etapa do processo. Isso porque possvel ter diferentes formas de conexo para cada rotina que ser executada. Em ambientes com bancos de dados Oracle e conexo ao schema-holder em modo somente-leitura (-RO), o console de converso altera automaticamente o modo de conexo para mono-usurio, sempre que for necessrio modificar definies do banco. Tambm possvel indicar para usar os mesmos parmetros de conexo para todas as etapas do processo. Nesse caso a tela de confirmao deixar de aparecer, exceto se algum banco de dados for demandado para a converso e no para a conferncia. As linhas da lista de bancos que aparecerem em vermelho indicam falha na conexo. O cliente ter a opo de continuar a converso descartando o banco de dados, ou ajustar TOTVS S.A. 12

os parmetros para conect-lo. Os erros de conexo so armazenados no arquivo conexao.txt, dentro do subdiretrio log-verso no diretrio de trabalho do console. possvel programar o console para executar um script criado pelo usurio, antes de cada etapa do processo. Para isso, apenas especifique o caminho e o nome do script no campo SCRIPT de cada etapa. Se for optado por executar a etapa via servidor de aplicao, o script ser executado apenas no primeiro servidor cadastrado.

4.6.

Configurao de Acesso Nativo

Alguns bancos de dados do sistema Datasul so conectados somente atravs dos padres ODBC ou JDBC. Esses bancos de dados, assim como ambientes com bancos de dados Oracle, tambm demandaro converso, porm com as rotinas de converso executadas atravs de um arquivo .sql ou .dfsql utilizando ferramentas nativas do banco. Caso a converso demande esse tipo de conexo, a tela de configurao de acesso nativo solicitar o preenchimento dos parmetros demandados. A lista de parmetros de conexo ir variar conforme o SGBD selecionado no incio da configurao. Todos os parmetros da lista so requeridos para conexo ao banco. Escolha o boto Salvar informaes de conexo para cada parmetro informado, ou o boto Salvar informaes para todos os bancos para gravar o valor do parmetro para todos os bancos de dados demandados. Caso no utilize algum banco de dados solicitado pelo console, selecione o boto No converter banco selecionado para descartar o banco do processo de converso. O console de converso conseguir extrair alguns tipos de conexo do .pf informado. Para esses casos, os parmetros identificados aparecero preenchidos nessa tela. No possvel importar essas definies atravs de servidor de aplicao.

5.

Conferncia de Definies

Essa conferncia compara se as definies de tabelas e ndices do banco de dados do cliente esto iguais s definies da expedio do produto Datasul, conforme a verso determinada nos requisitos da converso. A comparao feita com os arquivos .cax, disponibilizados no diretrio cax-verso, do diretrio de dados do console de converso. O objetivo listar as tabelas e ndices que esto com diferena de CRC. Fica sob responsabilidade do cliente a construo e aplicao dos deltas que corrigiro essas definies. As definies oficiais que podem ser usadas para gerao do delta esto localizadas no diretrio cax-verso. A conferncia poder apresentar 3 resultados diferentes: TOTVS S.A. 13

Diferente: quando o CRC da tabela est diferente da expedio do produto. Ausente: quando o cliente no possui alguma tabela da expedio do produto. ndice: quando a diferena encontra-se em algum ndice da tabela.

Tabelas que no tem problema no sero listadas aps a conferncia. Se o processo no encontrar diferenas a lista de tabelas ficar vazia. Em ambientes com banco de dados Oracle, apenas o schema-holder ser conferido.

6.

Conferncia de Dados

Essa etapa executa programas contra os bancos de origem para testar se a converso de dados funcionar. Durante essa rotina, a tela do console mostrar o andamento da tabela testada naquele momento e ocultar as tabelas j testadas com sucesso. Os programas do diretrio conf-verso so os responsveis por essa conferncia. Caso no existam conferncias a serem feitas, o console automaticamente pular essa etapa. A conferncia pode ser executada em servidores de aplicao. Nesse caso o console distribuir os programas de conferncia entre os appservers disponveis. Erros na conferncia permanecero na tela com o status NOK ou ERRO. Ao final do processo, a coluna de status pode ser ordenada para facilitar a identificao do resultado. O problema encontrado ser imediatamente reportado no arquivo conversao.txt, localizado dentro do subdiretrio log-verso, no diretrio de trabalho do console. Confira tambm esse arquivo para instrues de procedimentos em caso de erro. Em caso de dvidas, o suporte do mdulo responsvel pelo programa dever ser acionado. ALERTA: Por padro, o console no continuar a converso se a conferncia no terminar com sucesso. Porm possvel reiniciar o console, pular o processo de conferncia e continuar o processo de converso. Nunca faa esse procedimento a no ser que orientado explicitamente pelo suporte tcnico. DICA: Execute a conferncia de dados quantas vezes for necessrio para evitar que o processo de converso apresente erros que demandam retorno do backup dos bancos de dados. Essa conferncia limitada a criao de chaves nicas, validaes de formato de campo, alterao de tipo de dado de campos, e em alguns casos, validaes de regra de negcio. Ela apenas avisar que existe alguma inconsistncia no banco de dados que inviabilizar a converso. Nenhuma alterao feita nos bancos de dados. Para ambientes multi-empresa, favor verificar o item 4.2 deste manual para que o procedimento seja efetuado corretamente.

TOTVS S.A.

14

6.1.

EMS 5.05

Os clientes que executaro a conferncia da verso 5.05 do EMS 5 devero alterar o nome lgico do banco de dados EMSFIN, no arquivo .pf de conexo informado. Para isso, edite o arquivo .pf e especifique o parmetro ld movfin, na conexo do banco EMSFIN. Se for utilizado banco de dados unificado, a alterao dever ser feita no programa de alias informado para o Console de Converso. Nesse caso, ao invs do alias emsfin, defina o alias movfin para o banco unificado. Essa alterao se faz necessria porque os dados do banco EMSFIN sero copiados para um novo banco durante a converso, ficando os dados atuais no banco MOVFIN. Detalhes desse procedimento esto descritos no captulo 7.7.

6.2.

Troca Empresa do HCM

Clientes que convertero HCM e EMS para o produto Datasul, devero gerar um arquivo de troca de empresa, conforme procedimentos descritos no captulo 7.9. Se o arquivo no for encontrado, o programa de conferncia acusar a ausncia do arquivo, impedindo a continuidade do processo de converso. Se o cliente possuir apenas o HCM, os procedimentos para gerao do arquivo de troca de empresa no funcionar, podendo o cliente optar por uma das solues a seguir: Se for o nico problema identificado pela conferncia de dados, reinicie o processo e no execute a conferncia, marcando a opo No executar essa etapa, ou; Crie um arquivo vazio chamado troca-empresa.dat dentro do diretrio dat-verso.

7.

Procedimentos Pr-Converso

Alguns produtos precisam de ajustes antes da converso, que alteraro o banco de dados origem. Algum desses procedimentos inviabilizaro que os bancos de dados de origem sejam novamente utilizados pela verso origem do sistema. ALERTA: A partir desses processos, alteraes sero feitas nos bancos de dados de origem. Tenha um backup dos bancos de dados antes de iniciar.

7.1.

Reparao de Segurana do Banco MOVFRO

ALERTA: Esse procedimento destina-se a todos os clientes que possuem o mdulo de frotas com banco Progress OpenEdge.

Devido a uma falha na definio do banco MOVFRO, possvel que a tabela mmvmovto-mdo tenha restrio na permisso de acesso. Essa restrio dever ser corrigida TOTVS S.A. 15

antes de iniciar a converso do EMS 2. Isso pode ser feito pela ferramenta Data Administration, disponibilizado no Progress OpenEdge. A partir da opo Executar Programa do sistema, execute o programa _admin.p. Esse programa abrir o Data Administration. Selecione o menu Database Select working database. Selecione o banco MOVFRO ou o correspondente unificado. Confirme a seleo do banco e em seguida selecione o menu Admin Security Edit data security. Localize a tabela mmv-movto-mdo e altere as suas permisses, substituindo a informao !,* por *.

7.2.

Unificao do Foundation
ALERTA: Esse procedimento destina-se a todos os clientes que esto em verses anterior ao Datasul 10 e que desejam migrar seus cadastros para o Datasul 11. A no execuo desse procedimento implicar na necessidade de recadastramento manual dos dados do Foundation.

Desde a verso 10, os produtos TOTVS Datasul tem um cadastro nico de informaes referentes ao ncleo do sistema, conhecido por Foundation. Para unificar essas informaes, um processo acompanhar o que dever ser migrado, unificando os cadastros duplicados ou alterando-os, conforme opo do cliente. DICA: Reduza o tempo de indisponibilidade do ambiente, instalando, inicializando e unificando o Foundation antes de iniciar o processo de converso de negcio. Para iniciar a unificao, inicie o sistema Datasul 11, autentique-se com o usurio super e execute o programa btb/btb959za.w. A tela que permite a escolha da ordem dos produtos convertidos ser apresentada. Essa ordem determinar qual sistema ter prioridade sobre a migrao dos cadastros, sendo que o primeiro sistema migrar integralmente e os demais sero adaptados ao primeiro. Caso no possua os trs sistemas sugeridos, selecione a opo Sem Banco. Informe os parmetros de conexo ao banco de dados do Foundation de cada um dos sistemas existentes. A tabela a seguir apresenta o banco de dados de cada sistema:

Sistema
EMS 2 EMS 5 HCM

Banco Fsico Padro

ems2uni emsbas ems2uni

Nome Lgico
mguni emsbas mguni

ALERTA: O produto Gesto de Planos utiliza-se do Foundation do EMS 5 e ser contemplado com a migrao do banco EMSBAS do EMS 5. Caso os bancos de dados estejam unificados, indique os parmetros de conexo ao banco que contem o alias do nome lgico da tabela acima. Especifique esse mesmo nome lgico no parmetro ld da conexo. TOTVS S.A. 16

Proceda com as demais configuraes indicadas na tela. Por ltimo, ser solicitado um diretrio para gerao de log de migrao. Selecione um diretrio vlido e preferencialmente vazio, para facilitar a identificao dos logs posteriormente. Pressione o boto Converter para iniciar o processo. ALERTA: Todo o contedo do diretrio especificado para gerao de log, inclusive subdiretrios, ser eliminado antes do incio do processo. Sempre especifique um diretrio que no contenha arquivos necessrios.

7.3.

Matriz de Traduo EMS 5

No sistema Datasul, com um nico login os usurios tero acesso a todos os seus produtos. Para que isto seja possvel sem perder referncia s empresas cadastradas em cada produto, necessrio a criao de uma Matriz de Traduo para Organizao Externa no EMS 5 (prgint/utb/utb118aa) caso ela no exista. A matriz ser usada para identificar a unidade organizacional do EMS 5 correspondente unidade organizacional do EMS 2, relacionada ao usurio do login. Tambm ser usada na troca da empresa dentro do sistema Datasul (procedimento Troca Empresa Usurio). Dever existir ao menos um registro de relao entre a empresa do EMS 2 com a empresa do EMS 5. As demais podem ser cadastradas depois da converso. A Matriz de Traduo Organizao Externa dever ter o nome EMS2 e a Origem Organizao dever ser EMS. Se j existir uma matriz chamada EMS2, ela dever ser a oficial utilizada na integrao entre o EMS 2 e o EMS 5. Na matriz devero ser cadastradas todas as empresas e estabelecimentos usados no EMS 2, conforme abaixo: Tipo Unidade Organizacional: empresa/estabelecimento usado no EMS2. Unidade Organizacional Externa: Unidade Organizacional do EMS2. Unidade Organizacional: Unidade Organizacional do EMS5.

As demais informaes (matriz contas, matriz centro de custo e outras) no precisaro ser identificadas neste momento.

7.4.

Mdulo de Controle de Acesso

ALERTA: Esse procedimento destina-se apenas aos clientes que possuem o mdulo de controle de acessos no HCM 2.09.

Para o sistema Datasul, o mdulo de controle de acessos est integrado ao produto. At a verso 2.09 esse mdulo era comercializado como um componente acessrio. Por esse motivo, clientes com o Controle de Acesso antecipado no HCM 2.09 devem executar procedimentos que convertero os dados existentes para a nova verso do sistema. TOTVS S.A. 17

O primeiro passo trazer as definies do Controle de Acesso para a ltima verso. Caso no saiba sua verso do Controle de Acesso, confira o log de conferncia do programa conf-tm001, gerado no diretrio log-verso. Importe o delta correspondente do Controle de Acesso no banco DTHRTMA. Se o log indicar que o Controle de Acesso est atualizado com a ltima Verso, no ser necessrio aplicar deltas de atualizao:

Verso
Verso 1 Verso 2 Verso 3

Delta
msa_versao_1.df msa_versao_2.df msa_versao_3.df

Com as definies do Controle de Acesso na ltima verso, dever ser ento aplicado o delta dthrtma_msa_preparacao.df, localizado no subdiretrio spp do diretrio de dados da converso. Esse delta dever ser aplicado no banco DTHRTMA, ou em seu correspondente banco unificado, em caso de ambientes com bancos de dados unificados. Se o banco de dados for Oracle, alm do arquivo .df que dever ser importado sobre o schema-holder, tambm necessrio importar o arquivo .sql correspondente, sobre o banco de dados Oracle.

7.5.

Campos Indicativos do EMS 5

ALERTA: Esse procedimento destina-se apenas aos clientes que possuem o EMS 5 nas verses 5.05 e 5.06, com idiomas ingls ou espanhol.

No produto EMS 5 existe o conceito de Campos Indicativos, que so valores fixados geralmente para formatao de caixas de seleo. Um exemplo para esses campos o atributo pessoa_fisic.ind_estado_civil_pessoa (indicador do estado civil da pessoa fsica), que pode assumir os valores solteiro, vivo, casado, separado ou divorciado. Estes item so gravados no Banco de Dados e esto sempre no idioma do ambiente: Portugus, Ingls ou Espanhol. No produto Datasul, o EMS 5 multi-idioma. Desta forma, os campos indicativos devem estar em Portugus para a traduo ser feita automaticamente quando os programas que utilizarem o campo forem executados. Clientes com esse ambiente devero executar o programa prgint/utb/utb373aa.py, para traduzir os campos indicativos do idioma ingls ou espanhol para o idioma portugus.

7.6.

EMS 2 financeiro
ALERTA: Esse procedimento destina-se aos clientes que utilizam os mdulos de controladoria e finanas no produto EMS 2. Clientes que utilizam esses mdulos no produto EMS 5 no necessitam dessa etapa.

O produto EMS 2 disponibilizava mdulos financeiros para utilizao, tanto na verso 2.04 quanto na verso 2.06B. Porm o produto Datasul disponibiliza mdulos financeiros TOTVS S.A. 18

apenas para o produto EMS 5, chamado agora de parte financeira. Os mdulos de controladoria e finanas do EMS 2 no podem ser automaticamente convertidos para o Datasul 11. Existem duas alternativas para proceder com a converso: Alternativa 1: instalar o EMS 5.06 provisoriamente e fazer a configurao para essa verso. Uma vez configurado, proceder com a converso normal do produto. A vantagem dessa alternativa que o EMS 5.06 consegue ler informaes do EMS 2, o que torna a converso da parte financeira mais rpida. Porm, uma instalao provisria um passo a mais para o processo. Alternativa 2: converter o EMS 2 normalmente. Aps a converso, configurar a parte financeira no Datasul 11. Dessa forma no necessrio a instalao provisria de outra verso do sistema, porm perde-se mais tempo para trazer as informaes para o Datasul 11, que no consegue comunicar-se com o EMS 2.

Clientes nessa caracterstica de utilizao devero providenciar com a franquia Totvs que lhe atende, um servio de implantao para determinar a melhor alternativa para seu ambiente. Alm da configurao da parte financeira, este passo intermedirio j avalia as configuraes para garantir um teste integrado entre todos os mdulos, executando uma rotina completa, desde pedidos/compras at integraes com financeiro e contabilizaes. Essa configurao um requisito para o aproveitamento das funcionalidades do produto e contribuir com maior produtividade e organizao das informaes no novo sistema.

7.7.

Alterao do Banco de Dados EMSFIN

ALERTA: Esse procedimento destina-se a todos os clientes que possuem o sistema EMS 5.05

A verso 5.05 do EMS 5 possui os dados de cadastro e os dados de movimentos unificados no banco EMSFIN. O EMS 5 no produto Datasul possui os dados de movimentos separados, no banco de dados MOVFIN. O processo de converso separa os dados entre esses dois bancos. Porm, como os dados de movimento representam a maior parte do banco EMSFIN, optou-se por renomear o banco de dados EMSFIN existente para MOVFIN, e transferir os dados de cadastro para o novo banco de dados EMSFIN criado. Os seguintes passos exemplificam uma forma de fazer esse procedimento. ALERTA: No execute os passos descritos a seguir se o banco de dados EMSFIN existente no EMS 5.05 for unificado com os demais bancos. Nesse caso, o processo de converso unificar o novo banco na unificao j existente. 7.7.1. Banco de Dados Progress OpenEdge

TOTVS S.A.

19

Derrube o banco de dados EMSFIN. Se o servidor de banco de dados for Windows, no menu Iniciar Programas Pasta do Progress, existe um atalhos com o nome Proenv. Execute-o. Se o servidor de banco de dados for Unix ou Linux, no diretrio bin do Progress existe um script com o nome proenv. Execute-o. Navegue at o diretrio onde se encontra o arquivo emsfin.db. Esse o arquivo de estrutura do banco de dados. Execute o comando:

prostrct list emsfin

Comando para listagem de estrutura do banco As informaes de estrutura do banco sero apresentadas na tela. Tambm ser gerado o arquivo emsfin.st. Renomeie esse arquivo para movfin.st. Edite o arquivo com qualquer editor de texto sem formatao disponvel no sistema operacional utilizado, alterando toda referncia aos arquivos do banco EMSFIN para o nome MOVFIN. Salve o arquivo e feche-o. Execute o seguinte comando para copiar o banco de dados:

procopy emsfin movfin

Comando para cpia do banco de dados Aps a cpia, elimine o banco de dados EMSFIN.

prodel emsfin

Comando para excluso dos arquivos do banco EMSFIN A partir de agora, o banco de dados EMSFIN existente passa a ser o banco de dados MOVFIN. O prximo passo criar um novo banco de dados EMSFIN para utilizar no processo de converso. Pela mesma sesso do proenv, execute o seguinte comando:

prodb emsfin empty

Comando para criao do banco EMSFIN vazio Aps concluir as alteraes, feche a sesso do proenv e adicione a conexo ao banco MOVFIN no arquivo .pf utilizado para a converso. 7.7.2. Banco de Dados Oracle

Em banco de dados Oracle, tanto a parte Progress quanto a parte Oracle precisaro ser alteradas, para o que era considerado EMSFIN na verso 5.05, seja considerado MOVFIN na nova verso. Lembre-se que essa alterao necessria apenas se o banco de dados no for unificado. Primeiramente, altere o nome do schema-holder, seguindo os procedimentos do captulo TOTVS S.A. 20

7.7.1, lembrando que o schema-holder seguir o nome de SHMOVFIN. Crie tambm um novo schema-holder com o nome SHEMSFIN para o banco EMSFIN novo. Em seguida, exporte os objetos do EMSFIN do Oracle, que deve estar sob o schema EMS505BPORO8P930FIN, e importe sobre um novo schema com o nome de EMS505BPORO8P930MFIN. Para criar novas definies sobre o EMSFIN, elimine todos os objetos do schema EMS505BPORO8P930FIN Conecte o schema-holder renomeado para alterar o nome tambm do schema-image de EMSFIN para MOVFIN. Utilize o comando a seguir para abrir o Data Administration conectando ao SHMOVFIN e importe o delta spp/altera_schema_image_movfin.df.
prowin32 db c:\banco\shmovfin.db ld shmovfin -1 cpstream ibm850 d dmy numsep 46 numdec 44 p _admin.p -rx

Exemplo de comando para abertura do Data Administration Em seguida, execute o programa spp/altera_owner_emsfin.r para informar aos objetos, o nome do novo owner do lado Oracle. O programa ir perguntar o owner que ser atribudo para o banco movfin. Ele j trar o valor padro.
prowin32 db c:\banco\shmovfin.db ld shmovfin -1 cpstream ibm850 d dmy numsep 46 numdec 44 p spp\altera_owner_emsfin.p

Exemplo de comando para execuo de programa Por ltimo, execute o comando abaixo para conectar o banco SHEMSFIN e importar o arquivo spp/cria_schema_image_emsfin.df que criar o schema-image EMSFIN.
prowin32 db c:\banco\shemsfin.db ld shemsfin -1 cpstream ibm850 d dmy numsep 46 numdec 44 p _admin.p -rx

Exemplo de comando para abertura do Data Administration

7.8.

Componentes Acessrios
ALERTA: Esse procedimento destina-se a todos os clientes que possuem os componentes acessrios MAF, MOE e MSC.

A partir da verso 11 do produto Datasul, os dados de componentes acessrios sero armazenados em um nico banco de dados, chamado EMSDCA. Esse banco dever ser criado e os componentes acessrios do sistema origem devem ser unificados, para ento ter suas definies convertidas para o Datasul 11. Para isso, crie um novo banco de dados para o sistema origem com o nome de EMSDCA e importe as definies do arquivo spp/emsdca-origem.df.

TOTVS S.A.

21

DICA: Aps esse procedimento possvel utilizar o componente acessrio no sistema origem usando o EMSDCA, enquanto a converso oficial no for realizada. Basta conect-lo com o nome lgico antigo, ou criar um alias para esse nome. Em bancos de dados Oracle, o banco EMSDCA tambm dever ser criado em dois passos: crie um schema-holder com o nome SHEMSDCA e importe as definies do arquivo spp/shemsdca.df. Em seguida, crie um novo schema no Oracle chamado EMSDCA e importe sobre esse esquema as definies do arquivo spp/shemsdca.sql. Por ltimo, faa um dump de dados e valores de sequncia referente aos componentes acessrios MAF, MOE e MSC, e efetue o load sobre o banco EMSDCA criado. Utilize esse banco EMSDCA para o processo de converso para o Datasul 11.

7.9.

Troca Empresa do HCM

ALERTA: Esse procedimento destinado a todos os clientes que possuem os sistemas HCM e EMS2.

O processo de converso do HCM converter o cdigo da empresa para torn-lo compatvel com o EMS2. Para isso, execute no HCM origem o programa prghur/spp/upgera-troca-empresa.w. Ser solicitado os parmetros de conexo ao banco mguni do EMS2. Informe os parmetros e selecione o boto Conexo. A tela mostrar a lista de empresas do EMS2 e a lista de empresas no HCM. Caso seja identificado semelhana entre o cadastro de empresa pelo CNPJ, o programa automaticamente indicar a mudana do cdigo. Empresas iguais e de mesmo cdigo no precisaro sofrer alterao. Caso as informaes no sejam identificadas automaticamente, informe a necessidade da converso e o novo valor do cdigo da empresa no HCM. Informe o diretrio onde ser gerado o arquivo troca-empresa.dat. Indique o diretrio do console de converso, subdiretrio dat-verso, onde verso indica a converso do HCM que ser executada. ALERTA: Os procedimentos de troca de empresa funcionaro apenas com as tabelas padres do produto. Tabelas especficas devero ser revisadas juntamente com a consultoria do produto HCM. O layout do arquivo consiste no cdigo da empresa de origem no HCM e no cdigo que ser assumido por essa empresa cdigo correspondente ao cdigo da empresa no EMS. Os cdigos esto entre aspas duplas, separados por um espao em branco. Se no for necessrio alterar o cdigo das empresas, o arquivo dever ser gerado vazio.
"001" "47" "015" "22"

TOTVS S.A.

22

Exemplo de arquivo troca-empresa.dat ALERTA: Caso a base de dados seja Oracle, o arquivo troca-empresa.dat dever ser criado manualmente.

7.10.

Antecipao de Verso do APS

ALERTA: Esse procedimento destinado a todos os clientes que possuem o mdulo APS em verso superior a 2.0 com o EMS2.

Clientes com o mdulo APS devem conferir o log do programa de conferncia confdb005.p. Nesse log ser informado se a verso do APS foi antecipada. Nesse caso, os bancos de dados do APS EMS2DBR e MOV2DBR, no devero ser conectados pelo processo de converso. Quando o console de converso acusar a ausncia desses bancos de dados, eles devero ser marcados para no converter.

7.11.

Mdulo de Produo EMS2

ALERTA: Esse procedimento destinado a todos os clientes que convertero o EMS 2.04 para o Datasul 11 e utilizam ordens de produo com reporte por operao ou ponto de controle, atravs do programa CP0320 e CP0321.

Todas as ordens de produo parametrizadas com tipo de reporte por operao ou ponto de controle e reportadas pelos programas CP0320 e CP0321 devem obrigatoriamente ser encerradas antes de iniciar o processo de converso. Clientes que trabalham ou possuem parametrizado o mdulo de cho de fbrica no EMS 2.04 no sero afetados e continuaro reportando as ordens no Datasul 11, desde que elas no sofreram reporter no mdulo de produo pelos programas CP0320 e CP0321. No Datasul 11 os programas de reporte de operao (CP0320) e reporte de ponto de controle (CP0321) foram descontinuados. As ordens com essas caractersticas s podero ser reportadas atravs do mdulo de cho de fbrica (SFC).

7.12.

Licenas Corporativas

Caso utilize o License Server com licena corporativa, dever ser conferido j no sistema origem se o CNPJ da empresa est igual ao CNPJ da licena. Diferenas nessa informao inviabilizaro o uso do Datasul 11 convertido.

7.13.

Audit Trail
23

TOTVS S.A.

ALERTA: Esse procedimento destina-se apenas aos clientes que utilizam o mdulo Audit Trail com a opo 'Tabela Completa' A partir da verso 11.5.0 do Datasul a forma de armazenamento das informaes auditadas para tabelas completa mudou. Para manter a compatibilidade dos dados j auditados deve-se executar a api auapi008 ANTES da alterao da estrutura do banco. Vale lembrar que dados que no possam ser convertidos sero excludos. As informaes relacionadas a auditoria 'campo a campo' continuaro funcionando normalmente.

8.

Preparao de Dicionrio

Nessa etapa da converso, deltas de dicionrio sero aplicados sobre o banco de dados origem. Esses deltas tem o objetivo de incluir novas definies, preparando o banco de dados para execuo de programas de converso. Alm das novas definies, objetos existentes recebero sufixos para diferenci-los dos novos objetos inseridos. ALERTA: Caso possua programas especficos que acessam tabelas dos bancos padres do produto, localize nos deltas existentes no diretrio dfprep-verso se alguma tabela utilizada sofrer alteraes. Em caso positivo, recomendamos testar os programas especficos aps a converso para possvel correo. As alteraes desse processo colocaro os bancos de dados em uma posio intermediria entre as definies do sistema origem e as definies do sistema destino. esperado que nenhuma das duas verses funcionem com os bancos nesse estado. Antes de importar as definies, o console questionar se deseja alterar os parmetros de conexo aos bancos de dados. Por padro, usar os parmetros indicados no arquivo .pf informado na primeira etapa do processo. Bancos de dados que sofrem conexo ODBC/JDBC/OCI, tambm podero receber deltas. Eles sero conectados conforme os parmetros especificados no captulo 4.6 desse guia. Deltas de bancos de dados Progress podem ser importados via servidor de aplicao. Nesse caso, apenas o primeiro servidor cadastrado ser usado para o processo. O campo Importar em nova sesso disponibilizado para clientes que tem licena de desenvolvimento importar definies em uma nova sesso de Progress. Para clientes sem licena de desenvolvimento, esse comportamento padro. ALERTA: Devido a um BUG do Progress, aconselha-se sempre marcar essa opo. A no utilizao causar resultados inesperados no processo. Esse BUG encontra-se corrigido na verso 10.2B02. A informao de processos simultneos de importao ser utilizado com bancos de dados Oracle. Ela permite que vrias definies sejam importadas simultaneamente sobre os bancos de dados. Configure a quantidade conforme a capacidade de seu servidor. TOTVS S.A. 24

O administrador do sistema pode optar por importar os deltas pelas ferramentas nativas do banco de dados. Isso possvel desde que obedea a especificao do arquivo definicoes.dat localizado no subdiretrio dat-verso do diretrio de dados de converso, que contenham a indicao prep, ao final de cada linha. Os deltas esto no subdiretrio dfprep-verso do diretrio de dados da converso. Os logs sero gerados no subdiretrio log-verso, com o nome delta-etapa-arquivo.txt, onde etapa corresponde a preparao ou correo (prep/corr) e arquivo ao nome do delta.

8.1.

Bancos de Dados Progress OpenEdge

Caso faa a preparao do dicionrio em modo cliente-servidor, certifique-se que o banco de dados no foi iniciado com o parmetro bithold, que limita a utilizao do beforeimage. Da mesma forma, siga as recomendaes desse documento, habilitando arquivos maiores de 2 Gbytes ou adicionando vrias extenses para o before-image. ALERTA: Importao de definies pode gerar grande volume de dados para os arquivos de before-image, o que abortar o processo se existir alguma limitao que impea o crescimento desses arquivos. Durante a importao existiro momentos em que a tela do processo ficar travada para fazer o commit do banco. No aborte essa execuo, pois isso demandar retorno do backup dos bancos. DICA: Otimize o desempenho do processo de importao de definies quando possvel, conectando os bancos de dados em mono-usurio e com o parmetro i.

8.2.

Bancos de Dados Oracle

Os deltas de dicionrio que precisam ser aplicados sobre o banco de dados so liberados com extenso e formato SQL. Por padro, eles sero aplicados pelo utilitrio SQLPLUS, que o cliente dever ter disponvel no computador onde est executando a converso. O padro de acesso ao banco atravs do SQLPLUS est localizado no arquivo conexao.dat, localizado no diretrio dat do Console de Converso, que tentar identificar os parmetros de conexo com base na definio do arquivo .pf de conexo aos bancos. Se o cliente precisar estabelecer a conexo ao banco de dados Oracle por uma ferramenta diferente do SQLPLUS, dever importar os deltas manualmente, ou criar um padro de conexo no arquivo conexao.dat para o console importar. No segundo caso, a consultoria telefnica de banco de dados poder auxili-lo.

9.

Converso de Dados
25

TOTVS S.A.

Os programas de converso transformaro os dados da verso origem para a verso destino, utilizando-se das definies criadas pela importao de deltas de preparao. Essa transformao feita pelos programas localizados no diretrio conv-verso. O arquivo conversao.txt acumula os logs dos programas. ALERTA: Se o processo de converso terminar com status NOK, ERRO ou ALERT, o log da converso dever ser conferido para identificar o problema e o backup dos bancos origem devero ser retornados para reiniciar o processo. Da mesma forma que a etapa de conferncia de dados, a opo de executar os programas de converso em servidores de aplicao ir utilizar todos os servidores cadastrados simultaneamente. Quando servidores de aplicao so utilizados, a coluna de servidores ser populada com os processos ativos nesse momento. Para o processo sequencial, cada programa ser executado individualmente e o nmero de registros ser atualizado durante a execuo.

10.

Correo de Dicionrio

Essa etapa corrigir nos bancos de dados, definies temporrias geradas pelo processo de converso. Igual etapa de preparao de dicionrio, o administrador do sistema pode optar por importar as definies com ferramentas nativas do banco de dados. Obedea as mesmas regras, lembrando que nesse momento devero ser importadas as definies com a indicao corr. Elas estaro salvas no diretrio dfcorr-verso. ALERTA: Ambiente com bancos de dados Oracle tero algumas tabelas recriadas na etapa de correo. Caso o cliente tenha customizado o tamanho de algum campo tipo varchar, confira se os deltas do diretrio dfcorr-verso influenciam esses campos e altere-os conforme necessidade. Esse ltimo delta manipular ndices que so reservados para criar ao final do processo. Essa criao de ndices demandar muito tempo. Nesse processo, a tela do console congelar e, dependendo da verso do Windows, deixar de ser atualizada, parecendo que o processo est travado. Essa caracterstica esperada. ALERTA: No aborte o processo. Isso implicar no retorno do backup e reexecuo do processo de converso. Da mesma forma que as demais etapas, o console permitir a alterao dos parmetros de conexo e a possibilidade de importar os deltas em uma nova sesso do Progress. Terminado o processo, saia do console, derrube os bancos de dados e trunque suas reas de before-image com o comando sugerido a seguir:
proutil nome-do-banco C truncate bi

Comando de truncagem do before-image O processo de importao de definies gera muito espao em before-image. A TOTVS S.A. 26

truncagem elimina esse espao e permite a conexo a em modo somente-leitura (-RO) para schema-holders, em caso de bancos de dados Oracle ou SQL Server.

11.

Execuo de Rotinas Gravadas

As etapas que foram gravadas durante o processo so apresentadas para execuo, obedecendo a sua ordem de gravao. O cliente tem a opo de no executar uma etapa gravada, porm isso poder influenciar negativamente no resultado da converso. ALERTA: Apenas deixe de executar alguma etapa da converso quando explicitamente recomendado pelo suporte tcnico do produto Datasul. A no execuo de alguma etapa poder gerar resultados inesperados. Etapas que j foram executadas estaro desabilitadas nessa tela.

12.

Procedimentos Ps-Converso
ALERTA: Os bancos de dados estaro convertidos apenas aps a concluso desses procedimentos ps-converso. No utilize os bancos de dados com a converso incompleta

Esses devem ser executados aps as alteraes feitas pelo processo de converso.

12.1.

Mdulo de Controle de Acesso

ALERTA: Esse procedimento destina-se apenas aos clientes que possuem o mdulo de controle de acessos no HCM 2.09.

Aps a concluso do processo de converso necessrio transformar os dados do Controle de Acesso da verso utilizada no HCM 2.09 para o Datasul 11. Para isso execute o programa sp_conv_msa.r, localizado no diretrio spp do diretrio de dados da converso, com o banco DTHRTMA conectado ou seu correspondente unificado em caso de ambientes com bancos de dados unificados. Esse processo mover dados entre tabelas, o que pode ser lento dependendo do tempo de uso do controle de acesso. No aborte sua execuo. Em caso de erro, os bancos de dados originais devero ser retornados do backup e o processo de converso dever ser refeito. Ao final da execuo emitida a mensagem Programa Executado com Sucesso. O comando abaixo exemplifica uma forma de conectar o banco e executar o programa:
c:\progress\bin\prowin32 db d:\bancos\dthrtma -1 cpstream ibm850 numsep 46 numdec 44 d dmy p d:\converte\spp\sp_conv_msa.r

Comando para conectar o banco e executar o programa de acerto TOTVS S.A. 27

Por ltimo, o delta dthrtma_msa_correcao.df localizado no diretrio spp dever ser aplicado sobre o banco de dados DTHRTMA, ou seu correspondente unificado em caso de ambientes com bancos de dados unificados. Atravs do Data Administration, selecione o menu Admin Load Data And Definitions Data Definitions (.df file).
c:\progress\bin\prowin32 db d:\bancos\dthrtma -1 cpstream ibm850 numsep 46 numdec 44 d dmy p _admin.p -rx

Comando para conectar o banco e importar a definio pelo Data Administration Se o sistema gerenciador de banco de dados for Oracle, alm do arquivo dthrtma_msa_correcao.df que dever ser aplicado sobre o schema-holder, tambm dever ser aplicado os seguintes arquivos no banco Oracle, conforme a verso original do Controle de Acesso identificado no programa de conferncia conf-tm001:

Verso
Verso 1 Verso 2 Verso 3 ltima Verso

Delta
dthrtma_msa_correcao_v1.sql dthrtma_msa_correcao_v2.sql dthrtma_msa_correcao.sql dthrtma_msa_correcao.sql

12.2.

Criao de usurios em bancos com acesso JDBC

ALERTA: Esse procedimento destina-se apenas aos clientes que esto convertendo sistemas anteriores ao Datasul para o Datasul 11.

Alguns bancos de dados no Datasul precisam de acesso JDBC para execuo de rotinas Flex. Os bancos listados a seguir so provenientes da converso e precisam ter os usurios sysprogress e pub criados manualmente. As senhas padres para esse usurio so sysprogress e pub, respectivamente. Caso deseje informar outra senha, altere-a tambm no arquivo progress-ds.xml do JBoss.

Bancos de dados
eai mguni O mesmo arquivo tambm precisar ser alterado caso algum dos bancos da lista esteja unificado em outro banco. Dessa forma, altere os parmetros de conexo, mantendo a tag jndi que define a referncia ao nome do banco de dados.

12.3.

Substituio dos bancos de dados no sistema destino

ALERTA: A no utilizao de todos os bancos de dados sugeridos pela mdia de instalao do produto poder causar resultados inesperados no sistema. Apenas

TOTVS S.A.

28

deixe de utilizar algum banco de dados se for explicitamente recomendado pelo suporte tcnico do produto Datasul. O Datasul 11 ser composto pelos bancos de dados convertidos mais os bancos correspondente a novas funcionalidades. Os seguintes arquivos do sistema Datasul tambm devero ser conferidos para contemplar os bancos convertidos: Arquivo .pf de conexo dos bancos: conferir se os bancos convertidos esto contemplados na conexo, bem como bancos especficos trazidos no processo; Arquivo progress-ds.xml no JBoss: o banco com dados EMS2UNI necessrio para a execuo do ambiente Flex. Esse arquivo contm os parmetros de conexo a esse banco, que pode estar unificado aos bancos de dados origem. Programa de alias, caso seus bancos sejam unificados.

Alm da alterao desses arquivos, confira os cadastros de Banco de Dados Empresa e Relacionamento Empresa X Usurios, dentro do sistema Datasul. 12.3.1. Sistemas anteriores ao Datasul para Datasul 11

Clientes que esto migrando os sistemas EMS 2 e HCM possuem dois bancos de dados EMS2UNI, que podem estar unificados entre os bancos de dados origem. Como o Datasul unifica todos os produtos, apenas uma cpia desse banco ser conectada. Caso o cliente possua na origem apenas um desses sistemas (EMS 2 ou HCM), o banco de dados EMS2UNI a ser utilizado no sistema Datasul ser o mesmo utilizado no sistema origem. Se o cliente possuir os dois sistemas dever ser utilizado o EMS2UNI proveniente do sistema EMS 2. O banco EMS2UNI do sistema HCM ser descartado. Se o EMS2UNI do HCM estiver unificado com os demais bancos, importe o delta ems2uni-hcm.df localizado no diretrio spp do console de converso. Esse delta eliminar as tabelas do banco EMS2UNI. Clientes com bancos de dados Oracle devero executar tambm o ems2uni-hcm.sql para eliminar as tabelas do EMS2UNI no Oracle. 12.3.2. Banco de dados Oracle

Clientes com banco de dados Oracle devero descartar os Schemas-holder usados durante o processo de converso e utilizar os Schemas-holder instalados pela nova verso do produto. Caso no utilize os owners padres definidos pela Totvs, dever ser alterada a propriedade _for-owner dos objetos dos Schemas-image.

12.4.

Antecipao de Verso do APS

ALERTA: Esse procedimento destinado a todos os clientes com verso

TOTVS S.A.

29

antecipada do APS, informado no programa de conferncia conf-db005 Clientes com verso antecipada do APS precisam converter os bancos EMS2DBR e MOV2DBR que foram descartados durante o processo de converso. Para isso, devero importar os arquivos spp\deltaAPS201to300-ems2dbr.df e spp\deltaAPS201to300-mov2dbr.df, nos bancos EMS2DBR e MOV2DBR. Clientes com bancos de dados Oracle, alm dos arquivos listados acima que devem ser importados no schema-holder, tambm devero importar no banco de dados Oracle os arquivos spp\deltaAPS201to300-ems2dbr.sql e spp\deltaAPS201to300-mov2dbr.sql.

12.5.

Unificao de Conceitos

Se a opo de cenrio escolhido para a converso contempla a execuo da unificao de conceitos separado da converso, no esquea de execut-la antes de utilizar o Datasul 11.5.0. A utilizao do produto sem a atualizao demandar retorno de backup e reexecuo do processo de unificao de conceitos.

13.

Consideraes Finais

Aps a concluso de todas as etapas, os bancos de dados estaro prontos para serem utilizados no sistema destino. Faa um backup dos novos bancos e confira seus scripts de backup, conexo, carga e derrubada dos bancos para garantir que todos os bancos esto contemplados nas rotinas de administrao do ambiente. Dvidas que surgirem nos processos descritos nos manuais podero ser sanadas atravs da consultoria telefnica de banco de dados, atravs do telefone (11) 4003-0015. Escolha a opo 2 (Software), 3 (Consultoria), 4 (Datasul), 8 (Tecnologia), 3 (Banco de Dados).

TOTVS S.A.

30