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
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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 filedump.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
.
bash
# 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
1
2
3
4
2
3
4
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
.
bash
# Beralih ke terminal ServBay, atau pastikan PATH sudah benar
mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql
1
2
3
2
3
- 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.
bash
# 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
1
2
3
2
3
- Parameter koneksi: Spesifikasi koneksi ke PostgreSQL server.
- macOS:
-h /Applications/ServBay/tmp
(jalur Unix Domain Socket) - Windows:
-h localhost -p 5432
(koneksi TCP)
- macOS:
-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
.
bash
# 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
1
2
3
4
2
3
4
/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.
bash
# Beralih ke terminal ServBay
mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql
1
2
3
2
3
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
.
bash
# Beralih ke terminal ServBay
mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql
1
2
3
2
3
- 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.
bash
# Beralih ke terminal ServBay
pg_restore -h /Applications/ServBay/tmp -U your_username -d your_database -v /Applications/ServBay/backup/your_database.dump
1
2
3
2
3
- Parameter koneksi: Spesifikasi koneksi ke server PostgreSQL.
- macOS:
-h /Applications/ServBay/tmp
(jalur Unix Domain Socket) - Windows:
-h localhost -p 5432
(koneksi TCP)
- macOS:
-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
- macOS:
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.
bash
# 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
1
2
3
4
5
2
3
4
5
/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.
Ekspor database pada lingkungan sumber:
bash# Jalankan di terminal lingkungan sumber mysqldump -u your_source_username -p your_database > your_database.sql
1
2your_source_username
: Username database pada lingkungan sumber.your_database
: Nama database yang ingin dimigrasikan.your_database.sql
: Nama file hasil ekspor SQL.
Transfer file SQL hasil ekspor ke lingkungan target: Gunakan
scp
atau alat transfer file lain untuk memindahkan fileyour_database.sql
ke lokasi yang bisa diakses ServBay target (misal/Applications/ServBay/backup/
).Buat database baru di lingkungan ServBay target:
bash# Jalankan di terminal ServBay target mysql -u your_target_username -p -e "CREATE DATABASE your_database;"
1
2your_target_username
: Username database di ServBay target.your_database
: Nama database baru (sebaiknya sama dengan sumber).
Impor database ke lingkungan ServBay target:
bash# Jalankan di terminal ServBay target mysql -u your_target_username -p your_database < /path/to/your_database.sql
1
2/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.
- Ekspor database di lingkungan sumber:bash
# Jalankan di terminal sumber mysqldump -u your_source_username -p your_database > your_database.sql
1
2 - Transfer file SQL ke lingkungan target.
- Buat database pada ServBay target:bash
# Jalankan di terminal ServBay target mysql -u your_target_username -p -e "CREATE DATABASE your_database;"
1
2 - Impor database ke ServBay target:bash
# Jalankan di terminal ServBay target mysql -u your_target_username -p your_database < /path/to/your_database.sql
1
2
Migrasi PostgreSQL
Proses Migrasi PostgreSQL menggunakan tool pg_dump
dan pg_restore
. Pastikan parameter jalur socket ServBay sesuai.
Ekspor database di lingkungan sumber:
bash# 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
1
2
3
4your_source_username
: Username database di sumber.your_database
: Nama database yang ingin dimigrasi.your_database.dump
: Nama file hasil ekspor backup.
Transfer file backup ke ServBay target: Gunakan
scp
atau metode transfer lain untuk memindahkan fileyour_database.dump
ke lingkungan target.Buat database baru di ServBay target:
bash# 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;"
1
2
3your_target_username
: Username database di ServBay target.your_database
: Nama database yang akan dibuat.
Impor database ke ServBay target:
bash# Jalankan di terminal ServBay target pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump
1
2/path/to/your_database.dump
: Jalur backup di lingkungan target.
Migrasi Redis
Migrasi Redis pada umumnya cukup dengan menyalin file dump.rdb
secara langsung.
Ambil file
dump.rdb
dari lingkungan sumber:bash# Jalankan di terminal lingkungan sumber # Pastikan layanan Redis sudah dihentikan atau proses BGSAVE sudah selesai cp /path/to/source/redis/dump.rdb ./dump.rdb
1
2
3Transfer file
dump.rdb
ke direktori data Redis ServBay target:bash# Jalankan di terminal sumber atau lewat server perantara scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb
1
2your_target_server
: Alamat atau hostname ServBay target.- Penting: Sebelum meng-copy ke
/Applications/ServBay/db/redis/
, pastikan layanan Redis ServBay target berhenti.
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.