Mettre à niveau les microservices Oracle GoldenGate - Basé sur l'interface graphique

Découvrez les étapes de mise à niveau des microservices Oracle GoldenGate à l'aide de l'interface graphique.

A ce stade, vous devez disposer d'un nouveau répertoire de base Oracle GoldenGate 26ai Microservices et de tous les répertoires de base de version antérieure d'Oracle GoldenGate MA.

Mettre à niveau le gestionnaire de services

Après avoir installé la dernière version d'Oracle GoldenGate MA, l'étape suivante consiste à mettre à niveau le gestionnaire de services.

Si vous utilisez l'agent Oracle Grid Infrastructure (XAG), désactivez l'instance GoldenGate avant de mettre à niveau le gestionnaire de services :

$ agctl disable goldengate <goldengate_name>

Pour effectuer la mise à niveau du gestionnaire de services, procédez comme suit :

Connectez-vous au gestionnaire de services à partir de l'URL : https ://hostname:servicemanager_port
Développez le lien ServiceManager dans la section Déploiements de la page Aperçu du gestionnaire de services.
Cliquez sur Détails, puis sur l'icône en forme de crayon en regard de la section Détails du déploiement pour ouvrir la boîte de dialogue permettant de modifier le chemin d'accès au répertoire de base GoldenGate.
Mettez à jour le chemin du répertoire de base Oracle GoldenGate avec le chemin complet vers le nouveau répertoire de base Oracle GoldenGate.
Cliquez sur Appliquer.
Utilisez la liste déroulante Action pour redémarrer le gestionnaire de services.

Si vous utilisez XAG, mettez à jour les paramètres d'instance GoldenGate :
```
 $ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient
```
REMARQUE : Si vous utilisez XAG, les déploiements gérés par le gestionnaire de services mis à niveau doivent également être mis à niveau. Il n'est pas pris en charge d'exécuter des déploiements sous un gestionnaire de services à l'aide d'une autre version du logiciel GoldenGate vers le gestionnaire de services.

Mettre à niveau un déploiement

Pour mettre à niveau un déploiement, procédez comme suit :

Arrêtez progressivement tous les processus Extract et Replicat :
- Vérifiez la présence d'une transaction ouverte (à longue durée d'exécution) et d'une récupération délimitée car l'arrêt progressif de l'extraction peut prendre plus de temps.
- Si des transactions ouvertes inutiles sont visibles, par exemple SEND EXTRACT group_name SHOWTRANS, ces transactions peuvent être ignorées ou immédiatement arrêtées. Dans ce cas, un point de reprise Bounded Recovery peut être extrait à l'aide de la commande suivante :
  
  SEND EXTRACT group_name, BR BRCHECKPOINT immediate
Vérifiez l'emplacement actuel du répertoire de base Oracle GoldenGate 26ai à partir du gestionnaire de services.
1. Connectez-vous au gestionnaire de services : http://hostname:servicemanager_port
2. Développez le lien ServiceManager dans la section Deployments de la page d'accueil du gestionnaire de services.
3. Copiez le chemin du répertoire de base Oracle GoldenGate.
Revenez à la section Déploiements et développez le lien du déploiement à mettre à niveau.
Cliquez sur Détails, puis sur l'icône en forme de crayon en regard de la section Détails du déploiement pour ouvrir la boîte de dialogue permettant de modifier le chemin d'accès au répertoire de base GoldenGate.
Mettez à jour le chemin du répertoire de base Oracle GoldenGate avec le chemin d'accès complet au nouveau répertoire de base Oracle GoldenGate.
Cliquez sur Soumettre et vérifiez que le chemin d'accès au répertoire de base Oracle GoldenGate a été mis à jour.
Selon la base de données du déploiement en cours de mise à niveau, des modifications supplémentaires peuvent être apportées aux paramètres de variable d'environnement.

Cliquez sur Configuration pour modifier les paramètres des variables d'environnement, si nécessaire.

(Oracle GoldenGate pour Oracle AI Database uniquement), la fonctionnalité de build unifié nécessite uniquement que TNS_ADMIN soit ajusté au logiciel client Oracle Database dans Oracle GoldenGate.

TNS_ADMIN = emplacement de tnsnames.ora et sqlnet.ora

La variable d'environnement OGG_HOME peut détecter automatiquement les éléments DATABASE_HOME, LD_LIBRARY_PATH et JAVA_HOME. Remarque : lors de la mise à niveau de 21c vers 26ai, cette étape n'est pas nécessaire. Si vous effectuez une mise à niveau d'Oracle GoldenGate 19c (ou version antérieure) vers 26ai, vous avez uniquement besoin de la variable d'environnement TNS_ADMIN.

(Oracle GoldenGate pour SQL Server uniquement) Oracle GoldenGate 26ai pour SQL Server sur Linux inclut un pilote ODBC pour la connectivité de base de données. Bien qu'il ne soit pas nécessaire, il est recommandé d'utiliser le pilote emballé. Pour utiliser le pilote packagé, deux nouvelles variables d'environnement doivent être créées et tout fichier odbc.ini précédemment créé doit être mis à jour.

Ajoutez les variables d'environnement suivantes au déploiement :
- ODBCSYSINI = ${OGG_HOME}/msodbc
- ODBCINI = ${OGG_HOME}/msodbc/odbc.ini
Après avoir créé les nouvelles variables d'environnement, copiez votre fichier odbc.ini existant dans le dossier GoldenGate msodbc et modifiez la valeur du pilote ODBC d'une entrée DSN comme suit :
```
Driver=Microsoft ODBC Driver for SQL Server
```
Cliquez sur Soumettre pour enregistrer les modifications apportées aux variables d'environnement.
Revenez à la page d'accueil du gestionnaire de services.
Cliquez sur l'icône Redémarrer dans le champ Actions du déploiement, puis sur OK pour redémarrer le déploiement.
Reconnectez-vous au nouveau service d'administration et démarrez tous les processus d'extraction et de réplication.

Si vous utilisez XAG, réactivez l'instance GoldenGate après avoir mis à niveau le déploiement :
```
 $ agctl enable goldengate <GoldenGate Name>
```

Lorsque le gestionnaire de services et les déploiements ont été redémarrés, la mise à niveau est terminée.

Remarque : pour Oracle GoldenGate pour PostgreSQL, reportez-vous à Etapes après la mise à niveau avant de démarrer des extractions.