Manter suas implantações do OCI GoldenGate

Saiba mais sobre versões do GoldenGate, como e quando fazer upgrade, receber ou adiar notificações e como fazer rollback de upgrades.

Sobre versões do GoldenGate

O OCI GoldenGate oferece suporte a várias versões simultâneas, por exemplo, Oracle GoldenGate, Oracle GoldenGate for Big Data e Oracle GoldenGate for MySQL, para citar algumas. Consulte a referência de versões para obter detalhes sobre a versão apropriada para você.

Cada versão tem um número de build. Há três tipos de releases:

• Importante: o primeiro número no número de build indica uma versão principal. Por exemplo, 21.

• Pacote: O segundo número indica a liberação do pacote. Uma release de pacote é um conjunto de correções de bugs para uma release principal. Por exemplo, 21.5

• Habilitação: Os números à direita indicam uma liberação secundária. Uma versão secundária consiste em uma ou mais correções de bugs em uma versão do bundle. Por exemplo, 21.5.0.0.0.

Observação: todos os tipos de release podem conter correções de segurança.

Dependendo do tipo de release e se ela inclui ou não uma correção de segurança, você terá um tempo específico para fazer upgrade da sua implantação quando uma nova versão estiver disponível:

Tipo de release	Principal	Pacote	Secundário
Correção de não segurança	365 dias	180 dias	Não se aplica
Correção de segurança	Não se aplica	14 dias	14 dias

Se você não fizer upgrade manualmente dentro do prazo fornecido, sua implantação fará upgrade automaticamente para a versão mais recente no final desse prazo.

Observação: você pode exibir a data em que uma versão é suportada até a tela de implantação Upgrade e a lista Upgrades.

Obsolescência das versões

Uma versão do GoldenGate está disponível a partir da data em que foi liberada até a data em que foi descontinuada. Quando uma versão é obsoleta, você não pode mais selecioná-la para criação ou upgrade de implantação.

Os períodos de descontinuação usam os mesmos períodos de tempo que as atualizações de versão. Por exemplo:

• 365 dias após uma versão principal, a versão principal anterior está obsoleta.

• 180 dias após a versão do bundle, as versões anteriores do bundle da mesma versão principal estão obsoletas.

• 14 dias após uma versão de correção de Segurança (para versões Bundle ou Minor), todas as versões anteriores da mesma versão Principal estão obsoletas.

Observação: A partir de abril de 2027, todas as implantações de replicação de dados 21c serão atualizadas automaticamente para a versão de release mais recente disponível. As datas de liberação podem diferir entre regiões.

Programar atualizações

Você pode personalizar janelas de manutenção que definem quando fazer upgrade da sua implantação. Se você não definir uma janela de manutenção, o OCI GoldenGate calculará o melhor horário para fazer upgrade da implantação com base na data de release da versão mais recente e, em seguida, fará upgrade automaticamente da sua implantação durante o fim de semana mais próximo do final calculado do período de upgrade automático.

Observação: Quando uma nova versão de uma release Principal, de Pacote ou Secundária é lançada, o OCI GoldenGate programa um upgrade para você com base em sua linha do tempo aplicável (365 dias para Principal, 180 dias para Pacote, 14 dias para Secundário com correção de segurança). Se uma versão mais recente da mesma release estiver disponível, o serviço fará upgrade da sua implantação usando a versão mais recente disponível, mas a data programada permanecerá inalterada.

Você pode personalizar a janela de manutenção do OCI GoldenGate ao criar a implantação ou ao editar uma implantação existente. Quando uma nova versão do GoldenGate se torna disponível, a implantação faz upgrade automaticamente no dia e na hora exatos escolhidos. No entanto, é possível que as implantações façam upgrade automaticamente antes do dia e da hora escolhidos, quando o período de upgrade escolhido para upgrade manual fica fora da janela de manutenção.

Por exemplo, digamos que em 1º de janeiro, você tenha 30 dias para atualizar sua implantação e, em seguida, tenha até terça-feira, 31 de janeiro para atualizar manualmente. No entanto, sua janela de manutenção personalizada começa aos domingos às 10h. Com essa janela de manutenção, o OCI GoldenGate fará upgrade da sua implantação no domingo seguinte às 10h, porque o OCI GoldenGate sempre prioriza sua janela personalizada.

Para editar a janela de manutenção personalizada:

1. Na página de detalhes da implantação, em GoldenGate na área de informações Implantação, para Manutenção, selecione Editar.

2. Na caixa de diálogo Editar parâmetros de manutenção:

   1. (Opcional) Selecione Personalizar janela de manutenção para alterar os seguintes campos de seus valores padrão.

   2. Para Período de upgrade automático da versão principal em dias, informe um valor entre 0 e 365.

   3. Para Período de upgrade automático da liberação do bundle em dias, informe um valor entre 0 e 180.

   4. Para Período de upgrade automático do caminho de segurança em dias, informe um valor entre 0 e 14.

   5. (Opcional) Selecione Ativar upgrade automático da release secundária e informe um valor para Período de upgrade automático da release secundária em dias.

