> 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-verge-install.md).

# Hướng dẫn Cài đặt VergeOS

Hướng dẫn này cung cấp các quy trình chuẩn hóa và các phương pháp hay nhất cho các Kỹ sư và Quản trị viên VergeOS thực hiện cài đặt hệ thống ban đầu bằng giao diện trình cài đặt mới được cập nhật.

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

Việc cài đặ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 triển khai thành công. 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 khi lên lịch cài đặt
2. **Trước khi cài đặt** - Các kiểm tra cuối cùng trong vòng 24 giờ trước khi cài đặt
3. **Cài đặt** - Quá trình cài đặt và cấu hình hệ thống
4. **Sau khi cài đặt** - Xác minh rằng việc cài đặ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 mang tính tổng quát. Bạn có thể cần điều chỉnh các bước này cho môi trường và yêu cầu cụ thể của mình. Thêm không gian để đáp ứng số lượng node, cấu hình mạng và các nhu cầu khác.
{% endhint %}

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

* Có quyền truy cập vật lý vào các node phần cứng để cài đặt
* Hạ tầng mạng đã được cấu hình và sẵn sàng
* Truy cập IPMI/quản lý từ xa đến tất cả các node
* Thông tin xác thực giấy phép VergeOS
* **Thời gian ước tính:** 4-8 giờ tùy theo độ phức tạp của cấu hình

## Mục tiêu

Hoàn tất cài đặt ban đầu của Node1 và Node2+, mức tối thiểu cần có để đảm bảo dự phòng hệ thống và hỗ trợ hệ thống sản xuất.

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

Hoàn thành các bước này trước khi lên lịch cài đặt:

### Yêu cầu phần cứng

* [ ] Xác nhận phần cứng đáp ứng các yêu cầu tối thiểu

{% hint style="info" %}
**Tài liệu phần cứng**

Tham khảo [tài liệu sizing của VergeOS](/plan-and-deploy/vi/huong-dan-trien-khai/sizing.md) để biết các yêu cầu hiện tại và chi tiết.

\[ ] **Yêu cầu CPU:**

* [ ] CPU 64-bit có hỗ trợ ảo hóa phần cứng \[ ] **Yêu cầu bộ nhớ:**
* [ ] 16GB RAM cho mỗi vSAN Node dành cho hệ điều hành
* [ ] +1GB RAM cho mỗi 1 TB dung lượng lưu trữ thô vSAN; ví dụ: 16GB+4GB = 20GB RAM/Node cho một Node có 4TB dung lượng lưu trữ thô vSAN \[ ] **IPMI/Quản lý từ xa:**
* [ ] IPMI; iDRAC, iLO hoặc tương tự \[ ] **Bộ điều khiển đĩa:**
* [ ] Bộ điều khiển đĩa HBA (Ưu tiên)
* [ ] nếu là bộ điều khiển RAID: đảm bảo nó hỗ trợ chế độ JBOD/IT
* [ ] Đảm bảo bộ điều khiển hỗ trợ khởi động từ NVME nếu sử dụng chúng \[ ] **Yêu cầu mạng:**
* [ ] 1 giao diện mạng vật lý /Node cho giao diện VergeOS UI/'External'
* [ ] Cặp bonded thứ hai cùng loại *Rất* Khuyến nghị để dự phòng
* [ ] 1 giao diện mạng 10Gbps hoặc cao hơn /Node cho VergeOS Core Fabric
* [ ] Cùng loại thứ hai *Rất* Khuyến nghị để dự phòng (Không bonded) \[ ] **Yêu cầu lưu trữ:**
* [ ] Lưu trữ Tier0 (Tùy chọn, Khuyến nghị)
  * [ ] Dựa trên NVMe
  * [ ] Độ bền ghi cao (khuyến nghị 3+ Drive Writes Per Day (DWPD))
  * [ ] 5GB/1TB dung lượng đĩa khả dụng trong vSAN (khuyến nghị 10GB/1TB)
* [ ] Các tầng lưu trữ (1 yêu cầu, > tùy chọn)
  * [ ] Tối thiểu 1 tầng lưu trữ NVMe gắn PCIe *Rất khuyến nghị*
  * [ ] Hiệu năng phù hợp với kỳ vọng của khối lượng công việc
