Mengubah Pengaturan Database PostgreSQL di ServBay

ServBay menawarkan lingkungan pengembangan web lokal yang canggih bagi pengembang macOS, dengan integrasi database PostgreSQL. Dokumen ini akan memandu Anda secara rinci bagaimana mengubah pengaturan konfigurasi PostgreSQL di ServBay, termasuk metode UI yang direkomendasikan dan cara edit file manual yang hanya untuk referensi sementara.

Bergantung pada versi PostgreSQL yang dipasang di ServBay, file konfigurasi utama biasanya terletak di direktori /Applications/ServBay/etc/postgresql/<version>, misalnya untuk PostgreSQL 16, lokasinya adalah /Applications/ServBay/etc/postgresql/16.

Penting

ServBay mengelola sebagian besar pengaturan konfigurasi melalui antarmuka grafis (UI) dan secara otomatis membuat file konfigurasi yang relevan. Sangat disarankan melakukan perubahan melalui UI ServBay. Langsung mengedit file konfigurasi secara manual dapat menyebabkan perubahan Anda tertimpa saat ServBay memperbarui atau mengelola pengaturan di kemudian hari. Cara manual hanya cocok untuk pengujian sementara atau pengguna tingkat lanjut yang paham konfigurasi mendalam, dan tidak direkomendasikan untuk pengaturan jangka panjang atau produksi.

Mengubah Pengaturan Melalui UI ServBay (Disarankan)

ServBay menyediakan antarmuka grafis yang intuitif, menjadikannya metode termudah dan paling direkomendasi untuk modifikasi konfigurasi PostgreSQL Anda. Pengaturan yang diubah via UI akan diterapkan secara otomatis dan biasanya aktif secara langsung tanpa perlu restart layanan (kecuali jika ada pemberitahuan dari ServBay).

Langkah-Langkah

1. Buka aplikasi ServBay.
2. Dari navigasi sisi kiri, pilih Database.
3. Pada daftar database, temukan PostgreSQL, lalu klik versi yang ingin Anda atur.
4. Setelah masuk ke halaman konfigurasi PostgreSQL, Anda akan melihat detail dan opsi pengaturan untuk PostgreSQL versi bersangkutan.

Parameter yang Dapat Dikonfigurasi

Di halaman ini, Anda dapat melihat nama pengguna dan kata sandi default PostgreSQL yang telah diatur ServBay (biasanya ditampilkan di halaman ini). Anda juga dapat langsung mengubah beberapa parameter umum seperti:

• Alamat dengar (listen_addresses): Mengatur jaringan mana yang akan didengar PostgreSQL. Biasanya di-set ke * yang berarti semua antarmuka.
• Port (port): Port yang digunakan layanan PostgreSQL. Standarnya adalah 5432 (perhatikan ini berbeda dengan MySQL/MariaDB di 3306).
• Jumlah koneksi maksimum (max_connections): Batas jumlah maksimum klien yang dapat terkoneksi bersamaan ke database.
• Memori kerja (work_mem): Jumlah memori yang digunakan setiap proses query untuk operasi sorting dan hash.

Selain itu, pada bagian Additional Parameters, Anda dapat menambah atau mengubah parameter postgresql.conf lain yang tidak tertera eksplisit di UI ServBay. Isi per baris dengan format parameter = nilai.

Menerapkan Perubahan

Setelah selesai mengubah konfigurasi, klik tombol Simpan di bagian bawah layar. ServBay akan menerapkan perubahan Anda dengan otomatis. Untuk sebagian besar pengaturan, perubahan berlaku langsung. Jika sebuah perubahan memerlukan restart layanan, ServBay akan memberikan pemberitahuan.

Mengubah Pengaturan Melalui Edit File Manual (Tidak Disarankan untuk Pengaturan Permanen)

Seperti dijelaskan sebelumnya, edit file konfigurasi secara manual tidak disarankan untuk pengelolaan sehari-hari, sebab pengaturan ini dapat di-overwrite oleh UI ServBay. Namun, memahami lokasi dan isi file bisa bermanfaat untuk pengguna tingkat lanjut.

WARNING

Edit manual hanya untuk debugging sementara atau troubleshooting tingkat lanjut. ServBay sangat menyarankan modifikasi melalui UI untuk menjaga konsistensi dan keberlangsungan pengaturan. Isi serta lokasi file edit manual dapat berubah sewaktu-waktu akibat manajemen internal ServBay.

Lokasi File Konfigurasi

File utama konfigurasi PostgreSQL di ServBay adalah postgresql.conf dan pg_hba.conf. Lokasinya bergantung pada versi PostgreSQL, umumnya di:

