> 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/run-the-platform/vi/van-hanh/sop-update.md).

# Hướng dẫn cập nhật phiên bản VergeOS

Hướng dẫn này cung cấp các phương pháp tốt nhất để cập nhật an toàn hệ thống VergeOS lên một bản phát hành điểm mới. Hướng dẫn tập trung vào bảo mật dữ liệu và khả năng phục hồi của hệ thống thông qua một cách tiếp cận có phương pháp.

{% hint style="info" %}
**Tổng quan**

Việc cập nhật hệ thống VergeOS của bạn đòi hỏi phải lập kế hoạch và thực hiện cẩn thận để đảm bảo gián đoạn dịch vụ ở mức tối thiểu. Hướng dẫn này chia quy trình thành các giai đoạn chính:

1. **Chuẩn bị** - Các bước cần thực hiện trước cửa sổ bảo trì đã lên lịch của bạn
2. **Xác minh trước khi cập nhật** - Các kiểm tra cuối cùng ngay trước khi bắt đầu cập nhật
3. **Thực hiện cập nhật** - Quá trình cài đặt bản cập nhật
4. **Xác minh sau khi cập nhật** - Đảm bảo bản cập nhật đã thành công
   {% endhint %}

{% hint style="info" %}
**Yêu cầu cụ thể theo môi trường**

Hướng dẫn này bao gồm các phương pháp hay nhất chung. Bạn có thể cần điều chỉnh các bước này cho phù hợp với môi trường và yêu cầu cụ thể của mình.
{% endhint %}

## Điều kiện tiên quyết

* Quyền truy cập quản trị vào hệ thống VergeOS
* Quyền truy cập IPMI vào tất cả các node trong cụm
* Kết nối mạng để tải bản cập nhật
* **Thời gian ước tính:** 1-2 giờ tùy thuộc vào kích thước cụm và độ phức tạp của bản cập nhật

## Giai đoạn chuẩn bị

Hoàn thành các bước này từ sớm, trước cửa sổ bảo trì đã lên lịch của bạn:

### Sẵn sàng của hệ thống

* [ ] Đảm bảo thời gian lưu giữ snapshot của hệ thống đủ cho khả năng khôi phục lại
* [ ] Thiết lập các tiêu chí thành công và xác minh cụ thể cho khối lượng công việc của bạn
* [ ] Xác định các nhóm VM, dịch vụ, v.v. cần thiết cho trường hợp sử dụng cụ thể của bạn

{% hint style="info" %}
**Ví dụ về trường hợp sử dụng**

VDI có thể có nhiều hình ảnh hoặc nhóm tài nguyên riêng biệt. VPS có thể tập trung nhiều hơn vào chức năng mạng và khả năng kết nối.
{% endhint %}

* [ ] Lập bản đồ các sự kiện hệ thống và guest nhạy cảm với thời gian phải tiếp tục hoạt động

### Tài liệu và lập kế hoạch

* [ ] Cập nhật tài liệu nền tảng với cửa sổ bảo trì dự kiến
* [ ] Xem xét các bản cập nhật/nâng cấp cộng hưởng nào có thể cần được chạy
  * Tránh kết hợp các bản cập nhật không cần thiết
* [ ] Kiểm tra ghi chú phát hành phiên bản và lập kế hoạch cho bất kỳ tác động cụ thể nào
* [ ] Ghi lại cấu hình hệ thống hiện tại để tham chiếu khi khôi phục
* [ ] Lên kế hoạch thời gian truyền thông cho người dùng bị ảnh hưởng

### Xác minh tài nguyên

* [ ] Kiểm tra mức sử dụng tài nguyên của cụm
  * Đảm bảo hệ thống của bạn có đủ tài nguyên dự phòng để mất nút lớn nhất của bạn
* [ ] Xác nhận các đường dẫn mạng giữa các host
  * Từ mỗi nút: Node Diagnostics -> Fabric Configuration (tất cả các đường dẫn trên tất cả các nút phải là "confirmed:true")
* [ ] Nếu khả năng dự phòng mạng chưa được kiểm tra gần đây, hãy lên lịch kiểm tra trước khi cập nhật
* [ ] Xác nhận quyền truy cập IPMI vào tất cả host bằng một phương thức cho phép truy cập console trong trường hợp khẩn cấp

### Giai đoạn chuẩn bị cập nhật

