ECS : OBS: Comment générer des journaux SupportAssist/TSR via l’interface utilisateur RACADM ou iDRAC
Summary: ECS : Comment utiliser la commande racadm pour générer des journaux SupportAssist. Comment collecter des journaux de rapport de support technique (TSR) à partir de l’interface utilisateur de l’iDRAC. ...
Instructions
Présentation
Modèles matériels ECS - Gen 3 :
- EX300
- Réf. EX500
- Réf. EXF900
- EX3000 (EX3000S, EX3000D)
Modèles matériels ObjectScale - Gen 4 :
- X560
- XF960
- EX5000 (EX5000S, EX5000D)
svc_collect fonctionnalités des profils :
IMPORTANT: À compter de xDoctor 4.8-86 ou version ultérieure, la fonction de collecte des journaux de profil svc_collect peut être exécutée sur n’importe quel ECS. Si xDoctor 4.8-86 ou une version ultérieure n’est pas installé, vous devez utiliser le processus manuel de collecte des journaux. Le journal génère des journaux TSR pour tous les modèles, les journaux du contrôleur PERC/RAID (EX3000), les journaux des conditions générales du contrôleur PERC/RAID (EX3000) et les événements du contrôleur PERC/RAID (EX3000) pour le système ECS PowerEdge série EX. D’autres collectes doivent être effectuées manuellement à partir du serveur PowerEdge, comme demandé par l’équipe PowerEdge.
- Exécutez la commande de collecte de journaux à partir de svc_collect pour le nœud que vous dépannez.
Commande :
# svc_collect start -p ic_poweredge -n r<rack number>n<node number>
Exemple de collecte à partir du nœud 1 du rack 1 :
Remarque : Si vous exécutez la commande sans identifier le nœud, elle s’exécute sur l’ensemble du VDC.
admin@node2:~> svc_collect start -p ic_poweredge -n r1n1 svc_collect v1.3.2 (svc_tools v2.6.0-a3) Started 2022-07-29 21:13:02 ---------------------------------------------------------------------------------------------------------------- Starting data collection for: VDC1 Using collection profile: ic_poweredge Collect only from nodes: 'r1n1' Collect configuration files: True Collect log files: True Collect command outputs: True Log file Start time: 2022-07-29 20:53:02 Log file Stop time: 2022-07-29 21:13:02 Maximum root disk util %: 80 Maximum collect size: 10240MB Collect file name: /tmp/svc_collect-ic_poweredge-VDC1-20220729_211302.zip Creating manifest file /tmp/svc_collect-VDC1-20220729_211302/MANIFEST.INF Collecting node command output from nodes [Gathering Service Tag] [Gathering raid log EX3000 only] [Gathering term log] [Gathering events log] [Generating TSR log] [Gathering TSR log - waiting up to 10 minutes to complete] Exporting TSR: SUCCESS Collecting Fabric and OS logs Getting logs for *.raid.log* on node r1n1 Getting logs for *.term.log* on node r1n1 Getting logs for *.events.log* on node r1n1 Getting logs for *_tsr_report.zip* on node r1n1 Collect saved as file /tmp/svc_collect-ic_poweredge-VDC1-20220729_211302.zip Runtime: 40.0968358517
- Avec un client WinSCP (Secure Copy Protocol) (WinSCP), collectez les .zip générées à partir de la collecte exécutée, puis extrayez les fichiers avec le numéro de série Dell (DST) et les collectes dans le fichier pour examen par l’équipe PowerEdge.
Étapes manuelles (avant xDoctor 4.8-86)
La commande racadm (Remote Access Controller Admin) est un outil de ligne de commande Dell chargé sur tous les nœuds ECS de gamme EX qui permet un accès local (transfert de l’hôte ECS à l’iDRAC) et à distance (interface physique de l’iDRAC) aux ressources de l’Integrated Dell Remote Access Controller (iDRAC).
Les journaux SupportAssist peuvent être générés si vous êtes connecté en local (sur site) ou à distance (SCG ou WebEx) à l’aide de racadm. L’interface utilisateur de l’iDRAC n’est disponible qu’en local car, sur la gamme EX, l’interface physique de l’iDRAC utilise par défaut les adresses IP locales du nœud> 192.168.219.10<.
Comment générer des journaux SupportAssist (SA) sur un système EX300, EX500, X560, EXF900, XF960, EX5000 :
Utilisation de racadm en local pour se connecter à l’iDRAC (hôte ECS opérationnel, ssh sur le nœud cible). Remarque : L’appliance EX3000 utilise une version d’iDRAC différente des modèles ci-dessus. Reportez-vous donc à l’étape suivante de cet article de la base de connaissances :
1. Connectez-vous au nœud cible à l’aide de l’adresse IP NAN.
admin:~> ssh 169.254.1.6
2. Exécutez la commande racadm pour créer la collecte de journaux TSR.
admin:~> sudo -i racadm supportassist collect Job ID = JID_xxxxxx RAC1154: The requested operation is initiated. Run the RACADM jobqueue sub-command, using the job id to check the status of the requested operation.
Si vous rencontrez un message « EULA not accepted » :
admin@node1:~> sudo -i racadm supportassist collect
SRV085: Unable to start the operation because the SupportAssist End User License Agreement (EULA) is not accepted.
Accept the SupportAssist End User License Agreement (EULA) by running racadm supportassist accepteula command.
Une solution de contournement consiste à utiliser les étapes de la section : « Utilisation à distance de RACADM pour se connecter à l’iDRAC (hôte ECS arrêté) », voir ci-dessous.
admin@node2:~> sudo -i racadm -r 192.168.219.101 -u root -p passwd techsupreport collect Security Alert: Certificate is invalid - self signed certificate Continuing execution. Use -S option for racadm to stop execution on certificate-related errors. Job ID = JID_8xxxx RAC1154: The requested operation is initiated. Run the RACADM jobqueue sub-command, using the job id to check the status of the requested operation.
Accédez ensuite à la section « Utilisation de RACADM à distance pour vous connecter à l’iDRAC (hôte ECS arrêté) » pour extraire les journaux.
Si vous rencontrez le message « Une instance de RACADM local est déjà en cours d’exécution » :
admin@node1:~> sudo -i racadm supportassist collect One Instance of Local RACADM is already executing. Exiting the current session.
Consultez ensuite le lien pour plus d’informations : https://www.dell.com/community/Systems-Management-General/RACADM-is-already-executing-message/td-p/4732148
Vous devez effacer le processus racadm en cours d’exécution, puis réexécuter votre racadm.
Notez que personne d’autre n’a besoin d’exécuter racadm à ce moment-là, car vous effaceriez alors le processus racadm.
Le processus racadm peut être bloqué et doit être effacé à l’aide de la commande suivante sur le nœud :
admin@node1:~> sudo rm -rf /var/run/local_racadm.pid
Ensuite, exécutez à nouveau vos commandes racadm.
Les processus racadm bloqués sont plus susceptibles de se produire sur des firmwares iDRAC plus anciens.
Le cas échéant, vérifiez le niveau du firmware iDRAC et conseillez une mise à jour du firmware, le cas échéant.
3. La tâche créée par la demande de collecte doit se terminer avec succès avant de pouvoir être copiée sur le nœud ECS. Exécutez la commande suivante à l’aide de l’ID de tâche fourni à l’étape d’aperçu pour afficher l’état de la tâche.
admin:~> sudo -i racadm jobqueue view -i JID_8xxxxx ---------------------------- JOB ------------------------- [Job ID=JID_8xxxxx] Job Name=SupportAssist Collection Status=Completed Start Time=[Not Applicable] Expiration Time=[Not Applicable] Message=[SRV088: The SupportAssist Collection Operation is completed successfully.] Percent Complete=[100] ----------------------------------------------------------
4. Procurez-vous le numéro de série Dell (DST) du nœud à utiliser à l’étape suivante.
admin:~> sudo -i racadm getsvctag Cxxxxx
5. Copiez le rapport TSR de l’iDRAC vers l’emplacement du répertoire portant le nom <DST#>_tsr_report.zip sur le nœud ECS. L’exportation des journaux est au format .zip par défaut. L’exportation peut prendre quelques minutes.
admin:~> sudo -i racadm supportassist exportlastcollection -f /home/admin/Cxxxxx_tsr_report.zip Support Assist exported successfully. admin:~> ls -alt /home/admin/Cxxxxx_tsr_report.zip -rwxr-xr-x 1 root root 943054 Nov 5 21:07 /home/admin/xxxxx_tsr_report.zip
6. Si nécessaire, à l’aide de SCP ou d’autres outils de transfert, copiez le fichier /home/admin/Bxxxxx_tsr_report.zip vers un emplacement externe.
Utilisation à distance de racadm pour se connecter à l’iDRAC (hôte ECS arrêté) :
1. Connectez-vous à n’importe quel nœud opérationnel dans le rack où résident les nœuds cibles.
admin:~> ssh 169.254.1.1
Remarque : Par défaut, le réseau physique iDRAC n’est accessible qu’à partir d’un autre nœud connecté au même réseau back-end (rack).
2. Exécutez la commande racadm à distance sur l’adresse IP cible 192.168.219.10<node#> à l’aide du mot de passe/connexion root iDRAC pour créer la collection de journaux TSR.
admin:~> sudo -i racadm -r 192.168.219.106 -u root -p passwd techsupreport collect Job ID = JID_4xxxxxx RAC1154: The requested operation is initiated. Run the RACADM jobqueue sub-command, using the job id to check the status of the requested operation.
3. La tâche créée par la demande de collecte doit se terminer avec succès avant de pouvoir être copiée sur le nœud ECS.
Exécutez la commande suivante à l’aide de l’ID de tâche fourni à l’étape d’aperçu pour afficher l’état de la tâche.
admin:~> sudo -i racadm -r 192.168.219.106 -u root -p passwd jobqueue view -i JID_4xxxxxxx ---------------------------- JOB ------------------------- [Job ID=JID_4xxxxxxx] Job Name=TSR_Collect Status=Completed Start Time=[Not Applicable] Expiration Time=[Not Applicable] Message=[SYS018: Job completed successfully.] Percent Complete=[100] ----------------------------------------------------------
4. Procurez-vous le numéro de série Dell (DST) du nœud à utiliser à l’étape suivante.
admin:~> sudo -i racadm -r 192.168.219.106 -u root -p passwd getsvctag CX1TBM2
5. Copiez le rapport TSR de l’iDRAC vers l’emplacement du répertoire portant le nom <DST#>_tsr_report.zip sur le nœud ECS. L’exportation des logs se fait dans .zip format b par défaut. L’exportation peut prendre quelques minutes.
admin:~> sudo -i racadm -r 192.168.219.106 -u root -p passwd techsupreport export -f /home/admin/Cxxxxx_tsr_report.zip Progress = 100 percent Tech Support Report exported successfully. admin:~> ls -alt /home/admin/Cxxxxx_tsr_report.zip -rwxr-xr-x 1 root root 447811 Oct 31 18:42 /home/admin/Cxxxxxx_tsr_report.zip
6. Si nécessaire, à l’aide de SCP ou d’autres outils de transfert, copiez le fichier /home/admin/Cxxxxxx_tsr_report.zip vers un emplacement externe.
7. Pour afficher les informations TSR EX3000 : Une fois transféré vers un ordinateur portable Windows, ouvrez xxx_tsr_report.zip fichier dans Windows, affiche les fichiers, dont l’un sera TSR<Numbers>_DST#<>.pl.zip. Ouvrez ce fichier, ouvrez le répertoire tsr et double-cliquez sur « viewer.html.
Capture des journaux de rapport de support technique (TSR) sur un système EX3000 :
Utilisation de racadm en local pour se connecter à l’iDRAC (hôte ECS opérationnel, ssh sur le nœud cible). Remarque : L’appliance EX3000 utilise une version d’iDRAC différente des modèles ci-dessus, d’où les étapes ci-dessous :
1. Connectez-vous au nœud cible à l’aide de l’adresse IP NAN.
admin:~> ssh 169.254.1.6
2. Exécutez la commande racadm pour créer la collecte de journaux TSR.
admin:~> sudo -i racadm techsupreport collect Job ID = JID_xxxxxx RAC1154: The requested operation is initiated. Run the RACADM jobqueue sub-command, using the job id to check the status of the requested operation.
3. La tâche créée par la demande de collecte doit se terminer avec succès avant de pouvoir être copiée sur le nœud ECS.
Exécutez la commande suivante à l’aide de l’ID de tâche fourni à l’étape d’aperçu pour afficher l’état de la tâche.
admin:~> sudo -i racadm jobqueue view -i JID_xxxxx ---------------------------- JOB ------------------------- [Job ID=JID_xxxxxx] Job Name=TSR_Collect Status=Completed Start Time=[Not Applicable] Expiration Time=[Not Applicable] Message=[SYS018: Job completed successfully.] Percent Complete=[100] ----------------------------------------------------------
4. Procurez-vous le numéro de série Dell (DST) du nœud à utiliser à l’étape suivante.
admin:~> sudo -i racadm getsvctag xxxxxx
5. Copiez le rapport TSR de l’iDRAC vers l’emplacement du répertoire portant le nom <DST#>_tsr_report.zip sur le nœud ECS. L’exportation des logs se fait dans .zip format b par défaut. L’exportation peut prendre quelques minutes.
admin:~> sudo -i racadm techsupreport export -f /home/admin/xxxxxx_tsr_report.zip Tech Support Report exported successfully. admin:~> ls -alt /home/admin/xxxxxxx_tsr_report.zip -rwxr-xr-x 1 root root 447811 Oct 31 18:42 /home/admin/xxxxxx_tsr_report.zip
6. Si nécessaire, à l’aide de SCP ou d’autres outils de transfert, copiez le fichier /home/admin/xxxxxxx_tsr_report.zip vers un emplacement externe.
7. Pour afficher les informations TSR EX3000 : Une fois le transfert effectué sur un ordinateur portable Windows, ouvrez xxx_tsr_report.zip fichier dans Windows, qui affiche les fichiers, dont l’un sera TSR<Numbers>_DST#<>.pl.zip. Ouvrez ce fichier, ouvrez le répertoire tsr et double-cliquez sur « viewer.html.
Note: S’il s’agit d’un problème lié au disque sur un système EX3000, une demande de journaux megacli est demandée. Suivez cette base de connaissances pour collecter ces informations : KB ECS : EX3000 : Collecte des journaux du contrôleur RAID
Utilisation à distance de racadm pour se connecter à l’iDRAC (hôte ECS arrêté) :
1. Connectez-vous à n’importe quel nœud opérationnel dans le rack où résident les nœuds cibles.
admin:~> ssh 169.254.1.1
Remarque : Par défaut, le réseau physique iDRAC n’est accessible qu’à partir d’un autre nœud connecté au même réseau back-end (rack).
2. Exécutez la commande racadm à distance sur l’adresse IP cible 192.168.219.10<node#> à l’aide du mot de passe/connexion root iDRAC pour créer la collection de journaux TSR.
admin:~> sudo -i racadm -r 192.168.219.106 -u root -p passwd techsupreport collect Job ID = JID_xxxxx RAC1154: The requested operation is initiated. Run the RACADM jobqueue sub-command, using the job id to check the status of the requested operation.
3. La tâche créée par la demande de collecte doit se terminer avec succès avant de pouvoir être copiée sur le nœud ECS.
Exécutez la commande suivante à l’aide de l’ID de tâche fourni à l’étape d’aperçu pour afficher l’état de la tâche.
admin:~>sudo -i racadm -r 192.168.219.106 -u root -p passwd jobqueue view -i JID_xxxxx ---------------------------- JOB ------------------------- [Job ID=JID_xxxxxx] Job Name=TSR_Collect Status=Completed Start Time=[Not Applicable] Expiration Time=[Not Applicable] Message=[SYS018: Job completed successfully.] Percent Complete=[100] ----------------------------------------------------------
4. Procurez-vous le numéro de série Dell (DST) du nœud à utiliser à l’étape suivante.
admin:~> sudo -i racadm -r 192.168.219.106 -u root -p passwd getsvctag xxxxxx
5. Copiez le rapport TSR de l’iDRAC vers l’emplacement du répertoire portant le nom <DST#>_tsr_report.zip sur le nœud ECS. L’exportation des logs se fait dans .zip format b par défaut. L’exportation peut prendre quelques minutes.
admin:~> sudo -i racadm -r 192.168.219.106 -u root techsupreport export -f /home/admin/xxxxxx_tsr_report.zip Progress = 100 percent Tech Support Report exported successfully. admin:~> ls -alt /home/admin/xxxxxxx_tsr_report.zip -rwxr-xr-x 1 root root 447811 Oct 31 18:42 /home/admin/xxxxxxx_tsr_report.zip
6. Si nécessaire, à l’aide de SCP ou d’autres outils de transfert, copiez le fichier /home/admin/xxxxxx_tsr_report.zip vers un emplacement externe.
7. Pour afficher les informations TSR EX3000 : Une fois le transfert effectué sur un ordinateur portable Windows, ouvrez xxx_tsr_report.zip fichier dans Windows, qui affiche les fichiers, dont l’un sera TSR<Numbers>_DST#<>.pl.zip. Ouvrez ce fichier, ouvrez le répertoire tsr et double-cliquez sur « viewer.html.