• postgresql.conf: /Applications/ServBay/etc/postgresql/<version>/postgresql.conf
• pg_hba.conf: /Applications/ServBay/etc/postgresql/<version>/pg_hba.conf

Perlu dicatat, dalam dokumentasi lama mungkin ditemukan /db/postgresql/16/pg_hba.conf, namun saat ini UI ServBay mengutamakan manajemen file di bawah /Applications/ServBay/etc. Jika Anda perlu mengedit secara manual, pastikan untuk menggunakan path yang benar. Untuk konsistensi dengan UI, direktori /Applications/ServBay/etc/postgresql/<version> adalah yang paling handal.

Contoh Parameter Umum

Berikut contoh pengaturan pada postgresql.conf dan pg_hba.conf. Gunakan editor teks (seperti VS Code, Sublime, Nano, dll) dengan hak admin saat mengedit file.

postgresql.conf

postgresql.conf adalah file pengaturan utama untuk PostgreSQL, mengendalikan hampir seluruh perilaku servernya.

# Alamat dengar: Interface jaringan yang akan didengar server. '*' berarti semua.
listen_addresses = '*'

# Nomor port: Port yang didengar server. Port standar PostgreSQL adalah 5432.
port = 5432

# Koneksi maksimum: Jumlah maksimum klien bersamaan yang diizinkan.
max_connections = 100

# Ukuran buffer bersama: Besaran memori shared buffer untuk cache data.
shared_buffers = 128MB

# Direktori log: Lokasi penyimpanan file log.
log_directory = 'log'

# Format nama file log: Pola penamaan file log PostgreSQL.
log_filename = 'postgresql-%Y-%m-%d.log'

# Aktifkan slow query log: Catat query yang berjalan lebih dari sekian ms.
# Set angka positif, misal 2000 = lebih dari 2 detik akan dicatat.
# Set -1 untuk menonaktifkan slow query log.
log_min_duration_statement = 2000

pg_hba.conf

File pg_hba.conf (Host-Based Authentication) mengatur mekanisme autentikasi dan izin klien yang terkoneksi.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# Izinkan koneksi lokal via Unix socket tanpa password (trust).
# "local" is for Unix domain socket connections only
local   all             all                                     trust

# Izinkan semua alamat IPv4 koneksi TCP/IP dengan autentikasi md5.
# IPv4 local connections:
host    all             all             0.0.0.0/0               md5

# Izinkan rentang tertentu IPv4 (misal subnet 192.168.1.0/24) koneksi via TCP/IP dengan md5.
# IPv4 local connections from a specific subnet:
# host    all             all             192.168.1.0/24          md5

Saat mengedit pg_hba.conf, pastikan Anda memahami arti setiap kolom (TYPE, DATABASE, USER, ADDRESS, METHOD). Salah konfigurasi bisa menyebabkan gagal koneksi atau masalah keamanan.

Menerapkan Perubahan Manual

Setelah mengedit konfigurasi manual, Anda harus me-restart layanan PostgreSQL agar perubahan berlaku.

Restart Melalui UI ServBay

1. Buka UI manajemen ServBay.
2. Dari navigasi kiri, pilih Database.
3. Cari PostgreSQL dan klik versinya.
4. Di halaman, atau dari daftar "Paket"/"Layanan" di beranda ServBay, temukan layanan PostgreSQL versi terkait dan klik tombol Restart.

Restart Lewat Command Line servbayctl

Gunakan alat command line ServBay servbayctl untuk mengelola layanan, misal me-restart PostgreSQL:

servbayctl restart postgresql <version>

Ganti <version> dengan nomor versi PostgreSQL Anda, misal 16.

Ringkasan

ServBay menyediakan UI yang sangat praktis untuk ubah konfigurasi PostgreSQL, disarankan menggunakan cara ini agar terhindar dari risiko konfigurasi tertimpa. Anda bisa mengatur alamat dengar, port, jumlah koneksi, melihat kredensial database default, dan lainnya lewat UI. Untuk kebutuhan edit manual (misal pengujian singkat), file utama postgresql.conf dan pg_hba.conf dapat ditemukan di /Applications/ServBay/etc/postgresql/<version>. Setelah perubahan, layanan PostgreSQL biasanya harus di-restart—baik melalui UI ServBay maupun via command line servbayctl.

Pemahaman tentang parameter dan cara modifikasinya akan membantu Anda menyesuaikan pengaturan PostgreSQL di ServBay sesuai kebutuhan pengembangan Anda.