> 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/knowledge-base/vi/troubleshooting/vergeos-update-instructions.md).

# Hướng dẫn cập nhật VergeOS

{% hint style="danger" %}
**CẢNH BÁO: KHÔNG BỎ QUA CÁC PHIÊN BẢN CHÍNH**

Ví dụ, nếu bạn đang ở phiên bản 4.8, vui lòng cập nhật lên phiên bản 4.9 trước khi cập nhật lên 4.10. **Việc bỏ qua các phiên bản có thể gây ra các sự cố lớn về cơ sở dữ liệu và cấu hình.**
{% endhint %}

Nền tảng VergeOS hỗ trợ cập nhật “không gián đoạn”. Điều này có nghĩa là trong quá trình cập nhật thông thường, các workload của khách (VM và môi trường tenant) có thể vẫn bật và chạy bình thường.

> Để biết thêm thông tin về quy trình cập nhật, vui lòng tham khảo [Hướng dẫn Sản phẩm](/run-the-platform/system-administration/licensing-and-updates.md).

Thời gian cần để hoàn tất cập nhật thay đổi tùy thuộc vào các yếu tố như:

* Số lượng node trong hệ thống
* Dung lượng lưu trữ đã sử dụng trên vSAN
* Tốc độ thay đổi dữ liệu do các workload tạo ra trong quá trình cập nhật
* Hiệu năng phần cứng (tốc độ bộ xử lý, loại đĩa, tốc độ mạng)

{% hint style="warning" %}
**Trong quá trình cập nhật, bạn có thể thấy các tier và ổ đĩa luân phiên giữa các trạng thái Online, Verifying hoặc Repairing. Đây là điều bình thường khi hệ thống xác minh tính toàn vẹn của dữ liệu.**
{% endhint %}

{% hint style="warning" %}
**Trước khi thực hiện cập nhật, hãy xác minh rằng mức sử dụng bộ nhớ hệ thống của bạn nằm trong giới hạn. Ví dụ, trong cấu hình hai node, tổng bộ nhớ hệ thống nên dưới 50% sử dụng để node còn lại có thể xử lý 100% workload.**
{% endhint %}

{% hint style="warning" %}
**Đảm bảo không có node nào ở chế độ Maintenance trước khi tiếp tục cập nhật.**
{% endhint %}

## Quy trình cập nhật

1. Đăng nhập vào giao diện VergeOS.
2. Điều hướng tới **Hệ thống > Cập nhật**, sau đó chọn **Kiểm tra cập nhật** trong menu bên trái.
   * Một cửa sổ bật lên sẽ hỏi Yes hoặc No, hãy chọn **Có**.
   * Nếu xuất hiện một banner với nội dung "Có một phiên bản phụ mới có sẵn trên một nhánh khác," hãy làm theo lời nhắc để đổi nhánh bằng cách chọn **Đổi nhánh** trong menu bên trái. Xác nhận bằng **Có**. ![VergeOSupgrade-new-img2.png](/files/cdea54105a353cccdef4baaf2630e63e248a0228)
3. Các gói sẽ được tải xuống giờ sẽ được tô sáng. ![VergeOSupgrade-new-img3.png](/files/f8007e7284534c590b0959b403cc28a4d1eaf58a)
   * Chọn **Tải xuống** trong menu bên trái.
   * Một cửa sổ bật lên sẽ hỏi Yes hoặc No, hãy chọn **Có**.
   * Quá trình tải xuống sẽ xuất hiện trên bảng điều khiển trong **Máy chủ cập nhật hiện tại** ô.
4. Khi quá trình tải xuống hoàn tất, **Cài đặt** hành động sẽ khả dụng.
   * Chọn **Cài đặt** khi sẵn sàng.
   * Xác nhận bằng **Có** để bắt đầu cài đặt.
5. Sau khi cài đặt, sẽ xuất hiện yêu cầu khởi động lại hệ thống.
   * Chọn **Khởi động lại** trong menu bên trái để bắt đầu khởi động lại luân phiên trên tất cả các node.

{% hint style="info" %}
**Lưu ý**

Việc cập nhật sẽ bắt đầu với **Node 1**, đưa nó vào chế độ bảo trì và di chuyển workload sang node khác. Trong các thay đổi phiên bản phụ, bạn có thể tạm thời mất quyền truy cập vào giao diện người dùng khi hệ thống chuyển về Node 1. Điều này là bình thường và không nên kéo dài quá một hoặc hai phút. Workload không nên gặp sự cố mạng.
{% endhint %}

## Các bước khắc phục sự cố

### Workload không thể di chuyển

* Lỗi này thường là do không đủ tài nguyên (RAM) trong cụm. Hãy thử di chuyển các workload khác hoặc điều chỉnh mức sử dụng RAM. Các nguyên nhân và giải pháp khác được trình bày chi tiết [tại đây](/knowledge-base/vi/virtual-machines/workloads-failing-to-migrate.md).

### vSAN mất nhiều thời gian để xác minh

* Quá trình xác minh phụ thuộc vào các yếu tố như tốc độ mạng, loại đĩa và lượng dữ liệu đã sử dụng. HDD sẽ mất nhiều thời gian hơn NVMe hoặc SSD. Trên VergeOS phiên bản 4.9.0 trở lên, hãy kiểm tra **Tiến độ Full Walk** trên bảng điều khiển tiers để biết quá trình xác minh đã tiến hành đến đâu.

  ![walk-percentage.png](/files/38e1ed8b0b5e4f785c3146a4a1f2e1c97e5d97f4)

{% hint style="danger" %}
**CẢNH BÁO**

Quá trình này phải hoàn tất trước khi khởi động lại bất kỳ node bổ sung nào. Nếu không, có thể dẫn đến một **lỗi kép**, khiến các workload bị sập.
{% endhint %}

### Không thể kết nối tới máy chủ cập nhật

* Đảm bảo hệ thống có một máy chủ DNS hoạt động trên mạng bên ngoài (UI) của nó:
  1. Đi tới bảng điều khiển mạng bên ngoài.
  2. Chọn **Chẩn đoán** trong menu bên trái.
  3. Đặt Query thành **Tra cứu DNS** và chọn **Gửi**.
  4. Nếu DNS được cấu hình đúng, phản hồi sẽ hiển thị địa chỉ IP của Verge.io. Nếu không, hãy kiểm tra cài đặt DNS và thử lại truy vấn.
* Thông tin xác thực của Máy chủ cập nhật đã hết hạn cũng có thể gây ra sự cố này. Chúng được gắn với giấy phép của hệ thống và nên được gia hạn thông qua đại diện bán hàng VergeOS của bạn.

***

{% hint style="info" %}
**Thông tin tài liệu**

* Cập nhật lần cuối: 2024-09-03
* Phiên bản VergeOS: 4.12.6
  {% endhint %}


---

# 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/knowledge-base/vi/troubleshooting/vergeos-update-instructions.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.
