Installer AlloyDB Omni pour Linux

Sélectionnez une version de la documentation :

Vous pouvez installer des instances uniques d'AlloyDB Omni sur n'importe quelle machine Linux ou serveur Bare Metal compatible avec les environnements d'exécution RHEL 9.

Pour commencer à utiliser ce modèle de déploiement, remplissez ce formulaire pour demander l'accès.

Avant de commencer

Avant d'installer AlloyDB Omni, consultez Planifier votre installation AlloyDB Omni.

Créer un répertoire dans lequel AlloyDB Omni stocke les données

Si vous utilisez un système de stockage qui exécute AlloyDB Omni avec d'autres applications, vous pouvez créer le répertoire AlloyDB Omni sur le système de fichiers existant de votre appareil. Sinon, vous pouvez créer un système de fichiers sur votre appareil dédié.

Système de fichiers existant

Pour créer un répertoire dans un système de fichiers existant, exécutez la commande suivante :

mkdir -p DATA_DIR

Remplacez la variable suivante :

  • DATA_DIR : chemin d'accès au répertoire hôte dans lequel vos données sont stockées.

Appareil dédié

Pour créer un répertoire dans un système de fichiers dédié, procédez comme suit :

  1. Créez un répertoire sur l'hôte où le disque sera installé.

    mkdir -p MOUNT_POINT

    Remplacez la variable suivante :

    • MOUNT_POINT : chemin d'accès au répertoire de premier niveau qui doit contenir votre instance AlloyDB Omni.

  2. Créez une table de partitionnement et un système de fichiers gpt, puis installez le périphérique de disque.

    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

    Remplacez les variables suivantes :

    • DEVICE_PATH : chemin d'accès attribué par le système d'exploitation au périphérique de disque.
    • FS_LABEL : libellé du système de fichiers. La longueur maximale est de 12 caractères pour xfs.
    • PARTITION_PATH : chemin d'accès à la partition de disque utilisée pour stocker les données du système de fichiers.

    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

    Remplacez les variables suivantes :

    • DEVICE_PATH : chemin d'accès attribué par le système d'exploitation au périphérique de disque.
    • FS_LABEL : libellé du système de fichiers. La longueur maximale est de 16 caractères pour ext4.
    • PARTITION_PATH : chemin d'accès à la partition de disque utilisée pour stocker les données du système de fichiers.

  3. Créez un répertoire de données dans ce système de fichiers. Nous vous recommandons de créer DATA_DIR en tant que sous-répertoire à l'intérieur du point de montage, par exemple MOUNT_POINT/17.

    mkdir -p DATA_DIR

    Remplacez DATA_DIR par le chemin d'accès au répertoire hôte dans lequel stocker les données liées à la base de données (par exemple, MOUNT_POINT/17).

Configurer la stratégie SELinux

Installez le package policycoreutils-python-utils requis afin que la règle SELinux soit configurée pour autoriser le service de base de données AlloyDB Omni lors de l'installation du package RPM AlloyDB Omni.

Installer AlloyDB Omni

  1. Configurez le dépôt YUM dans votre répertoire 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

    Remplacez ALLOYDB_OMNI_URL par l'URL AlloyDB Omni que vous recevez après votre inscription.

  2. Installez le package RPM AlloyDB Omni.

    sudo dnf install alloydbomni17

  3. Initialisez et configurez la base de données AlloyDB Omni.

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

    Vous pouvez également transmettre les options initdb standards sous forme de chaîne unique dans la variable POSTGRES_INITDB_ARGS.

  4. Si vous utilisez un répertoire de données personnalisé, exécutez les commandes suivantes pour configurer SELinux afin d'autoriser le service AlloyDB Omni à lire et à écrire des données dans ce répertoire. Cette étape nécessite l'installation du package policycoreutils-python-utils.

    /usr/sbin/semanage fcontext -a -t postgresql_db_t "DATA_DIR(/.*)?"

    /sbin/restorecon -R -F DATA_DIR

  5. Préparez la base de données AlloyDB Omni.

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

  6. Facultatif. Pour une exécution optimisée du service AlloyDB Omni, exécutez la commande suivante.

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

    L'exécution de la commande précédente définit les configurations système suivantes sur leurs valeurs recommandées :

    Événement de paramètres système Valeur recommandée
    /sys/kernel/mm/transparent_hugepage/shmem_enabled within_size
    /sys/kernel/mm/transparent_hugepage/khugepaged/max_ptes_swap 511
    /sys/kernel/mm/transparent_hugepage/khugepaged/max_ptes_shared 511
    /proc/sys/vm/nr_overcommit_hugepages valeur égale à la taille de MemTotal en Mo
    /proc/sys/vm/max_map_count 1073741824

    Pour transmettre des valeurs personnalisées pour ces configurations, incluez des arguments au format <system_setting>=<value> dans la commande alloydbomni17-setup-host, comme dans l'exemple suivant :

    sudo /usr/lib/postgresql/17/bin/alloydbomni17-setup-host /proc/sys/vm/max_map_count=2097152 /proc/sys/vm/nr_overcommit_hugepages=524288

  7. Démarrez le service systemd AlloyDB Omni.

    sudo systemctl enable alloydbomni17

    sudo systemctl start alloydbomni17

  8. Vérifiez que le service AlloyDB Omni s'exécute correctement.

    sudo systemctl status alloydbomni17

    Voici un exemple de réponse : Vérifiez que l'état est "actif" (en cours d'exécution).

        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 "

Étapes suivantes