Manter suas implantações do OCI GoldenGate

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

Tópicos Relacionados

Sobre versões do GoldenGate

O OCI GoldenGate suporta várias versões simultâneas, por exemplo, Oracle GoldenGate, Oracle GoldenGate para Big Data e Oracle GoldenGate para 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. Existem três tipos de versões:

  • Principal: O primeiro número no número do build indica uma versão principal. Por exemplo, 21.
  • Pacote: O segundo número indica a liberação do pacote. Uma versão de pacote é um conjunto de correções de bugs para uma versão principal. Por exemplo, 21.5
  • Menor: Os números à direita indicam uma release secundária. Uma release secundária consiste em uma ou mais correções de bug em uma release 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 incluir ou não uma correção de segurança, você terá um tempo específico para atualizar 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 período especificado, sua implantação fará upgrade automaticamente para a versão mais recente no final desse período.

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 desde a data em que foi lançada até a data em que foi descontinuada. Quando uma versão estiver obsoleta, você não poderá mais selecioná-la para criação ou upgrade da implantação.

Os períodos de descontinuação usam os mesmos períodos 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 uma 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 de Pacote ou Secundárias), todas as versões anteriores da mesma versão Principal estão obsoletas.

Observação:

A data de liberação pode ser diferente entre as regiões.

Programar atualizações

Você pode personalizar janelas de manutenção que definem o início do período durante o qual atualizar sua implantação quando uma nova versão do GoldenGate estiver disponível. Se você não definir uma janela de manutenção, o OCI GoldenGate calculará o melhor momento para fazer upgrade da implantação com base na data de release da versão mais recente.

Observação:

Quando uma janela de manutenção não é definida, o OCI GoldenGate programa upgrades no fim de semana mais próximo do final calculado do período de upgrade automático.

Você pode personalizar a janela de manutenção do OCI GoldenGate ao criar a implantação ou mais tarde na página de detalhes da implantação. Quando uma nova versão do GoldenGate está disponível, a implantação é atualizada automaticamente no dia e na hora exatos escolhidos. No entanto, as implantações podem fazer upgrade automaticamente antes do dia e da hora escolhidos, quando o período da nova versão para upgrade manual estiver fora da janela de manutenção personalizada.

Por exemplo, digamos que em 1o de janeiro de 2023, 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, 4 de fevereiro, às 10h, porque o OCI GoldenGate sempre priorizará 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 da Implantação, para Manutenção, clique em Editar.
  2. Na caixa de diálogo Editar parâmetros de manutenção:
    1. (Opcional) Selecione Personalizar janela de manutenção para alterar os campos a seguir de seus valores padrão.
    2. Para Período de upgrade automático da release principal em dias, informe um valor entre 0 e 365.
    3. Para Período de upgrade automático da liberação do pacote 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. Clique em 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.

Certifique-se de 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 a Extração for iniciada. O campo Recovery Checkpoint mostra o log mais antigo necessário para recuperação.
Admin Client > INFO EXTRACT group_name, SHOWCH

É melhor realizar atividades de atualização 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 talvez precise iniciar o processamento do ponto de verificação de recuperação normal, em vez disso 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 compensar transações de longa execução, você tem duas opções:

  • Você pode restaurar os arquivos compactados de volta para, e incluindo, aquele mostrado no ponto de verificação 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 à Extração 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 à 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 de qualquer 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 concluir a limpeza de transações de longa execução, force um ponto de verificação de Recuperação Limitada. 
      Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Sincronizar Replicats

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 da interface da linha de comando SYNCHRONIZE REPLICAT.

Fazer upgrade de uma implantação

Certifique-se de concluir as etapas Antes de atualizar 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 GoldenGate disponível para upgrade e clique em Fazer Upgrade.

    Observação:

    Saiba mais sobre versões.

O upgrade demora alguns minutos para ser concluído. Clique em 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 for encontrado um problema durante o processo de upgrade.

Atualizar tabelas de pulsação
Você também deverá fazer upgrade das tabelas de pulsação se elas forem usadas em sua implantação. Depois de concluir a atualização, será possível:
  • Execute o comando UPGRADE HEARTBEATTABLE no Admin Client para adicionar colunas extras para tabelas e views em atraso. 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 clique em Configuração. Conectar-se ao banco de dados. Quando as tabelas de pulsação aparecerem, selecione Atualizar 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 é programado. Consulte GoldenGate Tipos de Evento de Upgrade para obter mais informações ou saiba mais sobre eventos.

Tempo para fazer 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ção para correções de segurança todos os dias.

Você também pode aprender sobre as próximas atualizações nos banners de notificação que aparecem na página de detalhes da implantação.

Aguardar 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 fim do período para atualização manual.

Tempo para fazer upgrade < 180 dias < 30 dias < 7 dias
Suspender período 30 dias 7 dias Não permitido

Observação:

Não é permitido suspender para correções de segurança de upgrades Secundários ou de Pacote.

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

Atualizações de rollback

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

Observação:

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

O 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 da qual você deseja fazer rollback.
  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 clique em 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 seus upgrades programados automaticamente. Você pode reprogramar a atualização para uma data mais próxima ou adiá-la para uma data posterior.

Observação:

A reprogramação não leva em consideração as janelas de manutenção. Sua data recém-programada não pode ser posterior ao valor definido do OCI GoldenGate. Consulte Sobre as versões 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. Clique em Salvar alterações.

Na lista Upgrades, a data e a hora Programadas refletem as alterações.

Cancelar upgrades

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

Observação:

O cancelamento de uma atualização para uma versão secundária não desativará as atualizações automáticas para versões 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 um upgrade:

  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, em seguida, no menu Ação, selecione Cancelar.
  4. Na janela Cancelar upgrade da implantação, clique em Cancelar upgrade da implantação.

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

Problemas conhecidos

Problemas encontrados durante o rollback das versões 21.15 ou 23.x para a versão 21.14

Ao tentar fazer rollback de um build 21.15 ou 23.x para:

  • da 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_240404040404)

Você pode encontrar um dos seguintes problemas:

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

    Solução alternativa: você deve cancelar a atribuiçã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 em decorrência de 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 se encontrar 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 continuar.