FAQs - Suporte técnico

Cross Segmentos - Backoffice Linha Protheus - Framework - Upgrade de Release do Protheus 12

time.png Tempo aproximado para leitura: 00:04:00 min

Dúvida
Como efetuar o Upgrade entre Releases do Protheus 12?

Ambiente
Totvs Backoffice - Cross Segmentos (Linha Protheus) - AppServer - A partir da versão 12.

Solução
1. Preparando a base para o upgrade

Faça uma cópia fria, com os serviços parados da pasta raiz do Protheus, ex.: C:\TOTVS 12\ e do Banco de Dados.

Caso o seu Dicionário de Dados estiver no formato DBF, será obrigatória a importação dos dados para o formato DTC Ctree. Link do procedimento de importação: MP - FRAME - Converter arquivos DBF para DTC

Informações adicionais sobre Upgrade para Releases a partir da 12.1.023
- É necessário utilizar o RPO 64 bits
- É necessário utilizar o Binário 64 bits
- É necessário utilizar o License Server Virtual, versão igual ou superior a 01.03.013
- O formato de arquivos CodeBase - DBF não é mais suportado pelo Application Server Lobo-Guará 64 bits

Informações adicionais sobre Upgrades para Releases a partir da 12.1.33
- É necessário utilizar o License Server Virtual, versão igual ou superior a 3.2.0
- É obrigatória a atualização para a última versão dos artefatos abaixo:
- Application Server - Binário Harpia
- SmartClient - Binário Harpia
- DBAccess
- WebApp
- RPO específico para Binário Harpia

Informações de como atualizar os artefatos neste link: MP - FRAME - Atualização de Artefatos para Binário Harpia (Release 33)


. Na chave DBDATABASE (da seção do Ambiente), para ambientes com Banco de Dados SQL Server, utilizar o valor MSSQL e não MSSQL7
Ex.: [P12.1.33]
SourcePath=
...
DBALIAS=P12133
DBSERVER=192.168.1.1
DBDATABASE=MSSQL
DBPORT=7890


O Binário Harpia possui uma arquitetura exclusiva. Portanto, não sobrescreva os arquivos do Harpia na pasta do antigo Lobo Guará. Faça uma pasta nova de binário, renomeie as antigas Appserver e Smartclient e crie novas, descompacte o novo binário nelas, e copie da original apenas os arquivos appserver.ini e smartclient.ini.

Antes de iniciar o Upgrade para a Release 12.1.25 do Protheus, é obrigatório desligar a Auditoria de Rastro de Usuários. Efetue o procedimento abaixo:

- Acesse o Configurador > Usuário > Senhas > Política > aba Outros > Regras de Auditoria, e desabilite as seguintes opções:
1- Auditar atualizações no dicionário de dados;
2- Auditar atualizações no cadastro de usuário;
3- Auditar autenticação/acesso;
4- Auditar rejeição de acesso à recursos.

É recomendada a utilização do Repositório de Imagens no Banco de dados. O Procedimento para configuração pode ser verificado no link: Repositório de Imagens no banco de dados

2. Checando duplicidades na base
Caso sua Base de Dados seja Relacional, utiliza DBACCESS, será necessário rodar o processo de verificação dos registros duplicados para todas as empresas. Assistente executado a partir da rotina CHECKDUPL via Configurador, que tem como pré-requisito a atualização do dicionário de dados padrão na pasta SYSTEMLOAD. Para fazer o download do dicionário, siga os procedimentos do seguinte link:
Atualizar o Dicionário de Dados do Protheus 12

Crie dentro da pasta Protheus_Data, a pasta UPGRADE e nela descompacte o dicionário de dados Completo da release para a qual vai executar upgrade. Na verificação de duplicidade será solicitado o SX2.UNQ, utilize este como referência para a checagem.
Vide Instruções para verificação de duplicidades no link: Rotina CheckDupl – Verifica a Integridade de Registros Duplicados

3. Atualizando os arquivos
É necessário atualizar os arquivos de dicionário de dados, Completo e Diferencial, da versão da release que deseja atualizar, e também o RPO - Repositório de Objetos da mesma versão. Para atualizar os dicionários, siga o procedimento do seguinte link: Atualizar o Dicionário de Dados do Protheus 12

Para atualizar o RPO, siga o procedimento abaixo:
1- Acesse o site do Suporte: Downloads e Atualizações
2- Linha Protheus;
3- MICROSIGA PROTHEUS VERSÃO 12.1.XX, onde XX é a versão da nova release;
4- PROTHEUS 12 TOPCONNECT PORTUGUES;
5- Categoria: Repositório de objetos;
6- Baixar o repositório para o Brasil BRA-EUA-PAR-URU-TTTP120.

ATUALIZAR
1- Pare o serviço do Protheus;
2- Na pasta APO, renomear o repositório anterior, ou mover para outra pasta;
3- Copiar o novo arquivo para o diretório APO do sistema;
4- Renomear o arquivo mantendo apenas os últimos 7 caracteres Exemplo: tttp120.rpo;

 Após trocar o RPO, é necessário atualizar a LIB baixando e aplicando a mais recente do Portal. Link com os procedimentos de atualização: Atualização básica do Protheus 12

