Educao Corporativa

Virada de Verso

(AP7 ou Protheus 8 Protheus 10)

Matriz - Av. Braz Leme, 1.717 - 02511-000 - So Paulo - SP - Brasil.

Tel.: 55 (11) 3981 - 7001 www.microsiga.com.br
Todos os direitos reservados.

Sumrio
2

Virada de Verso

ATUALIZAO DE VERSO (AP7 OU PROTHEUS 8 - PROTHEUS 10)

PR-REQUISITOS
Pr-requisitos
PREPARANDO O AMBIENTE
Procedimentos
EXECUTANDO O ATUALIZADOR DE VERSO (MP710TO101)
Iniciando o processo de Atualizao
Efetuando os backups necessrios
Efetuando Login para iniciar o processo de atualizao
Selecionando o Ambiente para a virada de verso
Configurao de execuo do MP710TO101
Seleo de Logs
Corrigindo erros automaticamente e Eliminando Backups
Detalhes do Processo de Atualizao
Consulta ao Logs e Interrupo Atualizao
Impresso de relatrios de arquivos de Log
PROCESSOS DA ATUALIZAO
Verificao de Integridade
ATUALIZAES PROCESSADAS

Todos os direitos reservados.

3
4
4
5
5
6
6
7
8
8
11
11
12
14
15
17
18
18
19

ATUALIZAO DE VERSO (AP7 OU PROTHEUS 8 - PROTHEUS 10)

Quando se est processando a atualizao de verso (AP7 ou Protheus 8 - Protheus 10), necessrio aps
a instalao do Protheus, executar o programa MP710TO101, antes de qualquer processamento, para que
os arquivos da empresa sejam compatibilizados com os da nova verso enviada pela Microsiga. Leia
sempre as Notas do Release que acompanham as novas verses para conhecer as alteraes que
sero efetuadas pelo programa de compatibilizao e os novos recursos.
Este programa sempre que possvel dar prioridade s configuraes do cliente. Esta prioridade apenas
ser modificada, quando a alterao da NOVA verso for imprescindvel para o funcionamento da
mesma.
O atualizador executa basicamente as seguintes tarefas:
Inclui, exclui ou altera o contedo dos arquivos customizadores SXs do usurio de acordo com as
modificaes feitas nos arquivos padres.
Acerta tabelas de dados, incluindo, excluindo ou alterando a estrutura dos campos. No entanto, o Sistema
no exclui campos includos pelo usurio em sua base de dados, desde que todas as alteraes
tenham sido efetuadas pelo ambiente Configurador.
Antes de fazer o acerto gerado um backup de cada arquivo a ser alterado com a terminao #BD.

Fique
atento

imprescindvel que o usurio faa backup dos seus arquivos de dados (\PROTHEUS_DATA\DATA) ou antigo (\DADOSADV),
dos arquivos customizadores SXs (\PROTHEUS_DATA\SYSTEM) ou antigo (\SIGAADV) e seus programas especficos,
antes de efetuar a Atualizao de Verso.

A seguir, sero apresentadas as etapas que devem ser realizadas para atualizar a verso.
Pr-requisitos
Preparando o ambiente
Executando o MP710TO101
Processos de atualizao

Anotaes

Todos os direitos reservados.

Virada de Verso

PR-REQUISITOS
Para o perfeito funcionamento da atualizao de verso, necessrio que sejam atendidos os prrequisitos relacionados a seguir:

Fique
atento

Os diretrios mencionados correspondem instalao padro do Protheus, portanto devem ser alterados conforme o
ambiente de instalao da empresa.

Pr-requisitos
Hardware
Ter espao em disco de aproximadamente 3 vezes o espao utilizado pelos diretrios SIGAADV e
DADOSADV (se verso 7.10) ou SYSTEM e DATA (se verso 8.11).
Sistema Operacional
Windows/Linux - deve-se utilizar a ltima verso/ServicePack disponibilizada pelo fabricante do
software.
Instalao do Protheus 10
TOTVS Application Server
TOTVS Smart Client
TOTVS DBAccess - caso utilize banco de dados relacional.
Configurao do Protheus 10
Assistente de Configurao do Servidor

Anotaes

Virada de Verso

Todos os direitos reservados.

PREPARANDO O AMBIENTE
Antes de iniciar o processo de atualizao das verses AP7 ou Protheus, importante executar algumas
operaes de segurana, como: Backup dos arquivos de dados, customizadores e profiles.

Procedimentos
Backup dos arquivos de dados
\DADOSADV - Verso 7.10
\PROTHEUS_DATA\DATA - Verso 8.11
Backup dos arquivos customizadores SXs
\SIGAADV - Verso 7.10
\PROTHEUS_DATA\SYSTEM - Verso 8.11

Fique
atento

Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), certifique-se de que esto
identificados pelo nickname. Pois, ao executar o aplicativo de atualizao de verso (MP710TO101) o Sistema ir adicionar
os novos ndices a partir da ordem original instalada pelo Protheus, o que poder ocasionar a sobregravao de ndices
personalizados caso no estejam identificados pelo Nickname.

Backup do arquivo PROFILE

Copie o contedo do diretrio PROFILE das verses 7.10/8.11 para o diretrio \PROTHEUS_DATA do
Protheus 10.

Anotaes

Todos os direitos reservados.

Virada de Verso

EXECUTANDO O ATUALIZADOR DE VERSO (MP710TO101)

Fique
atento

Este programa exclusivo para migrao das verses 7.10 e 8.11 para a Protheus 10 (10.1). Caso esteja utilizando uma
verso anterior, deve-se migrar as verses progressivamente, utilizando os atualizadores respectivos, at obter a verso
7.10, para que ento o MP710TO101 possa ser executado.

Iniciando o processo de Atualizao

Exerccio1 - Executar o atualizador de verso, para isso:
1. Acesse a pasta Protheus 10 e carregue o TOTVS Application Server.
2. Em seguida, acesse o TOTVS Smart Client.

3. Em Programa Inicial, digite MP710TO101

4. Clique no boto OK para confirmar.

Anotaes

Virada de Verso

Todos os direitos reservados.

Ser apresentada uma janela com orientaes sobre o processo de atualizao.

Anotaes

Efetuando os backups necessrios

Exerccio 2 - Antes de iniciar o processo, devemos:
Efetuar o backup dos arquivos dos diretrios SIGAADV e DADOSADV (se verso 7.10) ou SYSTEM
e DATA (se verso 8.11);
Ter espao em disco de aproximadamente 3 vezes o espao utilizado pelos diretrios SIGAADV e
DADOSADV (se verso 7.10) ou SYSTEM e DATA (se verso 8.11).

Todos os direitos reservados.

Virada de Verso

Efetuando Login para iniciar o processo de atualizao

Exerccio 3 - A tela seguinte adverte que apenas o Administrador pode processar a atualizao de
verso.

1. No campo Senha, digite a senha do Administrador.

Anotaes

Selecionando o Ambiente para a virada de verso

Esta informao muito importante para que o ambiente seja preparado corretamente:
Se estiver utilizando a verso 7.10, marque a caixa Atualizar 7.10 para 10.1
Se estiver utilizando a verso 8.11, marque a caixa Atualizar 8.11 R? para 10.1

Virada de Verso

Todos os direitos reservados.

Exerccio 4 - Aps a escolha e confirmao, o sistema retorna tela anterior para dar continuidade
ao processo de atualizao.
1- Ser apresentada a janela Ateno para que seja informada a partir de qual verso ser realizada a
atualizao.

2- Selecione a Opo Atualizar 7.10 para 10.1

Se estiver utilizando a verso 8.11 e a integridade referencial estiver ativa, o atualizador de verso ir desativ-la antes de
iniciar o processo de atualizao de verso.
Fique
atento

Desta forma, ao final desse processo, ser necessrio executar a rotina que ativa a integridade referencial,
atravs do ambiente Configurador, opo Base de Dados/Integridade.