* [ ] Mã hóa đĩa khi lưu trữ
  * [ ] Ổ đĩa USB /Node cho khóa giải mã vSAN (nếu muốn)
    {% endhint %}

### Phương tiện cài đặt và tài liệu

* [ ] Tạo phương tiện cài đặt theo [tài liệu VergeOS](/plan-and-deploy/vi/huong-dan-trien-khai/install-media.md)
  * [ ] Kiểm tra phương tiện khởi động để xác minh hoạt động
* [ ] Ghi lại và tạo tất cả yêu cầu mạng

{% hint style="info" %}
**Tài liệu mạng**

Tham khảo [tài liệu thiết kế mạng VergeOS](/plan-and-deploy/vi/huong-dan-trien-khai/network-design.md) để biết các yêu cầu mạng hiện tại và chi tiết.

\[ ] **Cấu hình mạng lõi:**

* [ ] VLAN1 của mạng lõi đã được tạo và ghi lại
* [ ] VLAN2 của mạng lõi đã được tạo và ghi lại \[ ] **Cấu hình mạng ngoài:**
* [ ] VLAN1 của mạng ngoài đã được tạo và ghi lại
* [ ] VLAN2 của mạng ngoài đã được tạo và ghi lại \[ ] **Cấu hình IP:**
* [ ] Địa chỉ IP UI/Quản lý đã được cấp phát và ghi lại
* [ ] Cấu hình cổng mặc định đã được ghi lại
* [ ] Máy chủ DNS đã được xác định và ghi lại \[ ] **Tài liệu thiết kế/xây dựng mạng**
* [ ] Sơ đồ cáp A-B đã được tạo và ghi lại
* [ ] Bố trí rack đã được ghi lại
* [ ] Tài liệu/Sơ đồ thiết kế mạng Layer 2 đã được tạo
* [ ] Tài liệu/Sơ đồ thiết kế mạng Layer 3 đã được tạo
  {% endhint %}

### Truy cập và cấu hình hệ thống

* [ ] Xác minh truy cập IPMI đến tất cả các node
* [ ] Xem lại các yêu cầu thiết lập BIOS
  * [ ] Đã chọn đúng phương thức khởi động (Legacy/Dual/UEFI) ***Cần UEFI nếu tất cả ổ đĩa là NVMe***
  * [ ] Đã bật ảo hóa hỗ trợ bởi phần cứng
  * [ ] Đã bật Hyperthreading
  * [ ] Đã bật tất cả lõi bộ xử lý
  * [ ] Đã đặt đúng đồng hồ (tất cả các node lệch nhau trong vòng vài giây)

### Các quyết định lập kế hoạch

* [ ] Xem xét toàn bộ quy trình được mô tả ở đây
* [ ] Chuẩn bị thông tin cần thiết để hoàn tất toàn bộ quy trình
* [ ] Quyết định ưu tiên dành bộ nhớ RAM: Nhiều hơn *Bộ nhớ khả dụng* **HOẶC** Nhiều hơn *việc thực thi HA N+1*
* [ ] Lập kế hoạch thời gian cài đặt và thông báo cho các bên liên quan

## Giai đoạn trước khi cài đặt

Thực hiện các kiểm tra này trong vòng 24 giờ trước thời điểm cài đặt đã lên lịch:

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

* [ ] Xác minh trạng thái hiện tại
  * [ ] Tất cả phần cứng đã được lắp đặt vật lý và đã bật nguồn
  * [ ] Tất cả cáp mạng đều qua được bài kiểm tra "kéo nhẹ"
  * [ ] Cấu hình switch đã hoàn tất và được kiểm tra
  * [ ] Đã kiểm tra cấu hình mạng đang chạy hiện tại và đã hoàn tất "write mem"
  * [ ] IPMI có thể truy cập trên tất cả các node
  * [ ] Các IP cần thiết đều có sẵn và không bị sử dụng
  * [ ] Khung jumbo (MTU 9216+) đã được cấu hình trên switch

### Kiểm tra cuối cùng phần cứng

