Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi con pcluster-diag

pcluster-diagè uno strumento di diagnostica che verifica una serie di condizioni che un AWS ParallelCluster nodo sano dovrebbe soddisfare.

pcluster-diagDa utilizzare come primo passaggio quando un cluster non si comporta correttamente in fase di esecuzione. Lo strumento emette un rapporto di diagnostica JSON per aiutarti a comprendere i problemi che riguardano il tuo cluster. Se non riesci a risolvere un problema, allega il rapporto a un AWS caso di supporto.

Lo strumento è incluso in tutte le AWS ParallelCluster AMI a partire dalla versione 3.16.0, sia le AMI ufficiali che le AMI personalizzate con cui si crea. pcluster build-image Se utilizzi una AWS ParallelCluster versione precedente, puoi comunque installare lo strumento seguendo i passaggi indicati. Versioni precedenti alla 3.16.0

È possibile eseguire pcluster-diag su qualsiasi nodo del cluster. Se non sai dov'è il problema, eseguilo sul nodo principale.

Mostra i controlli disponibili

Per vedere quali controlli verranno eseguiti dallo strumento, usa il describe-checks sottocomando, che restituisce un array JSON di ogni controllo registrato, ciascuno con il suo ID e la sua descrizione.

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

Esegui i controlli

Connettiti al nodo che desideri diagnosticare, quindi esegui il run sottocomando come root.

$ sudo pcluster-diag run

pcluster-diagscrive due stream separati:

Sono disponibili le seguenti opzioni.

Interpreta il rapporto

pcluster-diagemette un report JSON che tiene conto di ogni controllo eseguito, indipendentemente dal fatto che il controllo sia stato superato, avvertito, fallito o saltato. contextdescrive il nodo che è stato diagnosticato. La struttura generale del rapporto è la seguente:

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

Stati del controllo

Il risultato status di ogni controllo indica cosa farne.

Se ogni controllo viene riportatoPASSED, pcluster-diag non sono stati riscontrati problemi. Tuttavia, la copertura di non pcluster-diag è completa e aumenterà con ogni versione. Una diagnosi corretta non garantisce che il cluster sia sano.

Controlla i risultati

Il risultato di un controllo può contenere tre tipi di risultati, ciascuno con a code e amessage.

Scarica l'ultima versione di pcluster-diag da GitHub

pcluster-diagè disponibile su tutte le AWS ParallelCluster versioni 3.16.0 e successive e può essere installato anche su versioni precedenti con alcuni passaggi aggiuntivi.

Nuovi controlli e messaggi diagnostici migliorati arrivano nel repository https://github.com/aws/aws-parallelcluster-cookbook aws-parallelcluster-cookbook sul sito web. GitHub Per utilizzare i controlli più recenti senza attendere la versione successiva, segui i passaggi relativi alla tua AWS ParallelCluster versione. AWS ParallelCluster

Versioni 3.16.0 e successive

Nelle AWS ParallelCluster versioni 3.16.0 e successive, il pcluster-diag comando è installato e disponibile su. PATH

Per aggiornare lo strumento dalla develop filiale, esegui quanto segue sul nodo in cui desideri eseguire lo strumento.

$ 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/*'

Verifica che lo strumento sia funzionante:

$ sudo pcluster-diag describe-checks

Per utilizzare una versione diversa da quella suggeritadevelop, sostituisci develop l'URL con il ramo o il tag che desideri, ad esempio un release-* ramo.

Ricorda quanto segue:

Versioni precedenti alla 3.16.0

Nelle AWS ParallelCluster versioni precedenti alla 3.16.0, il pcluster-diag comando non è installato nel nodo.

Per installare lo strumento dalla develop filiale, esegui quanto segue sul nodo in cui desideri eseguire lo strumento.

$ 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/*'

Verifica che lo strumento sia funzionante:

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