Panduan Migrasi Data ServBay Lintas Platform

Jika Anda meningkatkan perangkat atau beralih antar platform (misalnya dari Mac Intel ke Mac Apple Silicon, atau dari macOS ke Windows), agar lingkungan pengembangan lokal ServBay Anda dapat berjalan dengan lancar dan efisien di perangkat baru, Anda perlu mengikuti proses migrasi khusus. Panduan ini akan memandu Anda melalui langkah-langkah secara rinci.

Mengapa Diperlukan Proses Migrasi Khusus?

ServBay adalah lingkungan pengembangan lokal lintas platform yang mendukung sistem operasi macOS dan Windows. Di macOS, aplikasi utama didesain universal sehingga kompatibel secara native dengan chip Intel dan Apple Silicon (seri M).

Namun, paket perangkat lunak utama yang disediakan ServBay (seperti PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, dll) dikompilasi dan dioptimalkan khusus untuk sistem operasi serta arsitektur CPU tertentu. Artinya:

• Paket versi macOS Intel tidak dapat dijalankan di Mac Apple Silicon
• Paket versi macOS tidak dapat dijalankan di Windows
• Paket versi Windows tidak dapat dijalankan di macOS

Jadi, ketika Anda berpindah antar platform atau arsitektur, Anda tidak dapat sekadar menyalin seluruh direktori ServBay. Anda harus mengganti semua paket perangkat lunak yang terpasang dan melakukan migrasi data serta konfigurasi pribadi Anda.

Langkah Migrasi Detil

Ikuti instruksi berikut secara berurutan untuk memastikan migrasi data Anda aman dan akurat.

Langkah 1: Matikan dan Keluar ServBay Secara Total

Di Mac Intel lama Anda, klik ikon ServBay di menu bar bagian atas layar. Dari menu, pilih Matikan Semua Layanan dan Keluar. Langkah ini penting agar semua file data sudah tertutup sempurna sebelum backup.

Langkah 2: Backup Direktori Data ServBay

macOS:

1. Buka Finder, navigasi ke direktori /Applications.
2. Cari direktori bernama ServBay (ingat, ini bukan aplikasi ServBay.app).
3. Ubah nama direktori ini menjadi ServBay.bak.

Windows:

1. Buka File Explorer, masuk ke direktori C:\.
2. Cari direktori bernama ServBay.
3. Ubah nama direktori ini menjadi ServBay.bak.

Direktori ini berisi semua file situs web, database, sertifikat SSL, backup, dan konfigurasi Anda.

Langkah 3: Install ServBay Baru di Perangkat Baru

1. Salin seluruh direktori ServBay.bak dari perangkat lama ke perangkat baru Anda:
   • macOS: Salin ke direktori /Applications
   • Windows: Salin ke direktori C:\
2. Di perangkat baru, unduh dan instal aplikasi ServBay versi terbaru.
3. Saat ServBay pertama kali dibuka, Anda akan dipandu melalui proses instalasi baru. Ikuti instruksi untuk instalasi normal. Setelah selesai, akan dibuat direktori baru bernama ServBay:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

Langkah 4: Instal Ulang Seluruh Paket Software yang Dibutuhkan

1. Buka ServBay di perangkat baru Anda.
2. Masuk ke menu Packages di navigasi sebelah kiri.
3. Instal ulang semua paket software yang sebelumnya Anda gunakan (misal PHP 8.2, MySQL 8.0, Nginx 1.25, dst).
4. Catatan Penting: Pada tahap ini, cukup instal paket software—tidak perlu mengaktifkannya dulu.

Langkah 5: Kembali Matikan dan Keluar ServBay

Setelah semua paket software selesai diinstal, klik lagi ikon ServBay di menu bar, lalu pilih Matikan Semua Layanan dan Keluar.

Langkah 6: Migrasi Data dan Konfigurasi Inti

Saat ini, di perangkat Anda terdapat dua direktori terkait:

• macOS:
  • /Applications/ServBay.bak (backup dari perangkat lama)
  • /Applications/ServBay (instalasi baru di perangkat baru)
• Windows:
  • C:\ServBay.bak (backup dari perangkat lama)
  • C:\ServBay (instalasi baru di perangkat baru)

Lakukan proses penyalinan berikut:

Buka direktori backup, salin sub-direktori berikut ke direktori ServBay yang baru, dan pilih timpa semua file/folder dengan nama yang sama:

• backup: berisi semua file backup manual dan otomatis Anda.
• data: berisi konfigurasi situs web dan pengaturan aplikasi.
• db: berisi semua file database Anda (MySQL, MariaDB, PostgreSQL).
• ssl: berisi seluruh file sertifikat SSL Anda.
• www: berisi semua file proyek situs web Anda.

Catatan: Langkah ini sangat penting karena akan memulihkan seluruh data Anda.

Langkah 7: Hubungi Dukungan Teknis untuk Konversi File Konfigurasi (Langkah Kunci)

Karena adanya perbedaan platform dan arsitektur, file konfigurasi lama harus dikonversi agar dapat digunakan di platform baru Anda.

1. Di perangkat baru, cari file konfigurasi hasil backup berikut:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. Kirim file config.data ini ke tim dukungan teknis resmi ServBay (misal via Discord, Telegram, WeChat, atau email).
3. Tim dukungan akan mengkonversi file tersebut supaya cocok dengan platform dan arsitektur baru, lalu file hasil konversi akan dikirim kembali kepada Anda.
4. Setelah Anda menerima file hasil konversi, timpa di lokasi berikut:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

Langkah 8: Instal Ulang ServBay Root CA

1. Buka aplikasi ServBay.
2. Pergi ke menu Settings di navigasi kiri.
3. Pada halaman pengaturan, temukan opsi ServBay Root CA dan klik tombol Instal Ulang ServBay Root CA.

Langkah 9: Restart Seluruh Layanan

1. Masuk ke menu Packages di navigasi kiri.
2. Untuk setiap paket software yang sudah diinstal, lakukan proses restart satu per satu: klik sakelar untuk menonaktifkan, lalu klik sekali lagi untuk mengaktifkan. Proses ini memastikan setiap layanan memulai dengan data dan konfigurasi yang baru saja Anda migrasikan.

Langkah 10: Migrasi Selesai

Kini, proses migrasi data ServBay Anda telah selesai! Anda dapat langsung menggunakan ServBay di perangkat baru, dan silakan cek apakah situs web, database, serta semua layanan berjalan sesuai harapan.

Pertanyaan Umum (FAQ)

• Tanya: Bolehkah saya melewati proses konversi file config.data dengan dukungan teknis?
  • Jawab: Tidak boleh. File config.data menyimpan pengaturan penting yang berkaitan dengan platform dan arsitektur perangkat Anda. Jika dilewati, ServBay bisa gagal memuat situs web, database, dan konfigurasi layanan lain Anda, bahkan mungkin tidak dapat berjalan sama sekali.
• Tanya: Jika saya lupa paket software apa saja yang sebelumnya diinstal, bagaimana?
  • Jawab: Anda dapat menanyakan ini sekaligus ketika menghubungi dukungan teknis untuk konversi file config.data. Daftar paket yang pernah Anda instal tercatat di dalam file tersebut.
• Tanya: Setelah migrasi situs saya tidak bisa diakses, solusi?
  • Jawab: Cek secara berurutan:
    1. Pastikan pada Langkah 9, semua paket terkait (seperti Nginx/Apache dan versi PHP yang digunakan) sudah direstart.
    2. Periksa konfigurasi situs web di ServBay apakah sudah benar.
    3. Buka file log pada paket software terkait untuk menemukan detail error yang terjadi.