Fazer Upgrade de Microsserviços do Oracle GoldenGate - Baseado em GUI

Conheça as etapas para fazer upgrade dos Microsserviços do Oracle GoldenGate usando a GUI.

Nesse ponto, você deverá ter um novo home do Oracle GoldenGate 26ai Microservices e qualquer home de release anterior do Oracle GoldenGate MA.

Fazer Upgrade do Gerenciador de Serviços

Após a instalação da versão mais recente do Oracle GoldenGate MA, a próxima etapa é fazer upgrade do Service Manager.

Se estiver usando o XAG (Oracle Grid Infrastructure Agent), desative a instância GoldenGate antes de fazer upgrade do Gerenciador de Serviços:

$ agctl disable goldengate <goldengate_name>

Estas são as etapas para executar o upgrade do Service Manager:

1. Faça login no Service Manager a partir do URL: https://hostname:servicemanager_port

2. Expanda o link ServiceManager na seção Implantações da página Visão Geral do Service Manager.

3. Clique em Detalhes e, em seguida, no ícone de lápis ao lado da seção Detalhes da Implantação para abrir a caixa de diálogo para editar o caminho do homeGoldenGate.

4. Atualize o caminho do Oracle GoldenGate Home com o caminho completo para o novo home do Oracle GoldenGate.

5. Clique em Aplicar.

6. Use a lista drop-down Ação para reiniciar o Gerenciador de Serviços.

   Se estiver usando XAG, atualize os parâmetros da instância GoldenGate:

    $ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient

   OBSERVAÇÃO: se estiver usando o XAG, as implantações gerenciadas pelo Gerenciador de Serviços atualizado também deverão ser atualizadas. Não há suporte para executar implantações em um Gerenciador de Serviços usando uma release de software GoldenGate diferente para o Gerenciador de Serviços.

Fazer Upgrade de uma Implantação

Para fazer upgrade de uma implantação:

1. Interrompa todos os processos Extract e Replicat normalmente:

   • Verifique a transação aberta (longa execução) e a Recuperação Vinculada, pois pode levar mais tempo para interromper o Extract normalmente.

   • Se quaisquer transações abertas desnecessárias estiverem visíveis, por exemplo, SEND EXTRACT group_name SHOWTRANS, essas transações poderão ser ignoradas ou imediatamente forçadas a serem interrompidas. Nesse caso, um checkpoint de Recuperação Vinculada pode ser recuperado usando o seguinte comando:

     SEND EXTRACT group_name, BR BRCHECKPOINT immediate

2. Verifique a localização atual do diretório home do Oracle GoldenGate 26ai no Gerenciador de Serviços.

   1. Faça login no Gerenciador de Serviços: http://hostname:servicemanager_port

   2. Expanda o link ServiceManager na seção Implantações da Home page do Service Manager.

   3. Copie o caminho Home do Oracle GoldenGate.

3. Retorne à seção Implantações e expanda o link da implantação a ser submetida a upgrade.

4. Clique em Detalhes e, em seguida, no ícone de lápis ao lado da seção Detalhes da Implantação para abrir a caixa de diálogo para editar o caminho do Home GoldenGate.

5. Atualize o caminho do Home do Oracle GoldenGate com o caminho completo para o novo diretório home do Oracle GoldenGate.

6. Clique em Submeter e confirme se o caminho do Home do Oracle GoldenGate foi atualizado.

7. Dependendo do banco de dados da implantação que está sendo atualizada, pode haver alterações adicionais nas configurações da Variável de Ambiente.

   Clique em Configuração para modificar as definições das variáveis de ambiente, se necessário.

   (Somente Oracle GoldenGate for Oracle AI Database), O recurso Build Unificado exige que apenas o TNS_ADMIN seja ajustado para o software Oracle Database Client no Oracle GoldenGate.

   TNS_ADMIN = Local de tnsnames.ora e sqlnet.ora

   A variável de ambiente OGG_HOME pode detectar automaticamente as variáveis DATABASE_HOME, LD_LIBRARY_PATH e JAVA_HOME. Observação: ao fazer upgrade do 21c para o 26ai, essa etapa não é necessária. Se você estiver fazendo upgrade do Oracle GoldenGate 19c (ou anterior) para o 26ai, só precisará da variável de ambiente TNS_ADMIN.

   (Somente Oracle GoldenGate for SQL Server) O Oracle GoldenGate 26ai for SQL Server no Linux inclui um driver ODBC para conectividade de banco de dados. Embora não seja necessário, recomenda-se utilizar o driver empacotado. Para usar o driver empacotado, duas novas variáveis de ambiente precisam ser criadas e qualquer arquivo odbc.ini criado anteriormente precisa ser atualizado.

   Adicione as seguintes variáveis do ambiente à implantação:

   • ODBCSYSINI = ${OGG_HOME}/msodbc

   • ODBCINI = ${OGG_HOME}/msodbc/odbc.ini

   Depois de criar as novas variáveis de ambiente, copie o arquivo odbc.ini existente para a pasta GoldenGate msodbc e altere o valor do Driver ODBC de qualquer entrada DSN para o seguinte:

   Driver=Microsoft ODBC Driver for SQL Server

8. Clique em Enviar para salvar as alterações feitas nas Variáveis de Ambiente.

9. Retorne à Home page do Service Manager.

10. Clique no ícone Reiniciar no campo Ações da implantação e clique em OK para reiniciar a implantação.

11. Efetue log-in novamente no novo Adminstration Service e inicie todos os Extracts e Replicats.

    Se estiver usando XAG, reative a instância GoldenGate após fazer upgrade da implantação:

     $ agctl enable goldengate <GoldenGate Name>

Quando o Service Manager e as implantações forem reiniciados, o upgrade será concluído.

Observação: Para o Oracle GoldenGate para PostgreSQL, consulte Etapas de Pós-Upgrade antes de iniciar qualquer Extract.