Tenir à jour vos déploiements OCI GoldenGate

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

Rubriques connexes

Versions d'OCI GoldenGate

À propos des versions GoldenGate

OCI GoldenGate prend en charge plusieurs versions concurrentes, par exemple Oracle GoldenGate, Oracle GoldenGate pour le service de mégadonnées et Oracle GoldenGate pour MySQL, pour n'en nommer que quelques-unes. Reportez-vous à la référence de version pour plus de détails sur la version qui vous convient.

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

Majeure : Le premier nombre dans le numéro de compilation indique une version majeure. Par exemple, 21.
Offre groupée : Le deuxième nombre indique le lancement de l'offre groupée. Une version groupée est un ensemble de correctifs de bogues pour une version majeure. Par exemple, 21.5
Minor : Les numéros de fin indiquent une version mineure. Une version mineure consiste en une ou plusieurs corrections de bogues sur une version d'ensemble. Par exemple, 21.5.0.0.0.

Note :

Tous les types de version peuvent contenir des correctifs de sécurité.

Selon le type de version et si elle 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	Majeur	Offre groupée	Mineur
Correctif de non-sécurité	365 jours	180 jours	Sans objet
Correctif de sécurité	Sans objet	14 jours	14 jours

Si vous ne procédez pas à une mise à niveau manuelle au cours de la période indiquée, votre déploiement passe automatiquement à la dernière version à la fin de cette période.

Note :

Vous pouvez voir la date à laquelle une version est prise en charge jusqu'à ce qu'elle se trouve dans l'écran de déploiement de la mise à niveau et dans la liste Mises à niveau.

Obsolète des versions

Une version GoldenGate est disponible à partir de la date à laquelle elle a été publiée jusqu'à la date à laquelle elle est obsolète. Lorsqu'une version est obsolète, 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. Par exemple :

365 jours après une version majeure, la version majeure précédente est obsolète.
180 jours après une version de l'offre groupée, les versions précédentes de la même version majeure sont obsolètes.
14 jours après la publication d'un correctif de sécurité (pour les versions groupées ou mineures), toutes les versions précédentes de la même version majeure sont obsolètes.

Note :

La date de publication peut différer d'une région à l'autre.

Programmer les mises à niveau

Vous pouvez personnaliser les fenêtres de maintenance qui définissent le début de la période au cours de laquelle mettre à niveau votre déploiement lorsqu'une nouvelle version de GoldenGate est disponible. 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.

Note :

Lorsqu'aucune fenêtre de maintenance n'est définie, OCI GoldenGate programme les mises à niveau le week-end le plus proche de la fin calculée de la période de mise à niveau automatique.

Vous pouvez personnaliser la fenêtre de maintenance OCI GoldenGate lorsque vous créez le déploiement, ou plus tard à partir de la page des détails du déploiement. Lorsqu'une nouvelle version de GoldenGate est disponible, le déploiement est automatiquement mis à niveau le jour et l'heure précis choisis. Toutefois, les déploiements peuvent être mis à niveau automatiquement avant le jour et l'heure que vous avez choisis lorsque la période de mise à niveau manuelle de la nouvelle version n'est pas comprise dans la fenêtre de maintenance personnalisée.

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

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

Dans la page des détails du déploiement, sous GoldenGate dans la zone d'informations sur le déploiement, pour Maintenance, cliquez sur Modifier.
Dans la boîte de dialogue Modifier les paramètres de maintenance :
1. (Facultatif) Sélectionnez Personnaliser la fenêtre de maintenance pour modifier les champs suivants à partir de leurs valeurs par défaut.
2. Pour Période de mise à niveau automatique des versions majeures en jours, entrez une valeur comprise entre 0 et 365.
3. Pour Période de mise à niveau automatique des versions groupées 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 des versions mineures, puis entrez une valeur pour Période de mise à niveau automatique des versions mineures, en jours.
Cliquez sur Enregistrer les modifications.

Avant la mise à niveau

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

Assurez-vous que les journaux d'archives 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 requis pour 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 de longue durée, vous pouvez considérer que sur le système source, le nouveau processus d'extraction doit commencer le traitement à partir du point de reprise normal. au point de reprise limité, si le premier enregistrement de la transaction ouverte la plus ancienne au moment de l'arrêt de l'extraction figure dans un journal qui n'est pas sur le système.

Effacer les transactions de longue durée

Pour effacer des transactions de longue durée, vous disposez de deux options :

Vous pouvez restaurer les archives en y incluant celles qui figurent dans le point de reprise indiqué avec :
```
Admin Client > INFO EXTRACT
```
(Si la base de données source le prend en charge.)
Vous pouvez effacer les transactions de longue durée 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. L'omission d'une transaction peut entraîner une perte de données, et le fait de forcer une transaction vers la piste peut ajouter des données indésirables à la piste si la transaction est annulée. Pour ignorer ou forcer une transaction :
1. Voir les transactions ouvertes :
```
Admin Client > SEND EXTRACT group_name, SHOWTRANS
```
2. Enregistrez l'ID de la 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 courant vers la piste en tant que transaction validée. Par exemple :
```
Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]
```
4. Après avoir terminé le nettoyage des transactions de longue durée, forcez un point de reprise Bounded Recovery.
```
Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE
```

Synchroniser les réplicats

Pour les déploiements avec des répliques parallèles, assurez-vous de synchroniser les répliques avant la mise à niveau :

Admin Client > SYNCHRONIZE REPLICAT group_name

Pour plus d'informations, voir référence à l'interface de ligne de commande SYNCHRONIZE REPLICAT.

Mettre à niveau un déploiement

Assurez-vous d'abord d'effectuer les étapes Avant la mise à niveau.

Lorsque vous mettez à niveau 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 s'ils sont configurés pour démarrer automatiquement.

