> 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/de/systemadministration/ipmi.md).

# IPMI

Wie man die IPMI-Integration in VergeOS für die Fernsteuerung der Serverleistung, Konnektivitätstests, Anmeldedatenverwaltung und den Zugriff auf die IPMI-Weboberfläche konfiguriert und verwendet.

IPMI ist ein universeller Standard, der von nahezu aller Hardware unterstützt wird, zur Verwaltung und zum Zugriff auf Server. Er ist sogar verfügbar, wenn ein Server ausgeschaltet ist, und ermöglicht die Fernsteuerung von Servern sowie die Überwachung des Hardwarestatus, einschließlich Dingen wie Temperatur, Stromverbrauch, Spannung, Hardwarefehlern usw. VergeOS integriert sich mit IPMI, um die Fernsteuerung der Serverleistung (Ein-/Ausschalten, Neustart usw.) und einen bequemen Zugriff über die VergeOS-Benutzeroberfläche bereitzustellen.

{% hint style="info" %}
Da IPMI mit physischer Hardware arbeitet, gilt es nur für Knoten auf Host-Ebene (nicht für Mandantenknoten).
{% endhint %}

## IPMI-Verbindung testen

1. Navigieren Sie zu **Infrastruktur** > **Knoten** im oberen Menü.
2. **Doppelklicken Sie auf den gewünschten Knoten** um auf das Knoten-Dashboard zuzugreifen.
3. Unter dem **IPMI** Untermenü klicken Sie auf **Test** im linken Menü.

### IPMI-Verbindungsstatus

Das Knoten-Dashboard zeigt den IPMI ***Status*** und ***Datum/Uhrzeit der letzten Verbindung***:

* **IPMI-Status** - „OK“ zeigt an, dass der letzte Verbindungsversuch erfolgreich war. Wenn der letzte Versuch nicht erfolgreich war, wird eine Fehlermeldung angezeigt.
* **Zuletzt mit IPMI verbunden** - zeigt das letzte Datum/die letzte Uhrzeit an, zu der das VergeOS-System erfolgreich eine Verbindung mit IPMI hergestellt hat. (Wenn nie eine erfolgreiche IPMI-Verbindung bestand, meldet das Feld „NA“.)

## Gespeicherte IPMI-Anmeldedaten ändern

{% hint style="success" %}
Die folgenden Anweisungen beschreiben, wie die IPMI-Anmeldedaten geändert werden, die ein Knoten für die Schnittstelle mit IPMI verwendet. Das Ändern dieser Felder führt nicht zur Benutzerverwaltung in IPMI; verbinden Sie sich mit Ihrer IPMI-Weboberfläche, um IPMI-Benutzer hinzuzufügen oder zu ändern.
{% endhint %}

1. Klicken Sie im Knoten-Dashboard auf **Bearbeiten** im linken Menü.
2. Geben Sie einen gültigen ***IPMI-Benutzer***. (Der IPMI-Benutzer sollte über Administratorrechte verfügen.)
3. Geben Sie ***das IPMI-Passwort ein***.
4. Klicken Sie auf **Senden** um die Änderungen am Knoten zu speichern.

## Auf die IPMI-Weboberfläche zugreifen

{% hint style="info" %}
Für eine erfolgreiche Verbindung mit der IPMI-Weboberfläche über die VergeOS-Benutzeroberfläche müssen ein gültiger IPMI-Benutzername und ein gültiges Passwort gespeichert sein und eine entsprechende Netzwerkkonfiguration vorhanden sein, damit das System mit dem IPMI des Knotens interagieren kann.
{% endhint %}

1. Navigieren Sie zu **Infrastruktur** > **Knoten** im oberen Menü.
2. **Doppelklicken Sie auf den gewünschten Knoten** um auf das Knoten-Dashboard zuzugreifen.
3. Unter dem **IPMI** Untermenü im linken Menü auf **Verbinden**.
4. Es öffnet sich ein neuer Browser-Tab auf der Anmeldeseite der IPMI-Weboberfläche.

## IPMI-Anmeldedaten über die REST-API verwalten

IPMI-Anmeldedaten können auch über die VergeOS-REST-API gelesen und aktualisiert werden. Dies ist nützlich, um Anmeldedaten über viele Knoten hinweg oder per Automatisierungsskripten zu verwalten.

### Den Knotenschlüssel finden

API-Aufrufe, die auf einen Knoten abzielen, verwenden den Zeilenschlüssel des Knotens (`$key`). Listen Sie die Knoten auf, um den Schlüssel zu finden:

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

Um einen bestimmten Knoten anhand des Namens zu finden:

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

Die Antwort enthält den `$key` Wert zusammen mit Feldern wie `name`, `ipmi_address`, und `ipmi_status`.

### IPMI-Informationen lesen

Einen einzelnen Knoten-Datensatz abrufen:

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

IPMI-bezogene Felder in der Antwort:

| Feld                              | Beschreibung                                                            |
| --------------------------------- | ----------------------------------------------------------------------- |
| `ipmi_address`                    | Die BMC-IP-Adresse oder der Hostname.                                   |
| `ipmi_user`                       | Der BMC-Benutzername.                                                   |
| `ipmi_password`                   | Nur zum Schreiben; nicht in Leseantworten enthalten.                    |
| `ipmi_status`                     | Der Verbindungsstatus: `bereit`, `verbindet`, `offline`, oder `Fehler`. |
| `ipmi_sel_free` / `ipmi_sel_used` | Kapazitätszähler des Systemereignisprotokolls.                          |

### IPMI-Anmeldedaten festlegen

Aktualisieren Sie die gespeicherten Anmeldedaten mit einem `PUT` Anfrage:

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

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

Das Speichern der Anmeldedaten führt automatisch einen Konnektivitätstest aus; eine separate Testaktion ist nicht erforderlich. Wenn der Test nicht ausgeführt werden kann — zum Beispiel, weil der Knoten keine IPMI-Adresse hat — gibt die API einen Fehler zurück und die Aktualisierung wird nicht gespeichert. Um die Aktualisierung zu überprüfen, lesen Sie den Knoten-Datensatz erneut aus und bestätigen Sie `ipmi_status` ist `bereit`.

### IPMI-Aktionen auslösen

Um einen Konnektivitätstest auszuführen oder das Systemereignisprotokoll zu löschen, ohne die Anmeldedaten zu ändern, senden Sie eine Knotenaktion:

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

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

Die verfügbaren IPMI-Aktionen sind `ipmi_test` und `clear_sel`.

{% hint style="info" %}
IPMI gilt nur für Knoten auf Host-Ebene, und `ipmi_password` kann nicht über die API ausgelesen werden.
{% 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/de/systemadministration/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.