> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/vi/module-9-giam-sat-and-khac-phuc-su-co/06-common-issues.md).

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

## 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.

```mermaid
graph TD
    A["Xác định triệu chứng"] --> B{"Phân hệ nào?"}
    B -->|VM| C["Mạng / Bộ nhớ"]
    B -->|Storage| D["vSAN / NAS"]
    B -->|Hardware| E["SEL / IPMI"]
    B -->|Install| F["Khởi động / Tham gia"]

    C --> G["Các bước khắc phục"]
    D --> G
    E --> G
    F --> G
    G --> H{"Đã khắc phục?"}
    H -->|Yes| I["Ghi lại & Đóng"]
    H -->|No| J["Chuyển lên Hỗ trợ"]

    style A fill:#4a90d9,color:#fff
    style B fill:#2c3e50,color:#fff
    style G fill:#27ae60,color:#fff
    style J fill:#e74c3c,color:#fff
```

***

## 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](https://docs.verge.io/product-guide/virtual-machines/vm-guest-agent/) để 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               |

{% hint style="success" %}
**Đ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.
{% endhint %}

***

## 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:

```json
{
  "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"
}
```

4. 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:**

```bash
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

{% hint style="warning" %}
**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`.
{% endhint %}

### 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:

```bash
sudo nano /etc/nsmb.conf
```

2. Thêm nội dung sau:

```ini
[default]
smb_neg=smb3_only
signing_required=no
```

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

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

4. **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)

{% hint style="success" %}
**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.
{% endhint %}

### 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/learn-the-platform/vi/module-9-giam-sat-and-khac-phuc-su-co/06-common-issues.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.