3. Se desejar apenas simular a atualizao para verificar as alteraes a serem processadas e

eventuais problemas na base de dados, clique na caixa de verificao Simulao.
Com esta opo ativada, no ser gravada nenhuma alterao na base. O sistema gera um arquivo de log
que pode ser impresso.
4. Em seguida, selecione a localizao/Pas a ser atualizada.
5. Se a opo SINDEX exclusivo for selecionada, o MP710TO101 criar automaticamente um dicionrio
de ndice para cada empresa cadastrada. Se esta opo no for selecionada, ser mantido o arquivo atual
compartilhado entre as empresas.

Anotaes

Todos os direitos reservados.

Virada de Verso

6. Clique no boto Avanar para prosseguir.

Ser apresentada a janela para informao do diretrio padro, onde sero criadas as novas tabelas de
dados referentes as empresas identificadas e relacionadas.

7. D um duplo clique sobre o diretrio e digite outro caminho, se necessrio.

A localizao informada ser considerada abaixo do diretrio raiz definido no TotvsAppServer.INI (\
ROOTPATH).

Anotaes

10

Virada de Verso

Todos os direitos reservados.

Configurao de execuo do MP710TO101

Exerccio 5- Clique no boto Avanar para prosseguir.
Ser apresentada a janela para configurao de execuo do MP710TO101.

Seleo de Logs
Exerccio 6 - Marque os logs desejados, observando:

Todos os direitos reservados.

Virada de Verso

11

 Log de Processos
O Log de Processos grava todas as operaes que o Atualizador realiza, como abertura de arquivos,
criao de ndices e arquivos temporrios.
Log de Atualizao
O Log de Atualizao grava todas as alteraes que o Atualizador fez na base, campo a campo, armazenando
o valor anterior e o atual.
Log de Incluso
O Log de Incluso grava todos os registros includos nos arquivos pelo Atualizador. Esta caixa selecionada
automaticamente.
Log Critical Error
O Log Critical Error grava erros crticos que inviabilizam a continuidade do processo de
atualizao.
Durante a verificao da integridade, caso seja encontrado um erro crtico, o processo de atualizao
somente poder prosseguir aps a correo do mesmo.
Esta caixa selecionada automaticamente.
Log Warning Error
Este log grava erros que no impedem o processo de atualizao e correes efetuadas atravs do
Assistente do Atualizador. Somente sero indicados neste arquivo.
Os logs so gravados no arquivos MPUPDATE.LOG.
Exerccio 7 - Marque a caixa Permite interromper processo durante a execuo para que ao
final de cada processo, a Atualizao possa ser interrompida.
O processo ser reiniciado a partir da ltima tarefa executada.
Se esta caixa no for selecionada, no ser possvel paralisar a Atualizao em nenhum momento.
Se o usurio desejar saber de todas as alteraes processadas, pode marcar todas as opes de Logs e tambm a
caixa Permite interromper processo durante a execuo.

Fique
atento

Neste caso, deve-se interromper ao final de cada processo, analisar os logs e executar a
Atualizao, novamente.
Deve-se optar por limpar o Arquivo de Log para evitar que este fique muito grande.

Corrigindo erros automaticamente e Eliminando Backups

Exerccio 8 - Clique na caixa Corrigir todos os erros automaticamente para que durante o processo
de anlise de integridade, o Atualizador corrija automaticamente alguns erros crticos.

12

Virada de Verso

Todos os direitos reservados.

Exerccio 9 - Clique na caixa Eliminar arquivos de backup ao trmino da atualizao para

excluir automaticamente os arquivos de backup que o Atualizador cria durante o processo.
Exerccio 10 - Clique na caixa Manter o arquivo de log existente para manter o log ao reiniciar o
processo de atualizao de verso aps uma pausa.
Tarefas que so executas durante a Atualizao
Exerccio 11 - 1. Clique no boto Avanar para prosseguir.
Ser apresentada a janela relacionando as tarefas que sero executadas pelo Atualizador.

Verificao da integridade das bases;

