Panduan Manajemen & Migrasi File Database di ServBay

Sebagai lingkungan pengembangan Web lokal yang tangguh, ServBay mengintegrasikan berbagai sistem manajemen database populer dan menata file data-nya secara terstruktur. Memahami cara penyimpanan file database di ServBay sangatlah penting bagi developer untuk urusan backup, pemulihan, dan migrasi data.

Dokumen ini memberikan penjelasan rinci mengenai struktur penyimpanan file database bawaan ServBay serta panduan praktis untuk mengelola file database dan melakukan migrasi antar lingkungan menggunakan tool command-line standar.

TIP

ServBay menyediakan fitur backup dan pemulihan data, baik otomatis maupun manual, untuk database MySQL, MariaDB, dan PostgreSQL. Silakan lihat bagian Backup & Restore untuk informasi lebih lanjut.

Struktur Default Penyimpanan File Database di ServBay

Agar pengelolaan dan isolasi data antar berbagai versi database semakin mudah, ServBay menempatkan semua file data database di direktori /Applications/ServBay/db. Tiap jenis database dipisahkan pada subdirektori berbeda, lalu di bawahnya diorganisasi lagi berdasarkan versi utama (major version).

Berikut contoh struktur direktori /Applications/ServBay/db:

/Applications/ServBay/db
├── mysql
│   ├── 8.0
│   └── 8.1
├── mariadb
│   ├── 10.10
│   ├── 10.11
│   ├── 10.5
│   ├── 10.6
│   ├── 10.7
│   ├── 10.8
│   ├── 10.9
│   ├── 11.0
│   ├── 11.1
│   ├── 11.2
│   └── 11.3
├── postgresql
│   ├── 10
│   ├── 11
│   ├── 12
│   ├── 13
│   ├── 14
│   ├── 15
│   └── 16
└── redis

Penjelasan Struktur Direktori

• /Applications/ServBay/db: Direktori utama tempat seluruh file database ServBay disimpan.
• mysql: Tempat penyimpanan file data MySQL. Subdirektori dibagi menurut versi utama (misal: 8.0, 8.1).
• mariadb: Tempat file data MariaDB, juga berdasarkan versi utama (misal: 10.11, 11.3).
• postgresql: Tempat file data PostgreSQL, dibagi berdasarkan versi utama (misal: 15, 16).
• redis: Tempat file persistensi Redis, biasanya berupa file dump.rdb.

Struktur seperti ini memungkinkan Anda untuk memasang dan menjalankan beberapa versi utama dari database yang sama secara bersamaan di ServBay, dengan file data yang terisolasi sehingga tidak saling mengganggu.

Manajemen File Database

Selama pengembangan, Anda kerap perlu melakukan backup, pemulihan, atau migrasi data database. Berikut cara menggunakan tool command-line standar untuk tiap tipe database. Pastikan Anda menggunakan terminal ServBay atau sudah mengatur environment variable agar klien database bisa dipanggil langsung.

Backup Database

Backup rutin adalah langkah utama untuk menjaga keamanan data. Berikut cara backup database ServBay untuk tiap tipe:

Backup MySQL

Backup database MySQL dilakukan menggunakan tool standar mysqldump.

# Masuk ke terminal ServBay, atau pastikan PATH sudah termasuk bin ServBay
# Contoh: export PATH="/Applications/ServBay/bin:$PATH"

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql

• your_username: Ganti dengan username database Anda.
• your_database: Ganti dengan nama database yang ingin di-backup.
• /Applications/ServBay/backup/your_database.sql: Lokasi dan nama file hasil backup. Sebaiknya letakkan di luar direktori ServBay, misal di direktori home Anda.

Backup MariaDB

Backup MariaDB sama saja, juga memakai mysqldump.

# Masuk ke terminal ServBay, atau pastikan PATH sudah termasuk bin ServBay

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql

• Penjelasan parameter sama seperti di atas.

Backup PostgreSQL

Gunakan pg_dump untuk backup database PostgreSQL. Harap diperhatikan, biasanya PostgreSQL di ServBay dikonfigurasi default memakai Unix Domain Socket, jalurnya /Applications/ServBay/tmp, jadi tambahkan -h /Applications/ServBay/tmp di perintah.