Pour mettre à niveau un déploiement :

Dans la page Déploiements, sélectionnez le déploiement à mettre à niveau.
Dans la page des détails du déploiement, dans le menu Actions, sélectionnez Mettre à niveau.
Dans le panneau Mettre à niveau le déploiement, sélectionnez une version GoldenGate disponible vers laquelle effectuer la mise à niveau, puis cliquez sur Mettre à niveau.

Note :
Pour plus d'informations sur les versions.

La mise à niveau prend quelques minutes. Cliquez sur Mises à niveau dans la page Détails du déploiement une fois la mise à niveau terminée pour voir l'historique de mise à niveau ou si un problème est survenu lors du processus de mise à niveau.

Mettre à niveau les tables de pulsation

Vous devez également mettre à niveau les tables Heartbeat 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 cliquez sur Configuration. Se connecter à la base de données. Lorsque des tables de pulsations apparaissent, sélectionnez Upgrade dans le menu Action.

Avis de mise à niveau

OCI GoldenGate vous envoie des notifications d'événement pour savoir quand une mise à niveau est disponible et quand une mise à niveau est programmée. Pour plus d'informations, voir GoldenGate Types d'événement de mise à niveau ou En savoir plus sur les événements.

Temps de mise à niveau	< 180 jours	< 30 jours	< 7 jours
Période d'avis	Tous les 30 jours	Tous les 7 jours	Tous les jours

Note :

OCI GoldenGate envoie un avis pour les correctifs de sécurité tous les jours.

Vous pouvez également en savoir plus sur les mises à niveau à venir à partir des bannières d'avis qui apparaissent dans la page des détails du déploiement.

Répéter les avis

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

Temps de mise à niveau	< 180 jours	< 30 jours	< 7 jours
Période de mise en veille	30 jours	7 jours	Non autorisé

Note :

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

Vous pouvez annuler le snooze à tout moment.

Repositionner les mises à niveau

Vous pouvez annuler une version de déploiement vers la version précédente. Le repositionnement n'est autorisé que pour la dernière mise à niveau réussie vers sa version précédente.

Note :

Lors du repositionnement, le système de fichiers de déploiement est restauré à son dernier état avant la mise à niveau.

Le repositionnement n'est pas autorisé lorsque la version précédente est obsolète.

Pour annuler une mise à niveau :

Dans la page Deployments, sélectionnez le déploiement à repositionner.
Dans la page des détails du déploiement, sélectionnez Mises à niveau.
Dans la liste Mises à niveau, localisez la version précédente la plus récente, puis, dans son menu d'actions, sélectionnez Repositionner.
Sélectionnez la version vers laquelle effectuer le repositionnement, puis cliquez sur Repositionner.

Note :
Consultez la référence sur les versions pour obtenir la liste des versions disponibles.

Le statut de votre déploiement passe à Mise à jour et prend quelques minutes.

Reprogrammer les mises à niveau

Vous pouvez reprogrammer les mises à niveau programmées automatiquement. Vous pouvez reprogrammer la mise à niveau à une date plus proche ou la reporter à une date ultérieure.

Note :

La reprogrammation 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 GoldenGate pour OCI. Pour plus d'informations, voir À propos des versions de GoldenGate.

Pour reprogrammer une mise à niveau :

Dans la page Deployments, sélectionnez le déploiement dont vous souhaitez reprogrammer la mise à niveau.
Dans la page des détails du déploiement, sélectionnez Mises à niveau.
Dans la liste Mises à niveau, localisez la version précédente la plus récente, puis, dans son menu d'actions, sélectionnez Reprogrammer.
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.
Cliquez sur Enregistrer les modifications.

Dans la liste Mises à niveau, la date et l'heure prévues 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.

Note :

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 des détails du déploiement. Voir Programmer les mises à niveau pour plus d'informations.

Pour annuler une mise à niveau :

Dans la page Deployments, sélectionnez le déploiement dont vous voulez annuler la mise à niveau.
Dans la page des détails du déploiement, sélectionnez Mises à niveau.
Dans la liste Mises à niveau, localisez la version précédente la plus récente, puis, dans son menu d'actions, sélectionnez Annuler.
Dans la fenêtre Annuler la mise à niveau du déploiement, cliquez sur Annuler la mise à niveau du déploiement.

Le statut de la mise à niveau est réglé à Annulé.

Problèmes connus

Problèmes rencontrés lors du repositionnement de versions 21.15 ou 23.x à 21.14

Lors d'une tentative de repositionnement d'une compilation 21.15 ou 23.x vers :

Oracle (21.14.0.0.0_240525)
Mégadonnées (21.14.0.0.0.0_240515)
MySQL (21.14.0.0_2404040404)
MSSQL (21-14-0-0-0-0-240404)

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

Problème de connexions/données d'identification manquant en raison de la nouvelle fonction de chiffrement du portefeuille introduite à partir de la version 21.15.
Solution de rechange : Vous devez annuler l'affectation et réaffecter les connexions existantes au déploiement et recréer les utilisateurs manquants requis pour tous les chemins Distribution ou Destinataire en cours d'utilisation.
Échec du démarrage du gestionnaire de services en raison d'un problème avec le service de mesures de performance dans les annulations de la version 23.x à la version 21.14. Communiquez avec Oracle Support si vous rencontrez ce problème.
Les processus Oracle GoldenGate échouent avec l'erreur "OGG-02431 En-tête d'enregistrement non valide trouvé dans le fichier de point de reprise".
Solution de rechange : Mettez à niveau le déploiement vers la dernière version 21.14 disponible dans la série. Communiquez avec Oracle Support si le problème persiste.

Titre et Copyright

Oracle et/ou ses sociétés affiliées.