1. Trong VergeOS, điều hướng đến **System > Updates**
2. Nhấp vào **Kiểm tra cập nhật**
3. Tải xuống bản cập nhật (nó sẽ không bắt đầu cho đến khi nhấp vào "Install")
4. Ghi lại phiên bản hiện tại và phiên bản mục tiêu để làm tài liệu

## Xác minh trước khi cập nhật

Thực hiện các kiểm tra này vào ngày bảo trì đã lên lịch, trước khi bắt đầu cập nhật:

### Xác minh trạng thái hiện tại

* [ ] Xác nhận phiên bản đang chạy là phiên bản mong đợi
* [ ] Kiểm tra nhật ký để tìm các lỗi gần đây
  * Ghi chú các sự cố không nghiêm trọng
  * Hủy nếu phát hiện lỗi nghiêm trọng
* [ ] Xác minh khả năng sẵn có của tài nguyên đáp ứng yêu cầu N+1
  * Xác nhận việc sử dụng RAM cho phép workload chạy khi một nút ngoại tuyến
* [ ] Xác minh các snapshot hệ thống gần đây và sẵn dùng
  * Đặt snapshot gần đây nhất hết hạn vào vài ngày tới để lưu giữ thêm
* [ ] Xác nhận đồng bộ đa site hoạt động bình thường và được cập nhật
* [ ] Xác minh tất cả các tầng vSAN đang ở trạng thái khỏe mạnh (trạng thái xanh)
* [ ] Xác nhận không có node nào đang chờ khởi động lại
* [ ] Ghi lại đường cơ sở hiệu năng hệ thống để so sánh sau khi cập nhật

### Xác minh cập nhật

* [ ] Xác nhận bản cập nhật đã được chuẩn bị của bạn trong **System > Updates**
* [ ] Kiểm tra lại các bản cập nhật
  * Nếu có một bản cập nhật khác, hãy đánh giá cẩn thận trước khi tiếp tục
* [ ] Xác minh đủ dung lượng đĩa cho quá trình cập nhật
* [ ] Xác nhận tất cả các nút có thể truy cập và phản hồi

## Giai đoạn thực hiện

### Cài đặt bản cập nhật

Quá trình cập nhật thực tế:

1. Đi tới **System > Updates**
2. Nhấp vào **Cài đặt** để bắt đầu quá trình cập nhật
3. **Theo dõi Nút 1** khi nó tự động:
   * Tự đưa vào chế độ bảo trì
   * Khởi động lại và áp dụng bản cập nhật
   * Quay lại phục vụ
4. **Quan sát các nút tiếp theo** khi hệ thống tiếp tục cập nhật và khởi động lại các nút
5. **Theo dõi workload** và mức sử dụng tài nguyên hệ thống trong suốt quá trình
6. **Theo dõi tiến trình** - mỗi nút sẽ được cập nhật tuần tự để duy trì khả năng sẵn có của dịch vụ

{% hint style="success" %}
**Theo dõi cập nhật**

Trong quá trình cập nhật, bạn có thể theo dõi tiến trình trong phần System > Updates. Mỗi nút sẽ hiển thị trạng thái hiện tại và tiến trình của nó qua các giai đoạn cập nhật.
{% endhint %}

{% hint style="warning" %}
**Không được gián đoạn**

Không tắt nguồn các nút hoặc làm gián đoạn quá trình cập nhật sau khi nó đã bắt đầu. Hãy để mỗi nút hoàn thành chu kỳ cập nhật một cách tự nhiên.
{% endhint %}

## Xác minh sau khi cập nhật

Sau khi cập nhật hoàn tất, hãy xác minh hệ thống đang hoạt động đúng cách:

### Xác nhận phiên bản

* [ ] Xác nhận phiên bản mong đợi trong **System > Updates**
  * Xác minh các gói sau đang ở phiên bản mong đợi:
    * **osm** (Dữ liệu Open Street Maps)
    * **yb** (Bộ phần mềm đám mây Verge.io)
    * **yb-help** (Trợ giúp và tài liệu tích hợp)
    * **ybos** (Hệ điều hành Verge.io)

### Kiểm tra tình trạng hệ thống

* [ ] Xác nhận ô 'Nodes Updated' trong **System > Updates** màu xanh và tất cả các nút đã hoàn tất
* [ ] Đảm bảo tất cả các tầng vSAN đều hiển thị trạng thái xanh
* [ ] Xác minh tất cả các nút hiển thị trạng thái xanh "Running"
  * Xác nhận các nút không có bất kỳ lần khởi động lại nào đang chờ