3. Selecione Salvar alterações.

Antes de fazer upgrade

Antes de fazer upgrade de uma implantação, certifique-se de concluir as tarefas a seguir e verificar se há transações de longa execução.

Garantir que os Logs de Arquivamento estejam disponíveis para recuperação

Use o comando a seguir no Admin Client para determinar o log de arquivamento mais antigo que talvez seja necessário restaurar quando o Extract for iniciado. O campo Recovery Checkpoint mostra o log mais antigo necessário para recuperação.

Admin Client > INFO EXTRACT group_name, SHOWCH

É melhor executar atividades de upgrade fora do horário de pico. Se houver transações grandes e de longa execução, você poderá considerar que, no sistema de origem, o novo Extract poderá precisar iniciar o processamento a partir do ponto de verificação de recuperação normal, em vez de do que o ponto de verificação de recuperação limitado, se o primeiro registro da transação aberta mais antiga no momento em que você interrompe o Extract estiver em um log que não esteja no sistema.

Limpar transações de longa execução

Para limpar transações de longa execução, você tem duas opções:

• Você pode restaurar os arquivos compactados de volta e incluir o mostrado no checkpoint de recuperação mostrado com:

  Admin Client > INFO EXTRACT

  (Se o banco de dados de origem suportar isso.)

• É possível limpar as transações de longa execução que se aplicam ao processo Extract que você está atualizando. Isso pode ser feito ignorando as transações ou forçando-as à trilha como transações confirmadas. Ignorar uma transação pode causar perda de dados, e forçar uma transação para a trilha pode adicionar dados indesejados à trilha se a transação for revertida. Para ignorar ou forçar uma transação:

  1. Visualizar transações abertas:

     Admin Client > SEND EXTRACT group_name, SHOWTRANS

  2. Registre o ID da transação que você deseja limpar.

  3. Limpe transações antigas usando SEND EXTRACT e a opção SKIPTRANS para ignorar uma transação ou FORCETRANS para forçar uma transação em seu estado atual para a Trilha como uma transação confirmada. Por exemplo:

     Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]}

  4. Depois de terminar de limpar transações de longa execução, force um checkpoint de Recuperação Vinculada.

     Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Sincronizar Replicat

Para implantações com Replicats Paralelos, certifique-se de sincronizar Replicats antes de fazer upgrade:

Admin Client > SYNCHRONIZE REPLICAT group_name

Para obter mais informações, consulte a referência de interface de linha de comando SYNCHRONIZE REPLICAT.

Fazer upgrade de uma implantação

Certifique-se de concluir as etapas Antes de fazer upgrade primeiro.

Quando você faz upgrade de uma implantação,

• A implantação é interrompida e depois reiniciada após a conclusão do upgrade.

• Todos os processos do Oracle GoldenGate serão interrompidos e depois reiniciados se estiverem configurados para início automático.

Para fazer upgrade de uma implantação:

1. Na página Implantações, selecione a implantação da qual você deseja fazer upgrade.

2. Na página de detalhes da implantação, no menu Ações, selecione Fazer Upgrade.

3. No painel Fazer upgrade da implantação, selecione uma versão disponível do GoldenGate para a qual fazer upgrade e, em seguida, selecione Fazer Upgrade.

Observação: Saiba mais sobre versões.

O upgrade demora alguns minutos para ser concluído. Selecione Upgrades na página detalhes da implantação após a conclusão da atualização para exibir o histórico da atualização ou se um problema for encontrado durante o processo de upgrade.

Atualizar tabelas de Heartbeat

Você também deve fazer upgrade das tabelas de Heartbeat se elas forem usadas em sua implantação. Depois de concluir o upgrade, você poderá:

• Execute o comando UPGRADE HEARTBEATTABLE no Admin Client para adicionar colunas extras para tabelas e exibições de lag. O GoldenGate usa essas colunas extras para rastrear a posição de reinicialização do Extract. Saiba mais.

• Na console de implantação, abra o menu de navegação da console de Administração e selecione Configuração. Conectar-se ao banco de dados. Quando as tabelas Heartbeat aparecerem, selecione Upgrade no menu Ação.

Notificações de upgrade

O OCI GoldenGate envia notificações de eventos para quando um upgrade está disponível e quando um upgrade está programado. Consulte Tipos de Evento de Upgrade do GoldenGate para obter mais informações ou saiba mais sobre eventos.

Horário para upgrade	180 dias	< 30 dias	< 7 dias
Período de notificação	A cada 30 dias	A cada 7 dias	Todos os dias

Observação: O OCI GoldenGate envia notificações para correções de segurança todos os dias.

Você também pode aprender sobre os próximos upgrades nos banners de notificação que aparecem na página de detalhes da implantação.

Suspender notificações

Você pode adiar ou atrasar notificações de eventos e banners. O período de suspensão muda à medida que você se aproxima do final do período para atualização manual.

