Effectuer une mise à niveau de version mineure pour AlloyDB Omni à l'aide de RPM

Sélectionnez une version de la documentation :

Cette page explique comment effectuer une mise à niveau de version mineure de base de données pour AlloyDB Omni à l'aide de Red Hat Package Manager (RPM), vérifier l'installation mise à niveau et revenir à une version mineure antérieure si nécessaire. Les mises à niveau de versions mineures mettent à jour les binaires de la base de données sur place et préservent les fichiers de configuration et de données existants sans nécessiter de migration de données.

Les instructions de cette page s'appliquent aux déploiements autonomes à nœud unique et aux nœuds de base de données individuels dans des topologies multinœuds, telles que les déploiements avec des instances répliquées avec accès en lecture ou des nœuds de secours à haute disponibilité. Tenez compte des points suivants en fonction de votre configuration :

  • Topologies multinœuds : mettez toujours à niveau tous les nœuds d'instance répliquée et de secours avant de mettre à niveau le nœud principal. Dans une configuration à haute disponibilité, effectuez une commutation vers un nœud de secours mis à niveau avant de mettre à niveau l'ancien nœud principal.
  • Agent Monitoring (alloydbomni_monitor) : si vous avez installé le package alloydbomni_monitor facultatif, mettez à niveau alloydbomni_monitor en même temps que alloydbomni18 sur chaque hôte.

Avant de commencer

  1. Planifiez un intervalle de maintenance ou un bref temps d'arrêt du service, car la mise à niveau du package nécessite l'arrêt temporaire du service de base de données.
  2. Nous vous recommandons de sauvegarder complètement votre base de données avant de commencer la mise à niveau. Pour en savoir plus, consultez Présentation de la sauvegarde et de la restauration.
  3. Si vous mettez à niveau une topologie multinœud, identifiez le nœud principal actuel et tous les nœuds de secours ou instances répliquées afin de pouvoir d'abord mettre à niveau les nœuds de secours et les instances répliquées.
  4. Vérifiez la version actuelle de votre base de données AlloyDB Omni avant de procéder à la mise à niveau :

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

Rechercher les mises à jour disponibles

Mettez à jour le cache de votre package local et recherchez les versions ultérieures du package alloydbomni18 :

sudo dnf makecache
sudo dnf check-update alloydbomni18

Si vous avez installé le package alloydbomni_monitor, vérifiez également si des mises à jour sont disponibles pour l'agent de surveillance :

sudo dnf check-update alloydbomni_monitor

Valider un dépôt privé

Facultatif : Si vous gérez des packages via un dépôt YUM privé ou dans un environnement sans accès à Internet, vous pouvez exécuter les commandes suivantes pour inspecter la configuration de votre dépôt et vérifier les versions de package disponibles :

  1. Définissez la variable d'environnement REPOID sur l'ID de votre dépôt privé :

    export REPOID=REPO_ID

    Remplacez REPO_ID par l'ID de votre dépôt YUM privé, par exemple alloydbomni.

  2. Vérifiez quel dépôt a fourni votre installation AlloyDB Omni actuelle :

    sudo dnf list installed alloydbomni18
  3. Répertoriez tous les dépôts activés et leurs ID :

    sudo dnf repolist
  4. Affichez les métadonnées de votre dépôt privé :

    sudo dnf repoinfo $REPOID
  5. Répertoriez toutes les versions du package alloydbomni18 disponibles dans vos dépôts :

    sudo dnf --showduplicates list available alloydbomni18

Mettre à niveau AlloyDB Omni

Pour mettre à niveau votre installation AlloyDB Omni vers une version mineure ultérieure, procédez comme suit sur chaque nœud. Dans une topologie multinœud, effectuez ces étapes sur chaque nœud de secours ou instance répliquée avant de mettre à niveau le nœud principal :

  1. Arrêtez le service de base de données AlloyDB Omni :

    sudo systemctl stop alloydbomni18

    Si vous avez installé le service alloydbomni_monitor, arrêtez-le également :

    sudo systemctl stop alloydbomni_monitor
  2. Installez le package RPM AlloyDB Omni mis à jour :

    sudo dnf upgrade -y alloydbomni18

    Cette commande met à jour les packages et les binaires AlloyDB Omni tout en laissant intact le répertoire de données de votre base de données.

    Si vous avez installé le package alloydbomni_monitor, mettez-le à niveau en même temps que le package de base de données :

    sudo dnf upgrade -y alloydbomni_monitor
  3. Démarrez le service AlloyDB Omni systemd :

    sudo systemctl start alloydbomni18

    Si vous avez arrêté le service alloydbomni_monitor, redémarrez-le :

    sudo systemctl start alloydbomni_monitor

Vérifier la mise à niveau

Après avoir mis à niveau les packages RPM et démarré les services, vérifiez que le service de base de données exécute la version mise à jour :

  1. Vérifiez l'état du service AlloyDB Omni et confirmez qu'il est active (running) :

    sudo systemctl status alloydbomni18

    Si vous avez mis à niveau alloydbomni_monitor, vérifiez que le service de surveillance est également active (running) :

    sudo systemctl status alloydbomni_monitor
  2. Connectez-vous à la base de données et vérifiez que la version mise à niveau est active :

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

Effectuer un rollback de la mise à niveau

Si vous devez rétablir la version mineure précédente de votre installation AlloyDB Omni, procédez comme suit :

  1. Arrêtez le service de base de données AlloyDB Omni :

    sudo systemctl stop alloydbomni18

    Si vous avez installé le service alloydbomni_monitor, arrêtez-le également :

    sudo systemctl stop alloydbomni_monitor
  2. Répertoriez toutes les versions disponibles du package alloydbomni18 et identifiez la chaîne de version exacte de votre installation précédente :

    sudo dnf --showduplicates list alloydbomni18
  3. Revenez à la version précédente du package alloydbomni18 :

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    Remplacez ROLLBACK_VERSION par la chaîne de version exacte de votre installation précédente, par exemple 18.1.0-3.rhel9.

    Si vous devez également rétrograder alloydbomni_monitor, listez ses versions disponibles et rétrogradez vers la version précédente du package de surveillance :

    sudo dnf --showduplicates list alloydbomni_monitor
    sudo dnf downgrade -y alloydbomni_monitor-MONITOR_ROLLBACK_VERSION

    Remplacez MONITOR_ROLLBACK_VERSION par la chaîne de version du package alloydbomni_monitor précédente.

  4. Démarrez le service AlloyDB Omni systemd :

    sudo systemctl start alloydbomni18

    Si vous avez arrêté le service alloydbomni_monitor, redémarrez-le :

    sudo systemctl start alloydbomni_monitor
  5. Vérifiez que le service AlloyDB Omni est actif et qu'il exécute la version précédente :

    sudo systemctl status alloydbomni18
    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

Étapes suivantes