Tenir à jour 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.
Rubriques connexes
A propos des versions de GoldenGate
OCI GoldenGate prend en charge plusieurs versions simultanées, par exemple, Oracle GoldenGate, Oracle GoldenGate pour Big Data et Oracle GoldenGate pour MySQL, pour n'en nommer que quelques-unes. Pour plus d'informations sur la version appropriée, reportez-vous à la référence des versions.
Chaque version a un numéro de build. Il existe trois types de version :
- Majeur : le premier numéro du numéro de build indique une version majeure. Exemple : 21.
- Bundle : le deuxième numéro 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 derniers numéros 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.
Remarques :
Tous les types de versions 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 | Lot | 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 indiquée, le déploiement est automatiquement mis à niveau vers la dernière version à la fin de cette période.
Remarques :
Vous pouvez afficher la date jusqu'à laquelle une version est prise en charge dans l'écran de déploiement Mise à niveau et 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 d'un 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 obsolète.
- 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 groupées ou mineures), toutes les versions précédentes de la même version majeure sont obsolètes.
Remarques :
La date de publication peut différer d'une région à l'autre.Programmer des mises à niveau
Vous pouvez personnaliser les fenêtres de maintenance qui définissent le début de la période pendant laquelle mettre à niveau le 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.
Remarques :
Lorsqu'aucune fenêtre de maintenance n'est définie, OCI GoldenGate planifie 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 ultérieurement, à partir de la page de 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 exacts choisis. Toutefois, les déploiements peuvent automatiquement être mis à niveau avant le jour et l'heure choisis lorsque la période de mise à niveau manuelle de la nouvelle version ne s'affiche pas dans la fenêtre de maintenance personnalisée.
Par exemple, disons 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 à 10PM. Avec cette fenêtre de maintenance, OCI GoldenGate mettra à niveau votre déploiement le dimanche 4 février à 10 heures, car OCI GoldenGate priorisera toujours votre fenêtre personnalisée.
Pour modifier la fenêtre de maintenance personnalisée, procédez comme suit :
- Sur la page de détails du déploiement, sous GoldenGate dans la zone d'informations Déploiement, pour Maintenance, cliquez sur Modifier.
- Dans la boîte de dialogue Modifier les paramètres de maintenance :
- (Facultatif) Sélectionnez Personnaliser la fenêtre de maintenance pour remplacer les valeurs par défaut des champs suivants.
- Pour Période de mise à niveau automatique de version majeure en jours, entrez une valeur comprise entre 0 et 365.
- Pour Période de mise à niveau automatique de la version du bundle en jours, entrez une valeur comprise entre 0 et 180.
- Pour Période de mise à niveau automatique du chemin de sécurité en jours, entrez une valeur comprise entre 0 et 14.
- (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.
- 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 à longue durée d'exécution.
Assurez-vous que les journaux d'archivage sont disponibles pour la récupération
Recovery Checkpoint affiche le journal le plus ancien nécessaire à la récupération.Admin Client > INFO EXTRACT group_name, SHOWCHIl 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 peut avoir besoin de démarrer 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 de l'arrêt du processus Extract figure 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 avez le choix entre deux options :
- Vous pouvez restaurer les archives vers, et y compris, celle affichée dans le point de reprise de récupération indiqué avec :
(Si la base de données source le prend en charge.)Admin Client > INFO EXTRACT - 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. 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 :
- Afficher les transactions non soldées :
Admin Client > SEND EXTRACT group_name, SHOWTRANS - Enregistrez l'ID de toute transaction que vous souhaitez nettoyer.
- Nettoyez les anciennes transactions à l'aide de
SEND EXTRACTet de l'optionSKIPTRANSpour ignorer une transaction, ou deFORCETRANSpour forcer une transaction dans son état actuel à passer à la trace en tant que transaction validée. Exemple :Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE] - Une fois que vous avez terminé le nettoyage des transactions à longue durée d'exécution, forcez un point de reprise de récupération limitée.
Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE
- Afficher les transactions non soldées :
Synchroniser les réplicats
Admin Client > SYNCHRONIZE REPLICAT group_namePour plus d'informations, reportez-vous à la référence d'interface de ligne de commande SYNCHRONIZE REPLICAT.
Mise à niveau d'un déploiement
Veillez à effectuer les étapes Avant de mettre à niveau en premier.
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.
La mise à niveau prend quelques minutes. Cliquez sur 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.
- Exécutez la commande
UPGRADE HEARTBEATTABLEdans le client d'administration afin d'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 d'extraction. En savoir plus. - Dans la console de déploiement, ouvrez le menu de navigation de la console d'administration, puis cliquez sur Configuration. Connexion à la base de données. Lorsque les tables Heartbeat s'affichent, sélectionnez Upgrade dans le menu Action.
Notifications 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, reportez-vous à GoldenGate Types d'événement de mise à niveau ou En savoir plus sur les événements.
| Mise à niveau | < 180 jours | < 30 jours | < 7 jours |
|---|---|---|---|
| Période de notification | Tous les 30 jours | Tous les 7 jours | Chaque jour |
Remarques :
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.
Mettre en attente les notifications
Vous pouvez mettre en veille ou retarder les notifications d'événements et de bannières. La période de mise en veille change à mesure que vous approchez de la fin de la période de mise à niveau manuelle.
| Mise à niveau | < 180 jours | < 30 jours | < 7 jours |
|---|---|---|---|
| Période de mise en veille | 30 jours | 7 jours | Non autorisé |
Remarques :
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 une version de déploiement vers la version 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.
Remarques :
Lors de l'annulation (rollback), le système de fichiers de déploiement est restauré à son dernier état avant la mise à niveau.L'annulation (rollback) n'est pas autorisée lorsque la version précédente est obsolète.
Pour annuler une mise à niveau :
- Sur la page Deployments, sélectionnez le déploiement à annuler.
- Sur la page de 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 Action, sélectionnez Annuler.
- Sélectionnez la version vers laquelle annuler, puis cliquez sur Annuler.
Remarques :
Reportez-vous à la référence de versions pour obtenir la liste des versions disponibles.
La mise à jour du statut de votre déploiement prend quelques minutes.
Replanifier les mises à niveau
Remarques :
La replanification ne prend pas en compte les fenêtres de maintenance. La date que vous venez de programmer ne peut pas être postérieure à la valeur définie par OCI GoldenGate. Pour plus d'informations, reportez-vous à A propos des versions de GoldenGate.Pour reprogrammer une mise à niveau :
- Sur la page Déploiements, sélectionnez le déploiement dont vous souhaitez reprogrammer la mise à niveau.
- Sur la page de 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 Action, sélectionnez Replanifier.
- Dans la fenêtre Replanifier la mise à niveau du déploiement, sélectionnez la date et l'heure de la mise à niveau.
- Cliquez sur Enregistrer les modifications.
Dans la liste Mises à niveau, la date et l'heure planifiées reflètent les modifications.
Annuler les mises à niveau
Remarques :
L'annulation d'une mise à niveau vers une version mineure ne désactivera pas implicitement les mises à niveau automatiques pour les versions mineures et doit ê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 à Programmation des mises à niveau.Pour annuler une mise à niveau :
- Sur la page Deployments, sélectionnez le déploiement dont vous souhaitez annuler la mise à niveau.
- Sur la page de 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 Action, 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 mis à jour sur Annulé.
Problèmes recensés
Problèmes rencontrés lors de l'annulation des versions 21.15 ou 23.x vers la version 21.14
Lors de la tentative d'annulation d'un build 21.15 ou 23.x vers :
- Oracle (21.14.0.0.0_240525)
- Big Data (21.14.0_240515)
- MySQL (21.14.0.0_2404)
- MSSQL (21.14.0.0.0_24040404)
Vous pouvez rencontrer l'un des problèmes suivants :
- Problème de connexions/informations d'identification manquantes en raison de la nouvelle fonctionnalité de cryptage de portefeuille introduite à partir de la version 21.15.
Solution de contournement : vous devez annuler l'affectation et réaffecter des connexions existantes au déploiement, et recréer les utilisateurs manquants requis pour les chemins de distribution ou de destinataire en cours d'utilisation.
- Le gestionnaire de services n'a pas pu démarrer en raison d'un problème lié au service de mesures de performances dans les annulations (rollbacks) de la version 23.x à la version 21.14. Contactez le support technique Oracle si vous rencontrez ce problème.
- Les processus Oracle GoldenGate échouent avec l'erreur suivante : "OGG-02431 Un en-tête d'enregistrement non valide a été 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.