Hướng Dẫn Di Chuyển Dữ Liệu ServBay Đa Nền Tảng
Khi bạn nâng cấp thiết bị hoặc chuyển đổi giữa các nền tảng (ví dụ từ Mac Intel sang Mac Apple Silicon, hoặc từ macOS sang Windows), để môi trường phát triển cục bộ ServBay của bạn vận hành trơn tru và hiệu quả trên thiết bị mới thì cần thực hiện đúng quy trình di chuyển. Bài hướng dẫn này sẽ giúp bạn từng bước thực hiện điều đó.
Tại Sao Cần Một Quy Trình Di Chuyển Đặc Biệt?
ServBay là môi trường phát triển cục bộ đa nền tảng, hỗ trợ cả macOS lẫn Windows. Trên macOS, ứng dụng chính được phát triển cho kiến trúc phổ thông, tương thích cả máy Mac dùng chip Intel và Apple Silicon (dòng M).
Tuy nhiên, các gói phần mềm của ServBay (như PHP, Node.js, Python, Go, Java, MySQL, MariaDB, Nginx, Apache, v.v...) lại được biên dịch và tối ưu riêng cho hệ điều hành/kiến trúc CPU cụ thể. Điều này dẫn đến:
- Gói phần mềm macOS (Intel) sẽ không chạy được trên Mac Apple Silicon.
- Gói phần mềm macOS không dùng được cho Windows.
- Gói phần mềm Windows không dùng được trên macOS.
Vì vậy, khi chuyển sang thiết bị/nền tảng khác, bạn không thể đơn giản sao chép toàn bộ thư mục ServBay mà cần thay thế hết các gói phần mềm đang dùng, đồng thời di chuyển dữ liệu và cấu hình cá nhân.
Quy Trình Di Chuyển Chi Tiết
Hãy tuân thủ các bước sau để đảm bảo dữ liệu được chuyển đổi đầy đủ, chính xác.
Bước 1: Dừng Hoàn Toàn Và Thoát ServBay
Trên Mac Intel cũ của bạn, nhấp vào biểu tượng ServBay ở thanh menu phía trên màn hình, rồi chọn Dừng tất cả dịch vụ và thoát
. Đây là bước quan trọng để đảm bảo mọi dữ liệu đã được đóng đúng cách trước khi sao lưu.
Bước 2: Sao Lưu Thư Mục Dữ Liệu ServBay
macOS:
- Mở Finder và truy cập vào thư mục
/Applications
. - Tìm thư mục có tên
ServBay
(lưu ý: không phải file ứng dụngServBay.app
). - Đổi tên thư mục này thành
ServBay.bak
.
Windows:
- Mở File Explorer, truy cập thư mục
C:\
. - Tìm thư mục mang tên
ServBay
. - Đổi tên thư mục này thành
ServBay.bak
.
Thư mục này chứa toàn bộ website, cơ sở dữ liệu, chứng chỉ SSL, dữ liệu sao lưu và cấu hình của bạn.
Bước 3: Cài Mới ServBay Trên Thiết Bị Mới
- Sao chép trọn vẹn thư mục
ServBay.bak
từ thiết bị cũ sang thiết bị mới:- macOS: Sao chép vào thư mục
/Applications
- Windows: Sao chép vào thư mục
C:\
- macOS: Sao chép vào thư mục
- Trên thiết bị mới, tải và cài đặt phiên bản ServBay mới nhất.
- Khi mở ServBay lần đầu, ứng dụng sẽ hướng dẫn bạn quá trình cài mới. Làm theo hướng dẫn để hoàn tất. Sau đó ServBay sẽ tạo một thư mục mới:
- macOS:
/Applications/ServBay
- Windows:
C:\ServBay
- macOS:
Bước 4: Cài Đặt Lại Tất Cả Gói Phần Mềm Cần Thiết
- Mở ứng dụng ServBay trên thiết bị mới.
- Truy cập mục Packages (Gói phần mềm) ở thanh điều hướng bên trái.
- Cài đặt lại tất cả các gói phần mềm bạn đã dùng trên thiết bị cũ (ví dụ PHP 8.2, MySQL 8.0, Nginx 1.25, v.v).
- Lưu ý quan trọng: Trong giai đoạn này, chỉ cần cài đặt lại các gói phần mềm, KHÔNG bật dịch vụ.
Bước 5: Dừng Hoàn Toàn Và Thoát ServBay Một Lần Nữa
Sau khi lắp đặt các gói phần mềm, một lần nữa nhấp vào biểu tượng ServBay trên thanh menu để chọn Dừng tất cả dịch vụ và thoát
.
Bước 6: Di Chuyển Dữ Liệu & Cấu Hình Lõi
Lúc này trên thiết bị sẽ có hai thư mục liên quan:
- macOS:
/Applications/ServBay.bak
(dữ liệu backup từ thiết bị cũ)/Applications/ServBay
(bản cài mới trên máy mới)
- Windows:
C:\ServBay.bak
(dữ liệu backup từ thiết bị cũ)C:\ServBay
(bản cài mới trên máy mới)
Thực hiện như sau:
Mở thư mục backup, sao chép các thư mục con bên dưới sang thư mục ServBay mới và chọn ghi đè nếu trùng tên:
backup
: chứa các bản sao lưu thủ công và tự động của bạn.data
: chứa cấu hình website, cài đặt ứng dụng,...db
: chứa các file dữ liệu database (MySQL, MariaDB, PostgreSQL).ssl
: chứa các chứng chỉ SSL của bạn.www
: chứa mã nguồn, dự án website của bạn.
Chú ý: Bước này rất quan trọng, sẽ khôi phục toàn bộ dữ liệu của bạn.
Bước 7: Liên Hệ Hỗ Trợ Kỹ Thuật Để Chuyển Đổi File Cấu Hình (Bước then chốt)
Do khác biệt nền tảng và kiến trúc, các file cấu hình cũ cần được chuyển đổi để dùng được trên thiết bị mới.
- Trên thiết bị mới, tìm file cấu hình backup có đường dẫn:
- macOS:
/Applications/ServBay.bak/data/servbay/config.data
- Windows:
C:\ServBay.bak\data\servbay\config.data
- macOS:
- Gửi file
config.data
cho đội ngũ hỗ trợ kỹ thuật chính thức của ServBay (qua Discord, Telegram, WeChat hoặc email). - Đội hỗ trợ kỹ thuật sẽ chuyển đổi file này cho phù hợp với nền tảng, rồi gửi lại cho bạn.
- Sau khi nhận được file đã chuyển đổi, ghi đè vào vị trí tương ứng trong ServBay mới:
- macOS:
/Applications/ServBay/data/servbay/config.data
- Windows:
C:\ServBay\data\servbay\config.data
- macOS:
Bước 8: Cài Lại ServBay Root CA
- Mở ứng dụng ServBay.
- Chọn Settings (Cài đặt) ở thanh điều hướng bên trái.
- Tại trang cài đặt, tìm mục
ServBay Root CA
và nhấn nútCài lại ServBay Root CA
.
Bước 9: Khởi Động Lại Từng Gói Phần Mềm
- Vào mục Packages (Gói phần mềm) ở thanh điều hướng bên trái.
- Với mỗi gói phần mềm đã cài, hãy khởi động lại từng gói một: Nhấn công tắc để tắt, rồi nhấn lại để bật. Đảm bảo tất cả dịch vụ đang chạy với dữ liệu và cấu hình bạn vừa di chuyển.
Bước 10: Hoàn Tất Việc Di Chuyển
Đến đây, việc di chuyển dữ liệu ServBay đã hoàn tất! Bạn có thể bắt đầu sử dụng ServBay trên thiết bị mới. Hãy kiểm tra website, database và các dịch vụ xem có hoạt động như mong đợi không.
Các Câu Hỏi Thường Gặp (FAQ)
- Q: Tôi có thể bỏ qua bước liên hệ hỗ trợ kỹ thuật để chuyển đổi file
config.data
không?- A: Không thể. File
config.data
chứa các cấu hình mang tính chất nền tảng & kiến trúc. Nếu bỏ qua, ServBay sẽ không thể nạp đúng website, database và dịch vụ, thậm chí không khởi động được.
- A: Không thể. File
- Q: Nếu tôi quên đã cài những gói phần mềm nào thì sao?
- A: Khi liên hệ đội ngũ hỗ trợ để chuyển đổi file
config.data
, bạn cũng có thể hỏi. Thông tin các gói phần mềm từng cài có trong file này.
- A: Khi liên hệ đội ngũ hỗ trợ để chuyển đổi file
- Q: Sau khi chuyển dữ liệu, website không truy cập được thì làm thế nào?
- A: Hãy kiểm tra lần lượt như sau:
- Đảm bảo đã khởi động lại tất cả các gói phần mềm liên quan (như Nginx/Apache, phiên bản PHP tương ứng) ở bước 9.
- Kiểm tra lại các cấu hình website trong ServBay.
- Xem log (nhật ký) của các gói phần mềm để xác định lỗi chi tiết.
- A: Hãy kiểm tra lần lượt như sau: