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)