Instala AlloyDB Omni para Linux

Selecciona una versión de la documentación:

Puedes realizar instalaciones de una sola instancia de AlloyDB Omni en cualquier máquina Linux o servidor físico que admita tiempos de ejecución de RHEL 9.

Para comenzar a usar este modelo de implementación, envía este formulario para solicitar acceso.

Antes de comenzar

Antes de instalar AlloyDB Omni, lee Planifica tu instalación de AlloyDB Omni.

Crea un directorio en el que AlloyDB Omni almacene datos

Si usas un sistema de almacenamiento que ejecuta AlloyDB Omni junto con otras aplicaciones, puedes crear el directorio de AlloyDB Omni en el sistema de archivos existente de tu dispositivo. De lo contrario, puedes crear un sistema de archivos nuevo en tu dispositivo dedicado.

Sistema de archivos existente

Para crear un directorio en un sistema de archivos existente, ejecuta el siguiente comando:

mkdir -p DATA_DIR

Reemplaza la siguiente variable:

  • DATA_DIR: Es la ruta de acceso al directorio del host en el que se almacenan tus datos.

Exclusivo

Para crear un directorio en un sistema de archivos dedicado, sigue estos pasos:

  1. Crea un directorio en el host en el que se activará el disco.

    mkdir -p MOUNT_POINT

    Reemplaza la siguiente variable:

    • MOUNT_POINT: Es la ruta de acceso al directorio de nivel superior que debe contener tu instancia de AlloyDB Omni.

  2. Crea una tabla de particiones gpt y un sistema de archivos, y activa el dispositivo de disco.

    EXT4

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%
mkfs.ext4 -q -m 1 -L FS_LABEL -F PARTITION_PATH
echo -e "LABEL=FS_LABEL\tMOUNT_POINT\text4\tdefaults\t0 0" | tee -a /etc/fstab
mount MOUNT_POINT

    Reemplaza las siguientes variables:

    • DEVICE_PATH: Es la ruta de acceso que el sistema operativo asigna al dispositivo de disco.
    • FS_LABEL: Es la etiqueta del sistema de archivos. La longitud máxima es de 12 caracteres para xfs.
    • PARTITION_PATH: Es la ruta de acceso a la partición del disco que se usa para almacenar los datos del sistema de archivos.

    XFS

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%
dnf install xfsprogs
mkfs.xfs -L FS_LABEL -f PARTITION_PATH
echo -e "LABEL=FS_LABEL\tMOUNT_POINT\txfs\tdefaults\t0 0" | tee -a /etc/fstab
mount MOUNT_POINT

    Reemplaza las siguientes variables:

    • DEVICE_PATH: Es la ruta de acceso que el sistema operativo asigna al dispositivo de disco.
    • FS_LABEL: Es la etiqueta del sistema de archivos. La longitud máxima es de 16 caracteres para ext4.
    • PARTITION_PATH: Es la ruta de acceso a la partición del disco que se usa para almacenar los datos del sistema de archivos.

  3. Crea un directorio de datos en este sistema de archivos. Te recomendamos que crees DATA_DIR como un subdirectorio dentro del punto de activación, por ejemplo, MOUNT_POINT/17.

    mkdir -p DATA_DIR

    Reemplaza DATA_DIR por la ruta del directorio del host en el que se almacenarán los datos relacionados con la base de datos, por ejemplo, MOUNT_POINT/17.

Configura la política de SELinux

Instala el paquete policycoreutils-python-utils requerido para que la política SELinux esté configurada para permitir el servicio de base de datos de AlloyDB Omni mientras se instala el paquete RPM de AlloyDB Omni.

Instalar AlloyDB Omni

  1. Configura el repositorio de YUM en tu directorio local.

    sudo tee -a /etc/yum.repos.d/alloydbomni.repo << EOF
[alloydbomni]
name=alloydbomni
baseurl=ALLOYDB_OMNI_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF

$ sudo yum makecache

    Reemplaza ALLOYDB_OMNI_URL por la URL de AlloyDB Omni que recibes después de registrarte para obtener acceso.

  2. Instala el paquete RPM de AlloyDB Omni.

    sudo dnf install alloydbomni17

  3. Inicializa y configura la base de datos de AlloyDB Omni.

    sudo PGPASSWORD=POSTGRES_PASSWORD PGDATA=DATA_DIR /usr/lib/postgresql/17/bin/alloydbomni17-setup initdb

    De manera opcional, puedes pasar opciones de initdb estándar como una sola cadena en la variable POSTGRES_INITDB_ARGS.

  4. Prepara la base de datos de AlloyDB Omni.

    sudo PGPASSWORD=POSTGRES_PASSWORD /usr/lib/postgresql/17/bin/alloydbomni17-setup preparedb

  5. Es opcional. Para optimizar la ejecución del servicio de AlloyDB Omni, ejecuta el siguiente comando.

    sudo /usr/lib/postgresql/17/bin/alloydbomni17-setup-host

  6. Inicia el servicio systemd de AlloyDB Omni.

    sudo systemctl enable alloydbomni17
$ sudo systemctl start alloydbomni17

  7. Verifica si el servicio de AlloyDB Omni se está ejecutando correctamente.

    sudo systemctl status alloydbomni17

    A continuación, se muestra una respuesta de ejemplo. Verifica que el estado esté activo (en ejecución).

        Loaded: loaded (/usr/lib/systemd/system/alloydbomni17.service; enabled; preset: disabled)
   Drop-In: /etc/systemd/system/alloydbomni17.service.d
     Active: active (running) since Wed 2025-11-19 07:37:31 UTC; 1 day 6h ago "
   Process: 120228 ExecStartPre=/usr/lib/postgresql/17/bin/alloydbomni17-check-db-dir ${PGDATA} (code=exited, status=0 SUCCESS)
  Main PID: 120231 (postgres)
     Tasks: 19 (limit: 203438)
    Memory: 161.7M (peak: 170.0M)
       CPU: 28min 10.149s
    CGroup: /system.slice/alloydbomni17.service
            ├─120231 /usr/lib/postgresql/17/bin/postgres -D /var/lib/postgresql/17/data
            ├─120232 "postgres: alloydb internal logger "
            ├─120233 "postgres: checkpointer "
            ├─120234 "postgres: background writer "
            ├─120237 "postgres: walwriter "
            ├─120243 "postgres: lux wal preallocator "
            ├─120244 "postgres: autovacuum launcher "
            ├─120246 "postgres: free buffer manager "
            ├─120247 "postgres: buffer control "

¿Qué sigue?