> 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/system-administration/proper-vergeos-system-shutdown-procedure.md).

# Quy trình tắt hệ thống VergeOS đúng cách

## Tổng quan

Tài liệu này cung cấp quy trình từng bước để tắt đúng cách một hệ thống VergeOS. Việc tuân theo đúng trình tự tắt là rất quan trọng để đảm bảo tính toàn vẹn dữ liệu, ngăn ngừa hỏng dữ liệu và duy trì tình trạng khỏe mạnh của môi trường VergeOS của bạn.

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

* Quyền truy cập quản trị vào giao diện người dùng VergeOS
* Hiểu rõ cấu trúc tô-pô của cụm
* Xác định tất cả các workload và tenant đang chạy
* Biết vị trí các nút controller (Node1 & Node2)

## Trình tự tắt

### Bước 1: Kiểm kê các workload đang chạy

Trước khi bắt đầu quá trình tắt, bạn phải xác định tất cả các workload đang hoạt động trong toàn bộ môi trường của mình.

1. Đi tới từng **Bảng điều khiển nút** trong cụm của bạn
2. Xem lại **Máy đang chạy** phần trên từng nút
3. Ghi lại tất cả các workload đang chạy bao gồm:
   * Máy ảo (VM)
   * Các nút tenant
   * Dịch vụ sao lưu VMware
   * Dịch vụ NAS
   * Bất kỳ dịch vụ đang hoạt động nào khác

### Bước 2: Tắt các workload của tenant

Nếu tenant đang chạy trên bất kỳ nút nào trong cụm của bạn:

1. **Đăng nhập vào từng môi trường tenant** có workload đang hoạt động
2. **Tắt an toàn tất cả các workload đang chạy** trong từng tenant
3. **Xác minh việc tắt đã hoàn tất** trước khi chuyển sang bước tiếp theo

{% hint style="warning" %}
**Quan trọng**

Đảm bảo tất cả workload của tenant đã được tắt đúng cách trước khi tiếp tục. Không làm như vậy có thể dẫn đến mất dữ liệu hoặc hỏng dữ liệu.
{% endhint %}

### Bước 3: Tắt các workload ở cấp host

Sau khi tất cả workload của tenant đã được tắt, hãy tắt toàn bộ các workload còn lại trên từng nút:

1. **Máy ảo (VM)**: Hãy sử dụng tùy chọn tắt an toàn khi có thể
2. **Các nút tenant**: Đảm bảo các nút này được tắt sau khi các workload nội bộ của chúng đã tắt
3. **Dịch vụ sao lưu VMware**: Dừng mọi tác vụ sao lưu đang hoạt động
4. **Dịch vụ NAS**: Dừng an toàn tất cả các dịch vụ liên quan đến NAS
5. **Các dịch vụ khác**: Tắt mọi dịch vụ đang hoạt động còn lại

{% hint style="info" %}
**Các vùng chứa vNet**

Các container vNet không cần phải dừng thủ công. Chúng sẽ được dừng an toàn tự động trong quá trình tắt cụm.
{% endhint %}

### Bước 4: Tắt từng nút riêng lẻ

Sau khi tất cả workload đã được dừng:

1. Đi tới **Bảng điều khiển cụm** cho cụm bạn muốn tắt nguồn
2. Chọn **Tắt nguồn** từ menu bên trái
3. Hệ thống sẽ bắt đầu tắt từng nút trong cụm
4. **Theo dõi tiến trình tắt** qua bảng điều khiển cụm

### Bước 5: Tắt toàn bộ cụm

Sau khi từng nút riêng lẻ đã được tắt:

1. Điều hướng tới **Hệ thống → Cụm**
2. Chọn cụm bạn muốn tắt
3. Chọn **Tắt nguồn** từ menu bên trái
4. Xác nhận việc tắt khi được nhắc

## Lưu ý cho môi trường nhiều cụm

{% hint style="danger" %}
**Cảnh báo nghiêm trọng**

Nếu môi trường của bạn có **nhiều cụm**, bạn phải **LUÔN LUÔN** tắt cụm chứa các nút điều khiển (Node1 & Node2) **CUỐI CÙNG**.
{% endhint %}

### Trình tự tắt cho môi trường nhiều cụm:

1. Tắt tất cả **các cụm không phải controller** trước tiên
2. Tắt **cụm controller** (chứa Node1 & Node2) sau cùng

Điều này đảm bảo các dịch vụ điều phối và quản lý cụm vẫn khả dụng cho đến khi tất cả các cụm khác được tắt an toàn.

## Phương pháp thay thế: Tắt qua API

Đối với người dùng nâng cao hoặc mục đích tự động hóa, bạn có thể dùng API VergeOS để tắt các cụm:

