Lỗi xfs_quota DirectAdmin: cách xử lý quota XFS

13

Lỗi xfs_quota DirectAdmin thường xuất hiện khi DirectAdmin không thể áp dụng quota dung lượng cho user trên filesystem XFS. Thông báo hay gặp nhất là xfs_quota: cannot set limits: Function not implemented, đặc biệt trên CentOS, AlmaLinux hoặc RockyLinux.

Nếu gặp lỗi này, Anh không nên vội kết luận DirectAdmin bị hỏng. Phần lớn trường hợp đến từ việc phân vùng chứa dữ liệu hosting, thường là /home, chưa được mount với tùy chọn quota phù hợp. Bài viết này hướng dẫn cách kiểm tra đúng nguyên nhân và xử lý lỗi xfs_quota DirectAdmin an toàn trên server production.

---

Mục lục

• Lỗi xfs_quota DirectAdmin là gì?
• Nguyên nhân thường gặp trên DirectAdmin
• Cách kiểm tra filesystem và mount point
• Cách bật quota XFS cho /home
• Cách xử lý nếu /home nằm chung với /
• Rebuild quota trên DirectAdmin
• Các lỗi cần lưu ý sau khi bật quota
• FAQ

Lỗi xfs_quota DirectAdmin là gì?

xfs_quota là công cụ quản lý quota trên filesystem XFS. DirectAdmin dùng quota để giới hạn dung lượng của từng user hosting theo package đã cấp. Ví dụ user được cấp 10 GB thì hệ thống cần ngăn user đó sử dụng vượt quá giới hạn.

Khi DirectAdmin gọi xfs_quota để đặt giới hạn nhưng filesystem chưa bật quota, hệ thống sẽ trả về lỗi:

xfs_quota: cannot set limits: Function not implemented

Có thể hiểu ngắn gọn là: kernel hoặc filesystem hiện tại chưa cho phép thao tác đặt quota theo cách DirectAdmin đang gọi.

Nguyên nhân gây lỗi xfs_quota DirectAdmin

Nguyên nhân	Giải thích
Chưa bật quota XFS	Phân vùng /home chưa có uquota, gquota hoặc pquota.
Sai mount point	/home có thể nằm chung với /, nên bật quota nhầm phân vùng sẽ không có tác dụng.
/etc/fstab thiếu option quota	Sau reboot, quota không được bật lại.
VPS/container giới hạn quota	Một số môi trường ảo hóa không hỗ trợ đầy đủ XFS quota.
DirectAdmin chưa tally lại	Quota đã bật nhưng DirectAdmin chưa cập nhật lại số liệu user.

Về bản chất, đây là nhóm lỗi liên quan đến quota filesystem. Anh có thể tham khảo thêm tài liệu DirectAdmin và tài liệu xfs_quota khi cần đối chiếu sâu hơn. Nếu cần thêm các ghi chú quản trị server, Anh có thể xem thêm chuyên mục Linux Server trên website.

Khi nào lỗi này thường xuất hiện?

Trên DirectAdmin, lỗi này thường xuất hiện trong các tình huống sau:

• Tạo user hosting mới.
• Đổi package cho user.
• Chạy tally toàn bộ user.
• DirectAdmin hiển thị dung lượng user không chính xác.
• User dùng vượt quota nhưng hệ thống không chặn.
• Log DirectAdmin ghi lỗi khi cập nhật quota.

Có thể kiểm tra nhanh log DirectAdmin bằng lệnh:

grep -R "xfs_quota" /var/log/directadmin/ /usr/local/directadmin/data/ 2>/dev/null

Bước 1: Kiểm tra filesystem đang dùng

Trước khi sửa, cần xác định phân vùng chứa dữ liệu hosting đang dùng filesystem gì. Thông thường DirectAdmin lưu user trong /home.

df -Th /home

Ví dụ nếu kết quả là XFS:

Filesystem     Type  Size  Used Avail Use% Mounted on
/dev/sda3      xfs   200G   50G  150G  25% /home

Trường hợp này có thể xử lý bằng xfs_quota.

Nếu filesystem là ext4, không nên xử lý theo hướng XFS. Khi đó quota dùng cơ chế khác như quotaon, quotacheck và repquota.

Bước 2: Xác định đúng mount point của /home

Không phải server nào cũng có phân vùng /home riêng. Một số VPS chỉ có một phân vùng root /, còn thư mục /home nằm bên trong đó.

findmnt -no TARGET,FSTYPE,OPTIONS /home

Nếu kết quả hiển thị target là /home, Anh cần bật quota cho /home. Nếu target là /, cần bật quota cho phân vùng root.

Mẹo nhỏ: luôn xử lý theo mount point thật của /home, không đoán theo tên thư mục.

