Instalar o AlloyDB Omni usando RPM

Selecione uma versão da documentação:

É possível fazer instalações de instância única do AlloyDB Omni em qualquer máquina Linux ou servidor Bare Metal que ofereça suporte a ambientes de execução do RHEL 9.

Para começar a usar esse modelo de implantação, envie este formulário para solicitar acesso.

Antes de começar

Antes de instalar o AlloyDB Omni, leia Planejar a instalação do AlloyDB Omni.

Criar um diretório em que o AlloyDB Omni armazena dados

Se você estiver usando um sistema de armazenamento que executa o AlloyDB Omni com outros aplicativos, poderá criar o diretório do AlloyDB Omni no sistema de arquivos atual do dispositivo. Caso contrário, crie um novo sistema de arquivos no dispositivo dedicado.

Sistema de arquivos atual

Para criar um diretório em um sistema de arquivos atual, execute o seguinte comando:

mkdir -p DATA_DIR

Substitua a seguinte variável:

  • DATA_DIR: o caminho do diretório do host em que seus dados são armazenados.

Dispositivo dedicado

Para criar um diretório em um sistema de arquivos dedicado, siga estas etapas:

  1. Crie um diretório no host em que o disco será ativado.

    mkdir -p MOUNT_POINT

    Substitua a seguinte variável:

    • MOUNT_POINT: caminho do diretório de nível superior que precisa conter a instância do AlloyDB Omni.

  2. Crie uma tabela de partição gpt e um sistema de arquivos e ative o 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

    Substitua as seguintes variáveis:

    • DEVICE_PATH: caminho atribuído pelo sistema operacional ao dispositivo de disco.
    • FS_LABEL: rótulo do sistema de arquivos. O comprimento máximo é de 12 caracteres para xfs.
    • PARTITION_PATH: caminho da partição de disco usada para armazenar os dados do sistema de arquivos.

    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

    Substitua as seguintes variáveis:

    • DEVICE_PATH: caminho atribuído pelo sistema operacional ao dispositivo de disco.
    • FS_LABEL: rótulo do sistema de arquivos. O comprimento máximo é de 16 caracteres para ext4.
    • PARTITION_PATH: caminho da partição de disco usada para armazenar os dados do sistema de arquivos.

  3. Crie um diretório de dados nesse sistema de arquivos. Recomendamos que você crie DATA_DIR como um subdiretório dentro do ponto de montagem, por exemplo, MOUNT_POINT/18.

    mkdir -p DATA_DIR

    Substitua DATA_DIR pelo caminho do diretório do host para armazenar dados relacionados ao banco de dados, por exemplo, MOUNT_POINT/18.

Configurar a política do SELinux

Instale o pacote policycoreutils-python-utils necessário para que a política SELinux seja configurada para permitir o serviço de banco de dados do AlloyDB Omni durante a instalação do pacote RPM do AlloyDB Omni.

Instalar o AlloyDB Omni

  1. Configure o repositório YUM no diretório local.

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

    sudo yum makecache

    Substitua ALLOYDB_OMNI_URL pelo URL do AlloyDB Omni que você recebe depois de se inscrever para acesso.

  2. Instale o pacote RPM do AlloyDB Omni.

    sudo dnf install alloydbomni18

  3. Inicialize e configure o banco de dados do AlloyDB Omni.

    sudo PGPASSWORD=POSTGRES_PASSWORD PGDATA=DATA_DIR /usr/lib/postgresql/18/bin/alloydbomni18-setup initdb

    Opcionalmente, você pode transmitir opções initdb padrão como uma única string na variável POSTGRES_INITDB_ARGS.

  4. Se você estiver usando um diretório de dados personalizado, execute os comandos a seguir para configurar o SELinux e permitir que o serviço do AlloyDB Omni leia e grave dados nesse diretório. Esta etapa exige que o pacote policycoreutils-python-utils esteja instalado.

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

    sudo PWFILE=PASSWORD_FILE_PATH PGDATA=DATA_DIR /usr/lib/postgresql/18/bin/alloydbomni18-setup initdb

    Substitua as seguintes variáveis:

    • POSTGRES_PASSWORD: sua senha.
    • PASSWORD_FILE_PATH: o caminho que contém apenas a senha em texto simples.
    • DATA_DIR: o caminho do diretório do host para armazenar dados relacionados ao banco de dados. Por exemplo, MOUNT_POINT/18.

    Opcionalmente, você pode transmitir opções initdb padrão como uma única string na variável POSTGRES_INITDB_ARGS.

  5. Se você estiver usando um diretório de dados personalizado e o SELinux estiver ativado, execute os comandos a seguir para configurar o SELinux e permitir que o serviço do AlloyDB Omni leia e grave dados nesse diretório. Esta etapa exige que o pacote policycoreutils-python-utils esteja instalado.

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

  6. Prepare o banco de dados do AlloyDB Omni.

    sudo PGPASSWORD=POSTGRES_PASSWORD /usr/lib/postgresql/18/bin/alloydbomni18-setup preparedb

  7. Opcional. Para execução otimizada do serviço do AlloyDB Omni, execute o comando a seguir.

    sudo /usr/lib/postgresql/18/bin/alloydbomni18-setup-host

    A execução do comando anterior define as seguintes configurações do sistema para os valores recomendados:

    Configuração do sistema Valor recomendado
    /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 valor igual ao tamanho do MemTotal em MB
    /proc/sys/vm/max_map_count 1073741824

    Para transmitir valores personalizados para essas configurações, inclua argumentos no formato <system_setting>=<value> no comando alloydbomni18-setup-host, como no exemplo a seguir:

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

  8. Inicie o serviço systemd do AlloyDB Omni.

    sudo systemctl enable alloydbomni18

    sudo systemctl start alloydbomni18

  9. Verifique se o serviço do AlloyDB Omni está em execução.

    sudo systemctl status alloydbomni18

    Confira um exemplo de resposta. Verifique se o status está ativo (em execução).

        Loaded: loaded (/usr/lib/systemd/system/alloydbomni18.service; enabled; preset: disabled)
   Drop-In: /etc/systemd/system/alloydbomni18.service.d
     Active: active (running) since Wed 2025-11-19 07:37:31 UTC; 1 day 6h ago "
   Process: 120228 ExecStartPre=/usr/lib/postgresql/18/bin/alloydbomni18-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/alloydbomni18.service
            ├─120231 /usr/lib/postgresql/18/bin/postgres -D /var/lib/postgresql/18/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 "

A seguir