Realiza una actualización de versión secundaria para AlloyDB Omni con RPM

Selecciona una versión de la documentación:

En esta página, se describe cómo realizar una actualización de la versión secundaria de la base de datos para AlloyDB Omni con Red Hat Package Manager (RPM), verificar la instalación actualizada y revertir a una versión secundaria anterior si es necesario. Las actualizaciones de versiones secundarias actualizan los objetos binarios de la base de datos in situ y conservan los archivos de configuración y datos existentes sin requerir la migración de datos.

Las instrucciones de esta página se aplican a las implementaciones independientes de un solo nodo y a los nodos de bases de datos individuales en topologías de varios nodos, como las implementaciones con réplicas de lectura o nodos en espera de alta disponibilidad. Busca las siguientes consideraciones según tu configuración:

  • Topologías de varios nodos: Siempre actualiza todos los nodos de réplica y en espera antes de actualizar el nodo principal. En una configuración de alta disponibilidad, realiza un cambio a un nodo en espera actualizado antes de actualizar el nodo principal anterior.
  • Agente de Monitoring (alloydbomni_monitor): Si instalaste el paquete opcional alloydbomni_monitor, actualiza alloydbomni_monitor junto con alloydbomni18 en cada host.

Antes de comenzar

  1. Planifica un período de mantenimiento o un breve tiempo de inactividad del servicio, ya que la actualización del paquete requiere detener temporalmente el servicio de base de datos.
  2. Te recomendamos que realices una copia de seguridad completa de tu base de datos antes de comenzar la actualización. Para obtener más información, consulta Descripción general de la copia de seguridad y el restablecimiento.
  3. Si actualizas una topología de varios nodos, identifica el nodo principal actual y todos los nodos en espera o de réplica para que puedas actualizar primero los nodos en espera y de réplica.
  4. Verifica la versión actual de tu base de datos de AlloyDB Omni antes de actualizarla:

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

Cómo comprobar si hay actualizaciones disponibles

Actualiza la caché de paquetes local y verifica si hay versiones posteriores del paquete alloydbomni18:

sudo dnf makecache
sudo dnf check-update alloydbomni18

Si instalaste el paquete alloydbomni_monitor, verifica también si hay actualizaciones disponibles para el agente de supervisión:

sudo dnf check-update alloydbomni_monitor

Verifica un repositorio privado

Opcional: Si administras paquetes a través de un repositorio de YUM privado o en un entorno sin acceso a Internet, puedes ejecutar los siguientes comandos para inspeccionar la configuración del repositorio y verificar qué versiones de paquetes están disponibles:

  1. Establece la variable de entorno REPOID en el ID de tu repositorio privado:

    export REPOID=REPO_ID

    Reemplaza REPO_ID por el ID del repositorio de tu repositorio privado de YUM, por ejemplo, alloydbomni.

  2. Verifica qué repositorio proporcionó tu instalación actual de AlloyDB Omni:

    sudo dnf list installed alloydbomni18
  3. Enumera todos los repositorios habilitados y sus IDs:

    sudo dnf repolist
  4. Visualiza los metadatos de tu repositorio privado:

    sudo dnf repoinfo $REPOID
  5. Enumera todas las versiones del paquete alloydbomni18 que están disponibles en tus repositorios:

    sudo dnf --showduplicates list available alloydbomni18

Actualiza AlloyDB Omni

Para actualizar tu instalación de AlloyDB Omni a una versión secundaria posterior, sigue estos pasos en cada nodo. En una topología de varios nodos, completa estos pasos en cada nodo de réplica o en espera antes de actualizar el nodo principal:

  1. Detén el servicio de base de datos de AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Si instalaste el servicio alloydbomni_monitor, también detenlo:

    sudo systemctl stop alloydbomni_monitor
  2. Instala el paquete RPM de AlloyDB Omni actualizado:

    sudo dnf upgrade -y alloydbomni18

    Este comando actualiza los paquetes y objetos binarios de AlloyDB Omni, pero deja intacto el directorio de datos de la base de datos.

    Si instalaste el paquete alloydbomni_monitor, actualízalo junto con el paquete de la base de datos:

    sudo dnf upgrade -y alloydbomni_monitor
  3. Inicia el servicio systemd de AlloyDB Omni:

    sudo systemctl start alloydbomni18

    Si detuviste el servicio alloydbomni_monitor, vuelve a iniciarlo:

    sudo systemctl start alloydbomni_monitor

Verifica la actualización

Después de actualizar los paquetes RPM y de iniciar los servicios, verifica que el servicio de base de datos ejecute la versión actualizada:

  1. Verifica el estado del servicio de AlloyDB Omni y confirma que sea active (running):

    sudo systemctl status alloydbomni18

    Si actualizaste alloydbomni_monitor, confirma que el servicio de supervisión también sea active (running):

    sudo systemctl status alloydbomni_monitor
  2. Conéctate a la base de datos y verifica que la versión actualizada esté activa:

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

Revierte la actualización

Si necesitas revertir la instalación de AlloyDB Omni a la versión secundaria anterior, sigue estos pasos:

  1. Detén el servicio de base de datos de AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Si instalaste el servicio alloydbomni_monitor, también detenlo:

    sudo systemctl stop alloydbomni_monitor
  2. Enumera todas las versiones disponibles del paquete alloydbomni18 y, luego, identifica la cadena de versión exacta de tu instalación anterior:

    sudo dnf --showduplicates list alloydbomni18
  3. Cambia el paquete alloydbomni18 a la versión anterior:

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    Reemplaza ROLLBACK_VERSION por la cadena de versión exacta de tu instalación anterior, por ejemplo, 18.1.0-3.rhel9.

    Si también necesitas cambiar a una versión inferior de alloydbomni_monitor, enumera sus versiones disponibles y cambia a la versión anterior del paquete de supervisión:

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

    Reemplaza MONITOR_ROLLBACK_VERSION por la cadena de versión del paquete alloydbomni_monitor anterior.

  4. Inicia el servicio systemd de AlloyDB Omni:

    sudo systemctl start alloydbomni18

    Si detuviste el servicio alloydbomni_monitor, vuelve a iniciarlo:

    sudo systemctl start alloydbomni_monitor
  5. Verifica que el servicio de AlloyDB Omni esté activo y ejecute la versión anterior:

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

¿Qué sigue?