Як збирати інформацію і створювати файли технічної підтримки в DELL Networking SONiC

Індекс

Що таке файл технічної підтримки?
Синтаксис команд
Як створити файл технічної підтримки в Dell SONiC
Як відстежувати стан створення файлу технічної підтримки
Як отримати файл технічної підтримки з комутатора
      FTP
      HTTP
      USB
      Програма SCP-клієнта
Ім’я та формат файлу технічної підтримки
Як обмежити старі записи й зменшити розмір файлу технічної підтримки
Видалення старого файлу технічної підтримки для заощадження місця.

Що таке файл технічної підтримки

Файл технічної підтримки – це стислий архівний файл, що містить інформацію про стан комутатора, наприклад Syslog, стан бази даних, дамп ядра тощо. Він потрібен агентам технічної підтримки Dell для детального аналізу події.

• Файл технічної підтримки є стисненим файлом і зберігається в папці /var/dump. Вміст цієї папки можна переглянути за допомогою команди:

  dir tech-support:/

• Файл технічної підтримки має розширення «.tar.gz»
• Процес створення файлу технічної підтримки може зайняти понад 15–30 хвилин.
• Розмір файлу залежить від кількості даних і тривалості журналів вибірки. Щоб зменшити розмір, можна скористатися параметром «since» (з якого часу)
• Якщо можливо, спробуйте створити файл технічної підтримки в стані проблеми

Синтаксис команд

Необов’язково

Як створити файл технічної підтримки в Dell SONiC

Створіть файл технічної підтримки, використовуючи команду «show tech-support».

Приклад

admin@DELLSONiC:~$ sonic-cli
DELLSONiC# 
DELLSONiC# show tech-support 
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress
DELLSONiC#

Як відстежувати стан процесу створення файлу технічної підтримки

Щоб зібрати інформацію про стан процесу створення файлу технічної підтримки, використовуйте команду «show tech-support status». На виході з’явиться повідомлення Status: Completed (Стан: завершено), коли процес створення файлу буде завершено.
Використовуйте команду «dir tech-support:/», щоб переглянути вміст папки /var/tmp. У цій папці створюється файл технічної підтримки.

Нижче наведено приклад виходу «show tech-support status» і «dir tech-support:/»

Під час створення файлу технічної підтримки:

DELLSONiC# show tech-support status 
Status: In Progress (Collecting Counters-1) Total items collected: 12

DELLSONiC# dir tech-support:/
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:21         4096           d         sonic_dump_DELLSONiC_20230415_202048
2023-04-15 20:22         11100160       -         sonic_dump_DELLSONiC_20230415_202048.tar

Після успішного створення файлу технічної підтримки.

DELLSONiC# show tech-support status
Status: Completed
File Name: /var/dump/sonic_dump_DELLSONiC_20230415_202048.tar.gz

DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:27         252932846      -         sonic_dump_DELLSONiC_20230415_202048.tar.gz

Як отримати файл технічної підтримки з комутатора

Використовуйте команду «copy tech-support://<tech-support filename><destination><filename>», щоб скопіювати файл технічної підтримки в домашній каталог, на USB-накопичувач або віддалений сервер ftp/http/scp.

Нижче наведено доступні варіанти місця призначення та їх використання.

• ftp: Копіювання на віддалений FTP-сервер (ftp://userid:passwd@hostip/filepath)
• домашній каталог: Копіювання в домашній каталог (home://filename)
• http: Копіювання на віддалений HTTP-сервер (http://hostip/filepath)
• scp: Копіювання на віддалений SCP-сервер (scp://userid:passwd@hostip/filepath)
• usb: Копіювання в каталог на USB-накопичувачі (usb://filename)

Ці варіанти пояснюються далі на прикладах.

FTP
Для копіювання файлу на віддалений FTP-сервер використовуйте наведений далі синтаксис.

copy techsupport://<techsupport file.tag.gz> ftp://userid:passwd@hostip/filepath

Наприклад, нам потрібно скопіювати файл технічної підтримки на віддалений FTP-сервер з IP 10.0.0.1, ім’ям користувача: TEST і паролем PASS

Вибірка

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz ftp://TEST:PASS@10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

HTTP
Для копіювання файлу на віддалений HTTP-сервер використовуйте наведений далі синтаксис.

copy techsupport://<techsupport file.tag.gz> http://hostip/filepath

Наприклад, нам потрібно скопіювати файл технічної підтримки на віддалений HTTP-сервер з IP 10.0.0.1.

Вибірка

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz http://10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

USB
Для використання USB-накопичувача на DELL SONiC у мережевому комутаторі потрібно переконатися, що команду активації USB налаштовано. За замовчуванням USB вимкнено.
Вставте USB-накопичувач у комутатор і виконайте команду встановлення USB.

Як встановлювати й видаляти USB-накопичувач у Dell Networking SONiC

Вибірка

sonic#
sonic# configure terminal
sonic(config)# usb enable
sonic(config)# exit
sonic# usb mount
DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz usb://sonic_dump_DELLSONiC_20230415_202048.tar.gz

програма SCP-клієнта
Ви можете використовувати будь-які програми SCP-клієнтів для вилучення файлу технічної підтримки в комутаторі.
Використовуйте облікові дані для входу в комутатор у програмі SCP-клієнта, щоб увійти в систему комутатора. Файл технічної підтримки знаходиться в каталозі /var/dump/.
Деякі програми SCP-клієнтів мають графічний інтерфейс, що спрощує процес копіювання файлу з каталогу /var/dump/ комутатора на локальний комп’ютер.

Ім’я та формат файлу технічної підтримки

Ім’я файлу технічної підтримки має формат «sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz»
*YYYYMMDD_HHMMSS – це рік, місяць, день_години, хвилини, секунди. Це час створення файлу технічної підтримки.

Наприклад, «sonic_dump_DELLSONiC_20230415_202048.tar.gz» – це ім’я створеного файлу технічної підтримки. Тут YYYYMMDD_HHMMSS – це 20230415_202048, а DELLSONiC – це ім’я хоста комутатора.

Як обмежити старі записи й зменшити розмір файлу технічної підтримки

Залежно від часу безперервної роботи комутатора файл технічної підтримки може мати великі розміри. У Dell SONiC можна зменшити розмір файлу, обмеживши тривалість часу реєстрації.

Використовуйте команду «show tech-support since <date/time>», щоб записати інформацію про технічну підтримку за певний час.

Вибірка

DELLSONiC# show tech-support since "2023-04-14T12:30:30Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

Радимо збирати дані аж до півночі попереднього дня, щоб мати змогу вжити будь-яких превентивних заходів перед подією.

Вибірка

DELLSONiC# show tech-support since "2023-04-14T00:00:00Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

Синтаксис команд

Видалення старого файлу технічної підтримки для заощадження місця

Файл технічної підтримки в папці кошика можна видалити після вилучення файлу з комутатора.

Для видалення файлу технічної підтримки використовуйте команду «delete tech-support:/ <techsupport file.tar.gz>».

Вибірка

DELLSONiC# delete tech-support:/ sonic_dump_DELLSONiC_20230415_202048.tar.gz
Proceed to delete tech-support:/sonic_dump_DELLSONiC_20230415_202048.tar.gz? [y/N]:y

Щоб перевірити, чи файл видалено, використовуйте команду «dir tech-support:/».

Вибірка

DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------