Bước 3: Kiểm tra trạng thái quota XFS

Nếu /home là phân vùng XFS riêng, chạy:

xfs_quota -x -c 'state' /home

Nếu /home nằm chung với /, chạy:

xfs_quota -x -c 'state' /

Khi quota chưa bật, Anh có thể thấy trạng thái tương tự:

User quota state on /home
  Accounting: OFF
  Enforcement: OFF

Khi quota hoạt động đúng:

User quota state on /home
  Accounting: ON
  Enforcement: ON

Bước 4: Backup file /etc/fstab trước khi sửa

/etc/fstab là file quan trọng. Sửa sai file này có thể khiến server boot vào emergency mode. Vì vậy, luôn backup trước khi chỉnh.

cp -a /etc/fstab /etc/fstab.bak.$(date +%F-%H%M%S)

Kiểm tra file backup:

ls -lh /etc/fstab.bak.*

Bước 5: Bật quota XFS cho phân vùng /home

Nếu /home là phân vùng riêng, mở file /etc/fstab và tìm dòng mount /home:

grep -E '[[:space:]]/home[[:space:]]' /etc/fstab

Ví dụ dòng ban đầu:

UUID=11111111-2222-3333-4444-555555555555 /home xfs defaults 0 0

Sửa thành:

UUID=11111111-2222-3333-4444-555555555555 /home xfs defaults,uquota,gquota,pquota 0 0

Hoặc dùng dạng đầy đủ:

UUID=11111111-2222-3333-4444-555555555555 /home xfs defaults,usrquota,grpquota,prjquota 0 0

Trên nhiều hệ thống, uquota/gquota/pquota và usrquota/grpquota/prjquota là các alias tương ứng. Điều quan trọng là sau khi mount lại, xfs_quota phải báo Accounting và Enforcement là ON.

Bước 6: Nếu /home nằm chung với / thì xử lý thế nào?

Nếu df -Th /home cho thấy /home nằm trên phân vùng root /, Anh cần sửa dòng mount / trong /etc/fstab, không phải tạo dòng riêng cho /home.

Ví dụ dòng ban đầu:

UUID=aaaa-bbbb / xfs defaults 0 0

Sửa thành:

UUID=aaaa-bbbb / xfs defaults,uquota,gquota,pquota 0 0

Đây là điểm nhiều người nhầm. Vì DirectAdmin lưu dữ liệu trong /home, nhưng quota phải bật trên filesystem thật đang chứa thư mục đó.

Bước 7: Remount hoặc reboot để quota có hiệu lực

Sau khi sửa /etc/fstab, có thể thử remount.

Nếu /home là phân vùng riêng:

mount -o remount,uquota,gquota,pquota /home

Nếu /home nằm chung với /:

mount -o remount,uquota,gquota,pquota /

Sau đó kiểm tra lại:

xfs_quota -x -c 'state' /home

Hoặc:

xfs_quota -x -c 'state' /

Nếu remount không áp dụng được, đặc biệt với phân vùng root, Anh nên kiểm tra fstab rồi reboot vào thời điểm phù hợp.

Bước 8: Kiểm tra fstab trước khi reboot

Trước khi reboot server production, nên kiểm tra cấu hình mount:

findmnt --verify

Và:

mount -a

Nếu không có lỗi, có thể reboot khi cần:

reboot

Cảnh báo: không reboot ngay nếu findmnt --verify hoặc mount -a báo lỗi. Hãy sửa lại /etc/fstab trước.

Bước 9: Rebuild quota trên DirectAdmin

Sau khi quota XFS đã hoạt động, cần cho DirectAdmin tính lại dung lượng user.

Chạy tally toàn bộ:

echo "action=tally&value=all" >> /usr/local/directadmin/data/task.queue
/usr/local/directadmin/dataskq d

Hoặc tally một user cụ thể:

echo "action=tally&value=USERNAME" >> /usr/local/directadmin/data/task.queue
/usr/local/directadmin/dataskq d

Thay USERNAME bằng user DirectAdmin thật.

Bước 10: Kiểm tra lại log DirectAdmin

Sau khi chạy tally, kiểm tra log:

tail -n 100 /var/log/directadmin/error.log

Nếu không còn lỗi xfs_quota: cannot set limits: Function not implemented, hệ thống quota đã ổn hơn.

Ví dụ xử lý lỗi xfs_quota DirectAdmin nhanh

Trường hợp phổ biến: DirectAdmin dùng XFS và /home là phân vùng riêng.

