> 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/quan-tri-he-thong/ipmi.md).

# IPMI

Cách cấu hình và sử dụng tích hợp IPMI trong VergeOS để điều khiển nguồn máy chủ từ xa, kiểm tra kết nối, quản lý thông tin xác thực và truy cập giao diện web IPMI.

IPMI là một tiêu chuẩn phổ quát, được hầu hết phần cứng hỗ trợ, để quản lý và truy cập máy chủ. Nó có thể truy cập ngay cả khi máy chủ đã tắt nguồn và cho phép điều khiển máy chủ từ xa cũng như giám sát trạng thái phần cứng, bao gồm các thông tin như nhiệt độ, mức tiêu thụ điện, điện áp, lỗi phần cứng, v.v. VergeOS tích hợp với IPMI để cung cấp khả năng điều khiển nguồn máy chủ từ xa (bật nguồn, chu kỳ nguồn, v.v.) và truy cập thuận tiện qua giao diện người dùng VergeOS.

{% hint style="info" %}
Vì IPMI xử lý phần cứng vật lý, nó chỉ áp dụng cho các node cấp máy chủ (không phải node tenant).
{% endhint %}

## Kiểm tra kết nối IPMI

1. Đi tới **Hạ tầng** > **Các node** từ menu trên cùng.
2. **Nhấp đúp vào node mong muốn** để truy cập bảng điều khiển của node.
3. Trong **IPMI** mục con, nhấp **Kiểm tra** trên menu bên trái.

### Trạng thái kết nối IPMI

Bảng điều khiển node sẽ hiển thị IPMI ***trạng thái*** và ***ngày/giờ của lần kết nối gần nhất***:

* **Trạng thái IPMI** - "OK" cho biết lần thử kết nối gần nhất đã thành công. Nếu lần thử gần nhất không thành công, một thông báo lỗi sẽ được hiển thị.
* **Lần kết nối IPMI gần nhất** - hiển thị ngày/giờ gần nhất mà hệ thống VergeOS đã kết nối thành công với IPMI. (Nếu chưa bao giờ có kết nối IPMI thành công, trường sẽ báo "NA".)

## Thay đổi thông tin đăng nhập IPMI đã lưu

{% hint style="success" %}
Các hướng dẫn sau đây cung cấp cách thay đổi thông tin đăng nhập IPMI mà một node sẽ dùng để giao tiếp với IPMI. Việc thay đổi các trường này không thực hiện quản trị người dùng IPMI; hãy kết nối tới giao diện web IPMI của bạn để thêm hoặc thay đổi người dùng IPMI.
{% endhint %}

1. Từ Bảng điều khiển Node, nhấp **Chỉnh sửa** trên menu bên trái.
2. Nhập một ***Người dùng IPMI***. (Người dùng IPMI nên có quyền cấp quản trị viên.)
3. Nhập ***Mật khẩu IPMI***.
4. Nhấp **Gửi** để lưu các thay đổi cho node.

## Truy cập giao diện web IPMI

{% hint style="info" %}
Việc kết nối thành công tới giao diện web IPMI thông qua giao diện người dùng VergeOS yêu cầu đã lưu tên người dùng/mật khẩu IPMI hợp lệ và cấu hình mạng phù hợp để hệ thống tương tác với IPMI của node.
{% endhint %}

1. Đi tới **Hạ tầng** > **Các node** từ menu trên cùng.
2. **Nhấp đúp vào node mong muốn** để truy cập bảng điều khiển của node.
3. Trong **IPMI** mục con trên menu bên trái, nhấp **Kết nối**.
4. Một tab trình duyệt mới sẽ mở ra trang đăng nhập giao diện web IPMI.

## Quản lý thông tin đăng nhập IPMI qua REST API

Thông tin đăng nhập IPMI cũng có thể được đọc và cập nhật qua REST API của VergeOS. Điều này hữu ích để quản lý thông tin đăng nhập trên nhiều node hoặc từ các script tự động hóa.

### Tìm khóa Node

Các lệnh gọi API nhắm tới một node sử dụng khóa hàng của node (`$key`). Liệt kê các node để tìm khóa:

```http
GET /api/v4/nodes
```

Để xác định một node cụ thể theo tên:

```http
GET /api/v4/nodes?filter=name eq 'node1'
```

Phản hồi bao gồm `$key` giá trị cùng với các trường như `name`, `ipmi_address`, và `ipmi_status`.

### Đọc thông tin IPMI

Truy xuất một bản ghi node duy nhất:

```http
GET /api/v4/nodes/{key}
```

Các trường liên quan đến IPMI trong phản hồi:

| Trường                            | Mô tả                                                                      |
| --------------------------------- | -------------------------------------------------------------------------- |
| `ipmi_address`                    | Địa chỉ IP hoặc tên máy chủ của BMC.                                       |
| `ipmi_user`                       | Tên người dùng BMC.                                                        |
| `ipmi_password`                   | Chỉ ghi; không bao gồm trong phản hồi đọc.                                 |
| `ipmi_status`                     | Trạng thái kết nối: `sẵn sàng`, `đang kết nối`, `ngoại tuyến`, hoặc `lỗi`. |
| `ipmi_sel_free` / `ipmi_sel_used` | Các bộ đếm dung lượng của Nhật ký Sự kiện Hệ thống.                        |

### Đặt thông tin đăng nhập IPMI

Cập nhật thông tin đăng nhập đã lưu bằng một `PUT` yêu cầu:

```http
PUT /api/v4/nodes/{key}
```

```json
{
  "ipmi_user": "admin",
  "ipmi_password": "newpassword"
}
```

Việc lưu thông tin đăng nhập sẽ tự động chạy một bài kiểm tra kết nối; không cần thực hiện một hành động kiểm tra riêng. Nếu bài kiểm tra không thể chạy — ví dụ, node không có địa chỉ IPMI — API sẽ trả về lỗi và bản cập nhật sẽ không được lưu. Để xác minh bản cập nhật, đọc lại bản ghi node và xác nhận `ipmi_status` là `sẵn sàng`.

### Kích hoạt các hành động IPMI

Để chạy kiểm tra kết nối hoặc xóa Nhật ký Sự kiện Hệ thống mà không thay đổi thông tin đăng nhập, hãy gửi một hành động cho node:

```http
POST /api/v4/node_actions
```

```json
{
  "$row": "/v4/nodes/{key}",
  "action": "ipmi_test"
}
```

Các hành động IPMI khả dụng là `ipmi_test` và `clear_sel`.

{% hint style="info" %}
IPMI chỉ áp dụng cho các node cấp máy chủ, và `ipmi_password` không thể đọc lại qua API.
{% 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/quan-tri-he-thong/ipmi.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.