# Masuk ke terminal ServBay, atau pastikan PATH sudah termasuk bin ServBay

pg_dump -h /Applications/ServBay/tmp -U your_username -d your_database -F c -b -v -f /Applications/ServBay/backup/your_database.dump

• -h /Applications/ServBay/tmp: Jalur socket server PostgreSQL.
• -U your_username: Username database Anda.
• -d your_database: Nama database yang dibackup.
• -F c: Output format custom archive (direkomendasikan).
• -b: Sertakan large object (blob).
• -v: Verbose output.
• -f /Applications/ServBay/backup/your_database.dump: Lokasi dan nama file hasil backup.

Backup Redis

Backup Redis cukup dengan menyalin file persistensinya, dump.rdb.

# Masuk ke terminal ServBay
# Pastikan Redis sedang berjalan atau sudah auto-save (BGSAVE)

cp /Applications/ServBay/db/redis/dump.rdb /Applications/ServBay/backup/dump.rdb

• /Applications/ServBay/db/redis/dump.rdb: Lokasi default file persistensi Redis.
• /Applications/ServBay/backup/dump.rdb: Lokasi tujuan backup.

Restore Database

Jika data hilang atau ingin rollback, gunakan backup hasil sebelumnya untuk melakukan pemulihan.

Restore MySQL

Gunakan klien mysql untuk restore file backup MySQL.

# Masuk ke terminal ServBay

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql

• your_username: Username database Anda.
• your_database: Nama database tujuan restore (harus sudah dibuat sebelumnya).
• /Applications/ServBay/backup/your_database.sql: Path ke file backup Anda.

Restore MariaDB

Sama persis seperti MySQL, gunakan klien mysql.

# Masuk ke terminal ServBay

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql

• Penjelasan parameter sama seperti di atas.

Restore PostgreSQL

Untuk backup dengan format custom, gunakan pg_restore. Sertakan juga jalur socket -h /Applications/ServBay/tmp.

# Masuk ke terminal ServBay

pg_restore -h /Applications/ServBay/tmp -U your_username -d your_database -v /Applications/ServBay/backup/your_database.dump

• -h /Applications/ServBay/tmp: Jalur socket PostgreSQL.
• -U your_username: Username database Anda.
• -d your_database: Nama database tujuan (harus sudah dibuat).
• -v: Tampilkan log detail.
• /Applications/ServBay/backup/your_database.dump: Path file backup Anda.

Restore Redis

Restore Redis umumnya dengan menyalin dump.rdb ke direktori data Redis. Penting: Pastikan layanan Redis dihentikan sebelum melakukan ini.

# Masuk ke terminal ServBay
# Hentikan layanan Redis ServBay
# Salin file backup
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# Jalankan kembali layanan Redis ServBay

• /Applications/ServBay/backup/dump.rdb: Path file backup.
• /Applications/ServBay/db/redis/dump.rdb: Lokasi default data Redis.

Migrasi Database

Migrasi database berarti memindahkan data dari satu environment ke environment lain (bisa antar ServBay, dari/ke server remote, atau ke/development lokal lain). Umumnya, datanya diekspor dulu dari source, lalu diimpor ke target.

Migrasi MySQL

Lihat detail migrasi MySQL — proses ini umum di pengembangan.

1. Ekspor database dari source:

   # Jalankan di terminal environment asal
   mysqldump -u your_source_username -p your_database > your_database.sql

   • your_source_username: Username database asal/source.
   • your_database: Nama database yang dimigrasikan.
   • your_database.sql: Nama file SQL hasil ekspor.

2. Transfer file SQL ke environment target: Gunakan scp atau tool lain untuk mengirim file your_database.sql ke lokasi yang dapat dijangkau ServBay target (misal /Applications/ServBay/backup/).

3. Buat database di ServBay target:

   # Jalankan di terminal ServBay target
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

   • your_target_username: Username database target.
   • your_database: Nama database baru (sebaiknya sama dengan source).

4. Import database ke ServBay target:

   # Jalankan di terminal ServBay target
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

   • /path/to/your_database.sql: Ganti dengan path file SQL pada environment target.

