NÂNG CẤP PHIÊN BẢN DATABASE TRÊN VPANEL

Hướng dẫn chi tiết cách nâng cấp MySQL hoặc MariaDB lên phiên bản mới một cách an toàn qua Admin Panel vPanel. Hệ thống thực hiện các kiểm tra bắt buộc trước khi chạy (dung lượng, trạng thái replication, backup) nhằm giảm thiểu tối đa rủi ro mất dữ liệu.

---

1. Truy cập tính năng

Đăng nhập vào Admin Panel trên cổng :2087. Trên thanh sidebar bên trái, chọn Databases → Upgrade Version để mở trang nâng cấp.

Tổng quan giao diện

---

2. Kiểm tra tiền điều kiện (Pre-flight)

Trước khi cho phép nâng cấp, hệ thống kiểm tra các điều kiện:

Cảnh báo: Tất cả các mục kiểm tra phải xanh thì nút Start Upgrade mới được kích hoạt.

---

3. Quy trình nâng cấp

• Bước 1: Tạo bản backup toàn phần qua Databases → Manage Databases nếu chưa có.
• Bước 2: Chọn phiên bản đích từ menu Target Version.
• Bước 3: Xem lại toàn bộ pre-flight checklist — tất cả phải xanh.
• Bước 4: Nhấn Start Upgrade và xác nhận trong popup.
• Bước 5: Hệ thống sẽ:
  1. Dừng dịch vụ MySQL/MariaDB một cách an toàn.
  2. Cập nhật gói phần mềm qua apt hoặc dnf.
  3. Chạy mysql_upgrade để nâng cấp bảng hệ thống.
  4. Khởi động lại dịch vụ và kiểm tra bằng truy vấn thử.
• Bước 6: Theo dõi tiến trình qua Task tracker — bạn có thể rời trang và quay lại; task sẽ tự tiếp tục.

---

4. Rollback khi thất bại

Nếu nâng cấp thất bại, hệ thống tự động:

1. Khôi phục lại phiên bản package cũ.
2. Khôi phục datadir từ snapshot nội bộ (nếu binlog được bật).
3. Khởi động lại dịch vụ ở phiên bản cũ.

Bạn cần khôi phục dữ liệu từ bản backup trước nâng cấp nếu rollback không thành công.

---

5. Xử lý sự cố và lưu ý

Lỗi "Insufficient disk space"

• Nguyên nhân: Dung lượng trống nhỏ hơn 2 lần datadir.
• Giải pháp: Giải phóng dung lượng trong /var/lib/mysql/ hoặc mở rộng đĩa.

Dịch vụ không khởi động sau nâng cấp

• Nguyên nhân: Cấu hình cũ không tương thích với phiên bản mới (ví dụ biến my.cnf bị deprecated).
• Giải pháp: Kiểm tra log tại /var/log/mysql/error.log và loại bỏ các biến đã bị bỏ.

mysql_upgrade thất bại

• Nguyên nhân: Bảng hệ thống bị hỏng hoặc định dạng cũ.
• Giải pháp: Chạy mysql_upgrade --force từ CLI và xem chi tiết output.

---

Chúc bạn quản trị Server an toàn và hiệu quả!