Aplicando Patches Usando OPatch

Depois de fazer download do patch, configure os seguintes pré-requisitos antes de instalar o patch:

Faça download da versão mais recente do OPatch e anote o diretório de instalação no qual você instalou a versão mais recente do OPatch.

Os detalhes de onde fazer download do OPatch estão disponíveis em: How To Download And Install The Latest OPatch(6880880) Version (Doc ID 274526.1)
Faça download do patch do Oracle GoldenGate e mantenha um local para armazenar o conteúdo do arquivo ZIP do patch. Este local ou o caminho absoluto é chamado de patch_top_dir nas etapas subsequentes.
Navegue até o diretório patch_top_dir e execute o comando a seguir para extrair o conteúdo do arquivo ZIP do patch para o local criado anteriormente.

cd patch_top_dir

unzip patch_number_version_platform.zip
Navegue até o diretório de patch descompactado:

cd patch_top_dir/patch_number_dir
Defina a variável de ambiente ORACLE_HOME como o diretório de instalação do Oracle GoldenGate que será submetido a patch:

Para Linux: $ export ORACLE_HOME=GoldenGate_Installation_Path

Para Windows: > set ORACLE_HOME=GoldenGate_Installation_Path
Defina a variável de ambiente PATH para incluir os locais dos diretórios ORACLE_HOME e OPatch.

Para Linux: $ export PATH=$PATH:$ORACLE_HOME:/OPatch

Para Windows: >set PATH=%PATH%;%ORACLE_HOME%;C:\OPatch
Verifique o inventário Oracle, que o OPatch acessa para instalar os patches. Para verificar o inventário, execute o seguinte comando:
```
opatch lsinventory
```
Se o comando exibir algum erro, entre em contato com o Suporte Técnico da Oracle para resolver o problema.
Execute a verificação de pré-requisitos do OPatch e verifique se ele foi aprovado.
```
opatch prereq CheckConflictAgainstOHWithDetail -ph ./
```
Se algum erro for exibido, identifique o tipo de erro. OPatch categoriza conflitos nos seguintes tipos:
- Em conflito com um patch já aplicado ao ORACLE_HOME: Nesse caso, interrompa a instalação do patch e entre em contato com o Oracle Support Services.
- Em conflito com um patch já aplicado ao ORACLE_HOME que é um subconjunto do patch que você está tentando aplicar: Nesse caso, continue com a instalação do patch porque o novo patch contém todas as correções do patch existente no ORACLE_HOME. O patch do subconjunto será automaticamente revertido antes da instalação do novo patch.
Antes de aplicar patch ao Oracle GoldenGate, se você tiver alguma implantação para a instalação, certifique-se de fazer shutdown de todos os processos, como Extracts, Replicats e caminhos de Distribuição, e interromper todos os serviços das implantações.

Isso pode ser feito no WebUI do Administration Service e no Service Manager ou no Admin Client.

Se estiver usando o Admin Client, execute as etapas a seguir para se conectar a cada implantação e interromper todos os processos.
Se estiver usando o Admin Client, conecte-se a cada implantação e interrompa todos os processos.
1. Inicie o Admin Client e conecte-se à implantação.
  
  /GoldenGate_Installation_Path/bin/adminclient
  
  OGG (not connected) 1>CONNECT https://host:srv_mgrport
  
  DEPLOYMENT <deployment-name> AS <user> PASSWORD <password>
2. Interrompa os processos de Extração e Replicação e os Caminhos de Distribuição.
```
STOP ER *
STOP DISTPATH ALL
```
3. Interrompa os serviços da implantação e verifique se todos eles foram interrompidos:
```
STOP SERVICE *
STATUS SERVICE *
```
4. Saia do Admin Client e interrompa o Service Manager:
  
  OGG (https://host:port deployment-name) exit
  
  ##Command for Service Manager not registered as a service/daemon
  
  export OGG_VAR_HOME=OGG_SRVMGR_DIRECTORY/var
  
  export OGG_ETC_HOME=OGG_SRVMGR_DIRECTORY/etc
  
  OGG_SRVMGR_DIRECTORY/bin/stopSM.sh
  
  ##Command for Service Manager registered as a service/daemon

Para Linux: $ sudo systemctl stop OracleGoldenGate

Para o Windows: Para interromper o Service Manager para Windows, use o applet Serviços do Windows (services.msc) e interrompa o serviço Oracle GoldenGate Service Manager.

Desconecte todas as sessões do usuário à implantação, bem como feche todos os programas Oracle GoldenGate em execução, incluindo o Admin Client.

Execute as seguintes etapas para instalar a correção:
Instale o patch executando o seguinte comando:
```
opatch apply
```
Quando o comando OPatch é iniciado, ele valida o patch e garante que não haja conflitos com o software já instalado no ORACLE_HOME da release do Oracle GoldenGate.
Após a conclusão da instalação do patch, execute o seguinte comando para verificar se o inventário Oracle contém o patch instalado:
```
opatch lsinventory
```
Observação: Para instalações do Oracle GoldenGate for PostgreSQL com patch para a release 21.8.0.0.2 e posterior, antes de reiniciar os processos Extract e Replicats, atualize as entradas DSN no arquivo odbc.ini para aproveitar a nova versão do driver.
Após a conclusão da instalação do patch, inicie os processos do Service Manager, dos serviços e do Oracle GoldenGate.
1. Inicie o Gerenciador de Serviços:
  
  Para Linux:
  
  ##Command for Service Manager not registered as a service/daemon
  
  $ export OGG_VAR_HOME=OGG_SRVMGR_DIRECTORY/var
  
  $ export OGG_ETC_HOME=OGG_SRVMGR_DIRECTORY/etc
  
  $ OGG_SRVMGR_DIRECTORY/bin/startSM.sh
  
  ##Command for Service Manager registered as a service/daemon
  
  $ sudo systemctl start OracleGoldenGate

Para Windows: Use o applet Serviços do Windows (services.msc) e inicie o serviço Oracle GoldenGate Service Manager.

2. Start the Admin Client and connect to the deployment.

    `/GoldenGate_Installation_Path/bin/adminclient`

    `OGG (not connected) 1>CONNECT https://host:srvmgr_port DEPLOYMENT deployment-name AS user PASSWORD password`

3. Start services for the deployment and verify that they are all running:

    <pre class="copy"><code>START SERVICE * STATUS SERVICE *</code></pre>

4. Start the Extract, Replicat and Distribution paths:

    <pre class="copy"><code>START ER * START DISTPATH ALL</code></pre>