Menginstal AlloyDB Omni untuk Linux

Pilih versi dokumentasi:

Anda dapat melakukan penginstalan instance tunggal AlloyDB Omni di mesin Linux atau server bare metal yang mendukung runtime RHEL 9.

Untuk mulai menggunakan model deployment ini, kirimkan formulir ini untuk meminta akses.

Sebelum memulai

Sebelum menginstal AlloyDB Omni, baca Merencanakan penginstalan AlloyDB Omni.

Buat direktori tempat AlloyDB Omni menyimpan data

Jika Anda menggunakan sistem penyimpanan yang menjalankan AlloyDB Omni bersama dengan aplikasi lain, Anda dapat membuat direktori AlloyDB Omni di sistem file yang ada di perangkat Anda. Atau, Anda dapat membuat sistem file baru di perangkat khusus Anda.

Sistem file yang ada

Untuk membuat direktori di sistem file yang ada, jalankan perintah berikut:

mkdir -p DATA_DIR

Ganti variabel berikut:

  • DATA_DIR: jalur direktori host tempat data Anda disimpan.

Perangkat khusus

Untuk membuat direktori di sistem file khusus, lakukan langkah-langkah berikut:

  1. Buat direktori di host tempat disk akan dipasang.

    mkdir -p MOUNT_POINT

    Ganti variabel berikut:

    • MOUNT_POINT: jalur direktori tingkat teratas yang harus berisi instance AlloyDB Omni Anda.

  2. Buat tabel partisi dan sistem file gpt, lalu pasang perangkat disk.

    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

    Ganti variabel berikut:

    • DEVICE_PATH: jalur yang ditetapkan oleh sistem operasi ke perangkat disk.
    • FS_LABEL: label untuk sistem file. Panjang maksimum adalah 12 karakter untuk xfs.
    • PARTITION_PATH: jalur untuk partisi disk yang digunakan untuk menyimpan data sistem file.

    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

    Ganti variabel berikut:

    • DEVICE_PATH: jalur yang ditetapkan oleh sistem operasi ke perangkat disk.
    • FS_LABEL: label untuk sistem file. Panjang maksimum adalah 16 karakter untuk ext4.
    • PARTITION_PATH: jalur untuk partisi disk yang digunakan untuk menyimpan data sistem file.

  3. Buat direktori data di sistem file ini. Sebaiknya buat DATA_DIR sebagai subdirektori di dalam titik pemasangan—misalnya, MOUNT_POINT/17.

    mkdir -p DATA_DIR

    Ganti DATA_DIR dengan jalur direktori host untuk menyimpan data terkait database—misalnya, MOUNT_POINT/17.

Mengonfigurasi kebijakan SELinux

Instal paket policycoreutils-python-utils yang diperlukan agar kebijakan SELinux dikonfigurasi untuk mengizinkan layanan database AlloyDB Omni saat menginstal paket RPM AlloyDB Omni.

Menginstal AlloyDB Omni

  1. Konfigurasi repositori YUM di direktori lokal Anda.

    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

    Ganti ALLOYDB_OMNI_URL dengan URL AlloyDB Omni yang Anda terima setelah mendaftar untuk mendapatkan akses.

  2. Instal paket RPM AlloyDB Omni.

    sudo dnf install alloydbomni17

  3. Lakukan inisialisasi dan konfigurasi database AlloyDB Omni.

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

    Secara opsional, Anda dapat meneruskan opsi initdb standar sebagai satu string dalam variabel POSTGRES_INITDB_ARGS.

  4. Siapkan database AlloyDB Omni.

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

  5. Opsional. Untuk eksekusi layanan AlloyDB Omni yang dioptimalkan, jalankan perintah berikut.

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

  6. Mulai layanan systemd AlloyDB Omni.

    sudo systemctl enable alloydbomni17
$ sudo systemctl start alloydbomni17

  7. Periksa apakah layanan AlloyDB Omni berhasil berjalan.

    sudo systemctl status alloydbomni17

    Berikut adalah contoh respons. Pastikan statusnya aktif (berjalan).

        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 "

Langkah berikutnya