> 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/mo-dun-3-cai-dat/02-controller-installation.md).

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

Việc cài đặt hai nút bộ điều khiển là cốt lõi của mọi triển khai VergeOS. Nút 1 khởi tạo một hệ thống hoàn toàn mới -- thiết lập tên hệ thống, tài khoản quản trị, mạng, giấy phép, mã hóa và các tầng lưu trữ. Nút 2 tham gia vào hệ thống hiện có và phản chiếu các cài đặt đó, giúp bạn có một cụm dự phòng ngay lập tức. Trang này hướng dẫn chi tiết cả hai lần cài đặt.

## Tổng quan luồng cài đặt

```mermaid
graph LR
    A["Khởi động Nút 1<br/>từ USB"] --> B["Cài đặt chuẩn →<br/>Bộ điều khiển → Mới"]
    B --> C["Cấu hình hệ thống &<br/>mạng"]
    C --> D["Giấy phép &<br/>Mã hóa"]
    D --> E["Chọn đĩa<br/>& Gán tầng"]
    E --> F["Khởi động lại &<br/>Xác minh Nút 1"]
    F --> G["Khởi động Nút 2<br/>từ USB"]
    G --> H["Cài đặt chuẩn →<br/>Bộ điều khiển → Tham gia"]
    H --> I["Tự động phát hiện<br/>mạng"]
    I --> J["Khớp mã hóa<br/>& tầng"]
    J --> K["Khởi động lại &<br/>Xác minh cụm"]

    style F fill:#e8f5e9,stroke:#2e7d32
    style K fill:#e8f5e9,stroke:#2e7d32
```

***

## Nút 1: Cài đặt Bộ điều khiển Chính

Nút 1 tạo hệ thống VergeOS. Mọi lựa chọn cấu hình bạn thực hiện ở đây sẽ thiết lập nền tảng mà Nút 2 và tất cả các nút tiếp theo sẽ tuân theo.

{% hint style="warning" %}
**Thao tác phá hủy**

VergeOS được cài đặt như một hệ điều hành hoàn chỉnh trên mỗi nút. Các ổ đĩa được chọn sẽ được định dạng và **mọi dữ liệu hiện có trên các ổ đó sẽ bị mất**. Hãy kiểm tra kỹ lựa chọn ổ đĩa trước khi xác nhận.
{% endhint %}

### Giai đoạn 1: Khởi động và Loại cài đặt

1. **Khởi động từ USB** -- Chèn phương tiện cài đặt VergeOS và khởi động máy chủ. Trình cài đặt đầy đủ được nạp vào bộ nhớ; thời gian tải thay đổi tùy theo tốc độ phương tiện.
2. **Chọn "Cài đặt (Tiêu chuẩn)"** -- Đây là mặc định. Chỉ nên sử dụng các tùy chọn không chuẩn khi làm việc trực tiếp với Bộ phận Hỗ trợ VergeOS.
3. **Chọn "Bộ điều khiển"** -- Hai nút đầu tiên trong bất kỳ hệ thống nào phải là nút bộ điều khiển.
4. **Chọn "Có"** để xác nhận đây là một **Cài đặt mới** (vSAN mới).

### Giai đoạn 2: Thời gian và Danh tính

5. **Múi giờ** -- Chọn múi giờ hệ thống (vị trí địa lý của các máy chủ).
6. **Cấu hình NTP** -- Nhập danh sách máy chủ NTP, phân tách bằng dấu cách (ví dụ, `pool.ntp.org time.google.com`), hoặc chấp nhận mặc định.
7. **Ngày và giờ** -- Xác nhận cẩn thận ngày và giờ hiện tại. Nút 1 sẽ điều khiển NTP cho toàn bộ hệ thống sau khi cài đặt, nên độ chính xác ở đây là rất quan trọng.

   > **Quan trọng về thời gian:** Ngày hoặc giờ không chính xác có thể gây ra sự cố vận hành vSAN. Hãy kiểm tra kỹ cả hai -- đặc biệt là ngày, vì rất dễ bỏ sót.
8. **Tên hệ thống** -- Nhập tên mô tả cho hệ thống VergeOS của bạn (ví dụ: "Cụm HCI sản xuất"). Tên này xuất hiện trong bảng điều khiển, cảnh báo, báo cáo và cấu hình đồng bộ site. Bạn có thể thay đổi sau cài đặt trong Cài đặt hệ thống.

### Giai đoạn 3: Tài khoản Quản trị