Informação
Se você utilizar o Appserver em Linux, transfira o arquivo compactado para o Linux, e só descompacte-o no Linux. Descompactar o arquivo no Windows e depois transferir o .txt para o Linux pode causar erros.
Ao preparar o ambiente para o upgrade, não é recomendável abrir o Protheus após atualizar os arquivos, mas sim, rodar direto o compatibilizador - UPDDISTR.

4. Limpeza das Pastas
1- Exclua os arquivos *.DBF e *.DTC da pasta SYSTEMLOAD;
2- Exclua os arquivos *.IDX da pasta SYSTEMLOAD;
3- Exclua os arquivos *.LOG da pasta SYSTEM;
4- Exclua os arquivos TOTVSP*.* da pasta SYSTEM;
5- Exclua os arquivos *.TSK e .LOG da pasta APPSERVER_X32.

5. Executando o compatibilizador de upgrade de release
Abra o Smartclient, e no Programa Inicial, digite: UPDDISTR
Maiores detalhes sobre a funcionalidade do UPDDISTR podem ser encontrados neste link: Atualizador de dicionário e base de dados - UPDDISTR

  
A partir do pacote de LIB disponibilizado em 07/04/2016 será possível escolher quais Grupos de Empresas serão considerados na atualização. Será exibida uma janela onde é possível marcar os Grupos de Empresas desejados. Por padrão, todos os grupos já vem selecionados. Se desejar utilizar todos os grupos, basta clicar no botão OK.
Caso uma dada migração seja reiniciada, deve-se escolher exatamente os mesmos grupos de empresas para retomar o processo.


Algumas tabelas não possuem grupo de empresas em seu nome, logo essa configuração não terá efeito sobre elas. Os arquivos de help, por exemplo, são compartilhados por todos os Grupos de Empresas de dado STARTPATH. Dessa forma, o arquivo compartilhado será atualizado.
Após a chamada, será exibido um assistente de atualização. A primeira tela traz um informativo dos requisitos para iniciar a atualização. As telas seguintes possuem um Termo de Aceite, que deve ser lido com atenção e marcadas as devidas caixinhas de confirmação. Atente-se também em selecionar a localização correta, país que será utilizada na atualização.


Após o Termo de Aceite confirmado, será aberta a janela de login para confirmação de autorização a executar o UPDDISTR. A autorização só é concedida para o usuário Administrador do Protheus, ou para usuários do Grupo Administradores¹ que possuam o acesso 194 habilitado. O usuário e senha serão validados ao clicar no botão Avançar.

¹ Grupo Administradores com acesso 194 permitido a partir da LIB versão 20210517

Também é possível nesta tela:

  • Configurar se a execução será apenas uma Simulação, onde nenhuma alteração será efetivada na base;
  • Determinar se o dicionário de índices é exclusivo por grupo de empresas, SIX ou se é utilizado o dicionário SINDEX.


Clique em Avançar. Na tela seguinte serão exibidas informações sobre o pacote de atualização encontrado na base, que será utilizado neste processo.


Clique em Avançar. Na próxima tela deve-se informar o diretório de dados X2_PATH para cada Grupo de Empresas para as novas tabelas a serem inseridas pela atualização. No caso de Bases de Dados SQL - Top Connect, não é necessário informar o diretório.

 

 

Avance novamente. Na tela de Configuração de execução do Update, deve-se marcar/desmarcar as configurações e arquivos de log que deseja utilizar durante o processo. Indicamos manter apenas as opções Log de Atualização,  Log de Critical Error e Corrigir erros automaticamente habilitadas, lembrando que a opção de corrigir os erros automaticamente executará as alterações de base pelo próprio Sistema. NÃO marque a opção Manter o arquivo de log existente.

 

 

Ao avançar, será exibida uma janela confirmando quais grupos de empresas serão processados e quais operações serão executadas. Em seguida será efetuada uma análise da base de dados existente. A análise verificará diversos fatores, como por exemplo a consistência da base de dados em relação ao dicionário existente. Se forem encontrados problemas, os mesmos deverão ser corrigidos antes que a atualização possa prosseguir.


 

Deve-se notar que nesta fase é analisado apenas o conteúdo da Base de Dados e do Dicionário já existente. Nesse momento não é efetuada nenhuma consulta ao dicionário de dados diferencial que se pretende aplicar.
Caso não existam erros ou os mesmos já tenham sido corrigidos a atualização iniciará logo após o processo de verificação. Deve-se aguardar o final da atualização e encerrar.

Atualização importante de Controle de aplicação de pacotes no UPDDISTR, a partir da LIB versão 20211004, Release 33: Controle de aplicação de pacotes no UPDDISTR

Caso o Upgrade possua erros, será exibida uma janela com os logs dos erros, que devem ser corrigidos na base antes de continuar. Segue abaixo link com as correções de erros mais comuns em Migrações/Upgrades: Erros críticos mais comuns em migrações

Caso o erro não esteja listado, é necessário abrir um ticket para o Suporte Framework através do Portal do Cliente.
Ao final do Upgrade, será exibida uma janela com a informação "O processo de atualização foi finalizado com sucesso."




Para confirmar, acesse o Configurador, tecle Shift+F6, e confira a Release do RPO.

 

Esse artigo foi útil?
Usuários que acharam isso útil: 3 de 4

0 Comentários

Artigo fechado para comentários.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _