Gérer vos déploiements OCI GoldenGate

Découvrez les versions de GoldenGate, comment et quand mettre à niveau, recevoir ou mettre en veille des notifications et comment annuler des mises à niveau.

A propos des versions GoldenGate

OCI GoldenGate prend en charge plusieurs versions simultanées, par exemple Oracle GoldenGate, Oracle GoldenGate for Big Data et Oracle GoldenGate for MySQL, pour n'en nommer que quelques-unes. Reportez-vous à la référence des versions pour plus de détails sur la version qui vous convient.

Chaque version a un numéro de build. Il existe trois types de version :

• Major : le premier numéro de build indique une version majeure. Exemple : 21.

• Bundle : le deuxième chiffre indique la version du bundle. Une version de bundle est un ensemble de corrections de bogues pour une version majeure. Exemple : 21.5

• Minor : les numéros de fin indiquent une version mineure. Une version mineure consiste en un ou plusieurs correctifs de bogues sur une version de bundle. Exemple : 21.5.0.0.0.

Remarque : tous les types de version peuvent contenir des correctifs de sécurité.

Selon le type de version et s'il inclut ou non un correctif de sécurité, vous disposez d'un délai spécifique pour mettre à niveau votre déploiement lorsqu'une nouvelle version devient disponible :

Type de version	Majeure	Regroupement	Mineure
Correction de non sécurité	365 jours	180 jours	Non applicable.
Correction de sécurité	Non applicable.	14 jours	14 jours

Si vous n'effectuez pas de mise à niveau manuelle au cours de la période donnée, le déploiement passe automatiquement à la dernière version à la fin de cette période.

Remarque : vous pouvez voir la date jusqu'à laquelle une version est prise en charge dans l'écran de déploiement de mise à niveau et dans la liste Mises à niveau.

Abandon des versions

Une version de GoldenGate est disponible à partir de la date de publication jusqu'à la date d'abandon. Lorsqu'une version est en phase d'abandon, vous ne pouvez plus la sélectionner pour la création ou la mise à niveau du déploiement.

Les périodes d'abandon utilisent les mêmes périodes que les mises à niveau de version. Exemple :

• 365 jours après une version majeure, la version majeure précédente est en phase d'abandon.

• 180 jours après la publication d'une version du bundle, les versions précédentes du bundle de la même version majeure sont obsolètes.

• 14 jours après la publication d'un correctif de sécurité (pour les versions Bundle ou Minor), toutes les versions précédentes de la même version Major sont obsolètes.

Remarque : à partir d'avril 2027, tous les déploiements de réplication de données 21c seront automatiquement mis à niveau vers la dernière version disponible. Les dates de publication peuvent différer d'une région à l'autre.

Programmer les mises à niveau

Vous pouvez personnaliser les fenêtres de maintenance qui définissent quand mettre à niveau votre déploiement. Si vous ne définissez pas de fenêtre de maintenance, OCI GoldenGate calcule le meilleur moment pour mettre à niveau le déploiement en fonction de la date de version de la dernière version, puis met automatiquement à niveau le déploiement pendant le week-end le plus proche de la fin calculée de la période de mise à niveau automatique.

Remarque : lorsqu'une nouvelle version d'une version majeure, d'un bundle ou d'une version mineure est publiée, OCI GoldenGate programme une mise à niveau pour vous en fonction de son calendrier applicable (365 jours pour la version majeure, 180 jours pour la version bundle, 14 jours pour la version mineure avec correctif de sécurité). Si une version plus récente de la même version devient disponible, le service met à niveau votre déploiement à l'aide de la dernière version disponible, mais la date programmée reste inchangée.

Vous pouvez personnaliser la fenêtre de maintenance OCI GoldenGate lorsque vous créez le déploiement ou lorsque vous modifiez un déploiement existant. Lorsqu'une nouvelle version de GoldenGate est disponible, le déploiement est automatiquement mis à niveau le jour et l'heure exacts choisis. Toutefois, il est possible que les déploiements soient mis à niveau automatiquement avant le jour et l'heure de votre choix, lorsque la période de mise à niveau manuelle choisie n'est pas comprise dans la fenêtre de maintenance.

Par exemple, le 1er janvier, il vous reste 30 jours pour mettre à niveau votre déploiement, puis jusqu'au mardi 31 janvier pour effectuer une mise à niveau manuelle. Cependant, votre fenêtre de maintenance personnalisée commence le dimanche à 10PM. Avec cette fenêtre de maintenance, OCI GoldenGate mettra à niveau votre déploiement le dimanche suivant à 10PM, car OCI GoldenGate donne toujours la priorité à votre fenêtre personnalisée.

Pour modifier la fenêtre de maintenance personnalisée :

1. Sur la page de détails du déploiement, sous GoldenGate dans la zone d'informations Déploiement, dans Maintenance, sélectionnez Modifier.

2. Dans la boîte de dialogue Modifier les paramètres de maintenance :

   1. (Facultatif) Sélectionnez Personnaliser la fenêtre de maintenance pour remplacer les valeurs par défaut des champs suivants.

   2. Pour Période de mise à niveau automatique de version majeure en jours, entrez une valeur comprise entre 0 et 365.

   3. Pour la période de mise à niveau automatique de version de bundle en jours, entrez une valeur comprise entre 0 et 180.

   4. Pour Période de mise à niveau automatique du chemin de sécurité en jours, entrez une valeur comprise entre 0 et 14.

   5. (Facultatif) Sélectionnez Activer la mise à niveau automatique de version mineure, puis entrez une valeur pour Période de mise à niveau automatique de version mineure en jours.

3. Sélectionnez Enregistrer les modifications.

Avant de mettre à niveau

Avant de mettre à niveau un déploiement, assurez-vous d'effectuer les tâches suivantes et de rechercher les transactions à longue durée d'exécution.

Assurez-vous que les journaux d'archivage sont disponibles pour la récupération

Utilisez la commande suivante dans le client d'administration pour déterminer le journal d'archivage le plus ancien que vous devrez peut-être restaurer au démarrage de l'extraction. Le champ Recovery Checkpoint affiche le journal le plus ancien nécessaire à la récupération.

Admin Client > INFO EXTRACT group_name, SHOWCH

Il est préférable d'effectuer des activités de mise à niveau en dehors des heures de pointe. S'il existe des transactions volumineuses et à longue durée d'exécution, vous pouvez considérer que sur le système source, le nouveau processus Extract devra peut-être commencer le traitement à partir du point de reprise de récupération normal. que le point de reprise de récupération limité, si le premier enregistrement de la transaction ouverte la plus ancienne au moment où vous arrêtez le processus Extract se trouve dans un journal qui ne se trouve pas sur le système.

Effacer les transactions longues

Pour effacer les transactions à longue durée d'exécution, vous disposez de deux options :

• Vous pouvez restaurer les archives vers, et y inclure, celle indiquée dans le point de reprise de récupération affiché avec :

  Admin Client > INFO EXTRACT

  (Si la base de données source le prend en charge.)

• Vous pouvez effacer les transactions à longue durée d'exécution qui s'appliquent à l'extraction que vous mettez à niveau. Pour ce faire, vous pouvez ignorer les transactions ou les forcer à accéder à la trace en tant que transactions validées. Ignorer une transaction peut entraîner une perte de données et forcer une transaction à la trace peut ajouter des données indésirables à la trace si la transaction est annulée. Pour ignorer ou forcer une transaction :

  1. Consulter les transactions en cours :

     Admin Client > SEND EXTRACT group_name, SHOWTRANS

  2. Enregistrez l'ID de transaction de toute transaction que vous souhaitez nettoyer.

  3. Nettoyez les anciennes transactions à l'aide de SEND EXTRACT et de l'option SKIPTRANS pour ignorer une transaction, ou de FORCETRANS pour forcer une transaction dans son état actuel à la trace en tant que transaction validée. Exemple :

     Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]}

  4. Une fois que vous avez fini de nettoyer les transactions à longue durée d'exécution, forcez un point de reprise Bounded Recovery.

     Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Synchroniser les répliques

Pour les déploiements avec des processus Replicat en parallèle, veillez à synchroniser les processus Replicat avant la mise à niveau :

Admin Client > SYNCHRONIZE REPLICAT group_name

Pour plus d'informations, reportez-vous à la référence de l'interface de ligne de commande SYNCHRONIZE REPLICAT.

Mise à niveau d'un déploiement

Veillez à effectuer d'abord les étapes Avant la mise à niveau.

Lors de la mise à niveau d'un déploiement :

• Le déploiement est arrêté puis redémarré une fois la mise à niveau terminée.

• Tous les processus Oracle GoldenGate sont arrêtés puis redémarrés si le démarrage automatique est configuré pour ces derniers.

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

1. Sur la page Déploiements, sélectionnez le déploiement à mettre à niveau.

2. Sur la page de détails du déploiement, dans le menu Actions, sélectionnez Mettre à niveau.

3. Dans le panneau Mettre à niveau le déploiement, sélectionnez une version GoldenGate disponible vers laquelle effectuer la mise à niveau, puis sélectionnez Mettre à niveau.

Remarque : en savoir plus sur les versions.

La mise à niveau prend quelques minutes. Sélectionnez Mises à niveau sur la page de détails du déploiement, une fois la mise à niveau terminée, pour visualiser l'historique des mises à niveau ou si un problème est détecté lors du processus de mise à niveau.

Mettre à niveau les tables de signal d'activité

Vous devez également mettre à niveau les tables de signal d'activité si elles sont utilisées dans votre déploiement. Une fois la mise à niveau terminée, vous pouvez :

• Exécutez la commande UPGRADE HEARTBEATTABLE dans le client d'administration pour ajouter des colonnes supplémentaires pour les tables et les vues de décalage. GoldenGate utilise ces colonnes supplémentaires pour suivre la position de redémarrage de l'extraction. En savoir plus.

• Dans la console de déploiement, ouvrez le menu de navigation de la console d'administration, puis sélectionnez Configuration. Connexion à la base de données. Lorsque les tables de signal d'activité apparaissent, sélectionnez Mettre à niveau dans le menu Action.

Créer des notifications de mise à niveau

OCI GoldenGate peut vous envoyer des notifications d'événement lorsqu'une mise à niveau est disponible et lorsqu'une mise à niveau est programmée. Pour plus d'informations, reportez-vous à Types d'événement de mise à niveau GoldenGate ou à En savoir plus sur les événements.

Mettre votre solution à niveau	< 180 jours	< 30 jours	< 7 jours
Période de notification	Tous les 30 jours	Tous les 7 jours	Tous les jour

Remarque : OCI GoldenGate envoie chaque jour une notification pour les correctifs de sécurité.

Vous pouvez également découvrir les mises à niveau à venir à partir des bannières de notification qui apparaissent sur la page de détails du déploiement.

Pour créer une notification de mise à niveau :

1. Assurez-vous que les stratégies suivantes ont été ajoutées pour votre location :

   allow group ContextualNotificationsUsers to manage ons-topics in tenancy
   allow group ContextualNotificationsUsers to manage cloudevents-rules in tenancy

2. Sur la page Déploiements, sélectionnez le déploiement pour lequel vous voulez configurer des notifications.

3. Sur la page de détails du déploiement, sélectionnez Surveillance.

4. Sur la page Monitoring, faites défiler la page jusqu'à Notifications.

5. Dans le panneau Créer une notification, vous pouvez sélectionner Démarrage rapide pour créer une notification à partir d'un ensemble de modèles.

6. Dans la liste déroulante Sélection de modèle, sélectionnez l'une des options suivantes :

   • Une mise à niveau de déploiement est disponible, pour recevoir une notification indiquant qu'un build de déploiement plus récent est disponible.

   • La maintenance de mise à niveau de déploiement est programmée, afin de recevoir une notification indiquant qu'une mise à niveau est programmée.

7. Dans la section Sujets et abonnements, créez ou sélectionnez un sujet existant.

8. Sélectionnez au moins un protocole d'abonnement :

   • Adresse électronique, puis entrez une adresse valide.

   • Slack, puis entrez l'adresse Slack.

     Envoie un message au canal Slack indiqué par défaut lorsque vous publiez un message sur le sujet parent de l'abonnement.

     Format d'adresse (URL) :

     https://hooks.slack.com/services/<webhook-token>

     L'élément <webhook-token> doit contenir deux barres obliques (/). Les paramètres de requête ne sont pas autorisés dans les URL. Afin d'établir une adresse pour un abonnement Slack (à l'aide d'un webhook pour le canal Slack), reportez-vous à la documentation de Slack.

   • SMS, puis sélectionnez le code du pays et entrez le numéro de téléphone.

9. (Facultatif) Modifiez les paramètres par défaut (type d'événement ou gravité d'alarme) répertoriés ci-dessus dans Sujet et abonnements.

10. Sélectionnez Créer une notification.

11. Confirmez les nouveaux abonnements, si nécessaire. Pour plus d'informations, voir Confirmation d'un abonnement.

Des messages sont envoyés aux entrées d'informations de contact chaque fois que la condition de la notification est satisfaite.

Mise en veille des notifications

Vous pouvez mettre en veille ou retarder les notifications d'événements et de bannières. La période de répétition change à mesure que vous approchez de la fin de la période de mise à niveau manuelle.

Mettre votre solution à niveau	< 180 jours	< 30 jours	< 7 jours
Période de répétition	30 jours	7 jours	Non autorisé

Remarque : la mise en veille des correctifs de sécurité des mises à niveau mineures ou groupées n'est pas autorisée.

Vous pouvez annuler la mise en veille à tout moment.

Annuler les mises à niveau

Vous pouvez annuler (rollback) une version de déploiement vers la précédente. L'annulation (rollback) n'est autorisée que pour la dernière mise à niveau réussie vers sa version précédente.

Remarque : lors de l'annulation (rollback), le dernier état du système de fichiers de déploiement est restauré avant la mise à niveau.

L'annulation n'est pas autorisée lorsque la version précédente est en phase d'abandon.

Pour annuler une mise à niveau :

1. Sur la page Déploiements, sélectionnez le déploiement que vous souhaitez annuler.

2. Sur la page de détails du déploiement, sélectionnez Mises à niveau.

3. Dans la liste Mises à niveau, localisez la version précédente la plus récente, puis sélectionnez Annuler dans le menu Action.

4. Sélectionnez la version vers laquelle annuler, puis sélectionnez Annuler.

Remarque : Pour obtenir la liste des versions disponibles, voir Référence des versions.

La mise à jour du statut du déploiement prend quelques minutes.

Replanifier les mises à niveau

Vous pouvez replanifier vos mises à niveau planifiées automatiquement. Vous pouvez replanifier la mise à niveau à une date plus proche ou la reporter à une date ultérieure.

Remarque : La replanification ne prend pas en compte les fenêtres de maintenance. La nouvelle date programmée ne peut pas être postérieure à la valeur définie par OCI GoldenGate. Pour plus d'informations, reportez-vous à A propos des versions GoldenGate.

Pour reprogrammer une mise à niveau :

1. Sur la page Déploiements, sélectionnez le déploiement dont vous souhaitez reprogrammer la mise à niveau.

2. Sur la page de détails du déploiement, sélectionnez Mises à niveau.

3. Dans la liste Mises à niveau, localisez la version précédente la plus récente, puis sélectionnez Replanifier dans le menu Action.

4. Dans la fenêtre Replanifier la mise à niveau du déploiement, sélectionnez la date et l'heure d'exécution de la mise à niveau.

5. Sélectionnez Enregistrer les modifications.

Dans la liste Mises à niveau, la date et l'heure planifiées reflètent les modifications.

Annuler les mises à niveau

Vous ne pouvez annuler une mise à niveau programmée automatiquement que si la version cible est une version mineure.

Remarque : l'annulation d'une mise à niveau vers une version mineure ne désactivera pas implicitement les mises à niveau automatiques pour les versions mineures et devra être désactivée manuellement. Vous pouvez désactiver la mise à niveau automatique des versions mineures à partir de la page de détails du déploiement. Pour plus d'informations, reportez-vous à Planification des mises à niveau.

Pour annuler une mise à niveau :

1. Sur la page Déploiements, sélectionnez le déploiement dont vous souhaitez annuler la mise à niveau.

2. Sur la page de détails du déploiement, sélectionnez Mises à niveau.

3. Dans la liste Mises à niveau, localisez la version précédente la plus récente, puis sélectionnez Annuler dans le menu Action.

4. Dans la fenêtre Annuler la mise à niveau du déploiement, sélectionnez Annuler la mise à niveau du déploiement.

Le statut de la mise à niveau est mis à jour sur Annulé.

Problèmes recensés

Après la mise à niveau vers Oracle GoldenGate 23.26.x, erreur de la console de déploiement 502 Bad Gateway ou échec de la liste des processus GoldenGate après la connexion

Les déploiements Oracle Cloud Infrastructure GoldenGate 23.26 peuvent devenir en mauvais état après la mise à niveau des libellés précédents vers la version 23.26.x ou après l'exécution d'une opération d'arrêt/de démarrage sur un déploiement 23.26.x.

Solution de contournement : la mise à niveau a eu un impact sur les déploiements Oracle pour étiqueter oggoracle:23.26.1.0.0_260331, afin de résoudre ce problème.

Pour le Big Data et les autres libellés non Oracle, un correctif sera annoncé prochainement. Contactez le support technique pour l'atténuation manuelle provisoire afin d'éviter l'impact.

Problèmes lors de la restauration des versions 21.15 ou 23.x vers la version 21.14

Lors de la tentative d'annulation (rollback) d'une version 21.15 ou 23.x vers l'une des versions suivantes :

• Oracle (21.14.0.0.0_240525)

• Big Data (21.14.0.0.0_240515),

• MySQL (21.14.0.0.0_240404)

• MSSQL (21.14.0.0.0_240404)

Vous pouvez rencontrer l'un des problèmes suivants :

• Problème de connexions/informations d'identification manquant en raison de la nouvelle fonctionnalité de cryptage de portefeuille introduite à partir de la version 21.15.

  Solution : vous devez annuler l'affectation et réaffecter les connexions existantes au déploiement, et recréer les utilisateurs manquants requis pour les chemins de distribution ou de destinataire en cours d'utilisation.

• Echec du démarrage du gestionnaire de services en raison d'un problème lié au service de mesures de performances lors des annulations de la version 23.x à la version 21.14. Contactez le support technique Oracle si vous rencontrez ce problème.

• Echec des processus Oracle GoldenGate avec l'erreur "OGG-02431 En-tête d'enregistrement non valide trouvé dans le fichier de point de reprise".

  Solution : mettez à niveau le déploiement vers la version 21.14 la plus récente disponible dans la série. Contactez le support technique Oracle si le problème persiste.