Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Problembehandlung mit pcluster-diag

pcluster-diagist ein Diagnosetool, das eine Reihe von Bedingungen überprüft, die ein AWS ParallelCluster intakter Knoten voraussichtlich erfüllen muss.

Wird pcluster-diag als ersten Schritt verwendet, wenn sich ein Cluster zur Laufzeit schlecht verhält. Das Tool gibt einen JSON-Diagnosebericht aus, der Ihnen hilft, die Probleme zu verstehen, die Ihren Cluster betreffen. Wenn Sie ein Problem nicht lösen können, fügen Sie den Bericht einer AWS Support-Anfrage bei.

Das Tool ist in jedem AWS ParallelCluster AMI ab Version 3.16.0 enthalten, sowohl in den offiziellen AMIs als auch in den benutzerdefinierten AMIs, mit denen Sie erstellen. pcluster build-image Wenn Sie eine ältere AWS ParallelCluster Version verwenden, können Sie das Tool trotzdem installieren, indem Sie die Schritte unter befolgen. Versionen, die älter als 3.16.0 sind

Sie können es pcluster-diag auf jedem Clusterknoten ausführen. Wenn Sie nicht wissen, wo das Problem liegt, führen Sie es auf dem Hauptknoten aus.

Verfügbare Schecks anzeigen

Um zu sehen, welche Prüfungen das Tool ausführen wird, verwenden Sie den describe-checks Unterbefehl, der ein JSON-Array aller registrierten Prüfungen zurückgibt, jede mit ihrer ID und Beschreibung.

$ pcluster-diag describe-checks
[
  {
    "check_id": "...",
    "check_description": "..."
  },
  ...
]

Führen Sie die Prüfungen aus

Stellen Sie eine Verbindung zu dem Knoten her, den Sie diagnostizieren möchten, und führen Sie dann den run Unterbefehl als Root aus.

$ sudo pcluster-diag run

pcluster-diagschreibt zwei separate Streams:

Verfügbar sind die nachfolgend aufgeführten Optionen.

Interpretieren Sie den Bericht

pcluster-diaggibt einen JSON-Bericht aus, der jede ausgeführte Prüfung berücksichtigt, unabhängig davon, ob die Prüfung bestanden, gewarnt, fehlgeschlagen oder übersprungen wurde. contextbeschreibt den Knoten, der diagnostiziert wurde. Die allgemeine Struktur des Berichts ist wie folgt:

{
  "context": { ... },
  "results": [
    {
      "check_id": "...",
      "check_description": "...",
      "status": "...",
      "errors": [ { "code": "...", "message": "..." } ],
      "warnings": [ { "code": "...", "message": "..." } ],
      "infos": [ { "code": "...", "message": "..." } ]
    }
  ]
}

Status prüfen

Bei status jedem Scheck erfahren Sie, was Sie damit machen sollen.

Wenn bei jeder Prüfung ein Bericht angezeigt wirdPASSED, pcluster-diag wurden keine Probleme gefunden. Die Berichterstattung von pcluster-diag ist jedoch nicht umfassend und wird mit jeder Veröffentlichung zunehmen. Eine fehlerfreie Diagnose garantiert nicht, dass der Cluster gesund ist.

Überprüfen Sie die Ergebnisse

Ein Prüfergebnis kann drei Arten von Ergebnissen mit jeweils einem code und einem enthaltenmessage.

Holen Sie sich das neueste pcluster-diag von GitHub

pcluster-diagist für alle AWS ParallelCluster Versionen 3.16.0 und höher verfügbar und kann mit einigen zusätzlichen Schritten auch auf älteren Versionen installiert werden.

Neue Prüfungen und verbesserte Diagnosemeldungen landen im https://github.com/aws/aws-parallelcluster-cookbook aws-parallelcluster-cookbook-Repository auf der Website. GitHub Um die neuesten Checks zu verwenden, ohne auf die nächste AWS ParallelCluster Version warten zu müssen, folgen Sie den Schritten für Ihre Version. AWS ParallelCluster

Versionen 3.16.0 und höher

In den AWS ParallelCluster Versionen 3.16.0 und höher ist der pcluster-diag Befehl installiert und verfügbar unter. PATH

Um das Tool von der develop Verzweigung aus zu aktualisieren, führen Sie den folgenden Befehl auf dem Knoten aus, auf dem Sie das Tool ausführen möchten.

$ curl -fL https://github.com/aws/aws-parallelcluster-cookbook/archive/refs/heads/develop.tar.gz \
  | sudo tar -xz --strip-components=5 -C /opt/parallelcluster/sources/pcluster-diag \
    --wildcards '*/cookbooks/aws-parallelcluster-platform/files/pcluster-diag/*'

Stellen Sie sicher, dass das Tool funktionsfähig ist:

$ sudo pcluster-diag describe-checks

Wenn Sie eine andere Version als die Spitze von verwenden möchtendevelop, ersetzen develop Sie die URL durch den gewünschten Zweig oder das gewünschte Tag, z. B. einen release-* Zweig.

Beachten Sie Folgendes:

Versionen, die älter als 3.16.0 sind

In AWS ParallelCluster Versionen, die älter als 3.16.0 sind, ist der pcluster-diag Befehl nicht auf dem Knoten installiert.

Um das Tool von der develop Verzweigung aus zu installieren, führen Sie den folgenden Befehl auf dem Knoten aus, auf dem Sie das Tool ausführen möchten.

$ sudo mkdir -p /opt/parallelcluster/sources/pcluster-diag
curl -fL https://github.com/aws/aws-parallelcluster-cookbook/archive/refs/heads/develop.tar.gz \
  | sudo tar -xz --strip-components=5 -C /opt/parallelcluster/sources/pcluster-diag \
    --wildcards '*/cookbooks/aws-parallelcluster-platform/files/pcluster-diag/*'

Stellen Sie sicher, dass das Tool funktionsfähig ist:

$ PYTHONPATH=/opt/parallelcluster/sources/pcluster-diag /opt/parallelcluster/pyenv/versions/3.12.8/envs/cookbook_virtualenv/bin/python3 -m pcluster_diag.cli describe-checks