Atualizao dos arquivos customizadores SXs;
Atualizao das tabelas;
Atualizao dos arquivos de helps;
Execuo das funes compatibilizadoras.

Ao iniciar o processo de converso da base de dados, o Sistema gera o arquivo MPUPT.TSK

detalhando todo o processo de atualizao realizado.
Fique
atento

Todos os direitos reservados.

Virada de Verso

13

Detalhes do Processo de Atualizao

O Atualizador identifica cada processo iniciado e a sua evoluo.

2. Se diagnosticado algum problema na base do cliente, este ser apresentado com opes para a
continuidade ou interrupo do processo.
3. Durante a verificao de integridade, se for diagnosticado algum critical error no previsto, o
processo ser interrompido e o administrador ter a possibilidade de analisar o arquivo de log,
corrigir o erro e reiniciar a atualizao.

Anotaes

14

Virada de Verso

Todos os direitos reservados.

Consulta ao Logs e Interrupo Atualizao

Exerccio 12 1 - Clique no boto Consulta Log para consultar o arquivo de log. Para mais detalhes
sobre a janela de consulta, consulte o item 6 mais adiante.

2. Ao final de cada processo, o usurio poder optar por interromper a Atualizao, caso tenha
selecionado esta opo no incio da configurao de execuo.

Se interrompida a Atualizao, ser possvel verificar o arquivo de log, clicando no boto Consulta Log.

Anotaes

Todos os direitos reservados.

Virada de Verso

15

3. A janela para consulta aos Logs ser exibida.

16

Virada de Verso

Todos os direitos reservados.

4. possvel escolher o tipo de evento a ser analisado, a empresa e a tarefa, atravs do boto
Filtro.

Impresso de relatrios de arquivos de Log

Exerccio 13 - 1.Se desejar um relatrio impresso, clique no boto Imprimir.

2 . Configure a impresso e confirme a emisso do relatrio.

Aps a interrupo da Atualizao, ser necessrio executar novamente o MP710TO101, porm sero
identificadas as operaes j realizadas e o processo ser continuado a partir da ltima tarefa executada.

Todos os direitos reservados.

Virada de Verso

17

PROCESSOS DA ATUALIZAO
Durante o processo de atualizao, o MP710TO101 executa uma srie de verificaes e substituies.
Conhea a seguir os detalhes.

