Comment générer et collecter des bundles de support dans les commutateurs DELL EMC Networking OS10

Sommaire :

Qu’est-ce qu’un bundle de support ?
Comment générer un bundle de support
Où le bundle de support est-il stocké ?
Comment vérifier que la génération du bundle de support a commencé
Comment vérifier que la génération du bundle de support est terminée
Comment récupérer le bundle de support à partir du commutateur
Supprimer un bundle de support existant

Qu’est-ce qu’un bundle de support ?

Le bundle de support est basé sur l’outil sosreport. Il génère un fichier tar qui inclut la configuration du système Linux et les informations de diagnostic, ainsi que des sorties de commandes show. Les agents du support technique Dell ont besoin d’un bundle de support pour une analyse détaillée.

Comment générer un bundle de support

Exécutez la commande suivante en mode EXEC :

• Utilisez la commande suivante pour OS10 version 10.5.2.0 et versions ultérieures :

  OS10# generate support-bundle

• Pour toute version d’OS10 antérieure à la version 10.5.2.0, utilisez la commande suivante :

  OS10# generate support-bundle enable-all-plugin-options

N’essayez pas de générer un autre bundle de support si vous n’avez pas constaté que le bundle était généré immédiatement après l’exécution de la commande. La génération d’un bundle de support prend un certain temps (parfois supérieur à 15 minutes).

Où le bundle de support est-il stocké ?

Le bundle de support est stocké dans le répertoire supportbundle. Pour afficher le contenu, utilisez la commande suivante :

OS10# dir supportbundle

Exemple de résultat :

OS10# dir supportbundle
Directory contents for folder: supportbundle
Date (modified)        Size (bytes)  Name
---------------------  ------------  ------------------------------------------
2020-01-12T19:34:21Z   8070044       sosreport-OS10-20200112193142.tar.xz
2020-01-12T19:34:27Z   33            sosreport-OS10-20200112193142.tar.xz.md5

Comment vérifier que la génération du bundle de support a commencé

Lors de la génération du bundle de support, un fichier aléatoire est généré dans le répertoire supportbundle. Vous devez attendre que le processus de génération soit terminé.

Exemple de sortie

OS10# dir supportbundle
Directory contents for folder: supportbundle
Date (modified)        Size (bytes)  Name
---------------------  ------------  ------------------------------------------
2020-01-13T09:17:12Z   3932160       _proc_sys.tar     <<<This is not the complete file. This files size increases during support bundle generation.

Journalisation
Le démarrage de la génération du bundle de support est journalisé.

Exemple de sortie

OS10# show logging log-file | grep "SUPPORT_BUNDLE_STARTED"
<165>1 2020-01-12T19:31:11.808623+00:00 OS10 dn_svc_sw 832 - - Node.1-Unit.1:PRI [event], Dell EMC (OS10) %SUPPORT_BUNDLE_STARTED: generate support-bundle execution has started successfully:All Plugin options enabled

Comment vérifier que la génération du bundle de support est terminée

Après la génération du bundle de support, deux fichiers sont présents dans le répertoire du bundle de support : l’un est le fichier du bundle de support et l’autre est un fichier avec une extension md5. Le fichier md5 est un fichier de somme de contrôle utilisé pour vérifier l’intégrité du fichier de bundle. Envoyez les deux fichiers au support technique.

Exemple de sortie

OS10# dir supportbundle
Directory contents for folder: supportbundle
Date (modified)        Size (bytes)  Name
---------------------  ------------  ------------------------------------------
2020-01-12T19:34:21Z   8070044       sosreport-OS10-20200112193142.tar.xz     <<<Support bundle file
2020-01-12T19:34:27Z   33            sosreport-OS10-20200112193142.tar.xz.md5     <<<Md5 checksum file

Dans l’exemple ci-dessus, sosreport-OS10-20200112193142.tar.xz est le fichier du bundle de support et sosreport-OS10-20200112193142.tar.xz.md5 est son fichier de somme de contrôle md5.

Journalisation
La fin de la génération du bundle de support est journalisée.

Exemple de sortie

OS10# show logging log-file | grep "BUNDLE_COMPLETED"
<165>1 2020-01-12T19:34:27.831211+00:00 OS10 dn_svc_sw 832 - - Node.1-Unit.1:PRI [event], Dell EMC (OS10) %SUPPORT_BUNDLE_COMPLETED: generate support-bundle execution has completed successfully:All Plugin options enabled

Comment récupérer le bundle de support à partir du commutateur

Vous pouvez utiliser ftp, http, https, scp, sftp, tftp, ou usb pour collecter le bundle de support, ou system bash pour copier le bundle de support avec scp vers un nœud local dans le rack afin de le télécharger via WinSCP.

Utilisez la commande suivante à partir de l’invite du commutateur :

OS10# copy supportbundle://sosreport-OS10- file-number.tar.xz XXXX://server-address/path commands

Où XXXX = ftp, http, https, scp, sftp ou tftp. Si vous utilisez un port USB, formatez-le au format FAT32.

Exemple de sortie

OS10#copy supportbundle://sosreport-OS10-20200112193142.tar.xz tftp://10.0.0.0.1/sosreport-OS10-20200112193142.tar.xz

Utilisez les commandes suivantes pour system bash :

• system bash

• ls -ltrh /var/opt/dell/os10/support_bundle/bundle/

• sudo scp /var/opt/dell/os10/support_bundle/bundle/sosreport* <user>@<node IP>:/target/dir

  • Saisissez ensuite les mots de passe adéquats lorsque vous y êtes invité.

Exemple de sortie

OS10# system bash
admin@OS10:~$ ls -ltrh /var/opt/dell/os10/support_bundle/bundle/
total 12M
-rw------- 1 root root 12M Nov  6 19:47 sosreport-os10-20241106194507.tar.xz
-rw-r--r-- 1 root root  33 Nov  6 19:47 sosreport-os10-20241106194507.tar.xz.md5
admin@OS10:~$ sudo scp /var/opt/dell/os10/support_bundle/bundle/sosreport* admin@192.168.219.5:/home/admin
[sudo] password for admin:
The authenticity of host '192.168.219.5 (192.168.219.5)' can't be established.
ED25519 key fingerprint is SHA256:SObGGFqgOZ4nY8np1sYvobZAHw2F96Goi7rdzHS+jQU.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.219.5' (ED25519) to the list of known hosts.
Password:
sosreport-os10-20241106194507.tar.xz                                                                                                      100%   12MB   1.6MB/s   00:07
sosreport-os10-20241106194507.tar.xz.md5                                                                                                  100%   33     4.1KB/s   00:00

Supprimer un bundle de support existant

Le bundle de support peut consommer une partie de l’espace de stockage de votre commutateur. Par conséquent, après avoir récupéré le bundle, vous pouvez le supprimer. Utilisez la commande suivante :

OS10# delete supportbundle://sosreport- filename.tar.extention

Exemple de sortie

OS10#delete supportbundle://sosreport-OS10-20200112193142.tar.xz