Guia de Atualizao

PRODUTO DATASUL










EMS 2
EMS 5
HCM
Gesto de Planos
Datasul 11
Unificao de Conceitos

TOTVS S.A. 2

1. Requisitos do Processo

Para dar incio ao processo de atualizao para o Datasul, o sistema deve obedecer a
verso de pacote de origem (entre parntesis) suportado pela atualizao, conforme
definies da tabela a seguir:
Sistema Origem Sistema Destino
EMS 2.04 (F82)
Datasul 11 (5.3)
EMS 2.04 Comex2 (F81)
EMS 2.06B (B97)
EMS 5.05 (C90)
EMS 5.06 (C90)
GP 1.00 (505.C99 / 506.C96)
HCM 2.09 (B07)
HCM 2.10 (A68)
Datasul 11 (2.3.3 / 5.2)
EMS 2.04 (F81)
Datasul 11 (5.2)
EMS 2.06B (B96)
EMS 5.05 (C87)
EMS 5.06 (C87)
GP 1.00 (505.C97 / 506.C94)
HCM 2.09 (B07)
HCM 2.10 (A65)
Datasul 11 (2.3 / 2.3.1 / 2.3.2 / 5.0 / 5.1)

O console automaticamente listar quais rotinas sero necessrias para a atualizao do
ambiente, conforme informaes de origem e destino selecionadas na console, pelo link
Obter Atualizao. Baixe todos os diretrios de dados listados pelo console.
Aps concluir o download, o console listar os processos disponveis para atualizao
O processo de atualizao 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.
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:



TOTVS S.A. 3

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 atualizao do produto;
Sistemas com bancos de dados SQL Server no so suportados.
Se o Windows do computador que est executando o Console possui o UAC (user
access control) ativo, o Console dever ser executado como administrador.
O Console permite baixar e aplicar atualizaes automaticamente. Porm isso somente
ser possvel se o computador que est executando o Console possui acesso internet.
Recomendam-se algumas boas prticas para garantir a confiabilidade da atualizao:
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
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
atualizao padro. Siga as informaes existentes no guia.
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.
Nunca utilize caminhos UNC (\\servidor\compartilhamento) como diretrio de
trabalho do console.
2. Preparando a Atualizao de Produtos Datasul

O pacote com o console de atualizao contm todos os objetos necessrios para a
utilizao do prprio console. O mesmo console permitir executar todas as atualizaes
necessrias nos dados dos bancos do produto.
As pastas cvp, dat, image e util so objetos do prprio Console de Atualizao. Demais
diretrios so chamados de Diretrios de Dados, e contm os objetos necessrios para
a atualizao que ser executada. Diretrios iniciados pelo prefixo log, contm os
arquivos de log dos processos executados. pasta download contm os temporrios de

TOTVS S.A. 4

atualizao do Console, e podem ser eliminados esporadicamente
Cada diretrio de dado pode conter os seguintes objetos:
Diretrio Contedo
cax Arquivos com a imagem das definies padres dos bancos origem
conf|atzconf|actconf Programas de conferncia de dados
conv|atz|acerto Programas de atualizao de dados
dat Arquivos de controle da atualizao
dfcorr Deltas de correo de dicionrio
dfprep Deltas de preparao de dicionrio

A raiz onde o Console de Atualizao foi descompactado possui um sub-diretrio char64,
que contm programas compilados em 64 bits. Programas de diretrios de dados tambm
sero atualizados nessa pasta para utilizao em servidores com Progress OpenEdge 64
bits instalado. A cpia dos objetos para o servidor deve ser feita manualmente.
3. Executando o Console de Atualizao

No diretrio onde o pacote do Console de Atualizao foi descompactado, est disponvel
o atalho para sua execuo. Na propriedade desse atalho, ser encontrado o parmetro
param que pode ser configurado com os seguintes valores:
param Arquivo idioma,Execuo automtica,Modo debug,Modo Update
Ex. : -param pt-br,auto,debug
Ex.2: -param pt-br
Ex.3: -param pt-br,,debug
Ex.4: -param pt-br,,,NOUPDATE

Argumentos passados no parmetro param

