Einleitung

In diesem Dokument werden häufige Fehlerbehebungsszenarien für die Hyperflex-Cluster-Bereitstellung durch Intersight beschrieben.

Voraussetzungen 

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Intersight
• HyperFlex-Cluster-Bereitstellung 

Verwendete Komponenten

Dieses Dokument ist nicht auf bestimmte Software- und Hardware-Versionen beschränkt.

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Hintergrundinformationen

Der Workflow des Intersight-Installationsprogramms folgt der in der Tabelle dargestellten Aufgabe zur Bereitstellung eines Hyperflex-Clusters:

Aufgabenname	Definition
VorbereitenVorClusterInfoTask	Generiert Konfigurationsdateien, die die zum Bereitstellen des Clusters erforderlichen Informationen enthalten (z. B. Konfigurationsdateipfad, Software-YAML-Datei).
ServerKonfigurationValidierungAufgabe	Validiert die UCS-Serverkonfiguration, um sicherzustellen, dass sie über die erforderliche Hardware- und Firmwarekonfiguration verfügt (z. B. Festplattengröße/PID-Validierung, korrekte NICs usw.)
PreConfigurationValidationTask	Validiert die Netzwerkkonfiguration, bevor die Serverkonfiguration gestartet wird (z. B. DNS, NTP, vCenter-Erreichbarkeit, Prüfung auf doppelte IP-Adressen)
LokaleImageRepoTask vorbereiten	Lädt Software-Images (Controller VM OVA, HXP-Pakete) in den lokalen Image-Speicher herunter. Diese Aufgabe ist nur dann im Workflow enthalten, wenn sie in der verbundenen Appliance-Umgebung ausgeführt wird.
Serverkonfigurationstask	Ermöglicht die erforderliche Konfiguration auf den UCS-Servern. Bei FI-basierten Bereitstellungen umfasst dies die Erstellung und Zuordnung der Serviceprofile.
HypervisorESX-Konfigurationsaufgabe	Konfiguriert den Netzwerkteil auf dem Hypervisor. Dazu gehört die Verwendung von "Seriell über LAN" zum Hinzufügen der Uplinks zum Management-vSwitch und zum Konfigurieren der IP-Adresse, des Hostnamens und der DNS-/NTP-Konfiguration.
PreDeployValidationTask	Führt Validierungen aus, bevor die Clusterbereitstellung beginnt. Zu den Validierungen gehören Prüfungen der Netzwerkerreichbarkeit und die Überprüfung, dass die Knoten nicht bereits Teil eines anderen Clusters sind.
VorbereitungHypervisorDeploymentTask	bereitet den Hypervisor auf die Konfiguration des virtuellen Controllers (VM) vor. Ruft Host-Informationen von ESXi ab und stellt sicher, dass die richtigen Betriebssystem-Parameter eingestellt werden.
HypervisorNetzwerkAufgabe	Konfiguriert den Netzwerkteil auf dem ESXi-Host. Umfasst die Konfiguration der verschiedenen vSwitches/Portgruppen auf dem Host, die für den Betrieb des Clusters erforderlich sind.
HypervisorSoftwareUpdateTask	Aktualisiert die Software auf dem Hypervisor, der ggf. aus den erforderlichen VIBs auf dem Host besteht.
HypervisorDatenspeicherAufgabe	Erstellt bei Bedarf den Datenspeicher für die Controller-VM.
BereitstellenHyperflexControllerVm	Bereitstellung der Storage Controller-OVA auf dem Hypervisor, falls erforderlich
Konfig.VmTask	Konfiguriert den Netzwerkteil auf dem Controller VM, der die Konfiguration der benötigten Parameter und der Daten-/Management-Netzwerke beinhaltet.
BereitstellenSoftwareVmAufgabe	Installiert HXDP-Pakete auf den virtuellen Controllern.
CollectNodeInfoTask	Erfasst Knoteninformationen wie UUID und IPs.
ErfassenBestandDatenAufgabe	Versendet Inventardaten an Controller-VMs.
ErstellenClusterValidationTask	Validiert, um sicherzustellen, dass die Controller-VM dem Cluster beitreten kann. Umfasst MTU-Prüfungen und verifiziert die Bereitschaft der Speicherdienste.
ErstellenClusterTask	Erstellt das Storage-Cluster und verbindet die Controller-VM mit allen Knoten im Cluster.
NachInstallationHostConfig	Konfiguriert den Host nach der Bereitstellung des Clusters. Beinhaltet die Änderung des ESXi-Kennworts in das neue Kennwort im Hyperflex-Clusterprofil.
NachInstallationStorageControllerVmConfig	Konfiguriert die Controller-VMs nach der Bereitstellung des Clusters und schließt die Änderung des Controller-VM-Kennworts in das neue Kennwort ein, das im Hyperflex-Clusterprofil angegeben wurde.
ClusterAutoAnspruchAufgabe	Fordert das HyperFlex-Cluster beim Intersight-Benutzerkonto an.

