Menyesuaikan penginstalan AlloyDB Omni

Catatan: Penggunaan AlloyDB Omni oleh Anda tunduk pada perjanjian antara Anda dan Google yang mengatur penawaran Google Cloud . Jika Anda tidak memiliki akun Google Cloud , atau belum membuat perjanjian dengan Google yang mengatur penawaran Google Cloud , jangan lanjutkan atau download software ini hingga Anda melakukannya. Untuk membuat akun Google Cloud , lihat halaman beranda Google Cloud .

Halaman ini menunjukkan cara mendownload, menginstal, dan terhubung ke AlloyDB Omni. Untuk memulai dengan cepat AlloyDB Omni menggunakan konfigurasi default, lihat Menginstal AlloyDB Omni di Debian atau Ubuntu.

Dalam dokumen ini, Anda juga akan mempelajari cara melakukan hal berikut:

• Buat partisi disk baru untuk mengoptimalkan penyimpanan data.
• Konfigurasi server Anda.
• Memastikan kompatibilitas dengan Debian, Ubuntu, dan RHEL.

Sebelum memulai

Persyaratan sistem

Debian

• Mesin virtual atau fisik yang menjalankan OS berbasis Debian, seperti Debian atau Ubuntu.
• Minimal 2 CPU, dengan arsitektur x86/AMD64.
• RAM minimum 2 GB. Untuk performa yang optimal, sebaiknya alokasikan RAM 8 GB untuk setiap CPU.
• Penyimpanan yang tersedia minimal 20 GB.
• Akses root tidak terbatas dalam OS.
• Docker versi 20.10 atau yang lebih tinggi.
• Kernel Linux versi 4.18 atau yang lebih tinggi. Sebaiknya gunakan kernel versi 5.3 atau yang lebih tinggi untuk performa terbaik.
• Cgroup v2 Linux diaktifkan.

  Secara default, cgroup v2 diaktifkan di sebagian besar sistem Linux modern. Untuk memeriksa apakah cgroup v2 diaktifkan, jalankan stat -fc %T /sys/fs/cgroup/ di shell. Jika cgroup v2 diaktifkan, output perintah akan menampilkan cgroup2fs.

• Jika ingin berintegrasi dengan Vertex AI, Anda memerlukan Google Cloud CLI yang tersedia di lingkungan Anda.

• Untuk menginstal AlloyDB Omni di platform cloud, sebaiknya gunakan jenis instance berikut:
  • Di Google Cloud, sebaiknya gunakan instance n2-highmem.
  • Di Amazon Web Services, sebaiknya gunakan instance R6i.
  • Di Microsoft Azure, sebaiknya gunakan instance Ebsv5.
• Sebaiknya gunakan perangkat penyimpanan SSD khusus untuk menyimpan data Anda. Jika Anda menggunakan perangkat fisik untuk tujuan ini, sebaiknya lampirkan langsung ke mesin host.

RHEL

• Virtual machine atau mesin fisik yang menjalankan Red Hat Enterprise Linux (RHEL) versi 8 atau yang lebih baru. Agar fitur pengelolaan memori otomatis AlloyDB Omni berfungsi, gunakan RHEL versi 9 atau yang lebih baru.
• Minimal 2 CPU, dengan arsitektur x86/AMD64.
• RAM minimum 2 GB. Untuk performa yang optimal, sebaiknya alokasikan RAM 8 GB untuk setiap CPU.
• Penyimpanan yang tersedia minimal 20 GB.
• Akses root tidak terbatas dalam OS.
• Docker versi 20.10 atau yang lebih tinggi.
• Kernel Linux versi 4.18 atau yang lebih tinggi. Sebaiknya gunakan kernel versi 5.3 atau yang lebih tinggi untuk performa terbaik.
• Cgroup v2 Linux diaktifkan.

  Secara default, cgroup v2 diaktifkan di sebagian besar sistem Linux modern. Untuk memeriksa apakah cgroup v2 diaktifkan, jalankan stat -fc %T /sys/fs/cgroup/ di shell. Jika cgroup v2 diaktifkan, output perintah akan menampilkan cgroup2fs.

• Jika ingin berintegrasi dengan Vertex AI, Anda memerlukan Google Cloud CLI yang tersedia di lingkungan Anda.