Migrasi MariaDB

Lihat detail migrasi MariaDB — proses sama persis dengan MySQL karena menggunakan tool dan format file yang sama.

1. Ekspor database dari source:

   # Jalankan di terminal environment asal
   mysqldump -u your_source_username -p your_database > your_database.sql

2. Transfer file SQL ke target.
3. Buat database di ServBay target:

   # Jalankan di terminal ServBay target
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

4. Import database ke ServBay target:

   # Jalankan di terminal ServBay target
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

Migrasi PostgreSQL

Lihat detail migrasi PostgreSQL — gunakan kombinasi pg_dump dan pg_restore, perhatikan juga socket-nya.

1. Ekspor database dari source:

   # Jalankan di terminal environment asal
   # Jika sumbernya juga ServBay
   pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
   # Jika bukan ServBay, sesuaikan parameternya dengan environment

   • your_source_username: Username di environment asal.
   • your_database: Nama database source.
   • your_database.dump: Nama file hasil backup.

2. Transfer file backup ke environment ServBay target: Gunakan scp atau tool lain ke lokasi yang dapat diakses ServBay.

3. Buat database baru di ServBay target:

   # Jalankan di terminal ServBay target
   # Koneksi ke database postgres lalu buat yang baru
   psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"

   • your_target_username: Username target.
   • your_database: Nama database yang akan dibuat.

4. Import database ke ServBay target:

   # Jalankan di terminal ServBay target
   pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump

   • /path/to/your_database.dump: Path file backup di environment target.

Migrasi Redis

Migrasi Redis biasanya hanya dengan menyalin file dump.rdb.

1. Ambil file dump.rdb dari environment source:

   # Jalankan di terminal source
   # Pastikan Redis sudah ditembak (stop) atau sudah auto-save (BGSAVE)
   cp /path/to/source/redis/dump.rdb ./dump.rdb

2. Transfer file dump.rdb ke direktori data Redis di ServBay target:

   # Jalankan di source atau intermediary server
   scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb

   • your_target_server: Alamat atau host ServBay target.
   • Penting: Sebelum menyalin ke /Applications/ServBay/db/redis/, pastikan Redis pada ServBay target sudah dihentikan!

3. Mulai ulang layanan Redis di ServBay target: Redis akan otomatis menggunakan file dump.rdb baru saat start.

Catatan Penting

• Stop layanan terlebih dahulu: Sebelum menyalin langsung (copy) atau memindahkan direktori/file database (terutama untuk MySQL/MariaDB/PostgreSQL), SELALU stop layanan database terkait via GUI atau terminal ServBay. Menyalin file database yang masih aktif berisiko menyebabkan kerusakan atau data tak konsisten. Pada Redis, stop dulu sebelum restore file dump.rdb.
• Hak akses: Pastikan user yang menjalankan operasi copy/move/import punya izin penuh ke folder/file yang bersangkutan.
• Cek jalur file: Pastikan jalur ServBay (/Applications/ServBay secara default) dan jalur subdirektori database-nya sudah benar, apalagi jika versi databasenya banyak.
• User & hak akses database: Setelah migrasi, cek apakah user, hak akses, serta konfigurasi database perlu diperbarui supaya sesuai dengan environment baru.
• Backup built-in ServBay: ServBay juga menyediakan fitur backup & restore terintegrasi via GUI (settings, file website, database, sertifikat SSL), bisa digunakan sebagai pelengkap atau pengganti backup/manual file.

Kesimpulan

ServBay menyediakan fondasi manajemen file database yang jelas melalui struktur folder yang terstandarisasi. Dokumen ini telah membahas detail lokasi penyimpanan file MySQL, MariaDB, PostgreSQL, dan Redis pada ServBay, beserta panduan praktis menggunakan command-line untuk backup, restore, maupun migrasi databasenya. Menguasai proses ini akan sangat membantu Anda dalam mengelola database local dengan lebih aman dan efisien, baik dari sisi perlindungan data maupun migrasi antar environment. Dengan pemanfaatan fitur-fitur lain seperti backup terintegrasi ServBay, efisiensi pengembangan dan kemampuan manajemen data Anda akan meningkat secara signifikan.