Problem

Nachfolgend sind die häufigsten Fehler aufgeführt, die bei der Clusterbereitstellung auftreten können:

Validierungsfehler/Warnung:

• Doppelte IPs (Fehler auf demselben Fabric Interconnect, Warnung bei globalen Überschneidungen)
• Cluster-Erstellung mit 2 Knoten
• 2 für gewählten Replikationsfaktor (Datenreplikationsfaktor von 3 wird empfohlen)

  

Laufzeitvalidierung:

• DNS, NTP nicht erreichbar
• vCenter ist nicht erreichbar oder falsche Anmeldeinformationen
• Bereits verwendete Mgmt-IP-Adressen

Bereitstellungsfehler:

• Identische Daten-VLANs für zwei verschiedene Cluster in derselben L2-Domäne (Uplink-Switch)
• Cross-over-Verbindung
• ESXi IP-Konfigurationsfehler (aufgrund falscher ESXi-Anmeldeinformationen)

Lösung

Je nach fehlgeschlagener Aufgabe und aufgetretenem Fehler können Sie die vorgeschlagenen Aktionen ausführen:

DNS/NTP nicht erreichbar

Validator_NTP_List, Status Code: 9 (FAILED), Message: There are no reachable NTP servers from list

Aktion: Überprüfen Sie die IP-Adresse, ändern Sie die Richtlinie bei falscher Eingabe, und starten Sie den Workflow neu.

 vCenter nicht erreichbar

"vCenter reachability and credential check : vCenter server is not reachable or invalid vCenter credentials."

Aktion: Überprüfen Sie die vCenter-IP/Anmeldeinformationen. Wenn dies falsch ist, ändern Sie die Richtlinie, und starten Sie den Workflow neu.

IP duplizieren

“IP address x.x.x.x already in use. Please verify there are no duplicate IPs.”

Aktion: Überprüfen Sie, ob die IP bereits verwendet wird. Ändern Sie in diesem Fall die Richtlinie, und starten Sie den Workflow neu.

Verbindung zum Host fehlgeschlagen

failed in Task: 'Connection to host' with Error: 'Host(x.x.x.x) is not reachable via device connector.
 Please check the VLAN ID, IP address and gateway settings.'

Aktion: Überprüfen Sie das VLAN/IP/Gateway, ändern Sie die Richtlinie, und starten Sie den Workflow neu, falls dies falsch ist.

Automatische Forderung fehlgeschlagen

"failed to claim the HyperFlex device connector.  
This cluster requires continued connectivity to Intersight to ensure Fault Tolerance is maintained. 
The cluster cannot tolerate failures until this step is completed.  Please check the cluster connectivity to Intersight and perform a manual claim. "

Aktion: Fordern Sie den HyperFlex-Cluster an, der im Verfahren für den Geräteantrag aufgeführt ist, und starten Sie den Workflow neu.

Fehler beim Konfigurieren der Serverprofilzuordnung

failed in Task: 'Failed to Configure Server Profile Association

Aktion:

Die ESXi IP-Konfiguration erfolgt über den Konsolenzugriff über CIMC Serial Over LAN. Manchmal erhält CIMC SoL die Konsole nicht in die Anmeldeaufforderung. Überprüfen Sie die CIMC-Konsole auf ESXi über KVM, setzen Sie CIMC zurück, und starten Sie den Workflow neu.

Fehler in Task: Überwachen des BS-Bootvorgangs

