Como atualizar a versão do sistema?

RT.FAQ-82921

Acessar a interface Informações sobre o sistema (ABOUT).

Clicar em [b:Forçar versão]

Informar a versão desejada no campo "Versão a ser instalada". Para instalar a última versão estável do sistema, este campo deve ficar "vazio" (nada deve ser informado).

Clicar novamente em [b:Forçar versão]

Clicar em [b:Refresh] de tempos em tempos para recarregar a tela e atualizar o campo "Atualizações", até que seja apresentada uma mensagem tipo "Atualização XX.XX.XX disponível".

Clicar em [b:Verificação] para apresentar os arquivos baixados para atualização da versão. Verificar se no final da lista apresenta a expressão "MD5 dos arquivos baixados OK!". Caso não seja apresentada esta mensagem, executar os procedimentos novamente a partir do [b:Forçar versão].

Até este ponto, tudo que foi realizado corresponde apenas ao download dos arquivos necessários para fazer a atualização e pode ser realizado com os usuários utilizando o servidor normalmente. Inclusive, pode ser feito com antecedência para permitir o menor downtime possível.

Pedir para os usuários não usar o sistema. Pode-se acessar a interface LST_THREADS para verificar se existe algum processo em execução. Qualquer processo em execução será derrubado, o que pode significar problemas no caso de processos como emissão de notas, por exemplo.

Clicar em [b:Aplicar atualização] e aguardar.

Sistema será recarregado e será solicitado o login do usuário novamente.

Se tiver informação de login e senha, ao efetuar o login, será executada automaticamente a interface Rotinas de atualização (PRO_ATUALIZACOES).

Se acesso ao sistema estiver sendo feito através do monitoramento, repita o acesso pelo monitoramento e execute manualmente a operação PRO_ATUALIZACOES.

No final da execução das rotinas de atualização, revise as mensagens apresentadas procurando por possíveis erros:

Erros relacionados a colunas que não puderam ser tornadas obrigatórias são normalmente causadas porque as rotinas de upgrade são executadas depois dessa etapa. Nestes casos, execute novamente a rotina PRO_ATUALIZACOES e verifique se a mensagem desapareceu.
Outras mensagens devem ser avaliadas com a equipe técnica.

Atenção

A atualização dos outros servidores deve seguir os mesmos passos até [b:Aplicar atualização]. Normalmente, basta aplicar a atualização sem executar o PRO_ATUALIZACOES.

JAMAIS EXECUTE O COMANDO PRO_ATUALIZACOES NOS DEMAIS SERVIDORES A NÃO SER QUE TENHA ABSOLUTA CERTEZA DE QUE TODOS OS COMANDOS DE ATUALIZAÇÃO DO PRIMEIRO JÁ TENHAM SIDO REPLICADOS.

Após a atualização de todos os servidores, deve-se:

Revisar as filas de integração e ajustar os eventuais erros de replicação em todas as bases que foram atualizadas.
Verificar pela Utilitário para consultar DML Logs (RTREPLICATOR.CON_DMLLOG) se os comandos de atualização executados no master foram replicados e executados com sucesso nos slaves.