9. **Tên người dùng quản trị** -- Chấp nhận mặc định (`admin`) hoặc nhập tên người dùng tùy chỉnh.
10. **Mật khẩu** -- Nhập mật khẩu mạnh (tối thiểu 8 ký tự). Lưu ngay vào kho mật khẩu của bạn.
11. **Địa chỉ email** -- Nhập email của quản trị viên. Email này được dùng để đặt lại mật khẩu và nhận cảnh báo đăng ký. Cần có địa chỉ email trong quá trình cài đặt.

### Giai đoạn 4: Cấu hình giao diện mạng

Đây là nơi tài liệu NIC trước khi cài đặt của bạn phát huy hiệu quả. Bạn sẽ cấu hình mọi NIC được phát hiện trên nút.

#### Các giao diện mạng lõi

12. **Chọn NIC Core1** -- Chọn NIC vật lý kết nối với switch Core Fabric 1 của bạn.
13. **Cấu hình Core1:**
    * **Tên** -- Một tên mô tả (ví dụ: hostname của switch hoặc quy ước đặt tên của bạn)
    * **MTU** -- Mặc định trên NIC là 9192; MTU của cổng switch vật lý phải ít nhất 9216 để chứa MTU của NIC cộng với phần overhead VXLAN
    * **Core** -- Giữ nguyên **"Có"**
    * **VLAN** -- Nhập ID VLAN của Core1, hoặc để trống/0 cho các cổng PVID (không gắn thẻ)
14. **Chọn NIC Core2** -- Chọn NIC vật lý kết nối với switch Core Fabric 2 của bạn.
15. **Cấu hình Core2** -- Cùng mẫu như Core1 nhưng dùng ID VLAN của Core2.

{% hint style="success" %}
**Điều hướng bằng bàn phím**

Trong trình cài đặt, `[Tab]` di chuyển giữa các mục hành động (Hoàn tất/Sửa/Hủy), không phải giữa các trường. Nhấn `[Enter]` để bật/tắt chế độ chỉnh sửa trên một trường. Khi chế độ chỉnh sửa TẮT, dùng phím mũi tên để di chuyển giữa các trường.
{% endhint %}

#### Giao diện mạng bên ngoài

16. **Chọn NIC bên ngoài** -- Chọn NIC được kết nối với switch bên ngoài/quản trị của bạn. Ghép cổng (LACP) được hỗ trợ ở đây để tăng dự phòng.
17. **Cấu hình External:**
    * **Tên** -- Tên mô tả cho mạng bên ngoài
    * **MTU** -- Thông thường là 1500 (Ethernet tiêu chuẩn)
    * **Core** -- Thay đổi thành **"Không"**
    * **VLAN** -- Nhập ID VLAN quản trị nếu có áp dụng (ưu tiên PVID)
    * **Địa chỉ IP** -- Địa chỉ tĩnh ở định dạng CIDR (ví dụ, `10.0.0.2/24`), hoặc nhập `dhcp` để dùng DHCP (phù hợp cho hệ thống thử nghiệm/đánh giá hoặc chỉ lưu trữ)
    * **Cổng** -- Địa chỉ IP của cổng mặc định
    * **DNS** -- Địa chỉ máy chủ DNS
18. **Cấu hình các NIC còn lại** -- Bất kỳ NIC không dùng hoặc chưa cắm nào vẫn nên được gán tên (ví dụ: "unused") trong quá trình cài đặt. Chọn **\[Hoàn tất]** khi tất cả NIC đã được cấu hình.

{% hint style="info" %}
Ghép cổng (LAG/LACP) nên **không** được dùng cho các mạng Core Fabric. VergeOS xây dựng khả năng dự phòng thông qua nhiều mạng core riêng biệt trên các switch riêng biệt. Ghép cổng chỉ phù hợp cho các giao diện mạng bên ngoài.
{% endhint %}

### Giai đoạn 5: Cấu hình Giấy phép

19. **Chọn máy chủ giấy phép** -- Chọn giữa máy chủ Sản xuất hoặc Dùng thử/NFR.
20. **Nhập thông tin xác thực** -- Cung cấp tên người dùng và mật khẩu giấy phép từ đội tài khoản VergeOS của bạn. Lưu trữ an toàn.

### Giai đoạn 6: Cấu hình Lưu trữ

#### Mã hóa vSAN

21. **Bật hoặc tắt mã hóa** -- VergeOS hỗ trợ mã hóa dữ liệu lưu trữ AES-256 cho vSAN.
    * Nếu bật, hãy nhập cụm mật khẩu khóa mã hóa (8--64 ký tự)
    * Tùy chọn ghi khóa mã hóa vào một **ổ USB** (rất khuyến nghị cho môi trường sản xuất)
    * Xác minh đã chọn đúng thiết bị USB trước khi xác nhận

{% hint style="warning" %}
**Mã hóa là vĩnh viễn**

Lựa chọn mã hóa **không thể đảo ngược** sau khi cài đặt. Việc chuyển từ mã hóa sang không mã hóa (hoặc ngược lại) đòi hỏi phải cài đặt lại toàn bộ hệ thống. Hãy quyết định cẩn thận.
{% endhint %}

#### Chọn đĩa và gán tầng

22. **Chọn các ổ đĩa vSAN** -- Tất cả các ổ đĩa được phát hiện đều hiển thị và được chọn mặc định (đánh dấu bằng dấu hoa thị). Bỏ chọn bất kỳ ổ nào cần loại trừ:
    * Thiết bị tháo rời (ổ USB)
    * Các ổ dùng riêng để lưu khóa mã hóa
    * Bất kỳ ổ nào không նախատեսված cho việc dùng vSAN
23. **Gán các tầng lưu trữ** -- Trình cài đặt tự động phát hiện một tầng cho mỗi ổ đĩa. Chọn **"Có"** để xem lại và có thể thay đổi việc gán tầng:
    * **Tầng 0** -- Lưu trữ siêu dữ liệu (NVMe, khuyến nghị độ bền ghi cao; nên dự trù khoảng \~5 GB tối thiểu / 10 GB khuyến nghị cho mỗi 1 TB vSAN khả dụng)
    * **Tầng 1** -- Khối lượng công việc hiệu năng cao, nhiều ghi (NVMe độ bền cao)
    * **Tầng 2** -- Khối lượng công việc hỗn hợp, VM đa dụng (SSD tầm trung)
    * **Tầng 3** -- HDD tốc độ cao hoặc lai (truyền thống; không bắt buộc)
    * **Tầng 4** -- HDD tiêu chuẩn / dung lượng (truyền thống; không bắt buộc)
    * **Tầng 5** -- Lưu trữ lưu trữ / lạnh (HDD lưu trữ)

Chọn **\[Hoàn tất]** khi việc gán tầng đã chính xác.

{% hint style="info" %}
**Tầng 0 Chỉ dành cho Siêu dữ liệu**

Tầng 0 lưu bản đồ băm vSAN và chỉ mục hệ thống tệp. Đây không phải bộ nhớ đệm hiệu năng và không lưu dữ liệu khối lượng công việc. Khuyến nghị dùng các ổ NVMe có độ bền ghi cao (3+ DWPD).
{% endhint %}

#### Cấu hình swap

24. **Chọn tầng swap** -- Chọn tầng lưu trữ nào sẽ dùng cho không gian swap. Tránh các ổ tầng 0 nếu có thể; chọn tầng nhanh tiếp theo. Không bao giờ chọn ổ HDD cho swap trừ khi nút chỉ có HDD.
25. **Nhập swap trên mỗi ổ** -- Chỉ định dung lượng swap tính bằng MB cho mỗi ổ (ví dụ, `2048` trên 8 ổ = tổng 16 GB). Thông thường, không nên cấu hình quá **16 GB swap cho mỗi nút** phải được cấu hình.
26. **Xác nhận** tóm tắt swap và chọn **"Có"**.

### Giai đoạn 7: Hoàn tất và Khởi động lại

27. Trình cài đặt sẽ định dạng từng ổ đĩa đã chọn (các ổ lớn có thể mất vài phút) và khởi tạo vSAN.
28. Khi cài đặt hoàn tất, **tháo phương tiện USB** và nhấn **\[Enter]** để khởi động lại.

### Xác minh Nút 1

Sau khi khởi động lại, hãy xác minh bộ điều khiển chính hoạt động tốt trước khi tiếp tục sang Nút 2:

| Chọn                   | Kết quả mong đợi                                                                                    |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| **Màn hình console**   | Menu người dùng VergeOS màu xanh xuất hiện                                                          |
| **Truy cập giao diện** | Điều hướng đến địa chỉ IP đã cấu hình trong trình duyệt; đăng nhập bằng thông tin xác thực quản trị |
| **Chỉ báo trạng thái** | Tất cả chỉ báo đều xanh trên bảng điều khiển chính                                                  |
| **Tình trạng vSAN**    | vSAN được gắn và hoạt động tốt (hiển thị trên bảng điều khiển)                                      |

{% hint style="success" %}
Nếu nút không khởi động đúng cách, nhấn `Esc` tại console để có dấu nhắc lệnh. Gõ `yb-install` để tiếp tục hoặc `yb-install --restart` để bắt đầu cài đặt lại từ đầu.
{% endhint %}

***

## Nút 2: Cài đặt Bộ điều khiển Phụ

Nút 2 tham gia vào hệ thống do Nút 1 tạo ra. Trình cài đặt sẽ tự động phát hiện hầu hết cấu hình mạng, làm cho quá trình này nhanh hơn Nút 1.

{% hint style="info" %}
Bộ điều khiển chính (Nút 1) phải được **cài đặt hoàn chỉnh và khởi động** trước khi bắt đầu cài đặt Nút 2. Không bắt đầu Nút 2 cho đến khi bạn đã xác minh Nút 1 đang hoạt động tốt.
{% endhint %}

### Các bước cài đặt

1. **Khởi động từ USB** -- Chèn phương tiện cài đặt VergeOS vào máy chủ thứ hai và khởi động.
2. **Chọn "Cài đặt chuẩn"** (mặc định).
3. **Chọn "Bộ điều khiển"** (mặc định).
4. **Chọn "Không"** -- Đây KHÔNG phải là cài đặt mới. Bạn đang tham gia vào hệ thống đã được tạo trên Nút 1.

   > **Cảnh báo:** Nếu bạn chọn "Có" ở đây, trình cài đặt sẽ tạo một **hệ thống riêng biệt, độc lập** thay vì tham gia cụm của Nút 1. Đây là sai lầm cài đặt Nút 2 phổ biến nhất.
5. **Nhập thông tin xác thực quản trị** -- Cung cấp tên người dùng và mật khẩu quản trị đã được tạo trong quá trình cài đặt Nút 1.
6. **Phát hiện mạng tự động** -- Chọn **"Có"** để tự động phát hiện cấu hình mạng. Trình cài đặt sẽ phát hiện cả hai mạng core từ Nút 1. Đây là phương pháp được khuyến nghị vì tránh cấu hình mạng thủ công sai sót.
7. **Xác minh các mạng đã phát hiện** -- Đối với mỗi mạng core được phát hiện, xem lại cấu hình hiển thị và nhấn **\[Enter]** để xác nhận.
8. **Cấu hình mã hóa** -- Các cài đặt mã hóa **phải khớp** Nút 1. Nếu Nút 1 dùng mã hóa, Nút 2 cũng phải dùng mã hóa với cùng cụm mật khẩu.
9. **Chọn các ổ vSAN và gán tầng** -- Việc chọn ổ đĩa và tầng nên khớp với mẫu đã thiết lập trên Nút 1 (gán tầng giống nhau cho các loại ổ tương đương).
10. **Cấu hình swap** -- Khớp cấu hình swap từ Nút 1.
11. Khi trình cài đặt hoàn tất, **tháo phương tiện USB** và nhấn **\[Enter]** để khởi động lại.

### Xác minh Nút 2

| Chọn                 | Kết quả mong đợi                                                                          |
| -------------------- | ----------------------------------------------------------------------------------------- |
| **Màn hình console** | Menu người dùng VergeOS màu xanh xuất hiện                                                |
| **Đăng nhập UI**     | Truy cập cùng địa chỉ IP đã dùng cho Nút 1; cả hai nút đều hiển thị trong bảng điều khiển |
| **Trạng thái nút**   | Cả hai nút đều hiển thị trạng thái khỏe mạnh (màu xanh) trong bảng điều khiển Nodes       |
| **Dự phòng vSAN**    | vSAN hiển thị trạng thái dự phòng (N+1) với cả hai nút cùng cung cấp lưu trữ              |

```mermaid
graph TB
    subgraph cluster["Cụm Bộ điều khiển (Dự phòng N+1)"]
        N1["Nút 1 — Bộ điều khiển Chính<br/>vSAN + Tính toán"]
        N2["Nút 2 — Bộ điều khiển Phụ<br/>vSAN + Tính toán"]
    end

    subgraph fabric["Core Fabric"]
        C1["Core 1"]
        C2["Core 2"]
    end

    N1 --- C1
    N1 --- C2
    N2 --- C1
    N2 --- C2

    EXT["Mạng ngoài<br/>(Giao diện quản trị)"] --- N1
    EXT --- N2

    style cluster fill:#e8f5e9,stroke:#2e7d32
    style fabric fill:#f0f4ff,stroke:#336
```

***

## Dự phòng N+2 (Tùy chọn Bộ điều khiển Thứ ba)