• Untuk menginstal AlloyDB Omni di platform cloud, sebaiknya gunakan jenis instance berikut:
  • Di Google Cloud, sebaiknya gunakan instance n2-highmem.
  • Di Amazon Web Services, sebaiknya gunakan instance R6i.
  • Di Microsoft Azure, sebaiknya gunakan instance Ebsv5.
• Sebaiknya gunakan perangkat penyimpanan SSD khusus untuk menyimpan data Anda. Jika Anda menggunakan perangkat fisik untuk tujuan ini, sebaiknya lampirkan langsung ke mesin host.

Mendownload dan menginstal AlloyDB Omni

Catatan: Untuk menginstal AlloyDB Omni versi terbaru, lihat Menyesuaikan penginstalan AlloyDB Omni.

1. Instal AlloyDB Omni CLI.

2. Gunakan CLI AlloyDB Omni untuk mengonfirmasi bahwa komputer Linux Anda siap menginstal AlloyDB Omni:

   sudo alloydb system-check

   Jika perlu, ubah sistem Anda hingga output perintah system-check menampilkan pemeriksaan yang berhasil.

3. Opsional: Untuk membuat partisi disk baru yang akan digunakan AlloDB Omni untuk penyimpanan data, sebaiknya gunakan sistem file ext4 untuk performa yang optimal.

   1. Untuk membuat sistem file ext4, gunakan perintah berikut:

      mkfs.ext4 -m 1 -F "$disk_path"

   2. Untuk memasang disk, gunakan perintah berikut:

      mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"

4. Instal software server menggunakan salah satu opsi berikut:

   Catatan: Untuk menginstal AlloyDB Omni dengan fungsi machine learning (ML) yang diaktifkan, termasuk kemampuan untuk membuat kueri model bahasa besar (LLM), lihat Menginstal AlloyDB Omni dengan AlloyDB AI.

   • Untuk mengonfigurasi server sebagai instance utama, jalankan perintah berikut:

     sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)

     Ganti DATA_DIR dengan direktori di sistem file lokal Anda tempat Anda ingin AlloyDB Omni menyimpan data, metadata, dan file konfigurasinya. AlloyDB Omni mencoba membuat direktori ini jika belum ada. Jika Anda tidak menentukan nilai ini, AlloyDB Omni akan ditetapkan secara default ke /var/alloydb/main/.

     Agar AlloyDB Omni memproses koneksi di port TCP selain 5432 default, sertakan tanda --pg-port:

     sudo alloydb database-server install \
         --data-dir=$(realpath DATA_DIR) \
         --pg-port=PORT

     Ganti PORT dengan port TCP yang ingin Anda gunakan untuk menerima koneksi AlloyDB Omni.

   • Untuk mengonfigurasi server sebagai replika baca, sertakan flag --replica-source-ip dan --replica-source-port:

     sudo alloydb database-server install \
         --data-dir=$(realpath DATA_DIR) \
         --replica-source-ip=SOURCE_IP \
         --replica-source-port=SOURCE_PORT

     Ganti kode berikut:

     • DATA_DIR: direktori pada sistem file lokal Anda tempat Anda ingin AlloyDB Omni menyimpan data, metadata, dan file konfigurasinya. AlloyDB Omni mencoba membuat direktori ini jika belum ada. Jika Anda tidak menentukan nilai ini, AlloyDB Omni akan ditetapkan secara default ke /var/alloydb/main/.

     • SOURCE_IP: alamat IP instance AlloyDB Omni utama yang akan direplikasi.

     • SOURCE_PORT: port TCP instance AlloyDB Omni utama yang akan direplikasi. Jika Anda tidak memberikan nilai ini, AlloyDB Omni akan menerapkan nilai default 5432.

     Untuk mengetahui informasi selengkapnya tentang replika baca AlloyDB Omni, lihat Membuat replika hanya baca.

5. Jika sistem Anda menjalankan Red Hat Enterprise Linux, perbarui file /usr/lib/tuned/virtual-guest/tuned.conf dengan hal berikut:

   vm.swappiness=1
   

Menghubungkan ke dan menggunakan server database

Terhubung ke AlloyDB Omni menggunakan psql:

sudo docker exec -it pg-service psql -h localhost -U postgres

Jendela terminal menampilkan teks login psql yang diakhiri dengan perintah postgres=#.