Verificao de Integridade
Integridade do SIX ndices
Substitui o SINDEX pelo SIX, caso tenha selecionado esta opo no incio da configurao de
execuo.
Verifica a existncia de chave duplicada.
Verifica se aps a atualizao, a chave ser duplicada.
Verifica a relao das tabelas SIX SX2 (Manuteno de Arquivos).
Verifica a relao das tabelas SIX SX3 (Manuteno de Campos).
Integridade do SX3 Dicionrio de Dados
Verifica a existncia de registro duplicado no SX3 (Manuteno de Campos).
Verifica a existncia de registro duplicado no SX2 (Manuteno de Arquivos).
Verifica a relao das tabelas SX2 (Manuteno de Arquivos) SX3 (Manuteno de Campos).
Verifica a relao das tabelas SXG (Manuteno de Configurao padro para grupo de campos) SX3
(Manuteno de Campos).
Verifica a relao das tabelas SXG (Manuteno de Configurao padro para grupo de campos) SX1
(Manuteno de Perguntas de parametrizao (movimentaes, consultas e relatrios).
Verifica se os campos criados pelo usurio na base de dados, existem como padro na nova verso do
Protheus.
Integridade do SX7 Gatilhos
Verifica a existncia de registros duplicados.

18

Virada de Verso

Todos os direitos reservados.

ATUALIZAES PROCESSADAS
Atualizao do SXG (Grupo de Campos)
Atualiza os campos Tamanho Mximo(XG_SIZEMAX) e Tamanho Mnimo (XG_SIZEMIN) para o padro
da nova verso.
Verifica o campo Tamanho (XG_SIZE). Caso seja maior que o campo Tamanho Mximo(XG_
SIZEMAX), atualiza para o valor do campo Tamanho Mximo(XG_SIZEMAX), ou, caso seja menor
que o campo Tamanho Mnimo (XG_SIZEMIN), o Sistema atualizar para o valor do Tamanho Mnimo
(XG_SIZEMIN).
Atualizao do SIX (ndices)
ndice do Sistema: Substitui todo o contedo mantendo o NICKNAME.
ndice do usurio: Mantm todo o contedo e altera a ordem posicionado para o final dos ndices padres
do Sistema.
Atualizao do SX1 (Perguntas)
Atualiza os registros que existem na nova verso e mantm o contedo dos campos Pr Seleo
(Combo) (X1_PRESEL), Contedo (Text/Range) (X1_CNT01/X1_CNT02).
Atualiza o contedo do campo Tamanho (X1_TAMANHO) com base nas informaes do Grupo de
Campos (SXG). Sendo que, o contedo dos campos que no possuem grupos sero mantidos.
Atualizao do SX2 (Arquivos)
Os arquivos existentes sero mantidos.
Sero inclusos os novos arquivos.
Somente ser atualizado o campo Rotina (X2_ROTINA) quando o contedo estiver em branco.
Atualizao do SX3 (Campos)
A ordem (X3_ORDEM) dos campos atuais sero mantidos e os novos campos sero inclusos aps a
ltima ordem da tabela relacionada.
Os campos criados pelo usurio sero mantidos, desde que o campo no exista na nova verso.
O campo Tipo (X3_TIPO) ser atualizado caso esteja diferente da nova verso.
Os campos Relao (X3_RELACAO) e Val. Usurio (X3_VLDUSER) sero atualizados caso o contedo
estiver em branco.

Todos os direitos reservados.

Virada de Verso

19

 Os campos Tamanho (X3_TAMANHO) e Decimal (X3_DECIMAL) so atualizados com base nas

informaes do Grupo de Campos (SXG). Porm, se os campos estiverem configurados para permitir
alterao do usurio, o contedo ser mantido, caso contrrio, ser atualizado.
Os campos Lista Opes (X3_CBOX), Lista Espanhol (X3_CBOXSPA), Lista Ingls (X3_
CBOXENG),Inic. Browse (X3_INIBRW),Form. Varivel (X3_PICTVAR) e Modo de Edio (X3_WHEN) sero
substitudos com o contedo da nova verso. Porm, ser mantido o contedo se os campos estiverem
em branco.
Atualizao do SX4 (Schedule)
Atualiza na nova verso todo o contedo da verso atual.
Atualizao do SX5 (Tabelas do CFG)
Sero inclusos os novos registros.
Atualizao do SX6 ( Parmetros)
Sero inclusos os novos registros.
Atualiza a contedo dos campos Descrio, Desc. Esp. e Desc. Ingls dos parmetros
existentes.
Atualizao do SX7 (Gatilhos)
Gatilho padro: Substitui todo o contedo. Caso no exista, o gatilho ser removido.
Gatilho de usurio: Mantm todo o contedo e altera a ordem posicionado para o final dos gatilhos
padres do Sistema.
Atualizao do SX9 (Relacionamentos)
Substitui todo o contedo.
Atualizao do SXB (Consulta Padro)
Substitui todo o contedo mantendo as consultas criadas pelo usurio.
Atualizao do SXD (Cadastro do SX4)
Substitui todo o contedo.
Atualizao das tabelas
Realiza a comparao da tabela SX3 com as tabelas existentes no Banco de dados. Caso seja
diferente, realiza a atualizao.
Atualizao do Help de programas
Substitui todo o contedo do arquivo sigahlp.hlp (Help de campo).

20

Virada de Verso

Todos os direitos reservados.

 Mantm os helps de campos alterados pelo usurio.

Exerccio 14 - Agora que j fizemos a Atualizao de verso da verso 7.10 para 10.1, seguindo os
passos anteriores, faa a atualizao da verso 8.11 R? para 10.1
Nmero de Registro:
ATVP10060807

Todos os direitos reservados.

Virada de Verso

21