Instalar 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 Bare Metal que admita tiempos de ejecución de RHEL 9.

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

Antes de empezar

Antes de instalar AlloyDB Omni, consulta el artículo Planificar la 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 de tu dispositivo. De lo contrario, puedes crear un nuevo sistema de archivos en tu dispositivo dedicado.

Sistema de archivos actual

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

mkdir -p DATA_DIR

Sustituye la siguiente variable:

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

Dispositivo especializado

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

  1. Crea un directorio en el host donde se montará el disco.

    mkdir -p MOUNT_POINT

    Sustituye la siguiente variable:

    • MOUNT_POINT: ruta del directorio de nivel superior que debe contener tu instancia de AlloyDB Omni.

  2. Crea una gpt tabla de particiones y un sistema de archivos, y monta 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

    Sustituye las siguientes variables:

    • DEVICE_PATH: ruta asignada por el sistema operativo al dispositivo de disco.
    • FS_LABEL: etiqueta del sistema de archivos. La longitud máxima es de 12 caracteres para xfs.
    • PARTITION_PATH: ruta de 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

    Sustituye las siguientes variables:

    • DEVICE_PATH: ruta asignada por el sistema operativo al dispositivo de disco.
    • FS_LABEL: etiqueta del sistema de archivos. La longitud máxima es de 16 caracteres para ext4.
    • PARTITION_PATH: ruta de 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 subdirectorio dentro del punto de montaje. Por ejemplo, MOUNT_POINT/17.

    mkdir -p DATA_DIR

    Sustituye 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.

Configurar la política de SELinux

Instala el paquete policycoreutils-python-utils necesario para que la política SELinux se configure de forma que permita el servicio de base de datos AlloyDB Omni al instalar el paquete RPM de AlloyDB Omni.

Instalar AlloyDB Omni

  1. Configura el repositorio 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

    Sustituye ALLOYDB_OMNI_URL por la URL de AlloyDB Omni que recibas 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

    También puedes enviar opciones estándar de initdb 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. Opcional. Para optimizar la ejecución del servicio 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. Comprueba si el servicio AlloyDB Omni se está ejecutando correctamente.

    sudo systemctl status alloydbomni17

    A continuación, se muestra un ejemplo de respuesta. Comprueba que el estado sea 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 "

Siguientes pasos