df -Th /home
findmnt -no TARGET,FSTYPE,OPTIONS /home
cp -a /etc/fstab /etc/fstab.bak.$(date +%F-%H%M%S)
# Sửa dòng /home trong /etc/fstab, thêm uquota,gquota,pquota
mount -o remount,uquota,gquota,pquota /home
xfs_quota -x -c 'state' /home
echo "action=tally&value=all" >> /usr/local/directadmin/data/task.queue
/usr/local/directadmin/dataskq d
tail -n 100 /var/log/directadmin/error.log

Trường hợp filesystem là ext4

Nếu /home là ext4, không dùng xfs_quota. Với ext4, quota thường dùng các công cụ:

• quotacheck
• quotaon
• repquota

Mount option thường là:

usrquota,grpquota

Ví dụ dòng /etc/fstab cho ext4:

UUID=xxxx-xxxx /home ext4 defaults,usrquota,grpquota 0 2

Sau đó có thể chạy:

quotacheck -avugm
quotaon -avug
repquota -a

Lưu ý quan trọng khi xử lý trên server production

• Luôn backup /etc/fstab trước khi sửa.
• Không reboot nếu chưa kiểm tra mount -a.
• Không đoán mount point, hãy kiểm tra bằng df -Th /home hoặc findmnt.
• Nên giữ một phiên SSH đang mở khi thao tác.
• Nếu server đang có lượng truy cập cao, nên thao tác ngoài giờ cao điểm.
• Nếu là VPS/container, cần xác nhận nhà cung cấp có hỗ trợ quota XFS.

Khi nào cần liên hệ nhà cung cấp VPS?

Anh nên liên hệ nhà cung cấp nếu đã cấu hình đúng nhưng lỗi vẫn còn. Một số môi trường ảo hóa, container hoặc storage backend có thể không hỗ trợ đầy đủ XFS quota.

Nội dung có thể gửi nhà cung cấp:

Server DirectAdmin của tôi dùng XFS nhưng khi set quota gặp lỗi:
xfs_quota: cannot set limits: Function not implemented

Vui lòng kiểm tra VPS/kernel/storage có hỗ trợ XFS user quota/project quota không.

Checklist xử lý lỗi

• Đã kiểm tra filesystem bằng df -Th.
• Đã xác định đúng mount point của /home.
• Đã kiểm tra mount option hiện tại.
• Đã backup /etc/fstab.
• Đã thêm uquota,gquota,pquota hoặc usrquota,grpquota,prjquota.
• Đã remount hoặc reboot.
• Đã kiểm tra bằng xfs_quota -x -c 'state'.
• Đã chạy tally DirectAdmin.
• Đã kiểm tra log DirectAdmin.
• Đã xác nhận quota hiển thị đúng trong DirectAdmin.

Kết luận về lỗi xfs_quota DirectAdmin

Lỗi xfs_quota DirectAdmin thường xuất phát từ việc quota XFS chưa được bật đúng trên phân vùng chứa dữ liệu hosting.

Cách xử lý chuẩn là kiểm tra filesystem, xác định đúng mount point, bật quota trong /etc/fstab, remount hoặc reboot, sau đó chạy tally để DirectAdmin cập nhật lại dữ liệu quota.

Nếu Anh đang xử lý server production, hãy thao tác cẩn thận với /etc/fstab, kiểm tra kỹ trước khi reboot và nên có backup hoặc snapshot nếu server quan trọng.

---

FAQ

Lỗi xfs_quota: cannot set limits: Function not implemented có nguy hiểm không?

Lỗi này không làm website ngừng chạy ngay, nhưng có thể khiến DirectAdmin không giới hạn dung lượng user đúng. Về lâu dài, user có thể dùng vượt package hoặc dung lượng hiển thị sai.

Có bắt buộc phải reboot server không?

Không phải lúc nào cũng cần. Nếu /home là phân vùng riêng, có thể thử remount. Nếu quota bật trên phân vùng root /, reboot thường chắc chắn hơn.

Nên dùng uquota,gquota,pquota hay usrquota,grpquota,prjquota?

Trên XFS, hai nhóm option này thường tương đương nhau tùy hệ điều hành. Quan trọng là sau khi mount lại, xfs_quota -x -c 'state' phải báo quota đang bật.

Nếu /home là ext4 thì có dùng xfs_quota không?

Không. Với ext4, cần dùng quota kiểu ext4 như quotacheck, quotaon và repquota.

DirectAdmin vẫn báo sai dung lượng sau khi bật quota thì làm gì?

Hãy chạy lại tally toàn bộ user bằng dataskq, sau đó kiểm tra log DirectAdmin và giao diện quản trị.

Hashtag: #DirectAdmin #XFSQuota #LinuxServer #Hosting #SystemAdmin #AlmaLinux #RockyLinux #CentOS #VPS #Quota