VxRail: Ändern der NTP-Server-IP-Adresse auf VxRail 8.0.x- und 7.0.x-Versionen über die REST API

Öffentliche Dokumentation für Dell Entwickler

Die Entwicklerdokumentation für die VxRail REST API und andere Dell Produkte finden Sie auf der Website für Dell Supportentwickler. Suchen Sie unter "Hyperconverged Infrastructure " nach der VxRail-spezifischen API.

Spezifische Dokumentation zum Abfragen oder Aktualisieren von NTP finden Sie unter Systeminformationen, Abrufen und NTP festlegen:

Diese Dokumentation kann verwendet werden, um nutzerdefinierte curl Befehle ausführen oder in eine Anwendung integrieren, wie z. B. postman oder andere Anwendungen für erfahrenere Benutzer.

Integrierter VxRail-API-Client 

Die bevorzugte Methode (empfohlen für Personen, die mit der REST-API weniger vertraut sind) ist die Nutzung des nativen VxRail Manager-API-Clients.

Ab VxRail-Codeversion 7.0.350 wird eine neue Benutzeroberfläche mit größeren Funktionen basierend auf Spotlight verwendet. Um auf den nativen API-Client zuzugreifen, rufen Sie die folgende URL auf, indem Sie VxM> durch den FQDN/IP von VxRail Manager mit Ihrem bevorzugten Browser ersetzen <(kein spezieller API-Client erforderlich):

https://<VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html

In diesem Beispiel lautet die VxRail Manager-IP 172.168.10.50 so dass die URL zu https://172.168.10.50/rest/vxm/api-doc.html:

Abfragen der aktuellen NTP-Konfiguration des VxRail-Clusters

Verwenden Sie den Befehl v1_sytem_ntp_get API Abschnitt Systeminformationen im linken Bereich, um die aktuelle NTP-Konfiguration abzufragen:

• Die direkte URL wäre https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get Diese können sich jedoch von Version zu Version ändern, daher navigieren Sie am besten in der Benutzeroberfläche.
• Geben Sie die Authentifizierungsdaten für VxRail vCenter Single Sign-On (SSO) ein, die häufig die administrator@vsphere.local kann jedoch je nach Domainkonfiguration variieren.
• Klicken Sie auf die Schaltfläche Anfrage senden , um die GET bitten:

• Der API-Client authentifiziert sich und wenn er eine 200 OK-Antwort erhält, gibt er die angeforderten Informationen zurück, wobei unsere aktuelle NTP-Server-Lab-IP ist 172.168.10.45:

Aktualisieren der NTP-IP-Serverinformationen des VxRail-Clusters

Verwenden Sie die v1_system_ntp_post API, die im Abschnitt Systeminformationen im linken Bereich zu finden ist, um die aktuelle NTP-Konfiguration zu aktualisieren:

• Die direkte URL wäre https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post Diese können sich jedoch von Version zu Version ändern, daher navigieren Sie am besten in der Benutzeroberfläche.
• Geben Sie im Abschnitt Authentifizierung die Zugangsdaten für die VxRail vCenter SSO-Authentifizierung ein, die häufig die administrator@vsphere.local kann jedoch je nach Domainkonfiguration variieren.
• Bearbeiten Sie zum Aktualisieren des NTP-Servers auch den Abschnitt Text in drei Bereichen:
  • Der Abschnitt Components ist optional und ALL ist der Standardwert. Wenn ALL festgelegt ist, werden alle NTP-Server im Cluster ersetzt. Wenn VXM festgelegt ist, wird nur der NTP-Server für VxRail Manager ersetzt, was ein eingeschränktes Anwendungsbeispiel wäre, da empfohlen wird, die Konfiguration aller Komponenten konsistent zu halten. 

• Im Abschnitt "vCenter" müssen Sie einen SSO-Nutzernamen und ein Kennwort des Administrators übergeben. In der Regel handelt es sich dabei um dieselben Informationen wie im Abschnitt "Authentifizierung", es kann jedoch ein anderes SSO-Konto auf Administratorebene bereitgestellt werden.
• Im Abschnitt "Server" wird im folgenden Beispiel gezeigt, wie NTP auf IP eingestellt wird 172.168.10.45

 

Wenn unerwartete Antwortcodes

In einem fehlerhaften System oder vielleicht kann ein neuer NTP-Server nicht von ESXi-Hosts usw. erreicht werden. Der API-Client bietet einige grundlegende Anleitungen zu Fehlermeldungen. Zusätzliche Antwortfehlercodes können online gefunden werden, z. B. https://restfulapi.net/http-status-codes/ ist ein guter Standort.

Wenn unerwartete Fehlercodes auftreten, wenden Sie sich für zusätzliche Fehlerbehebungsmaßnahmen an den Dell Support.

In frühen VxRail 8.0-Versionen beziehen sich die SolVe Online-Verfahren auf die Aktualisierung der VxRail-NTP-IP-Einstellungen über die REST API. Es ist Teil der VxRail-Roadmap (genaue Version wird später bestätigt), dass diese Funktion im VxRail-UI-Plug-in verfügbar ist.

Dieser Artikel enthält Anleitungen und Beispiele für diese Aktivität für Kunden, die weniger Erfahrung mit der Nutzung der VxRail REST API haben.

Die IP-Informationen in diesem Artikel stammen aus einem temporären virtuell isolierten Labor und enthalten keine Kunden- oder vertraulichen IP-Informationen.