Guia de Atualizao EMS 2.

06B
05/2013

Verso Atualizada
Guia de Atualizao EMS 2.06B

2 Guia de Atualizao EMS 2.06B
Verso 1.2

Sumrio

1 Processo de Upgrade................................................................................................................... 3
2 Procedimentos Pr-Atualizao .................................................................................................. 4
2.1 Unificao do Foundation ........................................................................................................... 4
2.2 Licenas Corporativas .................................................................................................................. 5
2.3 Audit Trail .................................................................................................................................... 5
2.4 Reparao de Segurana do Banco MOVFRO .......................................................................... 5
2.5 Ems 2 Financeiro ......................................................................................................................... 6
2.6 Componentes Acessrios ............................................................................................................ 6
2.7 Antecipao da Verso do APS ................................................................................................... 7
3 Procedimentos Ps-Atualizao .................................................................................................. 7
3.1 Criao de usurios em bancos com acesso JDBC ...................................................................... 7
3.2 Antecipao da Verso do APS ................................................................................................... 7
3.3 Acerto WMS e Data Collection .................................................................................................... 8
3.4 Sistemas anteriores ao Datasul para Datasul 11 ......................................................................... 8
3.5 Unificao de Conceitos fase 1 ................................................................................................. 8

Guia de Atualizao EMS 2.06B


3
Guia de Atualizao EMS 2.06B
Verso 1.2
1 Processo de Upgrade


ALERTA: Alm deste documento, consulte o Guia de Atualizao para Datasul 11.5.5. Nele esto
disponveis as informaes de execuo do processo.

O processo de acerto converter os bancos de dados de sistemas anteriores ao Datasul 11 para o Datasul 11.5.5. Esse processo
possui vrias etapas, conforme imagem a seguir:



O Console de Atualizao ir adaptar a execuo das etapas conforme configuraes pr-definidas no processo de upgrade. Dessa
forma, o prprio Console ir documentar a rotina de execuo na ajuda da prpria etapa. Rotinas no executadas pelo Console de
Atualizao esto documentadas nesse guia.

Guia de Atualizao EMS 2.06B

4 Guia de Atualizao EMS 2.06B
Verso 1.2
2 Procedimentos Pr-Atualizao

O produto precisa de ajustes antes da atualizao, 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.



2.1 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 No existe.
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 Banco Fsico Padro Nome Lgico
EMS 2 ems2uni mguni
EMS 5 emsbas emsbas
HCM ems2uni 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.


Guia de Atualizao EMS 2.06B


5
Guia de Atualizao EMS 2.06B
Verso 1.2
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.
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
Unificar 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.


2.2 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.

2.3 Audit Trail


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.
Dados que no possam ser convertidos sero excludos. As informaes relacionadas a auditoria 'campo a campo' continuaro
funcionando normalmente.

2.4 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 mmv-movto-mdo tenha restrio na permisso
de acesso. Essa restrio dever ser corrigida 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 banco MOVFRO ou o
correspondente unificado no menu Database Select working database. Selecione o menu Admin Security Edit data
security. Localize a tabela mmv-movto-mdo e altere as suas permisses, substituindo a informao !,* por *.

Guia de Atualizao EMS 2.06B

6 Guia de Atualizao EMS 2.06B
Verso 1.2
2.5 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. Porm o produto Datasul disponibiliza mdulos financeiros
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.
Aps processo de converso, j na base destino, executar o programa prgint/utb/utb800aa.p para acertar as parmetrizaes
da base (indicar que a integrao do ERP deve ser com Financeiro do EMS5).

2.6 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.


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.

Guia de Atualizao EMS 2.06B


7
Guia de Atualizao EMS 2.06B
Verso 1.2
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 atualizao para o Datasul 11.

2.7 Antecipao da 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 conf-db005.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 atualizao acusar a ausncia desses bancos de dados, eles devero ser marcados para no converter.

3 Procedimentos Ps-Atualizao


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

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

3.1 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 EAI e MGUNI 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.
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.

3.2 Antecipao da Verso do APS

Guia de Atualizao EMS 2.06B

8 Guia de Atualizao EMS 2.06B
Verso 1.2

ALERTA: Esse procedimento destinado a todos os clientes com verso 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.

3.3 Acerto WMS e Data Collection


ALERTA: Esse procedimento destinado a todos os clientes que utilizam o mdulo WMS (MWM) e/ou o
Data Collection (MBC).

Aps o processo de converso deve-se executar o programa spp/wmp/spwm014.r na base convertida, para alterar os valores do
nmero do embarque nas tabelas do WMS. Isto necessrio devido alterao do campo de nmero de embarque e para que os
programas executem corretamente, preciso fazer um acerto posterior ao delta de correo da converso.
Clientes que no utilizem nenhum destes mdulos no necessitam executar o programa mencionado.

3.4 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 atualizao. 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.
Nesse caso, caso o HCM possua uma empresa que no existia no EMS2, essa empresa dever ser cadastrada manualmente no Datasul 11.

3.5 Unificao de Conceitos fase 1

O Ems 2.06B precisa passar pelo processo unificaconceitos-fase1 antes de ser usado no Datasul 11.5.5. Verifique o guia de
unificao de conceitos para informaes.