> 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/es/administracion-del-sistema/ipmi.md).

# IPMI

Cómo configurar y usar la integración IPMI en VergeOS para control remoto de energía del servidor, pruebas de conectividad, gestión de credenciales y acceso a la interfaz web IPMI.

IPMI es un estándar universal, compatible con casi todo el hardware, para administrar y acceder a servidores. Es accesible incluso cuando un servidor está apagado y permite controlar servidores de forma remota y supervisar el estado del hardware, incluidas cosas como la temperatura, el consumo de energía, el voltaje, los errores de hardware, etc. VergeOS se integra con IPMI para proporcionar control remoto de la energía del servidor (encendido, ciclo de energía, etc.) y acceso conveniente a través de la interfaz de usuario de VergeOS.

{% hint style="info" %}
Debido a que IPMI trata con hardware físico, solo se aplica a nodos de nivel de host (no a nodos de inquilino).
{% endhint %}

## Probar la conectividad de IPMI

1. Navegue a **Infraestructura** > **Nodos** desde el menú superior.
2. **Haga doble clic en el nodo deseado** para acceder al panel del nodo.
3. En el **IPMI** submenú, haga clic en **Probar** en el menú izquierdo.

### Estado de conexión de IPMI

El panel del nodo indicará el ***estado*** y ***la fecha/hora de la última conexión***:

* **Estado de IPMI** - "OK" indica que el último intento de conexión fue exitoso. Si el último intento no fue exitoso, se muestra un mensaje de error.
* **Última conexión de IPMI** - muestra la última fecha/hora en que el sistema VergeOS se conectó correctamente a IPMI. (Si nunca hubo una conexión exitosa de IPMI, el campo mostrará "NA".)

## Cambiar las credenciales de inicio de sesión de IPMI almacenadas

{% hint style="success" %}
Las siguientes instrucciones sirven para cambiar las credenciales de IPMI que un nodo usará para interactuar con IPMI. Cambiar estos campos no realiza administración de usuarios de IPMI; conéctese a su interfaz web de IPMI para agregar o cambiar usuarios de IPMI.
{% endhint %}

1. Desde el Panel del Nodo, haga clic en **Editar** en el menú izquierdo.
2. Introduzca un ***usuario de IPMI***. (El usuario de IPMI debe tener privilegios de nivel de administrador.)
3. Introduzca ***la contraseña de IPMI***.
4. Haga clic en **Enviar** para guardar los cambios en el nodo.

## Acceder a la interfaz web de IPMI

{% hint style="info" %}
Conectarse correctamente a la interfaz web de IPMI a través de la interfaz de usuario de VergeOS requiere que se almacenen credenciales válidas de IPMI y que exista la configuración de red adecuada para que el sistema interactúe con el IPMI del nodo.
{% endhint %}

1. Navegue a **Infraestructura** > **Nodos** desde el menú superior.
2. **Haga doble clic en el nodo deseado** para acceder al panel del nodo.
3. En el **IPMI** en el submenú del menú izquierdo, haga clic en **Conectar**.
4. Se abre una nueva pestaña del navegador en la página de inicio de sesión de la interfaz web de IPMI.

## Administrar credenciales de IPMI mediante la API REST

Las credenciales de IPMI también se pueden leer y actualizar a través de la API REST de VergeOS. Esto es útil para administrar credenciales en muchos nodos o desde scripts de automatización.

### Encontrar la clave del nodo

Las llamadas a la API que apuntan a un nodo usan la clave de fila del nodo (`$key`). Liste los nodos para encontrar la clave:

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

Para localizar un nodo específico por nombre:

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

La respuesta incluye el `$key` valor junto con campos como `name`, `ipmi_address`, y `ipmi_status`.

### Leer información de IPMI

Recupere un único registro de nodo:

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

Campos relacionados con IPMI en la respuesta:

| Campo                             | Descripción                                                                 |
| --------------------------------- | --------------------------------------------------------------------------- |
| `ipmi_address`                    | La dirección IP o el nombre de host del BMC.                                |
| `ipmi_user`                       | El nombre de usuario del BMC.                                               |
| `ipmi_password`                   | Solo escritura; no se incluye en las respuestas de lectura.                 |
| `ipmi_status`                     | El estado de la conexión: `listo`, `conectando`, `sin conexión`, o `error`. |
| `ipmi_sel_free` / `ipmi_sel_used` | Contadores de capacidad del Registro de eventos del sistema.                |

### Establecer credenciales de IPMI

Actualice las credenciales almacenadas con una `PUT` solicitud:

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

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

Al guardar las credenciales, se ejecuta automáticamente una prueba de conectividad; no es necesaria una acción de prueba independiente. Si la prueba no puede ejecutarse — por ejemplo, si el nodo no tiene dirección IPMI — la API devuelve un error y la actualización no se guarda. Para verificar la actualización, vuelva a leer el registro del nodo y confirme `ipmi_status` es `listo`.

### Activar acciones de IPMI

Para ejecutar una prueba de conectividad o borrar el Registro de eventos del sistema sin cambiar las credenciales, publique una acción de nodo:

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

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

Las acciones de IPMI disponibles son `ipmi_test` y `clear_sel`.

{% hint style="info" %}
IPMI se aplica solo a nodos de nivel de host, y `ipmi_password` no puede leerse de vuelta a través de la 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/es/administracion-del-sistema/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.