Páginas filhas
  • Upgrade de Release do Protheus 12

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE (das pastas adequadas e banco de dados) da base de produção antes da aplicação dessa atualização.
  • Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE das pastas do Protheus (Ex.: C:\TOTVS 12\) antes da aplicação da atualização.


Estas recomendações tornam-se obrigatórias no caso de sistemas de missão crítica, quando a operação da empresa depende totalmente ou quase que totalmente do sistema Protheus.

Aviso
titleNovidades do Release

Acesse aqui as Novidades dos Releases separados por ano e Release.

Aviso

Deve ser atualizado o ultimo pacote de Lib disponível no Portal do Cliente



Expandir
titleInformações adicionais sobre Upgrades para Releases a partir da 12.1.23
  • É 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 



...

Expandir
titleInformações adicionais sobre Upgrades para Releases a partir da 12.1.2210
  • A partir do Release 12.1.2210, será obrigatório o uso dos arquivos de infraestrutura (dicionários, menus, usuários, etc.) no Banco de Dados.

  • Antes de efetuar a atualização para o release 12.1.2210, será necessário a migração dos arquivos de infraestrutura (dicionários, menus, usuários, etc.) para o Banco de Dados.

  • Para migrar para o Banco de Dados, o passo a passo pode ser encontrado aqui: https://tdn.totvs.com/pages/viewpage.action?pageId=360450442

  • Caso queira iniciar um novo ambiente diretamente no Banco de Dados, o passo a passo pode ser encontrado aqui: https://tdn.totvs.com/pages/viewpage.action?pageId=364926893

  • Para migrar para a Release 12.1.2210, o License Server deverá obrigatoriamente ser da versão 3.4.3 ou superior.
  • Quem já estiver na Release 12.1.2210, deve obrigatoriamente utilizar a versão 3.4.3 ou superior do License Server.
  • A partir do Release 12.1.2210 os dicionários de dados para as Tabelas (SX2) e para os Campos (SX3) do sistema, passam a ter uma chave única. Para mitigar eventuais problemas de duplicidade nestes dicionários, que acarretam problemas de atualização, é fortemente recomendada a verificação de integridade de registros duplicados, através da rotina CHECKDUPL, antes da atualização do Release.


Avisoexpand
titleAtençãoInformações adicionais sobre Upgrades para Releases a partir da 12.1.2310

Para migrar 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:
. Auditar atualizações no dicionário de dados 
. Auditar atualizações no cadastro de usuário
. Auditar autenticação/acesso
. Auditar rejeição de acesso à recursos

Dica

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

...

2310, são necessários os pré requisitos abaixo:

  • O License Server deverá obrigatoriamente ser da versão 3.6.0 ou superior.
  • O DBAccess deverá obrigatoriamente ser da versão 23.1.1.0 ou superior.
  • O AppServer (Build) deverá obrigatoriamente ser da versão 20.3.2.0 ou superior.
  • A Lib deverá obrigatoriamente ser da versão 20231009 ou superior.

Ao final do processo de migração será necessário configurar o tipo do ambiente.

Expandir
titleInformações adicionais sobre Upgrades para Releases a partir da 12.1.2410

Incluir Página
Informações adicionais sobre Upgrades para Releases a partir da 12.1.2410
Informações adicionais sobre Upgrades para Releases a partir da 12.1.2410



Aviso
titleAtenção

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:
. Auditar atualizações no dicionário de dados 
. Auditar atualizações no cadastro de usuário
. Auditar autenticação/acesso
. Auditar rejeição de acesso à recursos


Dica

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

Informações

Foi incluído um bloqueio para impedir que o sistema retroceda para releases anteriores. Se existir no ambiente alguma empresa com Release posterior a que está sendo aplicada, a atualização não será permitida.

Exemplo: Migração para Release 23, mas existe empresa já na Release 27.


Image Added

Dica
titleDiagnostico de dicionário

Protheus disponibiliza a ferramenta de diagnostico de Dicionário de dados, onde pode verificar as divergências do dicionário antes de realizar a atualização: TOTVS Diagnóstico de Dicionários



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:
http://tdn.totvs.com/pages/viewpage.action?pageId=271415266
Crie dentro da pasta Protheus_Data, a pasta UPGRADE e nela descompacte o dicionário de dados Completo da release para a qual vai atualizar. Na verificação de duplicidade será solicitado o SX2.UNQ,(Pode utilizar o SX2.UNQ, do pacote Dicionário Dif). Utilize este como referência para a checagem.
- Vide Instruções para verificação de duplicidades no link:

Foi incluído um bloqueio para impedir que o sistema retroceda para releases anteriores. Se existir no ambiente alguma empresa com Release posterior a que está sendo aplicada, a atualização não será permitida.

Exemplo: Migração para Release 23, mas existe empresa já na Release 27.

