Як збирати інформацію і створювати файли технічної підтримки в DELL Networking SONiC
Summary: У цій статті пояснюється, як створювати й збирати інформацію про технічну підтримку в Dell Networking SONiC версії 4.0 і новішої.
Instructions
Індекс
Що таке файл технічної підтримки?
Синтаксис команд
Як створити файл технічної підтримки в Dell SONiC
Як відстежувати стан створення файлу технічної підтримки
Як отримати файл технічної підтримки з комутатора
FTP
HTTP
USB
Програма SCP-клієнта
Ім’я та формат файлу технічної підтримки
Як обмежити старі записи й зменшити розмір файлу технічної підтримки
Видалення старого файлу технічної підтримки для заощадження місця.
Що таке файл технічної підтримки
Файл технічної підтримки – це стислий архівний файл, що містить інформацію про стан комутатора, наприклад Syslog, стан бази даних, дамп ядра тощо. Він потрібен агентам технічної підтримки Dell для детального аналізу події.
- Файл технічної підтримки є стисненим файлом і зберігається в папці /var/dump. Вміст цієї папки можна переглянути за допомогою команди:
dir tech-support:/
- Файл технічної підтримки має розширення «.tar.gz»
- Процес створення файлу технічної підтримки може зайняти понад 15–30 хвилин.
- Розмір файлу залежить від кількості даних і тривалості журналів вибірки. Щоб зменшити розмір, можна скористатися параметром «since» (з якого часу)
- Якщо можливо, спробуйте створити файл технічної підтримки в стані проблеми
Синтаксис команд
| КОМАНДА | ПОЯСНЕННЯ |
|---|---|
admin@sonic:~$ sonic-cli |
Увійдіть у Dell Sonic |
sonic# show tech-support |
Створіть файл технічної підтримки. |
sonic# show tech-support status |
Показати стан процесу створення файлу технічної підтримки |
sonic# dir tech-support:/ |
Показати вміст каталогу /var/dump, у якому створено файл технічної підтримки. |
sonic# copy tech-support://<filename> ftp/home/http/scp/usb://<filename> |
Скопіюйте файл технічної підтримки у віддалене місце, використовуючи протокол ftp, http, scp, або на USB-накопичувач чи в домашній каталог |
Необов’язково
| КОМАНДА | ПОЯСНЕННЯ |
|---|---|
sonic# show tech-support since <date/time> |
Створіть файл технічної підтримки за датою та часом. Клацніть тут, щоб отримати додаткові відомості. |
sonic# delete tech-support:/ <filename> |
Видаліть старий файл технічної підтримки. Це зекономить місце на накопичувачі. |
Як створити файл технічної підтримки в 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
Синтаксис команд
| Команда | Пояснення |
|---|---|
sonic# show tech-support since <date/time> |
Нижче наведено приклади формату дати / часу. «YYYY-MM-DDTHH:MM:SS[.ddd…]Z» або «YYYY-MM-DDTHH:MM:SS[.ddd…]+hh:mm» або «YYYY-MM-DDTHH:MM:SS[.ddd…]-hh:mm», де: YYYY = рік, MM = місяць, DD = день, T (потрібно достроково), HH = години, MM = хвилини, SS = секунди, (додатково) .ddd… = десяткова частка секунди (наприклад «.323») Z указує на нульовий зсув відносно місцевого часу. +/- hh:mm указує на зміщення годин:хвилин відносно місцевого часу. |
Видалення старого файлу технічної підтримки для заощадження місця
Файл технічної підтримки в папці кошика можна видалити після вилучення файлу з комутатора.
Для видалення файлу технічної підтримки використовуйте команду «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 -------------------------------------------------------------------------