Configuring CIMC server: failed in Task: 'Failed to Configure Server Profile Association.' with Error: 'failed in Task: 'Monitor OS boot' with Error: 'OS Installation has failed'\"}}}}'

Aktion:

• Stellen Sie sicher, dass das ESXi-Root-Kennwort richtig ist. 
• Überprüfen Sie bei der Erstinstallation das werksseitig voreingestellte Kennwort.
• Deaktivieren Sie für eine Neuinstallation das werksseitig voreingestellte Kennwort.
• Überprüfen Sie, ob der SoL-Zugriff fehlschlägt.
• Überprüfen Sie, ob der Geräteanschluss beim Booten des Betriebssystems getrennt wurde.

Wenn es sich um eine Neuinstallation handelt, stellen Sie sicher, dass das angegebene Kennwort nicht das Standardkennwort (Cisco123) ist, auch wenn das Optionsfeld für das werksseitig voreingestellte Kennwort aktiviert ist.

Das Ergebnis dieser Aktion ist, dass sich der Installer beim ESXi anmelden kann, das Kennwort jedoch nicht festlegen kann, da die Stärke des Standardkennworts schwach ist. 

Fehler bei der Aufgabe: Überprüfen der OVA gegen Sha1

Deploying Storage Controller VM on ESXi host: Failed in Task: “Verify OVA against Sha1"

Aktion:

• Überprüfen Sie, ob für ESXi kein DNS konfiguriert ist.
• Überprüfen Sie, ob das ESXi mgmt IP-Subnetz für den Intersight-Zugriff blockiert ist.

Fehler bei der Aufgabe: Hinzufügen des Hosts zum vCenter-Cluster

failed in Task: Add host to vCenter Cluster with Error: Try adding host manually to vCenter and retry. failed to add the host x.x.x.x with 3 attempts

Aktion:

Die vCenter-Version muss höher oder gleich allen Hosts im Cluster sein. Aktualisieren Sie vCenter auf eine höhere oder gleichwertige ESXi-Version, oder stufen Sie ESXi auf eine stabilere Version herunter. 

Fehler bei der Aufgabe: Konfiguration des Netzwerkspeicher-Controllers für VM fehlgeschlagen

failed in Task: 'Check Network for Storage Controller VM Configuration Result' with Error: 'Configure networking failed with error: Error while connecting to ESXi host. Please check the connection and retry'

Aktion:

Der EXSI API-Server reagiert gelegentlich nicht rechtzeitig.

• Überprüfen Sie den Status des gehosteten Dienstes, um sicherzustellen, dass ausgeführt wird.
• Starten Sie ESXi neu, und wiederholen Sie die Bereitstellung.

Workflow aufgrund von MTU-Problemen fehlgeschlagen

failed in Task: 'Verify Storage Cluster' with Error: 'id: 2 entityRef: id: x.x.x.x name: x.x.x cluster message: Could not ping x.x.x.x with MTU 9000 during failover test. 
     Verify the VLAN and MTU on the upstream switch is correct prior to continuing. severity: warning'

Aktion:

Der Jumbo Frame ist nicht in allen Pfaden aktiviert. Wenn der Jumbo Frame aktiviert ist, muss der MTU-Wert 9216 im Uplink-Switch konfiguriert werden. Stellen Sie sicher, dass die MTU in allen Pfaden auf Jumbo-Frames festgelegt ist, und starten Sie den Workflow neu.

Fehler bei der Aufgabe: Kopieren von Softwarepaketen auf den Speicher-Controller-VM

failed in Task: 'Copying Software Packages to Storage Controller VM(outbound)' with Error: 'Unexpected failure during module execution.

Aktion:

• Stellen Sie sicher, dass zwischen SCVM und Intersight eine Netzwerkverbindung besteht.
• Überprüfen Sie, ob die erforderlichen Ports im Netzwerk zulässig sind.
• Informationen zu den Netzwerkanforderungen finden Sie unter den Links zur Überprüfung vor der Installation.

Zugehörige Informationen

• Hyperflex - Installationsübersicht
• Hyperflex-Installationsanleitungen
• Checkliste für die Vorinstallation der HX-Datenplattform
• Technischer Support und Dokumentation für Cisco Systeme