Image Removed

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:
http://tdn.totvs.com/pages/viewpage.action?pageId=271415266
Crie dentro da pasta Protheus_Data, a pasta UPGRADE e nela descompacte o dicionário de dados Completo da release para a qual vai atualizar. Na verificação de duplicidade será solicitado o SX2.UNQ,(Pode utilizar o SX2.UNQ, do pacote Dicionário Dif). Utilize este como referência para a checagem.
- Vide Instruções para verificação de duplicidades no link:
http://tdn.totvs.com/pages/viewpage.action?pageId=242386686

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, o RPO (Repositório de Objetos) da mesma versão e o Arquivo Diferencial de Helps.

Informações
titleInformação:

Antes de executar o UPDDISTR você deve baixar tanto o arquivo de dicionário completo (SXSBRA.TXT, por exemplo) quanto o dicionário diferencial (SDFBRA.TXT, por exemplo), e descompactá-los na pasta Systemload. Embora a migração de release utilize apenas o arquivo diferencial, o arquivo completo também deve ser baixado para a pasta, pois futuramente, quando for criar uma nova empresa ou filial, por exemplo, o arquivo que será utilizado será o COMPLETO.

Também é necessário baixar o Arquivo Diferencial de Helps (HELPS DE CAMPOS/PERGUNTAS DIFERENCIAL - BRASIL), no Portal do Cliente, e descompactar os arquivos .txt na pasta Systemload do Ambiente.

Dicionários:
- Para atualizar os dicionários, siga o procedimento do seguinte link:
http://tdn.totvs.com/pages/viewpage.action?pageId=271415266
Repositório de Objetos:

Expandir
titlePara release até 12.1.27

- Para atualizar o RPO, siga o procedimento abaixo:
. Acesse o site do Suporte: https://suporte.totvs.com/download
. Linha Protheus
. MICROSIGA PROTHEUS VERSÃO 12.1.XX (onde XX é a versão da nova release)
. REPOSITÓRIOS
. Selecione, na parte superior da página, os filtros Categoria=Repositório de Objetos e Idioma=PT-BR (ou a língua desejada)
. REPOSITORIO DE OBJETOS 12.1.XX - TOP CONNECT
. Confirme no nome do Arquivo se refere-se ao país desejado, conforme a  língua utilizada no ambiente (Exemplo: 20-10-16-REPOSITORIO_DE_OBJETOS_BRASIL_12_1_27_TTTP120.RPO)
. Faça o download do arquivo do repositório para o País desejado
ATUALIZAR:
. Pare o serviço do Protheus
. Na pasta APO, renomear o repositório anterior, ou mover para outra pasta
. Copiar o novo arquivo para o diretório APO do sistema
. Renomear o arquivo mantendo apenas os últimos 7 caracteres mais a extensão (Exemplo: TTTP120.RPO)
Obs.: 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: http://tdn.totvs.com/pages/viewpage.action?pageId=271651871

Expandir
titlePara release a partir de 12.1.33

- Para atualizar o RPO, siga o procedimento abaixo:
. Acesse o site do Suporte: https://suporte.totvs.com/download
. Linha Protheus
. MICROSIGA PROTHEUS VERSÃO 12.1.XX (onde XX é a versão da nova release)
. REPOSITÓRIOS
. REPOSITORIO DE OBJETOS 12.1.XX - MULTI IDIOMA
. Faça o download do arquivo do repositório Multi Idioma da Release desejada
ATUALIZAR:
. Pare o serviço do Protheus
. Na pasta APO, renomear o repositório anterior, ou mover para outra pasta
. Copiar o novo arquivo para o diretório APO do sistema
. Renomear o arquivo mantendo apenas os últimos 7 caracteres mais a extensão (Exemplo: TTTM120.RPO)
Obs.: 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: http://tdn.totvs.com/pages/viewpage.action?pageId=271651871

...

242386686

Obs.: Para migrar para a Release 12.1.2410, não poderá haver chave duplicada nas tabelas dos dicionários de dados SX5 e SX6, caso houver a migração não poderá ser finalizada. Ambas as tabelas estão disponíveis na ferramenta de verificação de duplicidade de registros - CheckDupl (Vide link acima) a partir da LIB 20240520. 


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, o RPO (Repositório de Objetos) da mesma versão e o Arquivo Diferencial de Helps.

Informações

Informação:

Antes de executar o UPDDISTR você deve baixar tanto o arquivo de dicionário completo (SXSBRA.TXT, por exemplo) quanto o dicionário diferencial (SDFBRA.TXT, por exemplo), e descompactá-los na pasta Systemload. Embora a migração de release utilize apenas o arquivo diferencial, o arquivo completo também deve ser baixado para a pasta, pois futuramente, quando for criar uma nova empresa ou filial, por exemplo, o arquivo que será utilizado será o COMPLETO.

A partir do Release 12.1.2310, passam a ser expedidos dois arquivos SDFs: um para os clientes que estão em um release anterior ao corrente, e um novo SDF especificamente para o cliente que está no release corrente. Saiba mais clicando aqui.

Também é necessário baixar o Arquivo Diferencial de Helps (HELPS DE CAMPOS/PERGUNTAS DIFERENCIAL - BRASIL), no Portal do Cliente, e descompactar os arquivos .txt na pasta Systemload do Ambiente.


Dicionários:
- Para atualizar os dicionários, siga o procedimento do seguinte link:
http://tdn.totvs.com/pages/viewpage.action?pageId=271415266

