DELL Networking SONiC: как создать и собрать файл технической поддержки

Summary: В этой статье объясняется, как создать и собрать файл технической поддержки в Dell Networking SONiC версии 4.0 и более поздних версий.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Указатель

Что такое файл технической поддержки?
Синтаксис команд
Как создать файл технической поддержки в Dell SONiC
Как отслеживать состояние создания файла технической поддержки
Как извлечь файл технической поддержки из коммутатора
      FTP
      HTTP
      USB
      Клиентское приложение SCP
Имя и формат файла технической поддержки
Как ограничить доступ к старым записям и уменьшить размер файла технической поддержки
Удаление старого файла технической поддержки для экономии пространства.

Что такое файл технической поддержки

Файл технической поддержки — это сжатый архивный файл, содержащий информацию о состоянии коммутатора, такую как syslog, состояние базы данных, дамп ядра и т. д. Файл технической поддержки требуется специалистам службы технической поддержки Dell для подробного анализа того или иного события.

  • Файл технической поддержки является сжатым файлом и сохраняется в /var/dump. Содержимое этой папки можно просмотреть с помощью команды: 
    dir tech-support:/
  • Файл технической поддержки имеет расширение .tar.gz
  • Создание файла технической поддержки может занять более 15–30 минут.
  • Размер файла зависит от данных и продолжительности выборки журналов. Чтобы уменьшить размер, можно использовать параметр «since»
  • По возможности попробуйте создать файл технической поддержки в проблемном состоянии
ПРИМЕЧАНИЕ. Более раннюю версию см. в документе Dell Networking SONiC OS: как создать файл технической поддержки в выпусках 3.X

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

КОМАНДА ПОЯСНЕНИЕ
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

Как извлечь файл технической поддержки с коммутатора

Для копирования файла технической поддержки в домашний каталог или на USB либо удаленный сервер FTP/HTTP/SCP используйте команду copy tech-support://<tech-support filename> <destination>//<filename>».

Ниже приведены доступные параметры места назначения и информация об их использовании.

  • ftp: Копирование на удаленный FTP-сервер (ftp://userid:passwd@hostip/filepath)
  • home: Копирование в исходный каталог (home://filename)
  • http: Копирование на удаленный сервер HTTP (http://hostip/filepath)
  • scp: Копирование на удаленный сервер SCP (scp://userid:passwd@hostip/filepath)
  • usb: Копирование в каталог usb-носителя (usb://filename)
ПРИМЕЧАНИЕ. Параметр «tech-support://» В команде «copy» не заполняется автоматически. Поэтому введите полный путь вручную.

Далее мы объясним предложенные варианты с помощью примеров.

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

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

Предположим, что мы копируем файл технической поддержки на удаленный FTP-сервер с IP-адресом 10.0.0.1, имя пользователя: ТЕСТ; пароль: 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 на коммутаторе Networking необходимо убедиться, что настроена команда включения USB. По умолчанию USB отключен.
Выполните команду usb mount после подключения USB к коммутатору.

Dell Networking SONiC: как подключить и отключить USB

Пример выходных данных

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_<Имя хоста>_ _YYYYMMDD_HHMMSS.tar.gz»
* «YYYYMMDD_HHMMSS» означает «Год, месяц, день_час, минута, секунда». Сейчас происходит генерация файла технической поддержки.

Например, «sonic_dump_DELLSONiC_20230415_202048.tar.gz» — созданный файл технической поддержки. В этом случае YYYYMMDD_HHMMSS имеет значение 20230415_20:20:48, а 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                        
-------------------------------------------------------------------------

 

Affected Products

Enterprise SONiC Distribution, PowerSwitch E3200-ON Series, Dell EMC Networking N3200-ON, PowerSwitch S5212F-ON, PowerSwitch S5224F-ON, PowerSwitch S5232F-ON, PowerSwitch S5248F-ON, PowerSwitch S5296F-ON, PowerSwitch Z9100-ON, PowerSwitch Z9264F-ON , PowerSwitch Z9332F-ON, PowerSwitch Z9432F-ON ...
Article Properties
Article Number: 000212428
Article Type: How To
Last Modified: 25 Feb 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.