Các sự cố thường gặp & cách khắc phục

Các mẫu khắc phục sự cố cho những vấn đề VergeOS thường gặp nhất — mạng VM, báo cáo bộ nhớ guest, SEL noise, NAS shares, sự cố cài đặt và suy giảm lưu trữ.

Tài liệu tham khảo nhanh khắc phục sự cố

Trang này tổng hợp các sự cố phổ biến nhất mà quản trị viên VergeOS gặp phải, được tổ chức theo từng phân hệ. Mỗi mục bao gồm triệu chứng, nguyên nhân gốc rễ và quy trình khắc phục từng bước.

---

Kết nối mạng VM

Các sự cố kết nối mạng là chủ đề hỗ trợ phổ biến nhất. Trước khi đi sâu, hãy xác minh liệu các VM khác trong cùng môi trường có thể truy cập internet hay không. Nếu không VM nào truy cập được, sự cố có khả năng nằm ngoài VergeOS (switch, tường lửa, ISP). Nếu các VM khác hoạt động bình thường, vấn đề gần như luôn là một thiếu sót cấu hình trên VM bị ảnh hưởng.

Thiếu cấu hình NIC

Triệu chứng: VM khởi động nhưng hệ điều hành khách không thấy giao diện mạng nào.

Khắc phục:

1. Mở bảng điều khiển VM và kiểm tra NIC mục
2. Nếu không có NIC nào được liệt kê, nhấp Thêm NIC
3. Chọn đúng mạng và đặt loại giao diện thành VirtIO (khuyến nghị) hoặc E1000 để tương thích với hệ thống cũ
4. NIC sẽ xuất hiện ngay trong máy khách khi hot-plug được bật (mặc định) — một số hệ điều hành có thể cần quét lại hệ điều hành khách. Chỉ khởi động lại nguồn nếu hot-plug bị tắt.

Gán sai mạng

Triệu chứng: VM có NIC nhưng không thể truy cập các VM khác hoặc internet.

Khắc phục:

1. Đi tới bảng điều khiển VM → NIC
2. Xác minh trạng thái NIC là Up
3. Xác nhận Mạng cột hiển thị đúng mạng — so sánh với một VM đang hoạt động trong cùng môi trường
4. Nếu sai, chỉnh sửa NIC và gán lại nó vào mạng phù hợp
5. Tắt/bật nguồn VM

Thiếu trình điều khiển VirtIO

Triệu chứng: VM Windows không hiển thị bộ điều hợp mạng trong Trình quản lý Thiết bị, mặc dù NIC đã được cấu hình trong VergeOS.

Khắc phục:

1. Xác minh rằng có một NIC trong NIC mục của VM trong VergeOS
2. Kết nối tới VM qua Bảng điều khiển từ xa
3. Cài đặt trình điều khiển VirtIO từ ISO của guest agent — tham khảo tài liệu VergeOS về Tác nhân khách VM để biết các bước tải xuống và cài đặt
4. Sau khi cài trình điều khiển, Windows sẽ tự động phát hiện bộ điều hợp mạng

Cấu hình IP khách không đúng

Triệu chứng: NIC đã có và trình điều khiển đã được cài đặt, nhưng VM vẫn không thể truy cập mạng.

Khắc phục:

1. Trong hệ điều hành khách, xác minh bộ điều hợp mạng đã được phát hiện và bật
2. Với DHCP: đảm bảo mạng có dịch vụ DHCP đang chạy (kiểm tra Mạng → [Mạng] → DHCP)
3. Với IP tĩnh: xác nhận địa chỉ IP, mặt nạ mạng con, cổng mặc định và cài đặt DNS khớp với thiết kế mạng
4. Sử dụng Chẩn đoán mạng công cụ (ping, quét ARP) từ ngữ cảnh mạng VergeOS để xác minh kết nối Lớp 2

---

Báo cáo bộ nhớ khách

Quản trị viên chuyển từ VMware hoặc Nutanix thường nhận thấy VergeOS báo mức sử dụng bộ nhớ cao hơn họ mong đợi. Đây là chủ đích thiết kế — không phải vấn đề.

Bộ nhớ đã cấp phát so với bộ nhớ đang hoạt động

Triệu chứng: VergeOS hiển thị một VM đang dùng 8 GB RAM, nhưng trình quản lý tác vụ của hệ điều hành khách chỉ cho thấy 2 GB đang được sử dụng.

