VxRail: Het IP-adres van de NTP-server wijzigen op VxRail 8.0.x- en 7.0.x-releases met behulp van de REST API

Openbare documentatie voor ontwikkelaars van Dell

De ontwikkelaarsdocumentatie voor VxRail REST API en andere Dell producten is te vinden op de Dell Support Developer site, filter voor Hyperconverged Infrastructure om de VxRail specifieke API te vinden.

Specifieke documentatie voor het opvragen of bijwerken van NTP vindt u onder System Information, Get en Set NTP:

Deze documentatie kan worden gebruikt om aangepaste curl opdrachten of integreren in een applicatie, zoals postman of andere applicaties voor meer ervaren gebruikers.

VxRail embedded API-client 

De VxRail API's kunnen bij voorkeur worden gebruikt (aanbevolen voor mensen die minder bekend zijn met REST API's) door gebruik te maken van de native VxRail Manager API-client.

Vanaf VxRail code versie 7.0.350 wordt een nieuwe interface gebruikt met meer mogelijkheden op basis van spotlight. Om toegang te krijgen tot de native API-client, gaat u naar de volgende URL en vervangt u <VxM door de VxRail> Manager FQDN/IP door uw voorkeursbrowser (geen speciale API-client nodig):

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

In dit voorbeeld is het IP-adres van de VxRail Manager 172.168.10.50 zodat de URL wordt https://172.168.10.50/rest/vxm/api-doc.html:

Query's uitvoeren op de huidige NTP-configuratie van het VxRail cluster

Gebruik de v1_sytem_ntp_get API Sectie systeeminformatie in het linkerdeelvenster om een query uit te voeren op de huidige NTP-configuratie:

• De directe URL zou zijn https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get deze kunnen echter per versie verschillen, dus u kunt het beste in de gebruikersinterface navigeren.
• Voer de VxRail vCenter Single Sign-On (SSO)-authenticatiereferenties in, die vaak de administrator@vsphere.local Maar dit kan variëren afhankelijk van uw domeinconfiguratie.
• Klik op de knop Verzoek verzenden om de GET verzoek:

• De API-client verifieert en als deze een antwoord van 200 OK krijgt, retourneert u de gevraagde informatie waar ons huidige NTP-serverlab-IP-adres zich bevindt 172.168.10.45:

Informatie over de NTP IP-server van het VxRail cluster bijwerken

Gebruik de v1_system_ntp_post API die u kunt vinden onder de sectie Systeeminformatie in het linkerdeelvenster om de huidige NTP-configuratie bij te werken:

• De directe URL zou zijn https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post deze kunnen echter per versie verschillen, dus u kunt het beste in de gebruikersinterface navigeren.
• Voer in het gedeelte Verificatie de referenties voor SSO-verificatie van VxRail vCenter in, die vaak de administrator@vsphere.local Maar dit kan variëren afhankelijk van uw domeinconfiguratie.
• Als u de NTP-server wilt bijwerken, bewerkt u ook de sectie Body in drie gebieden:
  • Het gedeelte Componenten is optioneel en ALLES is de standaardinstelling. Als ALL is ingesteld, worden alle NTP-servers in het cluster vervangen. Als VXM is ingesteld, wordt alleen de NTP-server voor VxRail Manager vervangen. Dit zou een beperkt gebruiksscenario zijn, omdat het wordt aanbevolen om alle componentconfiguraties consistent te houden. 

• In het vCenter-gedeelte moet u de gebruikersnaam en het wachtwoord van een SSO-beheerder doorgeven. Meestal is dit dezelfde informatie als in het gedeelte Verificatie, maar er kan een ander SSO-account op beheerdersniveau worden opgegeven.
• In het gedeelte servers ziet u in het onderstaande voorbeeld hoe u NTP instelt op IP 172.168.10.45

 

Als er onverwachte responscodes zijn

In een ongezond systeem of misschien kan een nieuwe NTP-server niet worden bereikt vanaf ESXi-hosts, enzovoort. De API-client biedt enkele basisrichtlijnen voor foutmeldingen en aanvullende responsfoutcodes zijn bijvoorbeeld online te vinden https://restfulapi.net/http-status-codes/ is een goede locatie.

Als er onverwachte foutcodes zijn, neemt u contact op met Dell Support voor aanvullende probleemoplossing.

In vroege VxRail 8,0-releases verwijst de Solve Online-procedures naar het bijwerken van de VxRail NTP IP-instellingen via de REST API. Het staat op de VxRail-routekaart (exacte release wordt later bevestigd) om deze mogelijkheid beschikbaar te hebben in de VxRail UI-plug-in.

Dit artikel bevat richtlijnen en voorbeelden voor deze activiteit voor klanten met minder ervaring met het gebruik van de VxRail REST API.

De IP-informatie in dit artikel is afkomstig van een tijdelijk virtueel geïsoleerd lab en bevat geen klant- of vertrouwelijke IP-informatie.