* [ ] Kiểm tra/xác nhận các hệ thống khách theo yêu cầu trong tiêu chí thành công của bạn
* [ ] Chụp một snapshot thủ công với thời gian lưu giữ vài ngày
* [ ] Kiểm tra nhật ký để tìm bất kỳ sự kiện mới hoặc bất ngờ nào
* [ ] Xác minh tất cả các tiêu chí thành công đã nêu trong các bước chuẩn bị của bạn
* [ ] Xác nhận hiệu năng hệ thống phù hợp hoặc vượt mức cơ sở

### Kiểm tra chức năng

* [ ] Kiểm tra các thao tác VM quan trọng (khởi động, dừng, di chuyển)
* [ ] Xác minh kết nối mạng và hiệu năng
* [ ] Xác nhận các thao tác sao lưu và snapshot đang hoạt động
* [ ] Kiểm tra mọi tích hợp hoặc tự động hóa tùy chỉnh

## Khắc phục sự cố

### Các sự cố thường gặp

**Quá trình cập nhật bị đứng trên một nút**

* Kiểm tra khả năng truy cập nút qua IPMI
* Xem lại nhật ký hệ thống để tìm thông báo lỗi
* Xác minh kết nối mạng đến nút bị đứng
* Liên hệ hỗ trợ nếu nút vẫn không phản hồi

**Không khớp phiên bản sau khi cập nhật**

* Cho thêm thời gian để tất cả các thành phần đồng bộ
* Kiểm tra xem có gói nào cài đặt thất bại không
* Xác minh kết nối mạng giữa các node
* Xem lại nhật ký cập nhật để biết lỗi cụ thể

**Hiệu năng suy giảm sau khi cập nhật**

* So sánh với đường cơ sở trước khi cập nhật
* Kiểm tra các ràng buộc tài nguyên mới
* Xem lại tình trạng và hiệu năng của các tầng vSAN
* Theo dõi trong 24-48 giờ để thiết lập đường cơ sở mới

**VM không khởi động được sau khi cập nhật**

* Kiểm tra khả năng tương thích cấu hình VM
* Xác minh khả năng truy cập tầng lưu trữ
* Xem lại nhật ký riêng của VM để tìm lỗi
* Kiểm tra riêng từng thao tác của VM

## Quy trình khôi phục

{% hint style="warning" %}
**Các cân nhắc về khôi phục**

Nếu xảy ra sự cố, cách an toàn nhất là tạm dừng, điều tra hành vi bất thường, rồi tiếp tục lại với sự hiểu biết rõ ràng về vấn đề. Các bản cập nhật VergeOS được thiết kế để tương thích ngược, và việc khôi phục không phải lúc nào cũng có thể thực hiện được.
{% endhint %}

### Nếu xảy ra sự cố

1. **Ghi lại vấn đề** một cách chi tiết với ảnh chụp màn hình và nhật ký
2. **Cô lập sự cố** - xác định xem nó ảnh hưởng đến tất cả các nút hay các thành phần cụ thể
3. **Liên hệ hỗ trợ** trước khi thực hiện bất kỳ quy trình khôi phục nào
4. **Giữ nguyên trạng thái hệ thống** để phân tích khắc phục sự cố
5. **Làm theo hướng dẫn của bộ phận hỗ trợ** để xử lý hoặc thực hiện quy trình khôi phục

## Các bước tiếp theo

Sau khi cập nhật hoàn tất thành công:

* [ ] Cập nhật tài liệu hệ thống với thông tin phiên bản mới
* [ ] Lên lịch giám sát định kỳ để đảm bảo ổn định
* [ ] Xem lại mọi tính năng hoặc thay đổi mới được giới thiệu trong bản cập nhật
* [ ] Lập kế hoạch cho các bản cập nhật trong tương lai dựa trên lịch phát hành
* [ ] Cập nhật quy trình sao lưu và khôi phục thảm họa nếu cần

{% hint style="danger" %}
**Hỗ trợ khẩn cấp**

Nếu bạn gặp bất kỳ vấn đề nào với bản cập nhật phần mềm VergeOS của mình, vui lòng liên hệ [đội ngũ hỗ trợ của chúng tôi](/overview/vi/support-and-services.md) để được trợ giúp ngay lập tức.
{% 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/run-the-platform/vi/van-hanh/sop-update.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.