Application de patches à l'aide d'OPatch

Après avoir téléchargé le patch, configurez les prérequis suivants avant d'installer le patch :

Téléchargez et installez la version la plus récente de OPatch, et notez le répertoire d'installation dans lequel vous avez installé la dernière version de OPatch.

Les détails de l'emplacement de téléchargement de OPatch sont disponibles à l'adresse suivante : How To Download And Install The Latest OPatch(6880880) Version (ID de document 274526.1)
Téléchargez le patch Oracle GoldenGate et gérez l'emplacement de stockage du contenu du fichier ZIP de patch. Cet emplacement ou le chemin absolu est appelé patch_top_dir dans les étapes suivantes.
Accédez au répertoire patch_top_dir et exécutez la commande suivante pour extraire le contenu du fichier ZIP de patch à l'emplacement que vous avez créé précédemment.

cd patch_top_dir

unzip patch_number_version_platform.zip
Accédez au répertoire de patch décompressé :

cd patch_top_dir/patch_number_dir
Définissez la variable d'environnement ORACLE_HOME sur le répertoire d'installation d'Oracle GoldenGate auquel appliquer le patch :

Pour Linux : $ export ORACLE_HOME=GoldenGate_Installation_Path

Pour Windows : > set ORACLE_HOME=GoldenGate_Installation_Path
Définissez la variable d'environnement PATH de manière à inclure les emplacements des répertoires ORACLE_HOME et OPatch.

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

Pour Windows : >set PATH=%PATH%;%ORACLE_HOME%;C:\OPatch
Vérifiez l'inventaire Oracle auquel OPatch accède pour installer les patches. Pour vérifier l'inventaire, exécutez la commande suivante :
```
opatch lsinventory
```
Si la commande affiche des erreurs, contactez le support technique Oracle pour résoudre le problème.
Exécutez la vérification des prérequis OPatch et vérifiez qu'elle réussit.
```
opatch prereq CheckConflictAgainstOHWithDetail -ph ./
```
Si des erreurs sont affichées, identifiez le type d'erreur. OPatch classe les conflits dans les types suivants :
- Conflit avec un patch déjà appliqué à ORACLE_HOME : dans ce cas, arrêtez l'installation du patch et contactez Oracle Support Services.
- Conflit avec un patch déjà appliqué à ORACLE_HOME, qui est un sous-ensemble du patch que vous essayez d'appliquer : dans ce cas, poursuivez l'installation du patch car le nouveau patch contient tous les correctifs du patch existant dans ORACLE_HOME. Le patch du sous-ensemble est automatiquement annulé (rollback) avant l'installation du nouveau patch.
Avant d'appliquer des patches à Oracle GoldenGate, si vous disposez de déploiements pour l'installation, veillez à arrêter tous les processus tels que les extractions, les réplications et les chemins de distribution, et à arrêter tous les services pour les déploiements.

Cela peut être fait dans le service d'administration et le gestionnaire de services WebUI, ou dans le client d'administration.

Si vous utilisez le client d'administration, procédez comme suit pour vous connecter à chaque déploiement et arrêter tous les processus.
Si vous utilisez le client d'administration, connectez-vous à chaque déploiement et arrêtez tous les processus.
1. Démarrez le client d'administration et connectez-vous au déploiement.
  
  /GoldenGate_Installation_Path/bin/adminclient
  
  OGG (not connected) 1>CONNECT https://host:srv_mgrport
  
  DEPLOYMENT <deployment-name> AS <user> PASSWORD <password>
2. Arrêtez les processus d'extraction et de réplication et les chemins de distribution.
```
STOP ER *
STOP DISTPATH ALL
```
3. Arrêtez les services pour le déploiement et vérifiez qu'ils sont tous arrêtés :
```
STOP SERVICE *
STATUS SERVICE *
```
4. Quittez le client Admin et arrêtez le gestionnaire de services :
  
  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

Pour Linux : $ sudo systemctl stop OracleGoldenGate

Pour Windows : pour arrêter le gestionnaire de services pour Windows, utilisez l'applet des services Windows (services.msc) et arrêtez le service Oracle GoldenGate Service Manager.

Déconnectez toutes les sessions utilisateur du déploiement et fermez tous les programmes Oracle GoldenGate en cours d'exécution, y compris le client d'administration.

Pour installer le patch, procédez comme suit :
Installez le patch en exécutant la commande suivante :
```
opatch apply
```
Lorsque la commande OPatch démarre, elle valide le patch et s'assure qu'il n'y a pas de conflit avec le logiciel déjà installé dans ORACLE_HOME de la version Oracle GoldenGate.
Une fois l'installation du patch terminée, exécutez la commande suivante pour vérifier que l'inventaire Oracle contient le patch installé :
```
opatch lsinventory
```
Remarque : pour les installations Oracle GoldenGate pour PostgreSQL, les patches ont été appliqués à la version 21.8.0.0.2 et versions ultérieures, avant de redémarrer les extractions et les réplications, mettez à jour les entrées DSN dans le fichier odbc.ini pour tirer parti de la nouvelle version du pilote.
Une fois l'installation du patch terminée, démarrez le gestionnaire de services, les services et les processus Oracle GoldenGate.
1. Démarrez le gestionnaire de services :
  
  Pour 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

Pour Windows : utilisez l'applet Services Windows (services.msc) et démarrez le service 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>