```json
POST /v4/cluster_actions
{
    "cluster": [cluster_id],
    "action": "shutdown",
    "params": "{}"
}
```

## Trình tự bật nguồn đúng cách

Khi bật lại hệ thống VergeOS của bạn, hãy làm theo trình tự này:

### Môi trường một cụm:

1. **Bật Node1** trước tiên
2. **Chờ cho Node1 trực tuyến** hoàn toàn
3. **Bật Node2**
4. **Bật các nút còn lại** từng nút một, chờ khoảng 1 phút giữa mỗi lần
5. **Xác minh trạng thái hệ thống** trên bảng điều khiển chính (nên hiển thị màu xanh lá và Online)

### Môi trường nhiều cụm:

1. **Bật cụm controller trước** (Node1, rồi Node2, rồi các nút controller còn lại)
2. **Chờ cho cụm controller trực tuyến hoàn toàn**
3. **Bật các cụm khác** theo trình tự của một cụm cho từng cụm

## Xác minh và giám sát

Sau khi hoàn tất quá trình tắt hoặc khởi động:

1. **Kiểm tra bảng điều khiển chính** các chỉ báo trạng thái hệ thống
2. **Xác minh tất cả các nút** hiển thị trạng thái phù hợp (Offline khi tắt, Online khi khởi động)
3. **Theo dõi nhật ký hệ thống** để tìm bất kỳ lỗi hoặc cảnh báo nào
4. **Kiểm tra các dịch vụ quan trọng** sau khi khởi động để đảm bảo hoạt động đúng

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

### Các sự cố thường gặp trong quá trình tắt:

**Các workload không tắt an toàn được:**

* Kiểm tra cài đặt ACPI của hệ điều hành khách
* Sử dụng tùy chọn "Hard Reset" hoặc "Kill Power" như biện pháp cuối cùng
* Xem lại cài đặt quản lý nguồn của VM

**Các nút không vào trạng thái tắt:**

* Xác minh rằng tất cả workload đã dừng
* Kiểm tra các VM bị treo hoặc không phản hồi
* Xem lại nhật ký nút để tìm thông báo lỗi

**Tắt cụm thất bại:**

* Đảm bảo từng nút riêng lẻ đã được tắt đúng cách trước
* Kiểm tra trạng thái cụm và kết nối
* Xác minh không có di chuyển hoặc tác vụ bảo trì nào đang hoạt động

### Cách nhận trợ giúp:

Nếu bạn gặp sự cố trong quá trình tắt:

1. **Ghi lại các thông báo lỗi** và trạng thái hệ thống hiện tại
2. **Kiểm tra nhật ký VergeOS** để xem thông tin lỗi chi tiết
3. **Liên hệ bộ phận hỗ trợ VergeOS** với các chi tiết cụ thể về sự cố

## Các phương pháp hay nhất

* **Lên kế hoạch cho các khung giờ tắt** trong các thời điểm ít sử dụng
* **Thông báo cho người dùng** trước khi bắt đầu các quy trình tắt
* **Ghi lại môi trường cụ thể của bạn** bao gồm tô-pô cụm và các workload quan trọng
* **Kiểm thử quy trình tắt** trước tiên trong môi trường không phải sản xuất
* **Duy trì các bản sao lưu hiện tại** trước khi thực hiện tắt hệ thống
* **Sử dụng chế độ bảo trì** cho từng nút khi có thể thay vì tắt toàn bộ

## Danh sách kiểm tra tóm tắt

* [ ] Kiểm kê tất cả các workload đang chạy trên tất cả các nút
* [ ] Tắt an toàn các workload của tenant
* [ ] Tắt toàn bộ các workload ở cấp host (VM, dịch vụ, v.v.)
* [ ] Đi tới Cluster Dashboard và chọn Power Off
* [ ] Đi tới System → Clusters và tắt toàn bộ cụm
* [ ] Đối với nhiều cụm: Tắt cụm controller (Node1 & Node2) CUỐI CÙNG
* [ ] Xác minh việc tắt đã hoàn tất thông qua theo dõi trên bảng điều khiển
* [ ] Ghi lại mọi sự cố gặp phải để tham khảo sau này

Tuân theo quy trình này giúp đảm bảo việc tắt môi trường VergeOS của bạn diễn ra an toàn và có kiểm soát, đồng thời duy trì tính toàn vẹn dữ liệu và tình trạng hệ thống.

***

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

* Loại tài liệu: Bài viết cơ sở tri thức
* Danh mục: Quản trị hệ thống
* Thẻ: shutdown, power-off, cluster-management, system-maintenance
* Áp dụng cho: VergeOS 4.12.6 và các phiên bản mới hơn
  {% 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/system-administration/proper-vergeos-system-shutdown-procedure.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.