Sổ tay lỗi
Những lỗi đã gặp khi vận hành thật, và cách xử lý.
Mỗi mục gồm dấu hiệu trong log, nguyên nhân và cách sửa. Danh sách này được bổ sung sau mỗi sự cố được giải quyết.
Công cụ backup không cùng phiên bản với server
Nguyên nhân: mariabackup đọc định dạng redo log của đúng dòng phiên bản. Bản 10.8 trở lên không đọc được redo log của 10.5; bản mới hơn nữa có thể không tương thích ngược.
Cách sửa: Cài gói MariaDB cùng major.minor với server trên máy Agent (chỉ cần thư mục bin) và trên Center. Hoặc nhập đường dẫn công cụ ở bước 1 của Agent / Cài đặt của Center.
Deadlock khi chốt điểm nhất quán
Nguyên nhân: Lỗi đã biết của MariaDB 10.5.8 khi có giao dịch dài lúc backup chuyển giai đoạn.
Cách sửa: Agent tự thử lại tối đa 3 lần, cách nhau 30 giây. Nếu lặp lại thường xuyên: nâng MariaDB lên bản vá mới nhất của 10.5 hoặc lên 10.11/11.4. Nếu mọi bảng là InnoDB, chế độ không khoá được bật tự động và tránh được lỗi này.
Thiếu quyền backup
Nguyên nhân: Tài khoản backup thiếu quyền RELOAD, PROCESS, LOCK TABLES, BINLOG MONITOR hoặc SELECT.
Cách sửa: Agent → bước 1 → Kiểm tra kết nối và quyền, chạy câu GRANT hiện ra bằng tài khoản root.
Không thấy database hoặc bảng nào
Nguyên nhân: User được khai báo theo host khác với host Agent kết nối (localhost, 127.0.0.1, ::1), hoặc thiếu quyền SELECT.
Cách sửa: Kiểm tra SELECT user, host FROM mysql.user, tạo thêm user cho đúng host rồi bấm Đọc lại danh sách ở bước 2.
Bảng có trong từ điển nhưng không có file
Nguyên nhân: Khi prepare, mariabackup liệt kê các bảng InnoDB ngoài phạm vi backup (DB không được chọn). Hoàn toàn vô hại — Center gom lại thành một dòng thông báo.
Cách sửa: Không cần làm gì. Nếu bảng đó nằm trong phạm vi và thật sự mất file (mục từ điển mồ côi, thường do xoá file thủ công): tạo lại bảng cùng tên trong một DB tạm theo cùng cấu trúc rồi DROP TABLE để dọn mục từ điển, hoặc hỏi hỗ trợ.
Prepare cảnh báo thiếu thống kê
Nguyên nhân: Bản backup không có database mysql. Bản 1.0 luôn kèm mysql; lỗi chỉ gặp với bản tạo từ cấu hình cũ.
Cách sửa: Chạy một bản full mới.
Đồng hồ hai máy lệch
Nguyên nhân: Mỗi yêu cầu được ký kèm thời điểm; lệch quá 5 phút bị từ chối để chống phát lại.
Cách sửa: Bật đồng bộ giờ tự động (Windows Time / chrony / systemd-timesyncd) trên cả hai máy.
Máy chưa ghép cặp
Nguyên nhân: Agent hoặc Center đã bị gỡ ở một bên, hoặc cài lại làm đổi khoá.
Cách sửa: Gỡ ghép cặp ở bên còn lại rồi ghép lại.
Chuỗi backup bị gãy
Nguyên nhân: Thiếu một bản incremental ở giữa (bị xoá, gửi lỗi, hoặc Agent đổi máy).
Cách sửa: Bấm Chạy full ngay trên trang Agent. Các mốc trước chỗ gãy vẫn khôi phục được.
Database đích đã tồn tại
Nguyên nhân: SaintBackup không ghi đè database đang có.
Cách sửa: Đặt tên khác, hoặc tự DROP DATABASE nếu chắc chắn không cần.
IMPORT TABLESPACE không chạy
Nguyên nhân: MariaDB trên Center lưu mọi bảng trong một file chung.
Cách sửa: Đặt innodb_file_per_table=1 trong my.ini của Center và khởi động lại MariaDB.
Ổ đĩa sắp đầy
Nguyên nhân: Center lâu không nhận (tắt máy, mất mạng) nên bản chờ dồn lại; hoặc kho Center đầy.
Cách sửa: Bật Center hoặc sửa kết nối; giảm số ngày giữ ở Center; chuyển kho sang ổ lớn hơn.
MySQL chưa được hỗ trợ
Nguyên nhân: Bản 1.0 chỉ có MariaDB.
Cách sửa: Theo dõi Lộ trình.