Panduan Migrasi Data ServBay Lintas Platform

Jika anda menaik taraf peranti atau bertukar antara platform (contohnya dari Mac Intel ke Mac Apple Silicon, atau dari macOS ke Windows), adalah penting untuk mengikuti proses migrasi khas agar persekitaran pembangunan tempatan ServBay anda terus berjalan lancar dan berkesan di peranti baru. Panduan ini menyediakan langkah-langkah terperinci untuk anda.

Mengapa Proses Migrasi Khas Diperlukan?

ServBay ialah persekitaran pembangunan tempatan merentas platform yang menyokong macOS dan Windows. Pada macOS, aplikasi utama dibina secara universal dan serasi secara asli dengan cip Intel dan Apple Silicon (siri M).

Namun begitu, pakej perisian utama ServBay (seperti PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache dan lain-lain) telah dikarang dan dioptimumkan mengikut sistem operasi dan seni bina CPU tertentu. Ini bermakna:

• Pakej versi Mac Intel tidak boleh dijalankan pada Mac Apple Silicon
• Pakej versi macOS tidak boleh dijalankan di Windows
• Pakej versi Windows tidak boleh dijalankan di macOS

Oleh itu, apabila anda bertukar platform atau seni bina, anda tidak boleh hanya menyalin seluruh direktori ServBay. Anda perlu menggantikan semua pakej yang dipasang serta memindahkan data dan konfigurasi peribadi anda.

Langkah-langkah Migrasi Terperinci

Sila ikut setiap langkah di bawah dengan teliti untuk memastikan integriti dan ketepatan migrasi data anda.

Langkah 1: Berhenti dan Keluar Sepenuhnya dari ServBay

Di Mac Intel lama anda, klik ikon ServBay di bar menu atas skrin dan pilih Hentikan semua perkhidmatan dan keluar dari menu. Langkah ini sangat penting untuk memastikan semua fail data ditutup dengan betul sebelum disandarkan.

Langkah 2: Sandarkan Direktori Data ServBay

macOS:

1. Buka Finder dan pergi ke direktori /Applications.
2. Cari direktori bernama ServBay (perhatikan ini bukan aplikasi ServBay.app).
3. Tukar nama direktori ini kepada ServBay.bak.

Windows:

1. Buka File Explorer dan pergi ke direktori C:\.
2. Cari direktori bernama ServBay.
3. Tukar nama direktori ini kepada ServBay.bak.

Direktori ini mengandungi semua fail laman web, pangkalan data, sijil SSL, sandaran dan konfigurasi anda.

Langkah 3: Pasang ServBay Baharu di Peranti Baru

1. Salin seluruh direktori ServBay.bak dari peranti lama ke peranti baru anda:
   • macOS: Salin ke direktori /Applications
   • Windows: Salin ke direktori C:\
2. Muat turun dan pasang versi terkini aplikasi utama ServBay di peranti baru.
3. Buka ServBay buat kali pertama; anda akan dipandu melalui proses pemasangan baharu. Setelah selesai, sebuah direktori ServBay baru akan dihasilkan:
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

Langkah 4: Pasang Semula Semua Pakej Perisian Diperlukan

1. Buka ServBay di peranti baru anda.
2. Pergi ke paparan Pakej (Packages) di bar navigasi sebelah kiri.
3. Pasang semula semua pakej perisian yang anda pernah gunakan di peranti lama (contohnya PHP 8.2, MySQL 8.0, Nginx 1.25 dan lain-lain).
4. Nota Penting: Hanya pasang pakej, tidak perlu aktifkan mereka pada tahap ini.

Langkah 5: Sekali Lagi, Berhenti dan Keluar Penuh ServBay

Selepas semua pakej dipasang, klik ikon ServBay di bar menu dan pilih Hentikan semua perkhidmatan dan keluar sekali lagi.

Langkah 6: Migrasi Data dan Konfigurasi Teras

Kini anda akan dapati dua direktori berkaitan di peranti anda:

