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.

Da IPMI mit physischer Hardware arbeitet, gilt es nur für Knoten auf Host-Ebene (nicht für Mandantenknoten).

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

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.

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

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.

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:

GET /api/v4/nodes

Um einen bestimmten Knoten anhand des Namens zu finden:

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:

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:

PUT /api/v4/nodes/{key}

{
  "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:

POST /api/v4/node_actions

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

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

IPMI gilt nur für Knoten auf Host-Ebene, und ipmi_password kann nicht über die API ausgelesen werden.