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.Importante: 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:
Converter arquivos do formato DBF para DTC


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
Antes de iniciar o Upgrade
  • 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

Aviso
titleAtenção
  • Para migrar 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

...

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, 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.

...

  • 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.


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

Para migrar para a Release 12.1.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

Para migrar para a Release 12.1.2410, são necessários os pré requisitos abaixo:



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:
http://tdn.totvs.com/pages/viewpage.action?pageId=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




Repositório Helps de ObjetosCampos:
- Para atualizar o RPO, siga o procedimento É 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)
. PROTHEUS 12 TOPCONNECT "LINGUA" (Lingua utilizada no ambiente)
. Categoria: Repositório de objetos
. Baixar o repositório para o Pais desejado (PPP-TTTP120)
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 (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
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 .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.

...

Aviso
titleAviso

O uso do APSDU restringe-se apenas ao ajuste de Erros Críticos que podem ocorrer na execução do UPDDISTR. Não recomendamos o uso do APSDU antes da finalização do processo. Caso seja necessário algum ajuste através da ferramenta, é recomendado o uso com o RPO da Release de origem.



4. Limpeza das Pastas


- Exclua os arquivos *.DBF e *.DTC da pasta SYSTEMLOAD
- Exclua os arquivos *.IDX da pasta SYSTEMLOAD
- Exclua os arquivos *.LOG da pasta SYSTEM
- Exclua os arquivos TOTVSP*.* da pasta SYSTEM
- Exclua os arquivos *.TSK e .LOG da pasta APPSERVERDeletar 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.


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

...


Observação importante: a ferramenta UPDDISTR apenas atualiza o dicionário de dados (metadado), os helps de campo e a base de dados. As alterações no repositório do sistema (sejam elas substituição do repositório, aplicação de "patchs", "updates" e pacotes) e atualizações de menus devem continuar sendo efetuadas conforme instruído em cada processo específico. 

Procedimento do UPDDISTR

...

Image Removed

  

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.

...

Link com Regras para atualização dos dicionários - UPDDISTR e Migrador de Versão: https://tdn.totvs.com/pages/releaseview.action?pageId=301201717


Procedimento do UPDDISTR


- Abra o Smartclient, e no Programa Inicial, digite: UPDDISTR

Image Added

  

Selecionar os grupos de empresas;



Aviso

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.

...