Instalar o AlloyDB Omni para Linux

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 seja compatível com 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, crie 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 deve conter sua instância do AlloyDB Omni.

  2. Crie uma tabela de partição e um sistema de arquivos gpt 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 tamanho máximo é de 12 caracteres para xfs.
    • PARTITION_PATH: caminho para a partição do 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 tamanho máximo é de 16 caracteres para ext4.
    • PARTITION_PATH: caminho para a partição do disco usada para armazenar os dados do sistema de arquivos.

  3. Crie um diretório de dados nesse sistema de arquivos. Recomendamos criar DATA_DIR como um subdiretório dentro do ponto de montagem, por exemplo, MOUNT_POINT/17.

    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/17.

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 seu diretório 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

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

  2. Instale o pacote RPM do AlloyDB Omni.

    sudo dnf install alloydbomni17

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

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

    Também é possível transmitir opções padrão de initdb como uma única string na variável POSTGRES_INITDB_ARGS.

  4. Prepare o banco de dados do AlloyDB Omni.

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

  5. Opcional. Para uma execução otimizada do serviço AlloyDB Omni, execute o seguinte comando.

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

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

    sudo systemctl enable alloydbomni17
$ sudo systemctl start alloydbomni17

  7. Verifique se o serviço do AlloyDB Omni está sendo executado corretamente.

    sudo systemctl status alloydbomni17

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

        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 "

A seguir