Panduan Manajemen & Migrasi File Database ServBay

ServBay merupakan lingkungan pengembangan web lokal yang kuat, mengintegrasikan berbagai sistem manajemen database populer dan melakukan pengelolaan file data secara terstruktur. Memahami struktur penyimpanan file database default ServBay sangat penting bagi pengembang yang ingin melakukan backup, restore, ataupun migrasi data.

Dokumen ini akan membahas secara detail struktur penyimpanan file database ServBay serta memberikan panduan penggunaan alat command-line standar untuk manajemen file database dan migrasi antar lingkungan.

TIP

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

Struktur Penyimpanan File Database Default ServBay

Untuk memudahkan manajemen dan pemisahan data versi database yang berbeda, ServBay menyimpan semua file data database di satu direktori utama: /Applications/ServBay/db. Direktori ini dikategorikan berdasarkan tipe database, kemudian di dalamnya dipisah lagi berdasarkan versi utama (major version) masing-masing database.

Contoh struktur direktori /Applications/ServBay/db adalah sebagai berikut:

/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 ServBay menyimpan seluruh file database.
• mysql: Berisi file data database MySQL. Subdirektori dibedakan berdasarkan versi utama (misal: 8.0, 8.1).
• mariadb: Berisi file data database MariaDB. Subdirektori sesuai versi utama (misal: 10.11, 11.3).
• postgresql: Menyimpan file data database PostgreSQL. Subdirektori sesuai versi utama (misal: 15, 16).
• redis: Menyimpan file persistensi Redis, biasanya berupa file dump.rdb.

Dengan struktur ini, Anda dapat menginstal dan menjalankan beberapa versi utama dari tipe database yang sama secara bersamaan di ServBay, tanpa saling bertabrakan data antar versi.

Manajemen File Database

Selama proses pengembangan lokal, Anda sering membutuhkan fitur backup, restore, atau migrasi database. Di bawah ini adalah cara melakukan langkah-langkah tersebut menggunakan alat command-line standar masing-masing database. Perlu diingat, operasi-operasi ini umumnya perlu dijalankan di terminal lingkungan ServBay atau setelah memastikan variabel lingkungan sudah dikonfigurasi agar dapat langsung memanggil klien database dan alat bantu terkait.

Backup Database

Backup berkala adalah langkah penting untuk menjaga keamanan data. Berikut adalah contoh backup untuk masing-masing tipe database di ServBay.

Backup MySQL

Backup database MySQL standar menggunakan tool mysqldump.

# Beralih ke terminal bawaan ServBay, atau pastikan variabel PATH sudah memasukkan direktori 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 dibackup.
• /Applications/ServBay/backup/your_database.sql: Sesuaikan dengan lokasi dan nama file backup yang diinginkan. Disarankan menyimpan file backup di luar direktori ServBay, misalnya di folder user Anda.

Backup MariaDB

Cara backup MariaDB sama seperti MySQL, menggunakan tool mysqldump.

# Beralih ke terminal ServBay, atau pastikan PATH sudah benar

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

• Penjelasan parameter sama seperti di atas.

Backup PostgreSQL

Gunakan tool pg_dump untuk membackup database PostgreSQL. Perhatikan bahwa PostgreSQL di ServBay biasanya terkoneksi menggunakan Unix Domain Socket dengan jalur default /Applications/ServBay/tmp, sehingga perlu ditambahkan -h /Applications/ServBay/tmp pada perintah.

# Beralih ke terminal bawaan ServBay, atau pastikan PATH sudah benar

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

• Parameter koneksi: Spesifikasi koneksi ke PostgreSQL server.
  • macOS: -h /Applications/ServBay/tmp (jalur Unix Domain Socket)
  • Windows: -h localhost -p 5432 (koneksi TCP)
• -U your_username: Ganti dengan username database Anda.
• -d your_database: Ganti dengan nama database yang ingin dibackup.
• -F c: Format output ke bentuk arsip custom (disarankan).
• -b: Sertakan large objects (blobs).
• -v: Output detail.
• -f /Applications/ServBay/backup/your_database.dump: Jalur dan nama file backup.

Backup Redis

Backup Redis biasanya dilakukan dengan meng-copy file persistensi dump.rdb.

# Beralih ke terminal ServBay
# Pastikan layanan Redis sedang berjalan atau sudah terkonfigurasi autosave (BGSAVE)

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

• /Applications/ServBay/db/redis/dump.rdb: Jalur file persistensi Redis default.
• /Applications/ServBay/backup/dump.rdb: Jalur dan nama file backup yang diinginkan.

Restore Database

Jika terjadi kehilangan data atau ingin mengembalikan ke status sebelumnya, Anda bisa melakukan restore dari file backup.

Restore MySQL

Gunakan klien mysql untuk me-restore file backup MySQL.

# Beralih ke terminal ServBay

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

• your_username: Ganti dengan username database Anda.
• your_database: Nama database tujuan restore (biasanya harus sudah dibuat sebelumnya).
• /Applications/ServBay/backup/your_database.sql: Lokasi file backup Anda.

Restore MariaDB

Cara restore MariaDB identik dengan MySQL, menggunakan klien mysql.

# Beralih ke terminal ServBay

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

• Penjelasan parameter sama seperti di atas.

Restore PostgreSQL

Menggunakan tool pg_restore untuk mengembalikan file backup format custom PostgreSQL. Pastikan socket path -h /Applications/ServBay/tmp sudah ditambahkan.

# Beralih ke terminal ServBay

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

• Parameter koneksi: Spesifikasi koneksi ke server PostgreSQL.
  • macOS: -h /Applications/ServBay/tmp (jalur Unix Domain Socket)
  • Windows: -h localhost -p 5432 (koneksi TCP)
