Cara Memigrasi Data ServBay dari Mac Berbasis Intel ke Mac dengan Chip Apple Silicon (Seri M)

Selamat atas peningkatan ke Mac baru dengan chip Apple Silicon! Untuk memastikan lingkungan pengembangan lokal ServBay Anda tetap berjalan lancar dan efisien di perangkat baru, Anda perlu mengikuti proses migrasi khusus. Panduan berikut akan memberikan langkah-langkah detail yang dibutuhkan.

Mengapa Proses Migrasi Khusus Diperlukan?

Aplikasi utama ServBay dibangun dengan arsitektur universal, sehingga kompatibel secara native dengan chip Intel maupun Apple Silicon (seri M).

Namun, paket perangkat lunak inti yang disediakan oleh ServBay (seperti PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, dan lainnya) dikompilasi dan dioptimalkan khusus untuk arsitektur CPU tertentu. Artinya, paket yang dioptimalkan untuk Intel tidak bisa dijalankan langsung di chip seri M, demikian pula sebaliknya.

Karena itu, saat Anda beralih dari Mac Intel ke Mac seri M, Anda tidak dapat sekadar menyalin seluruh direktori ServBay — Anda harus mengganti semua paket perangkat lunak yang terpasang sekaligus memigrasikan data pribadi dan konfigurasi Anda.

Langkah Migrasi Detail

Lakukan setiap langkah berikut secara berurutan agar integritas dan akurasi data tetap terjamin.

Langkah 1: Hentikan dan Tutup ServBay Sepenuhnya

Di Mac Intel lama Anda, klik ikon ServBay pada menu bar di bagian atas layar, lalu pilih Hentikan semua layanan dan keluar dari menu. Ini adalah langkah penting untuk memastikan semua file data telah ditutup dengan benar sebelum dicadangkan.

Langkah 2: Backup Direktori Data ServBay

1. Buka Finder dan pergi ke direktori /Applications.
2. Temukan folder bernama ServBay (pastikan ini adalah folder, bukan aplikasi ServBay.app).
3. Ganti nama folder ini menjadi ServBay.bak. Folder ini berisi seluruh file situs, basis data, sertifikat SSL, backup, dan konfigurasi Anda.

Langkah 3: Instal Bersih ServBay di Mac Baru

1. Salin folder ServBay.bak secara utuh dari Mac lama ke direktori /Applications di Mac seri M baru.
2. Di Mac baru, unduh dan pasang versi terbaru aplikasi utama ServBay.
3. Saat pertama kali membuka ServBay.app, Anda akan dibimbing melalui proses instalasi baru. Ikuti proses normal hingga selesai. Direktori baru bernama ServBay akan (kembali) dibuat di /Applications.

Langkah 4: Instal Ulang Semua Paket yang Dibutuhkan

1. Buka ServBay di Mac baru Anda.
2. Pergi ke menu Packages (Paket) di navigasi sebelah kiri.
3. Instal ulang semua paket perangkat lunak yang Anda gunakan di perangkat lama (misal, PHP 8.2, MySQL 8.0, Nginx 1.25, dll.).
4. Catatan penting: Pada tahap ini, cukup instal paket, tidak perlu mengaktifkannya.

Langkah 5: Hentikan dan Tutup ServBay Sepenuhnya (Lagi)

Setelah semua paket selesai diinstal, klik lagi ikon ServBay di menu bar dan pilih Hentikan semua layanan dan keluar.

Langkah 6: Migrasikan Data Inti dan Konfigurasi

Kini, seharusnya terdapat dua folder terkait di direktori /Applications/ Anda:

• /Applications/ServBay.bak (backup dari Mac lama)
• /Applications/ServBay (instalasi baru di Mac baru)

Lakukan salin-tempel berikut:

Buka folder /Applications/ServBay.bak dan salin subfolder di bawah ini ke dalam folder /Applications/ServBay yang baru, dengan memilih timpa/replace semua file dan folder yang memiliki nama sama:

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

Catatan: langkah ini sangat penting karena akan mengembalikan seluruh data Anda.

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

Karena perbedaan arsitektur CPU, file konfigurasi lama tidak bisa langsung digunakan di chip baru.

1. Di Mac baru Anda, cari file konfigurasi yang telah dibackup: /Applications/ServBay.bak/data/servbay/config.data.
2. Kirim file config.data tersebut ke tim dukungan teknis resmi ServBay (misal, via Discord, Telegram, WeChat, atau email resmi).
3. Tim dukungan akan mengonversi file Anda agar kompatibel dengan arsitektur chip seri M dan mengirimkannya kembali.
4. Setelah menerima file hasil konversi, timpa file di lokasi berikut: /Applications/ServBay/data/servbay/config.data.

Langkah 8: Instal Ulang ServBay Root CA

1. Buka aplikasi ServBay.
2. Pergi ke menu Settings (Pengaturan) di navigasi sebelah kiri.
3. Pada halaman pengaturan, cari opsi ServBay Root CA, lalu klik tombol Instal ulang ServBay Root CA.

Langkah 9: Restart Semua Layanan

1. Kembali ke menu Packages (Paket) di navigasi sebelah kiri.
2. Untuk setiap paket yang sudah terinstal, lakukan restart satu per satu: klik tombol saklar untuk menonaktifkan, lalu klik lagi untuk mengaktifkannya. Tindakan ini memastikan semua layanan sudah berjalan dengan data dan konfigurasi terbaru hasil migrasi.

Langkah 10: Migrasi Selesai

Selamat! Proses migrasi ServBay Anda telah selesai. Kini Anda dapat menggunakan ServBay seperti biasa di Mac baru dengan chip seri M. Pastikan juga semua situs, database, dan layanan berjalan normal sesuai harapan.

Pertanyaan Umum (FAQ)

• Q: Apakah saya bisa melewati langkah konversi file config.data oleh dukungan teknis?
  • A: Tidak bisa. File config.data memuat informasi konfigurasi penting terkait arsitektur perangkat. Jika dilewati, ServBay tidak akan bisa memuat situs, database, atau layanan lain dengan benar — bahkan mungkin gagal berjalan sama sekali.
• Q: Bagaimana jika saya lupa paket apa saja yang sebelumnya terinstal?
  • A: Anda dapat menanyakannya ke tim dukungan teknis saat proses konversi file config.data. Informasi paket terpasang tercatat di dalam file tersebut.
• Q: Setelah migrasi selesai, situs saya tetap tidak bisa diakses. Apa yang harus saya lakukan?
  • A: Silakan lakukan pengecekan berikut secara berurutan:
    1. Pastikan pada Langkah 9, Anda sudah me-restart semua paket terkait (misalnya Nginx/Apache dan versi PHP yang dipakai).
    2. Periksa kembali konfigurasi situs di ServBay, pastikan sudah benar.
    3. Periksa log pada paket yang bermasalah untuk mengidentifikasi error atau kendala spesifik.