Horário para upgrade	180 dias	< 30 dias	< 7 dias
Período de suspensão	30 dias	7 dias	Não permitido

Observação: Não é permitido adiar para correções de segurança de atualizações Menores ou de Pacote.

Você pode cancelar a suspensão a qualquer momento.

Fazer rollback de atualizações

Você pode fazer rollback de uma versão de implantação para a anterior. O rollback só é permitido para o upgrade mais recente bem-sucedido para a versão anterior.

Observação: Durante a reversão, o sistema de arquivos de implantação é restaurado para seu último estado antes do upgrade.

Rollback não é permitido quando a versão anterior está obsoleta.

Para fazer rollback de um upgrade:

1. Na página Implantações, selecione a implantação que deseja reverter.

2. Na página de detalhes da implantação, selecione Upgrades.

3. Na lista Upgrades, localize a versão anterior mais recente e, em seguida, no menu Ação, selecione Rollback.

4. Selecione a versão para a qual fazer rollback e, em seguida, selecione Rollback.

Observação: Para obter uma lista de versões disponíveis, consulte a referência de versões.

O status da sua implantação muda para atualização e leva alguns minutos para ser concluído.

Reprogramar atualizações

Você pode reprogramar suas atualizações programadas automaticamente. Você pode reprogramar o upgrade para uma data mais próxima ou adiá-lo para uma data posterior.

Observação: A reprogramação não leva em consideração as janelas de manutenção. A data recém-programada não pode ser posterior ao valor definido do OCI GoldenGate. Consulte Sobre versões do GoldenGate para obter mais informações.

Para reprogramar um upgrade:

1. Na página Implantações, selecione a implantação cujo upgrade você deseja reprogramar.

2. Na página de detalhes da implantação, selecione Upgrades.

3. Na lista Upgrades, localize a versão anterior mais recente e, em seguida, no menu Ação, selecione Reprogramar.

4. Na janela Reprogramar upgrade de implantação, selecione a data e a hora para executar o upgrade.

5. Selecione Salvar alterações.

Na lista Atualizações, a data e hora agendadas refletem as alterações.

Cancelar upgrades

Você só poderá cancelar um upgrade programado automaticamente se a versão de destino for uma versão secundária.

Observação: o cancelamento de um upgrade para uma release secundária não desativará os upgrades automáticos para releases secundárias implicitamente e deverá ser desativado manualmente. Você pode desativar o upgrade automático da release secundária na página de detalhes da implantação. Consulte Programar upgrades para obter mais informações.

Para cancelar uma atualização:

1. Na página Implantações, selecione a implantação cujo upgrade você deseja cancelar.

2. Na página de detalhes da implantação, selecione Upgrades.

3. Na lista Upgrades, localize a versão anterior mais recente e, no menu Ação, selecione Cancelar.

4. Na janela Cancelar upgrade de implantação, selecione Cancelar upgrade de implantação.

O status da atualização é atualizado para Cancelado.

Problemas conhecidos

Pós-upgrade para o Oracle GoldenGate 23.26.x, erro de Gateway Inválido na console de implantação 502 ou falha ao listar processos do GoldenGate após o log-in

As implantações do Oracle Cloud Infrastructure GoldenGate 23.26 podem ficar insalubres após o upgrade de labels anteriores para a versão 23.26.x ou após a execução de uma operação de interrupção/inicialização em uma implantação do 23.26.x.

Solução alternativa: O upgrade afetou as implantações da Oracle para rotular o oggoracle:23.26.1.0.0_260331, a fim de corrigir esse problema.

Para Big Data e outros rótulos não Oracle, uma correção será anunciada em breve. Entre em contato com o Suporte para obter a mitigação manual provisória para evitar impacto.

Problemas durante a reversão de builds 21.15 ou 23.x para 21.14

Ao tentar reverter uma compilação 21.15 ou 23.x para uma das seguintes compilações:

• O Oracle (21.14.0.0.0_240525)

• big data (21.14.0.0.0_240515)

• MySQL (21:14,0,0,0_240404)

• MSSQL (21.14.0.0.0_240404)

Você pode encontrar um dos seguintes problemas:

• Problema de Conexões/Credenciais ausente devido ao novo recurso de criptografia da wallet introduzido na versão 21.15 em diante.

  Solução alternativa: você deve cancelar a designação e reatribuir as conexões existentes à implantação e recriar os usuários ausentes necessários para qualquer caminho de Distribuição ou Receptor em uso.

• Falha ao iniciar o Service Manager devido a um problema com o Serviço de Métricas de Desempenho em rollbacks de 23.x para 21.14. Entre em contato com o Suporte Técnico da Oracle caso encontre esse problema.

• Falha nos processos do Oracle GoldenGate com o erro "OGG-02431 Cabeçalho de registro inválido encontrado no arquivo de checkpoint."

  Solução alternativa: Faça upgrade da implantação para o build 21.14 mais recente disponível na série. Entre em contato com o Suporte Técnico da Oracle se o problema persistir.