• macOS:
  • /Applications/ServBay.bak (sandaran dari peranti lama)
  • /Applications/ServBay (pemasangan baru di peranti baru)
• Windows:
  • C:\ServBay.bak (sandaran dari peranti lama)
  • C:\ServBay (pemasangan baru di peranti baru)

Lakukan salinan berikut:

Buka direktori sandaran, salin subdirektori berikut ke direktori pemasangan ServBay yang baru dan ganti semua fail atau folder yang bernama sama:

• backup: Menyimpan semua fail sandaran manual dan automatik anda.
• data: Konfigurasi laman web dan tetapan aplikasi.
• db: Semua fail pangkalan data (MySQL, MariaDB, PostgreSQL).
• ssl: Semua fail sijil SSL anda.
• www: Semua fail projek laman web anda.

Nota: Langkah ini amat penting untuk memulangkan semula data anda.

Langkah 7: Hubungi Sokongan Teknikal untuk Menukar Fail Konfigurasi (Langkah Utama)

Disebabkan perbezaan platform dan seni bina, fail konfigurasi lama perlu ditukar agar boleh digunakan di platform baru.

1. Di peranti baru anda, cari fail konfigurasi sandaran:
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. Hantar fail config.data ini kepada pasukan sokongan teknikal rasmi ServBay (misalnya melalui Discord, Telegram, WeChat atau email rasmi).
3. Pasukan sokongan akan menukar fail agar serasi dengan platform dan seni bina baru, kemudian mengembalikannya kepada anda.
4. Selepas menerima fail yang sudah ditukar, ganti fail di lokasi berikut:
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

Langkah 8: Pasang Semula ServBay Root CA

1. Buka aplikasi ServBay.
2. Pergi ke paparan Tetapan (Settings) di bar navigasi sebelah kiri.
3. Dalam halaman tetapan, cari pilihan ServBay Root CA dan klik butang Pasang Semula ServBay Root CA.

Langkah 9: Mulakan Semula Semua Perkhidmatan

1. Pergi ke paparan Pakej (Packages) di bar navigasi sebelah kiri.
2. Untuk setiap pakej perisian yang telah dipasang, lakukan proses mula semula: Klik suis untuk nyahaktifkan, kemudian klik sekali lagi untuk aktifkan. Ini memastikan semua perkhidmatan memulakan semula dengan data dan konfigurasi yang baru dipindahkan.

Langkah 10: Migrasi Selesai

Kini, proses migrasi data ServBay anda sudah selesai! Anda boleh menggunakan ServBay seperti biasa di peranti baru. Sila semak laman web, pangkalan data dan perkhidmatan anda untuk memastikan semuanya berfungsi sebagaimana dijangka.

Soalan Lazim (FAQ)

• S: Bolehkah saya abaikan langkah menghubungi sokongan teknikal untuk menukar fail config.data?
  • J: Tidak boleh. Fail config.data memuatkan maklumat konfigurasi kritikal yang berkaitan dengan platform dan seni bina. Jika anda melangkau langkah ini, ServBay tidak dapat memuatkan laman web, pangkalan data dan konfigurasi perkhidmatan anda dengan betul, malah mungkin gagal untuk bermula.
• S: Apa perlu saya lakukan jika saya lupa pakej apa yang telah dipasang sebelum ini?
  • J: Anda boleh bertanya kepada pihak sokongan teknikal semasa menukar fail config.data. Maklumat pakej terdahulu anda direkod di dalam fail tersebut.
• S: Selepas migrasi, laman web saya tidak dapat diakses. Apa yang perlu saya lakukan?
  • J: Sila periksa perkara berikut secara berurutan:
    1. Pastikan anda telah memulakan semula semua pakej berkaitan (seperti Nginx/Apache dan PHP versi yang digunakan) pada Langkah 9.
    2. Semak konfigurasi laman web di dalam ServBay.
    3. Lihat fail log pakej berkaitan untuk kenalpasti maklumat ralat.