Menginstal AlloyDB Omni untuk Linux

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengetahui informasi tentang akses ke rilis ini, lihat halaman permintaan akses.

Pilih versi dokumentasi: 17.5.0

• Saat ini (17.5.0)
• 17.5.0

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, kirim 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 direktori 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.

   Catatan: Untuk rilis Pratinjau, integritas paket diverifikasi di tingkat RPM individual. Konfigurasi repo_gpgcheck=0 untuk melanjutkan konfigurasi repositori YUM.

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. Jika Anda menggunakan direktori data kustom, jalankan perintah berikut untuk mengonfigurasi SELinux agar layanan AlloyDB Omni dapat membaca dan menulis data di direktori tersebut. Langkah ini mengharuskan paket policycoreutils-python-utils diinstal.

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

   /sbin/restorecon -R -F DATA_DIR
   

5. Siapkan database AlloyDB Omni.

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

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

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

   Menjalankan perintah sebelumnya akan menetapkan konfigurasi sistem berikut ke nilai yang direkomendasikan:

   Setelan sistem	Nilai yang direkomendasikan
   /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	nilai yang sama dengan ukuran MemTotal dalam MB
   /proc/sys/vm/max_map_count	1073741824

   Untuk meneruskan nilai kustom untuk konfigurasi ini, sertakan argumen dalam format <system_setting>=<value> di perintah alloydbomni17-setup-host, seperti dalam contoh berikut:

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

7. Mulai layanan systemd AlloyDB Omni.

   sudo systemctl enable alloydbomni17
   

   sudo systemctl start alloydbomni17
   

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

• Jalankan dan hubungkan ke AlloyDB Omni.