Dell Networking SONiC OS: як генерувати Tech-підтримку в релізах 3.X

Зміст

• Що таке файл технічної підтримки?
• Як згенерувати файл техпідтримки
• Місцезнаходження файлу техпідтримки
• Як отримати файл техпідтримки з комутатора
  • Роз'єм
  • Віддалений сервер SCP
  • Додаток SCP-клієнта
• Формат імен файлів Tech-support
• Як обмежити старі записи та зменшити розмір файлу техпідтримки
• Видаліть старий файл технічної підтримки, щоб заощадити місце

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

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

• Спробуйте згенерувати файл техпідтримки в проблемному стані
• Файл технічної підтримки є стисненим файлом і зберігається в /var/dump
• Файл техпідтримки має розширення ".tar.gz"
• Генерація файлів технічної підтримки може зайняти більше 15-30 хвилин залежно від тривалості журналу

Як згенерувати файл техпідтримки

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

Приклад виводу

admin@DELLSONiC:~$ sonic-cli
DELLSONiC#
DELLSONiC# show tech-support
Output stored in:  /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz
DELLSONiC#

Перейдіть до інтерфейсу командного рядка Dell SONiC, щоб перевірити створений файл технічної підтримки та видалити старі файли технічної підтримки.

DELLSONiC#
DELLSONiC# exit
admin@DELLSONiC:~$

Місцезнаходження файлу техпідтримки

Файл технічної підтримки зберігається в /var/dump.

admin@DELLSONiC:~$ dir /var/dump/
sonic_dump_DELLSONiC_20230419_043803.tar.gz
admin@DELLSONiC:~$ 

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

Ви можете скопіювати файл технічної підтримки на віддалений сервер SFTP/SCP, будь-яку програму SCP, наприклад WINSCP, або USB, вставлену в комутатор. Нижче ми згадаємо три методи.

Роз'єм
Використовуйте USB з форматом FAT32.
Приклад виводу

admin@DELLSONiC:~$sudo mkdir /mnt/usb
admin@DELLSONiC:~$sudo mount /dev/sdb1 /mnt/usb
admin@DELLSONiC:~$sudo cp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz /mnt/usb/sonic_dump_DELLSONiC_20230419_043803.tar.gz

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

Віддалений сервер
SCPДля копіювання на віддалений сервер SCP використовуйте наступний синтаксис:

scp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz username@<Ip address or hostname of scp server>:/<path>

admin@DELLSONiC:~$ scp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz username@10.0.0.1:/home/admin/                       
username@10.0.0.1's password:

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

Формат імен файлів Tech-support

Файл техпідтримки має назву у форматі.

sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz

Наприклад, sonic_dump_DELLSONiC_20230419_043803.tar.gz — це згенерований файл технічної підтримки, де YYYYMMDD_HHMMSS — 20230419_043803, а DELLSONiC — ім'я хоста комутатора.

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

Залежно від часу безперервної роботи комутатора файл технічної підтримки може мати великі розміри. Ми можемо зменшити розмір техпідтримки, зменшивши кількість Syslog, використовуючи опцію since .

show tech-support since <date/time>

Формат дати і часу
" РРРР-ММ-ДДТГГ:ХХ:СС[.ddd...]Z" або
"РРРР-ММ-ДДТГГ:ХХ:СС[.ddd...]+гг:хх" або
"РРРР-ММ-ДДТГГ:ХХ:СС[.ddd...]-гг:хх" Де:

РРРР = рік, ММ = місяць, ДД = день,
Т (потрібно до часу),
ГГ = години, ММ = хвилини, СС = секунди,
(необов'язково) .ддд... = десяткова частка секунди (наприклад, ".323")
Z вказує на нульове зміщення від місцевого часу.
+/- гг:мм вказує на зміщення години:хвилини від місцевого часу.

Наприклад

DELLSONiC# show tech-support since "2023-04-18T19:31:00Z"
Output stored in: /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz

Рекомендується зафіксувати до 0 годин дня перед будь-якими можливими превентивними діями до події.

DELLSONiC# show tech-support since "2023-04-18T00:00:00Z"

Видаліть старий файл технічної підтримки, щоб заощадити місце

Ми можемо безпечно видалити файл техпідтримки або папку дампа після вилучення файлу з комутатора. Якщо необхідно згенерувати новий файл техпідтримки, у var створюється нова папка дампа.

Щоб видалити конкретний файл, виконайте такі дії:

sudo rm /var/dump/<techsupportfile>.tar.gz

Приклад виводу

admin@DELLSONiC:~$ ^C
admin@DELLSONiC:~$ sudo rm -r /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz
admin@DELLSONiC:~$

Щоб видалити папку /var/dump:

sudo rm -r /var/dump

Приклад виводу

admin@DELLSONiC:~$ sudo rm -r /var/dump
admin@DELLSONiC:~$

Checking
admin@DELLSONiC:~$ ls /var/dump
ls: cannot access '/var/dump': No such file or directory
admin@DELLSONiC:~$