Applicazione di patch mediante OPatch

Dopo aver scaricato la patch, impostare i prerequisiti seguenti prima di installare la patch:

Scaricare e installare la release più recente di OPatch e tenere presente la directory di installazione in cui è stata installata l'ultima release di OPatch.

I dettagli da cui scaricare OPatch sono disponibili all'indirizzo: Come scaricare e installare l'ultima versione di OPatch(6880880) (ID documento 274526.1)
Scaricare la patch di Oracle GoldenGate e gestire una posizione per memorizzare il contenuto del file ZIP della patch. Questa posizione o il percorso assoluto viene indicato come patch_top_dir nei passi successivi.
Passare alla directory patch_top_dir ed eseguire il comando seguente per estrarre il contenuto del file ZIP della patch nella posizione creata in precedenza.

cd patch_top_dir

unzip patch_number_version_platform.zip
Passare alla directory delle patch decompressa:

cd patch_top_dir/patch_number_dir
Impostare la variabile di ambiente ORACLE_HOME sulla directory di installazione di Oracle GoldenGate a cui applicare le patch:

Per Linux: $ export ORACLE_HOME=GoldenGate_Installation_Path

Per Windows: > set ORACLE_HOME=GoldenGate_Installation_Path
Impostare la variabile di ambiente PATH in modo che includa le posizioni delle directory ORACLE_HOME e OPatch.

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

Per Windows: >set PATH=%PATH%;%ORACLE_HOME%;C:\OPatch
Verificare l'inventario Oracle a cui ha accesso OPatch per installare le patch. Per verificare l'inventario, eseguire il comando seguente:
```
opatch lsinventory
```
Se il comando visualizza eventuali errori, contattare il Supporto Oracle per risolvere il problema.
Eseguire il controllo dei prerequisiti OPatch e verificare che venga superato.
```
opatch prereq CheckConflictAgainstOHWithDetail -ph ./
```
Se vengono visualizzati errori, identificare il tipo di errore. OPatch classifica i conflitti nei seguenti tipi:
- Guerra con una patch già applicata a ORACLE_HOME: in questo caso, arrestare l'installazione della patch e contattare Oracle Support Services.
- Conflitti con una patch già applicata a ORACLE_HOME che è un sottoinsieme della patch che si sta tentando di applicare: in questo caso, continuare con l'installazione della patch perché la nuova patch contiene tutte le correzioni della patch esistente in ORACLE_HOME. Verrà eseguito automaticamente il rollback della patch subset prima dell'installazione della nuova patch.
Prima di applicare le patch a Oracle GoldenGate, se si dispone di distribuzioni per l'installazione, assicurarsi di chiudere tutti i processi quali estrazioni, repliche e percorsi di distribuzione e arrestare tutti i servizi per le distribuzioni.

Questa operazione può essere eseguita nel servizio di amministrazione e nel Service Manager WebUI o nel client di amministrazione.

Se si utilizza il client di amministrazione, eseguire i passi riportati di seguito per connettersi a ciascuna distribuzione e arrestare tutti i processi.
Se si utilizza il client di amministrazione, connettersi a ciascuna distribuzione e arrestare tutti i processi.
1. Avviare il client di amministrazione e connettersi alla distribuzione.
  
  /GoldenGate_Installation_Path/bin/adminclient
  
  OGG (not connected) 1>CONNECT https://host:srv_mgrport
  
  DEPLOYMENT <deployment-name> AS <user> PASSWORD <password>
2. Arrestare i processi Extract e Replicat e i percorsi di distribuzione.
```
STOP ER *
STOP DISTPATH ALL
```
3. Arrestare i servizi per la distribuzione e verificare che siano tutti arrestati:
```
STOP SERVICE *
STATUS SERVICE *
```
4. Uscire dal client di amministrazione e arrestare 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

Per Linux: $ sudo systemctl stop OracleGoldenGate

Per Windows: per arrestare Service Manager per Windows, utilizzare l'applet Servizi Windows (services.msc) e arrestare il servizio Oracle GoldenGate Service Manager.

Disconnettere tutte le sessioni utente alla distribuzione e chiudere tutti i programmi Oracle GoldenGate in esecuzione, incluso il client di amministrazione.

Eseguire i passaggi indicati di seguito per installare la patch.
Installare la patch eseguendo il seguente comando:
```
opatch apply
```
All'avvio del comando OPatch, convalida la patch e garantisce che non vi siano conflitti con il software già installato in ORACLE_HOME della release di Oracle GoldenGate.
Al termine dell'installazione delle patch, eseguire il comando seguente per verificare che l'inventario Oracle contenga la patch installata:
```
opatch lsinventory
```
Nota: per le installazioni di Oracle GoldenGate per PostgreSQL a cui è stata applicata la patch alla release 21.8.0.0.2 e versioni successive, prima di riavviare Estrazioni e repliche, aggiornare le voci DSN nel file odbc.ini per sfruttare la nuova versione del driver.
Al termine dell'installazione delle patch, avviare Service Manager, i servizi e i processi Oracle GoldenGate.
1. Avviare Service Manager:
  
  Per 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

Per Windows: utilizzare l'applet Servizi Windows (services.msc) e avviare il servizio Service Manager di Oracle GoldenGate.

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>