• -U your_username: Username database Anda.
• -d your_database: Nama database tujuan restore (umumnya harus sudah dibuat).
• -v: Output detail.
• Jalur backup file: Lokasi file backup Anda.
  • macOS: /Applications/ServBay/backup/your_database.dump
  • Windows: C:\ServBay\backup\your_database.dump

Restore Redis

Restore Redis biasanya dilakukan dengan menyalin file dump.rdb backup kembali ke direktori data Redis. Penting: Pastikan layanan Redis sudah dihentikan sebelum melakukan langkah ini.

# Beralih ke terminal ServBay
# Hentikan layanan Redis pada ServBay
# Copy file backup
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# Mulai ulang layanan Redis pada ServBay

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

Migrasi Database

Migrasi database adalah proses memindahkan database dari satu lingkungan (misalnya ServBay lain, server remote, atau lingkungan lokal lain) ke lingkungan baru. Biasanya dilakukan dengan ekspor data dari sumber, lalu impor ke target.

Migrasi MySQL

Proses Migrasi MySQL adalah kasus umum sehari-hari.

1. Ekspor database pada lingkungan sumber:

   # Jalankan di terminal lingkungan sumber
   mysqldump -u your_source_username -p your_database > your_database.sql

   • your_source_username: Username database pada lingkungan sumber.
   • your_database: Nama database yang ingin dimigrasikan.
   • your_database.sql: Nama file hasil ekspor SQL.

2. Transfer file SQL hasil ekspor ke lingkungan target: Gunakan scp atau alat transfer file lain untuk memindahkan file your_database.sql ke lokasi yang bisa diakses ServBay target (misal /Applications/ServBay/backup/).

3. Buat database baru di lingkungan ServBay target:

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

   • your_target_username: Username database di ServBay target.
   • your_database: Nama database baru (sebaiknya sama dengan sumber).

4. Impor database ke lingkungan 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: Jalur file SQL pada lingkungan target.

Migrasi MariaDB

Proses Migrasi MariaDB sama persis dengan MySQL karena menggunakan alat dan format file yang identik.

1. Ekspor database di lingkungan sumber:

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

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

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

4. Impor database ke ServBay target:

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

Migrasi PostgreSQL

Proses Migrasi PostgreSQL menggunakan tool pg_dump dan pg_restore. Pastikan parameter jalur socket ServBay sesuai.

1. Ekspor database di lingkungan sumber:

   # Jalankan di terminal lingkungan sumber
   # Jika sumber adalah ServBay
   pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
   # Jika sumber adalah sistem lain, sesuaikan parameter koneksi

   • your_source_username: Username database di sumber.
   • your_database: Nama database yang ingin dimigrasi.
   • your_database.dump: Nama file hasil ekspor backup.

2. Transfer file backup ke ServBay target: Gunakan scp atau metode transfer lain untuk memindahkan file your_database.dump ke lingkungan target.

3. Buat database baru di ServBay target:

   # Jalankan di terminal ServBay target
   # Koneksi ke database default (postgres) untuk membuat database baru
   psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"

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

4. Impor 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: Jalur backup di lingkungan target.

Migrasi Redis

Migrasi Redis pada umumnya cukup dengan menyalin file dump.rdb secara langsung.

1. Ambil file dump.rdb dari lingkungan sumber:

   # Jalankan di terminal lingkungan sumber
   # Pastikan layanan Redis sudah dihentikan atau proses BGSAVE sudah selesai
   cp /path/to/source/redis/dump.rdb ./dump.rdb

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

   # Jalankan di terminal sumber atau lewat server perantara
   scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb

   • your_target_server: Alamat atau hostname ServBay target.
   • Penting: Sebelum meng-copy ke /Applications/ServBay/db/redis/, pastikan layanan Redis ServBay target berhenti.

3. Mulai ulang layanan Redis di ServBay target: Setelah Redis aktif, file dump.rdb akan otomatis terbaca.

Hal Penting yang Harus Diperhatikan

• Hentikan Layanan: Sebelum meng-copy atau memindahkan file data database apapun (terutama direktori data MySQL/MariaDB/PostgreSQL), pastikan layanan database terkait sudah dihentikan lewat GUI ServBay atau command line. Copy file dari database yang masih berjalan bisa menyebabkan data corrupt atau konsistensi bermasalah. Untuk Redis, layanan juga harus berhenti sebelum restore dump.rdb.
• Masalah Izin (Permission): Pastikan user yang menjalankan operasi file memiliki akses dan izin yang cukup untuk direktori dan file database.
• Jalur File: Pastikan jalur instalasi ServBay (default /Applications/ServBay) dan subdirektori database benar, terutama untuk tiap versi database yang berbeda.
• User & Permission Database: Setelah migrasi, cek dan update user, permission, dan konfigurasi database agar sesuai dengan lingkungan baru.
• Backup Internal ServBay: ServBay menyediakan fitur backup dan restore bawaan melalui GUI, mendukung backup settings, file website, database, dan sertifikat SSL—fitur ini bisa jadi pelengkap ataupun alternatif dari manajemen file manual.

Kesimpulan

ServBay dengan struktur file data yang terstandarisasi memberikan dasar manajemen database yang jelas bagi pengembang. Dokumen ini menjelaskan lokasi penyimpanan file untuk MySQL, MariaDB, PostgreSQL, dan Redis di ServBay, serta panduan praktis penggunaan command-line standar untuk backup, restore, dan migrasi database. Menguasai teknik ini akan membantu Anda mengelola data database lingkungan lokal dengan lebih baik, memastikan keamanan data, dan melakukan migrasi proyek antar lingkungan secara efisien. Digabungkan dengan fitur backup internal ServBay yang praktis, produktivitas dan pengelolaan data Anda pun akan meningkat pesat.