En esta página, se muestra la documentación de la versión 15.5.4 de AlloyDB Omni.
Consulta la documentación más reciente de AlloyDB Omni.

Se usó la API de Cloud Translation para traducir esta página.

Cómo migrar de la versión 15.5.2 de AlloyDB Omni y versiones anteriores a la versión más reciente

A partir de AlloyDB Omni 15.5.4, puedes controlar AlloyDB Omni con herramientas comunes de administración de paquetes.

Si tienes una instalación existente de AlloyDB Omni, sigue las instrucciones de esta página para migrar a la nueva instalación de una sola imagen.

Requisitos previos

Antes de comenzar a actualizar a la versión más reciente de AlloyDB Omni, completa los siguientes requisitos previos, si aún no lo hiciste.

Actualiza a AlloyDB Omni 15.5.2

La versión más reciente de AlloyDB Omni que admite la CLI de AlloyDB Omni es la 15.5.2. Para verificar la versión de AlloyDB Omni, ejecuta el siguiente comando:

sudo alloydb version

El resultado es similar al siguiente:

AlloyDB Omni CLI version: 1.6
AlloyDB Omni database server version: 15.5.2

Si el resultado muestra una versión de base de datos anterior a la 15.5.2, ejecuta el siguiente comando para actualizar:

sudo alloydb database-server upgrade

Recopila información sobre tu instalación existente

Ejecuta el siguiente comando:
```
cat /var/alloydb/config/dataplane.conf
```
En el resultado del comando cat, anota los valores de las siguientes variables para tu referencia:
- DATADIR_PATH (por ejemplo, /var/alloydb/main)
- ENABLE_ALLOYDB_AI (por ejemplo, FALSE)
- PGPORT (por ejemplo, 5432)
- INSTANCE_TYPE (por ejemplo, PRIMARY/READ_REPLICA)

Realiza una actualización in situ

Detén la base de datos existente:
```
sudo alloydb database-server stop
```
Inicia la nueva imagen única de AlloyDB Omni y activa el directorio de datos existente de antes:
```
docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=PASSWORD \
    -e PGDATA=/var/lib/postgresql/data \
    -v /var/alloydb/main/data:/var/lib/postgresql/data \
    -v /dev/shm:/dev/shm \
    -p PGPORT:5432 \
    --network=host \
    --ulimit=nice=-20:-20 \
    --ulimit=core=-1:-1 \
    --log-driver=journald \
    -d google/alloydbomni:15.5.4
```
Reemplaza lo siguiente:
- CONTAINER_NAME: Es el nombre que se asignará a este nuevo contenedor de AlloyDB Omni en el registro de contenedores de la máquina anfitrión, por ejemplo, my-omni.
- PASSWORD: Es la contraseña asignada al usuario postgres del contenedor nuevo después de su creación.
- PGPORT: Es la dirección IP del puerto en el que se ejecuta AlloyDB Omni. Este es el valor que anotaste en el paso 2 de Recopila información sobre tu instalación existente.
Los argumentos de docker run son los que se usan en versiones anteriores de AlloyDB Omni, pero puedes personalizarlos aún más. Consulta Cómo personalizar tu instalación de AlloyDB Omni para obtener más información.

Si el tipo de instancia de tu base de datos es PRIMARY, ejecuta el siguiente comando para crear los siguientes usuarios. Estos son nombres de usuario que no se usan en este momento, pero que se reservan para extensiones futuras.

for name in alloydbagent alloydbexport alloydbiamgroupuser alloydbiamuser alloydbimportexport alloydbobservability alloydbsqllogical alloydbsuperuser; do
  echo docker exec -it CONTAINER_NAME psql -h localhost -U postgres alloydbadmin \
    -c "CREATE ROLE ${name} NOLOGIN;" \
    -c "CREATE TABLE ${name}_table();" \
    -c "ALTER TABLE ${name}_table OWNER TO ${name};"
done

Si ENABLE_ALLOYDB_AI está configurado como TRUE, sigue las instrucciones que se indican en Cómo instalar AlloyDB Omni con AlloyDB AI para configurar AlloyDB AI.
Conéctate a la base de datos para verificar que los datos no hayan cambiado:
```
docker exec -it CONTAINER_NAME psql -h localhost -U postgres
```
Desinstala la CLI de AlloyDB Omni:
```
sudo alloydb database-server uninstall
```
La desinstalación de la CLI de AlloyDB Omni no afecta los datos almacenados en AlloyDB Omni.