* [ ] Tất cả ổ đĩa hiển thị trong BIOS
* [ ] Tất cả NIC hiển thị trong BIOS
* [ ] Đối chiếu MAC với hồ sơ
* [ ] Ngày và giờ chính xác trong BIOS
* [ ] Đã bật cài đặt ảo hóa

### Kiểm tra cuối cùng mạng

* [ ] Các switch mạng lõi phản hồi
* [ ] Các switch mạng ngoài phản hồi
* [ ] Không có máy chủ DHCP xung đột (nếu dùng DHCP)
* [ ] Có sẵn tài liệu để khắc phục sự cố

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

### Cài đặt bộ điều khiển chính

Quy trình cài đặt thực tế theo thứ tự của trình cài đặt:

* [ ] Khởi động từ trình cài đặt USB
* [ ] Chọn "Standard Install"
* [ ] Chọn "Controller"
* [ ] Chọn "New Install"

### Cấu hình hệ thống

**Cấu hình NTP:**

* [ ] Nhập danh sách máy chủ NTP phân tách bằng dấu cách, hoặc để mặc định

**Cấu hình ngày/giờ:**

* [ ] Xác nhận cẩn thận ngày hiện tại
* [ ] Xác nhận rất cẩn thận thời gian hiện tại (Node 1 điều khiển NTP cho hệ thống)

**Nhận diện hệ thống:**

* [ ] Nhập tên hệ thống của bạn. (Có thể thay đổi sau khi cài đặt)

### Cấu hình tài khoản quản trị

* [ ] Nhập tên người dùng Quản trị viên của bạn, hoặc để mặc định
* [ ] Nhập mật khẩu cho tài khoản quản trị của bạn (nên được tạo và lưu trữ trong kho mật khẩu của bạn)
* [ ] Đặt địa chỉ email cho tài khoản quản trị (tùy chọn nhưng nên làm)

### Cấu hình giao diện mạng

**Giao diện mạng lõi:**

* [ ] Chọn giao diện mạng Core1
* [ ] Cấu hình tên giao diện Core1, MTU, Core (để là "Yes"), và VLAN theo yêu cầu
* [ ] Chọn giao diện mạng Core2
* [ ] Cấu hình tên giao diện Core2, MTU, Core (để là "Yes"), và VLAN theo yêu cầu

**Giao diện mạng ngoài:**

* [ ] Chọn giao diện mạng ngoài
* [ ] Cấu hình tên mạng ngoài, MTU (thường là 1500), Core (đổi thành "No").
* [ ] Cấu hình VLAN ngoài (nếu cần)
* [ ] Đặt IP ngoài (định dạng CIDR)
* [ ] Đặt cổng mặc định ngoài
* [ ] Đặt máy chủ DNS ngoài

### Cấu hình giấy phép

* [ ] Chọn máy chủ giấy phép (Sản xuất hoặc Thử nghiệm/NFR)
* [ ] Nhập thông tin xác thực người dùng giấy phép
* [ ] Nhập mật khẩu giấy phép (lưu an toàn trong kho mật khẩu)

### Cấu hình lưu trữ

**Mã hóa vSAN:**

* [ ] Chọn cài đặt mã hóa vSAN (Có/Không)
* [ ] Ghi lại khóa mã hóa, nếu bật (lưu an toàn trong kho mật khẩu)
* [ ] Tạo ổ đĩa mã hóa USB (rất khuyến nghị nếu dùng mã hóa vSAN)

**Chọn đĩa vSAN & phân bổ tầng:**

* [ ] Chọn các đĩa vSAN để cài đặt
* [ ] Phân bổ đĩa vào các tầng lưu trữ phù hợp (theo kế hoạch trong phần chuẩn bị cài đặt)

**Cấu hình swap:**

* [ ] Cấu hình phân bổ swap theo yêu cầu
* [ ] Sau khi trình cài đặt hoàn tất, tháo phương tiện USB
* [ ] Khởi động lại

### Xác minh node chính

* [ ] Hệ thống khởi động đến màn hình 'xanh' trên console
* [ ] UI có thể truy cập tại địa chỉ IP đã cấu hình
* [ ] Tất cả chỉ báo trạng thái đều xanh trong UI
* [ ] vSAN được gắn và hoạt động tốt

## Cài đặt bộ điều khiển phụ

* [ ] Khởi động node phụ từ trình cài đặt USB
* [ ] Chọn "Controller"
* [ ] Chọn "No" cho cài đặt mới
* [ ] Nhập thông tin đăng nhập quản trị từ bộ điều khiển chính
* [ ] Xác nhận tự động phát hiện mạng (DỪNG nếu bất kỳ IP hoặc giao diện nào được phát hiện không như mong đợi!)
* [ ] Khớp cài đặt mã hóa với bộ điều khiển chính
* [ ] Khớp phân bổ tầng ổ đĩa với bộ điều khiển chính

### Xác minh node phụ

* [ ] Hệ thống khởi động đến màn hình 'xanh' trên console
* [ ] Node2 hiển thị trong UI chính
* [ ] Tất cả chỉ báo trạng thái đều xanh
* [ ] Trạng thái vSAN màu xanh trên cả hai node

## Xác minh sau khi cài đặt

Sau khi quá trình cài đặt hoàn tất, hãy xác minh hệ thống đang hoạt động đúng:

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

* [ ] Tất cả chỉ báo Dashboard đều xanh
* [ ] Không có cảnh báo hoặc warning bất thường trong Dashboard Logs
* [ ] Tất cả các node hiển thị đúng phiên bản
* [ ] Tất cả các node ở trạng thái "Running" (kiểm tra từng node riêng lẻ)
* [ ] Không có node nào đang chờ khởi động lại
* [ ] Tình trạng vSAN màu xanh trên tất cả các tầng
* [ ] Kết nối core fabric đã được xác minh
* [ ] Kết nối mạng ngoài đã được xác minh

### Xác nhận cấu hình hệ thống

* [ ] Đã đặt tầng lưu trữ VM mặc định
* [ ] Đã cấu hình phần trăm RAM tối đa mục tiêu của cụm
* [ ] Đã cấu hình đồng bộ site (nếu cần)
* [ ] Hệ thống đã được kích hoạt và cập nhật
* [ ] Thiết lập máy chủ SMTP (rất khuyến nghị)
* [ ] Đã cấu hình thông báo email cho người dùng quản trị

### Kiểm thử cuối cùng

* [ ] Kiểm tra tạo VM và các thao tác cơ bản
* [ ] Xác minh kết nối mạng từ VM kiểm thử
* [ ] Xác nhận chức năng snapshot
* [ ] Kiểm tra sao lưu/khôi phục hệ thống nếu áp dụng

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

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

**Sự cố khởi động:**

* Xác minh cài đặt khởi động BIOS khớp với loại phương tiện cài đặt
* Kiểm tra chức năng của phương tiện USB trên hệ thống đã biết là hoạt động tốt
* Xác nhận khả năng tương thích phần cứng với VergeOS

**Sự cố cấu hình mạng:**

* Xác minh cấu hình VLAN khớp với thiết kế mạng
* Kiểm tra kết nối cáp vật lý và cấu hình switch
* Xác nhận địa chỉ IP không xung đột với hạ tầng hiện có

**Sự cố cấu hình lưu trữ:**

* Xác minh bộ điều khiển đĩa đang ở chế độ JBOD/IT
* Kiểm tra khả năng hiển thị đĩa trong BIOS
* Xác nhận phân bổ tầng lưu trữ khớp với tài liệu kế hoạch

**Sự cố tham gia node phụ:**

* Xác minh kết nối mạng giữa các node
* Kiểm tra thông tin đăng nhập quản trị là chính xác
* Xác nhận node chính đã hoạt động đầy đủ trước khi thêm node phụ

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

Sau khi hoàn tất cài đặt thành công:

* [ ] Lên lịch sao lưu hệ thống ban đầu
* [ ] Cấu hình giám sát và cảnh báo
* [ ] Cập nhật tài liệu mạng với cấu hình cuối cùng
* [ ] Lên kế hoạch tạo tenant và phân bổ tài nguyên
* [ ] Lên lịch đào tạo quản trị viên nếu cần
* [ ] Ghi lại cấu hình hệ thống cuối cùng cho nhóm vận hành

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

Nếu bạn gặp bất kỳ vấn đề nào với việc cài đặt VergeOS, 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-verge-install.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.