Arquivo idioma: Por padro, e caso no seja especificado, o Console assumir que
o idioma ser portugus brasileiro, assumido pelo cdigo pt-br.
Execuo automtica: quando especificado o parmetro auto, o Console ir ler o
arquivo auto.dat previamente gravado, que conter todas as parametrizaes
realizadas. Esse arquivo estar gravado na pasta dat do Console.
Modo debug: ativado quando especificado o parmetro debug. Nesse modo, o
Console ir gerar logs adicionais para serem analisados em caso de problema.
Modo Update: Desativa a atualizao do Console e dos diretrios de dados.
No deve ser configurado qualquer conexo a banco de dados para executar o Console,
nem especificar qualquer informao de alias. Estas informaes sero solicitadas
durante a sua execuo.
A imagem a seguir mostrar os objetos do Console:
1. A verso do Console.
2. A atualizao que o console ir executar.

TOTVS S.A. 5

3. As etapas que o console est preparado para executar. Conforme as selees
efetuadas, algumas etapas sero marcadas como desabilitadas (em cor cinza),
executas com sucesso (em cor verde), no-executadas (em cor amarelo), ou
executadas com erro (em cor vermelho).
4. rea de configurao dos dados da etapa atual.
5. Barra de progresso ativada na execuo de cada etapa.
6. Executa a etapa configurada na rea 4.
7. Permite gravar etapas para execuo posterior.
8. Essa opo habilita a prxima etapa sem executar a etapa atual.
9. Abre a ajuda da etapa atual.
10. Abre o arquivo de log em formato texto.
11. Abre o arquivo de log em formato do Internet Explorer, com os dados de execuo
tabulados.
12. Retorna a uma tela de configurao anterior.
13. 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.

O mesmo console de atualizao executar os processos de upgrade, acertos e
unificao de conceitos. Ele se ajustar automaticamente aos requisitos de cada
processo, no momento que o diretrio de dados for selecionado.

TOTVS S.A. 6


ATENO: O Console de Atualizao executa apenas atualizaes nos bancos
de dados do produto. Atualizao de programas feito com o Updater ou com a
reinstalao da mdia de programas.
A seguir apresentado o fluxo de atualizao de cada sistema origem suportado.

4. Consideraes Finais

A atualizao do produto pode conter procedimentos manuais anteriores e posteriores
atualizao executada pelo console de atualizao. Esses procedimentos so descritos
DICA: Cada atualizao dispe de um guia que orientar os procedimentos
especficos do processo. O link para esse guia encontra-se no diretrio raiz do
console que j tem o diretrio de dados disponvel.



TOTVS S.A. 7

no guia da atualizao do seu produto.
4.1. 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
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 atualizados, mais os bancos
correspondente a novas funcionalidades, disponibilizados pela mdia de programas. 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.
O Console de atualizao efetua a converso de um sistema em cada execuo.
recomendvel concluir a converso de todos os produtos origem antes de utilizar o
produto Datasul 11 em produo
4.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.
4.3. Upgrade Bancos Histricos

Clientes que utilizam bancos histricos e que desejarem efetuar o processo de upgrade
para este conjunto de bancos, devem utilizar um backup dos bancos de cadastro no
formato origem, juntamente com os bancos histricos conectados na sesso, com os
nomes lgicos dos seus respectivos bancos de movimento. Essa configurao
semelhante ao atalho para consulta de dados dos bancos histricos.

TOTVS S.A. 8

O processo de upgrade e unificao de conceitos para ambientes com bancos histricos
o mesmo utilizado para os ambientes de produo, ou seja, os mesmos passos e
procedimentos devem ser executados para garantir o sucesso do processo para a verso
destino.
Atualmente os bancos histricos homologados para o produto Totvs Datasul so:
(EMS5) MOVFIN Financeiro (banco multi)
(EMS2) MOVADM Administrativo (banco multi)
(EMS2) MOVRAC Comisses de Representantes (banco multi)
(EMS2) MOVIND Industrial (banco mono)
(EMS2) MOVDIS Distribuio (banco mono)
(EMS2) MOVMNT Manuteno Industrial (banco mono)
(EMS2) MOVMFG Cho de Fbrica (banco mono)
(EMS2) MOVFIS Fiscal (banco mono)