Hai nút bộ điều khiển cung cấp mặc định **dự phòng N+1** -- hai bản sao của mỗi khối dữ liệu. Đối với các môi trường cần khả năng phục hồi cao hơn, VergeOS cũng hỗ trợ **dự phòng N+2** với ba nút bộ điều khiển, duy trì ba bản sao của mỗi khối dữ liệu.

Để cấu hình N+2:

1. Cài đặt nút bộ điều khiển thứ ba theo cùng quy trình của Nút 2 (tham gia hệ thống hiện có).
2. Trong quá trình cài đặt bộ điều khiển thứ ba, trình cài đặt sẽ cảnh báo rằng hệ thống sẽ chuyển sang dự phòng N+2 (3 bản sao dữ liệu, \~33% dung lượng sử dụng) và yêu cầu bạn gõ `N+2` để xác nhận.
3. Sau khi cả ba nút bộ điều khiển được cài đặt, **khởi động lại cả ba nút** để kích hoạt dự phòng N+2.
4. Việc thêm nút bộ điều khiển thứ ba để đạt dự phòng N+2 nên được thực hiện phối hợp với Bộ phận Hỗ trợ VergeOS.

{% hint style="warning" %}
Việc chuyển đổi giữa N+1 và N+2 trên hệ thống hiện có đòi hỏi một quá trình tái cân bằng dữ liệu đầy đủ có thể liên quan đến **thời gian ngừng hoạt động đáng kể**, đặc biệt trên các hệ thống có khối lượng dữ liệu lớn. Chỉ nên thực hiện thay đổi này phối hợp với Bộ phận Hỗ trợ VergeOS.
{% endhint %}

***

## Tóm tắt quyết định cài đặt

### Các quyết định không thể đảo ngược

**Mã hóa** (Có/Không) không thể thay đổi sau khi cài đặt nếu không cài lại toàn bộ. Hãy quyết định trước khi bắt đầu.

### Có thể thay đổi sau cài đặt

Tên hệ thống, thông tin xác thực quản trị, email, cấu hình swap và tên mạng đều có thể được sửa thông qua giao diện sau khi cài đặt.

### Phải khớp giữa các nút

Cài đặt mã hóa và mẫu gán tầng phải nhất quán giữa Nút 1 và Nút 2 (và tất cả các nút bộ điều khiển tiếp theo).

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

Nhấn `Esc` để có dấu nhắc lệnh. Dùng `yb-install` để tiếp tục hoặc `yb-install --restart` để khởi động lại quá trình cài đặt.

***

## Tham khảo nhanh: Điều hướng trình cài đặt

| Bước               | Lựa chọn Nút 1          | Lựa chọn Nút 2                        |
| ------------------ | ----------------------- | ------------------------------------- |
| Loại cài đặt       | Cài đặt chuẩn           | Cài đặt chuẩn                         |
| Vai trò            | Bộ điều khiển           | Bộ điều khiển                         |
| Cài đặt mới?       | **Có** (vSAN mới)       | **Không** (tham gia hệ thống hiện có) |
| Múi giờ / NTP      | Cấu hình thủ công       | Không được nhắc (kế thừa từ Nút 1)    |
| Tên hệ thống       | Nhập tên                | Không được nhắc (kế thừa từ Nút 1)    |
| Tài khoản quản trị | Tạo mới                 | Nhập thông tin xác thực hiện có       |
| Cấu hình mạng      | Thủ công theo từng NIC  | Khuyến nghị tự động phát hiện         |
| Giấy phép          | Nhập thông tin xác thực | Không được nhắc (kế thừa từ Nút 1)    |
| Mã hóa             | Chọn Có/Không           | Phải khớp Nút 1                       |
| Chọn đĩa/tầng      | Chọn đầy đủ             | Phải khớp mẫu của Nút 1               |
| Swap               | Cấu hình                | Cấu hình (khớp Nút 1)                 |

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

Khi cả hai nút bộ điều khiển đã được cài đặt và xác minh, bạn có thể tiếp tục thêm dung lượng bổ sung:

* [**Thêm nút →**](/learn-the-platform/vi/mo-dun-3-cai-dat/03-adding-nodes.md) -- Cài đặt nút mở rộng quy mô, chỉ tính toán và chỉ lưu trữ
* [**Xác minh sau cài đặt →**](/learn-the-platform/vi/mo-dun-3-cai-dat/04-post-install-verification.md) -- Kiểm tra tình trạng hệ thống và các tác vụ cấu hình hoàn chỉnh


---

# 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/mo-dun-3-cai-dat/02-controller-installation.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.