Giải thích: VergeOS hiển thị đã cấp phát bộ nhớ — RAM vật lý được dành riêng trên máy chủ cho VM đó. Khi bạn gán 8 GB cho một VM, hypervisor sẽ ngay lập tức dành 8 GB bộ nhớ vật lý, bất kể hệ điều hành khách đang sử dụng bao nhiêu. Đây là mức cam kết tài nguyên thực sự trên máy chủ.

Không dùng ballooning bộ nhớ

Không giống các nền tảng dựa vào memory ballooning để thu hồi bộ nhớ khách không dùng, VergeOS cố ý không sử dụng ballooning. Quyết định thiết kế này mang lại:

• Hiệu năng có thể dự đoán — không có chi phí phụ của driver balloon hay áp lực bộ nhớ bất ngờ
• Lập kế hoạch dung lượng đơn giản hơn — đã cấp phát = đã cam kết; không cần đoán tỷ lệ overcommit
• Độ tin cậy cao hơn — không có rủi ro OOM do balloon gây ra bên trong máy khách
• Kích thước di chuyển chính xác — lượng bạn cấp phát chính là lượng bạn cần trên máy chủ đích

Thực hành tốt nhất khi lập kế hoạch dung lượng

Chỉ số	Kiểm tra ở đâu	Ý nghĩa
RAM VM đã cấp phát	Bảng điều khiển VM	RAM vật lý được dành riêng cho VM này
RAM hoạt động của khách	Trong hệ điều hành khách (Task Manager / free -h)	Phần mà hệ điều hành khách thực sự đang dùng
RAM khả dụng của nút	Bảng điều khiển nút → Bộ nhớ	Còn lại bao nhiêu RAM máy chủ chưa được cấp phát
% RAM tối đa mục tiêu của cụm	Hệ thống → Cài đặt → Nâng cao	Ngưỡng để quyết định vị trí đặt VM

Điều chỉnh kích thước VM cho phù hợp

Vì VergeOS cấp phát toàn bộ lượng bộ nhớ, việc điều chỉnh kích thước bộ nhớ VM phù hợp quan trọng hơn so với các nền tảng có ballooning. Hãy bắt đầu với mức cấp phát thận trọng và chỉ tăng khi giám sát trong máy khách cho thấy mức sử dụng cao kéo dài.

---

Nhiễu SEL (nhật ký IPMI báo sai)

Một số phần cứng máy chủ tạo ra các mục nhật ký IPMI lặp đi lặp lại, vô hại, làm đầy System Event Log (SEL) và kích hoạt cảnh báo không cần thiết. Thủ phạm phổ biến nhất là "lệnh Get SEL Info thất bại" thông báo.

Hiểu về SEL

System Event Log được lưu trữ trong phần cứng (trên bộ điều khiển BMC/IPMI) với dung lượng hạn chế. Khi đầy, các sự kiện mới không thể được ghi lại cho đến khi nhật ký được xóa. Bảng điều khiển nút hiển thị dung lượng SEL dưới dạng thanh phần trăm.

Lọc nhiễu SEL qua API

Để loại bỏ các thông báo báo sai mà không làm mất cảnh báo phần cứng thực:

1. Đi tới Hệ thống → Tài liệu API
2. Tìm cài đặt bảng và mở rộng nó
3. Nhấp vào POST tùy chọn và nhập nội dung sau:

{
  "key": "syslog_regex_list",
  "value": "2E2A4765742053454C20496E666F20636F6D6D616E64206661696C65642E",
  "default_value": "",
  "description": "Các dòng biểu thức chính quy được mã hóa hex để lọc ra khỏi syslog"
}

1. Nhấp Thực thi

Giá trị là một regex được mã hóa hex: .*Get SEL Info command failed. — bạn có thể mã hóa các mẫu bổ sung bằng công cụ mã hóa hex và phân tách nhiều mẫu bằng |.

Ví dụ — lọc hai mẫu:

Biểu thức chính quy (Get SEL Info command failed|Unable to send command: Device or resource busy) được mã hóa thành:

284765742053454C20496E666F20636F6D6D616E64206661696C65647C556E61626C6520746F2073656E6420636F6D6D616E643A20446576696365206F72207265736F75726365206275737929