Repositório de Objetos:

Expandir
titlePara release até 12.1.27

- Para atualizar o RPO, siga o procedimento abaixo:
. Acesse o site do Suporte: https://suporte.totvs.com/download
. Linha Protheus
. MICROSIGA PROTHEUS VERSÃO 12.1.XX (onde XX é a versão da nova release)
. REPOSITÓRIOS
. Selecione, na parte superior da página, os filtros Categoria=Repositório de Objetos e Idioma=PT-BR (Para outro idioma, baixar REPOSITORIO DE OBJETOS MERCADO INTERNACIONAL)
. REPOSITORIO DE OBJETOS 12.1.XX - TOP CONNECT
. Confirme no nome do Arquivo se refere-se ao país desejado, conforme a  língua utilizada no ambiente (Exemplo: 20-10-16-REPOSITORIO_DE_OBJETOS_BRASIL_12_1_27_TTTP120.RPO)
. Faça o download do arquivo do repositório para o País desejado
ATUALIZAR:
. Pare o serviço do Protheus
. Na pasta APO, renomear o repositório anterior, ou mover para outra pasta
. Copiar o novo arquivo para o diretório APO do sistema
. Renomear o arquivo mantendo apenas os últimos 7 caracteres mais a extensão (Exemplo: TTTP120.RPO)
Obs.: 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: http://tdn.totvs.com/pages/viewpage.action?pageId=271651871

Expandir
titlePara release a partir de 12.1.33

- Para atualizar o RPO, siga o procedimento abaixo:
. Acesse o site do Suporte: https://suporte.totvs.com/download
. Linha Protheus
. MICROSIGA PROTHEUS VERSÃO 12.1.XX (onde XX é a versão da nova release)
. REPOSITÓRIOS
. REPOSITORIO DE OBJETOS 12.1.XX - MULTI IDIOMA
. Faça o download do arquivo do repositório Multi Idioma da Release desejada (Para outro idioma, baixar REPOSITORIO DE OBJETOS MERCADO INTERNACIONAL)
ATUALIZAR:
. Pare o serviço do Protheus
. Na pasta APO, renomear o repositório anterior, ou mover para outra pasta
. Copiar o novo arquivo para o diretório APO do sistema
. Renomear o arquivo mantendo apenas os últimos 7 caracteres mais a extensão (Exemplo: TTTM120.RPO)
Obs.: 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: http://tdn.totvs.com/pages/viewpage.action?pageId=271651871




Helps de Campos:
É necessário atualizar também os arquivos de Helps de Campo (Arquivo Diferencial de Helps, conforme passos abaixo:
. Acesse o site do Suporte: https://suporte.totvs.com/download
. Linha Protheus
. MICROSIGA PROTHEUS VERSÃO 12.1.XX (onde XX é a versão da nova release)
. HELP DE CAMPO
. Baixe o arquivo HELPS DE CAMPOS/PERGUNTAS DIFERENCIAL - BRASIL (ou  idioma desejado)
Obs.: se não estiverem aparecendo as versões, em "Filtros de pacotes" selecione "Todos pacotes disponíveis" e selecione a categoria novamente.
. Os arquivos .txt contidos no arquivo compactado dever ser extraídos na pasta Systemload do ambiente


Aviso

Para Mercado internacional, baixar os dicionários, Helps e Reposotório de Objeto, correspondentes ao seu País.

Exemplo País Chile:

Dicionário Completo(SXSCHI.TXT).
Dicionário Diferencial(SDFCHI.TXT).
(HELPS DE CAMPOS/PERGUNTAS DIFERENCIAL - CHILE)

Repositório: REPOSITORIO DE OBJETOS MERCADO INTERNACIONAL



Informações
titleInformaçã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.

...


-Deletar todos os arquivos da pasta Systemload e manter somente os arquivos de dicionário de dados SXSBRA, SDFBRA e os arquivos de Help diferencial.
-Deletar todos os arquivos *.cdx que existirem na pasta System. Se estiver com dicionário de dados no banco de dados, desconsiderar este item.
- Deletar os arquivos Console.log e mpupddistri.old e/ou *.tsk, dentro das pastas Appserver e System.
- Dropar a tabela MPUPDLOG do banco de dados via APSDU.


Aviso

O arquivo MPUPDDISTRI.TSK só deve ser apagado no inicio do processo de migração de release ou quando for necessário voltar o backup dos dicionarios e/ou base de dados.

Caso a migração já tenha sido iniciada e o processo foi parado para a correção de um erro critico, ao reiniciar a migração o arquivo MPUPDDISTRI.TSK não deve ser apagado

Aviso

Solicitamos que ao executar uma dada atualização pela primeira vez seja excluído (se existir) o arquivo MPUPDDISTRI.TSK do diretório APPSERVER da instalação do Protheus em uso. Este arquivo apenas é necessário caso o processo tenha sido interrompido antes de sua conclusão, e guarda quais tarefas foram concluídas e quais ainda estão pendentes.



5. Executando o compatibilizador de Upgrade de Release - UPDDISTR

...