Khởi động lại dịch vụ IPMI

Sau khi áp dụng bộ lọc, khởi động lại việc thu thập nhật ký trên từng nút bị ảnh hưởng:

Tùy chọn A — Qua giao diện:

1. Đi tới Hạ tầng → Nút → [Nút]
2. Chỉnh sửa nút, bỏ chọn "Thu thập nhật ký hệ thống", gửi
3. Chờ 15 giây
4. Chỉnh sửa lại nút, bật lại "Thu thập nhật ký hệ thống"

Tùy chọn B — Qua SSH:

sudo systemctl restart openipmi

Xóa một SEL đã đầy

Nếu SEL đã đầy:

1. Đi tới Hạ tầng → Nút → [Nút]
2. Nhấp Xóa SEL trong menu bên trái
3. Xác nhận bằng Có

---

Sự cố chia sẻ NAS

Windows: Không thể Kết nối tới CIFS Shares

Triệu chứng: Máy khách Windows 10/11 không thể truy cập các chia sẻ CIFS, nhận lỗi "access denied" hoặc "cannot connect" ngay cả khi thông tin xác thực đúng.

Nguyên nhân gốc rễ: Windows hiện đại mặc định tắt đăng nhập khách không an toàn cho kết nối SMB.

Khắc phục — Bật đăng nhập khách không an toàn:

1. Nhấn Win + R, nhập gpedit.msc, nhấn Enter
2. Đi tới: Computer Configuration → Administrative Templates → Network → Lanman Workstation
3. Tìm Enable insecure guest logons → Nhấp chuột phải → Chỉnh sửa
4. Chọn Đã bật → Nhấp OK
5. Khởi động lại thiết bị Windows

Windows Home Edition

gpedit.msc không có sẵn trên Windows Home. Hãy dùng Registry Editor thay thế: Đi tới HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters và đặt AllowInsecureGuestAuth (DWORD) thành 1.

macOS: Lỗi kết nối hoặc hiệu năng kém

Triệu chứng: Finder trên macOS không thể kết nối tới các chia sẻ CIFS, kết nối bị rớt ngắt quãng, hoặc hiệu năng không thể sử dụng được.

Khắc phục — Ép SMB3 thông qua nsmb.conf:

1. Mở Terminal và tạo hoặc chỉnh sửa cấu hình SMB:

sudo nano /etc/nsmb.conf

1. Thêm nội dung sau:

[default]
smb_neg=smb3_only
signing_required=no

1. Xóa bộ nhớ đệm SMB của macOS:

sudo rm -rf /var/db/samba/*
sudo rm -rf /var/db/smb/*

1. Khởi động lại máy Mac để áp dụng thay đổi

Tùy chọn cấu hình nâng cao cho máy khách macOS: Để tương thích tốt hơn với macOS, hãy thêm các chỉ thị dành cho macOS (bao gồm vfs objects = fruit streams_xattr và các fruit:* tùy chọn liên quan) trong Tùy chọn cấu hình nâng cao trong cài đặt NAS CIFS (NAS → CIFS). Điều này bật các phần mở rộng SMB gốc của Apple.

Lỗi bị từ chối quyền

Triệu chứng: Người dùng nhận "Access Denied" khi duyệt hoặc mở tệp trên một share, dù họ vẫn thấy tên share.

Danh sách kiểm tra khắc phục:

1. Danh sách người dùng hợp lệ: Đi tới NAS → Shares → [Share] và xác nhận người dùng hoặc nhóm nằm trong danh sách valid users
2. Cài đặt browseable: Đảm bảo share được đặt là browseable nếu người dùng cần tự tìm thấy nó
3. Ép người dùng / Ép nhóm: Nếu đã cấu hình, xác minh người dùng/nhóm bị ép có quyền đọc/ghi trên volume bên dưới
4. Khởi động lại dịch vụ NAS: Sau khi thay đổi quyền, khởi động lại dịch vụ NAS để áp dụng

Hiệu năng CIFS Chậm

Triệu chứng: Việc truyền tệp qua CIFS chậm hơn đáng kể so với mong đợi.

Khắc phục:

1. Phiên bản giao thức SMB: Trong mục NAS → Volumes → [Volume] → Advanced Configuration, xác minh phiên bản SMB tối thiểu. Đặt quá thấp (SMB1) sẽ buộc đàm phán kiểu cũ
2. Đường dẫn mạng: Dùng Network Diagnostics (ping, traceroute) để kiểm tra độ trễ giữa mạng con của máy khách và mạng NAS
3. Tải kết nối: Dùng NAS Diagnostics → Trạng thái Samba để kiểm tra các kết nối đang hoạt động và xác định các share quá tải
4. Tài nguyên NAS: Kiểm tra phân bổ CPU và bộ nhớ cho dịch vụ NAS — các VM NAS cấp phát thiếu sẽ là nút thắt thông lượng

---

Khắc phục sự cố cài đặt

Sự cố khởi động

Triệu chứng: Nút không khởi động được từ trình cài đặt USB VergeOS.

Khắc phục:

• Xác minh cài đặt khởi động BIOS/UEFI khớp với loại phương tiện cài đặt (khuyến nghị UEFI)
• Thử phương tiện USB trên một hệ thống đã biết hoạt động để loại trừ ổ đĩa lỗi
• Xác nhận tương thích phần cứng — kiểm tra CPU có hỗ trợ 64-bit với ảo hóa phần cứng (VT-x/AMD-V)
• Tắt Secure Boot trong BIOS nếu trình cài đặt không tải được

Không khớp cấu hình mạng

Triệu chứng: Cài đặt hoàn tất nhưng nút không thể giao tiếp với các nút khác hoặc với mạng.

Khắc phục:

• Trong quá trình cài đặt, dừng ngay lập tức nếu bất kỳ IP hoặc giao diện nào được phát hiện không khớp với thiết kế mạng của bạn
• Xác minh cấu hình VLAN khớp với cài đặt cổng switch
• Kiểm tra kết nối cáp vật lý — trình cài đặt tự động phát hiện giao diện; cáp đấu sai sẽ dẫn đến gán sai giao diện
• Xác nhận địa chỉ IP không xung đột với các thiết bị hiện có trên mạng

Chế độ JBOD của bộ điều khiển lưu trữ

Triệu chứng: Trình cài đặt VergeOS không phát hiện tất cả ổ đĩa mong đợi.

Khắc phục:

• VergeOS yêu cầu các ổ đĩa được trình bày dưới dạng đĩa riêng lẻ (chế độ JBOD/passthrough), không dưới dạng mảng RAID
• Vào BIOS của bộ điều khiển lưu trữ (ví dụ: PERC, MegaRAID) và cấu hình từng ổ đĩa thành volume JBOD hoặc RAID-0 riêng lẻ
• Một số bộ điều khiển cần cập nhật firmware để hỗ trợ chế độ JBOD — hãy tham khảo tài liệu của nhà cung cấp phần cứng

Lỗi tham gia của nút phụ

Triệu chứng: Bộ điều khiển phụ hoặc nút tính toán không thể tham gia cụm hiện có.

Khắc phục:

1. Xác minh rằng bạn đã chọn "Không" khi được hỏi đây có phải là cài đặt mới không (đối với các nút phụ)
2. Xác nhận rằng bạn đã nhập thông tin xác thực quản trị từ bộ điều khiển chính chính xác
3. Đảm bảo cả hai nút ở cùng một mạng và có thể truy cập nhau (kiểm tra gán VLAN của cổng switch)
4. Khớp chính xác cài đặt mã hóa từ bộ điều khiển chính
5. Khớp chính xác gán tầng ổ đĩa từ bộ điều khiển chính
6. Nếu nút phụ khởi động nhưng không hiển thị trong giao diện người dùng của nút chính, hãy kiểm tra cấu hình mạng core fabric và xác minh kết nối switch giữa các nút

---

Sự cố lưu trữ

Trạng thái vSAN suy giảm

Triệu chứng: Bảng điều khiển hiển thị một tầng vSAN ở trạng thái "degraded" hoặc "not redundant".

Giải thích: Trạng thái suy giảm nghĩa là một hoặc nhiều ổ đĩa trong một tầng đã hỏng hoặc không khả dụng, nhưng vSAN vẫn hoạt động. Dữ liệu vẫn truy cập được vì VergeOS duy trì dự phòng trên các nút.

Khắc phục:

1. Đi tới Hệ thống → vSAN → Ổ đĩa để xác định (các) ổ đĩa bị lỗi
2. Kiểm tra dữ liệu SMART của ổ đĩa qua Chẩn đoán nút → Kiểm tra chẩn đoán S.M.A.R.T.
3. Nếu cần thay thế phần cứng, dùng Chẩn đoán nút → Điều khiển LED để bật sáng khay ổ đĩa nhằm nhận diện
4. Liên hệ hỗ trợ Verge để được hướng dẫn thay ổ đĩa — vSAN sẽ tự động xây dựng lại dự phòng khi ổ thay thế được thêm vào

Thời gian tái tạo ổ đĩa

Hiểu kỳ vọng: Thời gian tái tạo phụ thuộc vào lượng dữ liệu trên tầng và dung lượng I/O của các ổ đĩa còn lại. Trong quá trình tái tạo:

• Hệ thống vẫn hoạt động đầy đủ
• Hiệu năng ghi có thể giảm nhẹ
• Theo dõi tiến trình qua chỉ báo tiến độ của tầng trên bảng điều khiển vSAN (100% = hoàn tất)

Giảm thiểu tác động của tái tạo

Tránh lên lịch di chuyển khối lượng công việc lớn hoặc nhập dữ liệu lớn trong quá trình tái tạo. vSAN ưu tiên các thao tác tái tạo, nhưng I/O bổ sung sẽ kéo dài thời gian tái tạo.

Cảnh báo ngưỡng dung lượng

Triệu chứng: Cảnh báo trên bảng điều khiển cho biết dung lượng lưu trữ đang tiến gần giới hạn.

Khắc phục:

1. Kiểm tra mức sử dụng tầng trong Hệ thống → vSAN — mỗi tầng hiển thị dung lượng đã dùng so với tổng dung lượng
2. Xem dữ liệu SMART của ổ đĩa qua Hạ tầng → Nút → [Nút] → Chẩn đoán → Kiểm tra chẩn đoán S.M.A.R.T. để kiểm tra mức độ hao mòn và các chỉ báo sức khỏe ổ đĩa
3. Để giảm ngay, hãy xác định và xóa các snapshot không cần thiết hoặc các ổ đĩa VM không dùng
4. Để khắc phục lâu dài, thêm ổ đĩa hoặc nút để mở rộng tầng — tham khảo quy trình mở rộng quy mô vSAN

Các ngưỡng sau là hướng dẫn đào tạo cho việc lập kế hoạch, không phải ngưỡng được tài liệu hóa. Các giá trị được tài liệu hóa là mặc định mức sử dụng cao 80% subscription (được dùng bởi các cảnh báo mức sử dụng cao mặc định của vSAN/tầng lưu trữ) và 90% sync_max_usage ngưỡng mà tại đó vSAN điều tiết ghi và đánh dấu tầng là outofspace.

Mức sử dụng	Hành động cần thực hiện
< 70%	Hoạt động bình thường — không cần hành động
70–85%	Lên kế hoạch mở rộng dung lượng; xem lại chính sách giữ snapshot
85–90%	Chủ động giảm mức sử dụng hoặc thêm dung lượng
> 90%	Khẩn cấp — ưu tiên mở rộng; nguy cơ lỗi ghi

---

Cây quyết định khắc phục sự cố

Khi gặp một sự cố không phù hợp với các nhóm trên, hãy làm theo quy trình chung này:

1. Xác định phạm vi sự cố

Sự cố ảnh hưởng đến một VM, một mạng, một nút hay toàn bộ hệ thống? Xác định phạm vi sẽ quyết định nên bắt đầu bằng công cụ chẩn đoán nào.

2. Dùng chẩn đoán theo thành phần

Bắt đầu bằng công cụ chẩn đoán theo thành phần (Network, Node, NAS hoặc vSAN Diagnostics) — chúng tự động chạy trong ngữ cảnh đúng.

3. Kiểm tra nhật ký hệ thống

Xem lại nhật ký Dashboard và cảnh báo hệ thống để tìm các sự kiện liên quan. Hãy tìm mẫu — có nhiều cảnh báo cùng kích hoạt một lúc không?

4. Chuyển tiếp kèm dữ liệu

Nếu sự cố chưa được giải quyết, tạo một Chẩn đoán Hệ thống gói bundle (Hệ thống → Chẩn đoán hệ thống) và gửi kèm yêu cầu hỗ trợ của bạn.