Утилита IPMICFG: полный справочник команд с указанием поддержки в DOS и UEFI
IPMICFG — официальная утилита Supermicro для настройки и управления IPMI-устройствами (BMC) из командной строки, работающая непосредственно на сервере (in-band). Она незаменима при первичной настройке, сбросе забытого пароля, обновлении прошивки или диагностике, когда веб-интерфейс недоступен. Утилита поддерживает среды DOS, UEFI Shell, Linux и Windows. В этом справочнике приведены все доступные команды с указанием поддержки в DOS и UEFI — двух самых распространённых «голых» сред, используемых при восстановлении серверов.
Важно: Синтаксис команд одинаков для всех версий утилиты. Отличаются только имена исполняемых файлов:
— DOS:
— UEFI:
— Linux:
— Windows:
В таблицах ниже для краткости указано просто
— DOS:
IPMICFG.exe— UEFI:
ipmicfg.efi— Linux:
./ipmicfg-Linux.x86_64— Windows:
ipmicfg-win.exeВ таблицах ниже для краткости указано просто
ipmicfg.
1. Общие команды и справка
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -help | Да | Да | Вывод полного списка команд с кратким описанием. |
| ipmicfg -ver | Да | Да | Отображение версии утилиты IPMICFG и версии |
| | | | прошивки BMC. |
| ipmicfg -ver bmc | Да | Да | Показать только версию прошивки BMC. |
| ipmicfg -ver smc | Да | Да | Показать версию OEM-расширений Supermicro. |
| ipmicfg -license | Да | Да | Отобразить информацию о лицензии IPMI (SFT, KVM).|
| ipmicfg -check | Да | Да | Проверка связи с BMC и его статуса (жив ли BMC). |
+----------------------+--------+--------+--------------------------------------------------+2. Конфигурация сети (IP, MAC, VLAN, DHCP)
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -m | Да | Да | Показать текущий IPv4-адрес и MAC-адрес BMC. |
| ipmicfg -m <IP> | Да | Да | Установить статический IPv4-адрес BMC. |
| ipmicfg -a <MAC> | Да | Да | Установить MAC-адрес BMC (осторожно!). |
| ipmicfg -k | Да | Да | Показать текущую маску подсети. |
| ipmicfg -k <mask> | Да | Да | Установить маску подсети. |
| ipmicfg -g | Да | Да | Показать IP-адрес шлюза по умолчанию. |
| ipmicfg -g <GW> | Да | Да | Установить IP-адрес шлюза. |
| ipmicfg -dhcp | Да | Да | Показать статус DHCP (включен/отключен). |
| ipmicfg -dhcp on | Да | Да | Включить DHCP (адрес будет получен автоматически).|
| ipmicfg -dhcp off | Да | Да | Отключить DHCP (ручная настройка статического IP).|
| ipmicfg -dhcp6 | Нет | Да | Показать статус DHCPv6 (для IPv6). |
| ipmicfg -dhcp6 on | Нет | Да | Включить DHCPv6. |
| ipmicfg -dhcp6 off | Нет | Да | Отключить DHCPv6. |
| ipmicfg -vlan | Да | Да | Показать текущий статус VLAN. |
| ipmicfg -vlan on <tag>| Да | Да | Включить VLAN с указанным тегом (1-4094). |
| ipmicfg -vlan off | Да | Да | Отключить VLAN. |
| ipmicfg -l | Да | Нет | Показать режим Failover (Dedicated/Shared). |
| ipmicfg -l <mode> | Да | Нет | Установить режим Failover: 0 — Dedicated, 1 — |
| | | | Shared, 2 — Failover (для старых плат). |
| ipmicfg -garp on/off | Да | Да | Включить/отключить Gratuitous ARP (GARP). |
+----------------------+--------+--------+--------------------------------------------------+3. Управление пользователями и безопасность
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -user list | Да | Да | Список всех пользователей IPMI с их правами. |
| ipmicfg -user info <ID> | Да | Да | Детальная информация о пользователе по его ID. |
| ipmicfg -user add <name> | Да | Да | Создать нового пользователя с правами по умолчанию|
| ipmicfg -user add <ID> | Да | Да | Создать пользователя с указанным ID (обычно |
| <name> <pwd> | | | используется ID 2-15, ID=1 зарезервирован). |
| ipmicfg -user del <ID> | Да | Да | Удалить пользователя по его ID. |
| ipmicfg -user setpwd <ID> | Да | Да | Установить/изменить пароль для пользователя ID. |
| <password> | | | |
| ipmicfg -user level | Да | Да | Показать уровень привилегий пользователя. |
| ipmicfg -user level <ID> | Да | Да | Назначить уровень прав (1 — Callback, 2 — User, |
| <level> | | | 3 — Operator, 4 — Administrator). |
| ipmicfg -user enable <ID> | Да | Да | Включить пользователя (активировать учётную |
| | | | запись). |
| ipmicfg -user disable <ID> | Да | Да | Отключить пользователя (заблокировать доступ). |
| ipmicfg -user export <file>| Да | Да | Экспорт списка пользователей в файл. |
| ipmicfg -user import <file>| Да | Да | Восстановить список пользователей из файла. |
| ipmicfg -lockdown on/off | Да | Да | Включить/отключить режим Lockdown (запрет |
| | | | изменения настроек). |
| ipmicfg -commit | Да | Да | Сохранить изменения в энергонезависимую память |
| | | | (для некоторых версий требуется после -user). |
| ipmicfg -encryption off/1/2/3| Да | Да | Настройка уровня шифрования для IPMI-сессии. |
+----------------------+--------+--------+--------------------------------------------------+4. Управление системными событиями (SEL) и сенсорами (SDR)
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -sel info | Да | Да | Общая информация о журнале SEL (количество |
| | | | записей, версия, статус). |
| ipmicfg -sel list | Да | Да | Вывести все записи SEL (системный журнал |
| | | | событий: перегрев, отказ вентиляторов, |
| | | | ECC-ошибки и т.д.). |
| ipmicfg -sel list <N>| Да | Да | Вывести последние N записей SEL (например, |
| | | | -sel list 50). |
| ipmicfg -sel del | Да | Да | Удалить все записи SEL (очистить журнал). |
| ipmicfg -sel del <ID>| Да | Да | Удалить одну запись SEL по её ID. |
| ipmicfg -sel raw | Да | Да | Вывести SEL в сыром (HEX) виде для анализа. |
| ipmicfg -sdr | Да | Да | Показать все SDR-записи и текущие показания |
| | | | датчиков (температуры, напряжения, обороты |
| | | | вентиляторов). |
| ipmicfg -sdr <ID> | Да | Да | Показать показания конкретного датчика по его ID.|
| ipmicfg -sdr del <ID>| Да | Да | Удалить SDR-запись (не рекомендуется без |
| | | | необходимости). |
| ipmicfg -sdr full | Да | Да | Полный вывод SDR с детальной информацией по |
| | | | каждому датчику. |
| ipmicfg -sdr ver | Да | Да | Показать версию SDR. |
+----------------------+--------+--------+--------------------------------------------------+5. Управление питанием и сброс BMC
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -reset | Да | Да | Холодный перезапуск BMC (перезагружает чип, |
| ipmicfg -r | Да | Да | сбрасывает временные ошибки). То же, что -reset. |
| ipmicfg -fd | Да | Да | Сброс BMC до заводских настроек (Factory |
| | | | Defaults): очистка пользователей, сетевых |
| | | | настроек, SEL. |
| ipmicfg -fde | Да | Да | Расширенный сброс до заводских настроек с |
| | | | очисткой абсолютно всех данных (не |
| | | | использовать без крайней необходимости). |
| ipmicfg -fdo | Да | Да | Сброс с сохранением сетевых настроек. |
| ipmicfg -fwum | Да | Да | Обновление прошивки BMC с проверкой целостности. |
| ipmicfg -power on/off/cycle| Нет | Да | Управление питанием сервера: включить, выключить, |
| | | | перезапустить (только в UEFI). |
| ipmicfg -power status| Нет | Да | Показать текущее состояние питания сервера. |
| ipmicfg -wol on/off | Да | Да | Включить/отключить Wake-on-LAN. |
+----------------------+--------+--------+--------------------------------------------------+6. FRU (Field Replaceable Unit) и информация о системе
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -fru info | Да | Да | Показать информацию FRU: производитель |
| | | | материнской платы, модель, серийный номер. |
| ipmicfg -fru write <file>| Да | Да | Записать FRU-данные из файла. |
| ipmicfg -fru read <file> | Да | Да | Сохранить текущие FRU-данные в файл. |
| ipmicfg -pminfo | Да | Да | Информация о блоках питания (напряжение, ток, |
| | | | температура, мощность, статус). |
| ipmicfg -psfruinfo | Да | Да | Подробная информация о блоках питания: |
| | | | модель, серийный номер, версия прошивки, |
| | | | температура, обороты вентиляторов PSU. |
| ipmicfg -psbbpinfo | Да | Да | Информация о батарейном блоке питания |
| | | | (battery backup): напряжение, температура, |
| | | | оставшаяся ёмкость, статус заряда. |
| ipmicfg -psbbp discharge| Да | Да | Принудительная ручная разрядка батарейного |
| | | | блока (для калибровки). |
| ipmicfg -autodischarge| Да | Да | Настройка автоматической разрядки батареи |
| | | | по расписанию (указать модуль и дни). |
| ipmicfg -discharge <module>| Да| Да | Запустить ручную разрядку указанного модуля. |
+----------------------+--------+--------+--------------------------------------------------+7. OEM-команды и RAW-доступ
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -raw <NetFn>| Да | Да | Отправка сырого IPMI-запроса. Пример: |
| <LUN> <CMD> | | | ipmicfg -raw 0x30 0x68 0 0 — сброс |
| [<Data>...] | | | конфигурации сети. |
| ipmicfg -oem list | Да | Да | Список доступных OEM-команд Supermicro. |
| ipmicfg -oem <code>| Да | Да | Выполнить специфическую OEM-команду. |
| ipmicfg -nm info | Да | Да | Информация о Node Manager (управление питанием |
| | | | и энергопотреблением процессора). |
| ipmicfg -nm set <param>| Да | Да | Установка параметров Node Manager (лимиты |
| | | | мощности, P-state и т.д.). |
| ipmicfg -snm <community>| Да | Да | Настройка SNMP-community для мониторинга. |
| ipmicfg -sol info | Да | Да | Информация о Serial Over LAN (консоль через сеть).|
| ipmicfg -sol on/off | Да | Да | Включить/отключить SOL. |
| ipmicfg -kvm on/off | Да | Да | Включить/отключить доступ к KVM-over-IP. |
| ipmicfg -vmedi on/off| Да | Да | Включить/отключить Virtual Media. |
+----------------------+--------+--------+--------------------------------------------------+8. Диагностические и служебные команды
+----------------------+--------+--------+--------------------------------------------------+
| Команда | DOS | UEFI | Описание |
+----------------------+--------+--------+--------------------------------------------------+
| ipmicfg -i | Да | Да | Краткая информация о системе: модель, |
| | | | серийный номер, версия BIOS. |
| ipmicfg -ipmi info | Да | Да | Подробная информация об IPMI: версия спецификации,|
| | | | версия прошивки BMC, GUID. |
| ipmicfg -eemc | Да | Да | Экспорт переменных окружения BMC в файл. |
| ipmicfg -iemc <file>| Да | Да | Импорт переменных окружения BMC из файла. |
| ipmicfg -session list| Да | Да | Список активных IPMI-сессий. |
| ipmicfg -session close <ID>| Да | Да | Принудительно закрыть указанную сессию. |
| ipmicfg -intrusion on/off| Да | Да | Включить/отключить датчик вскрытия корпуса |
| | | | (Chassis Intrusion). |
| ipmicfg -intrusion clear| Да | Да | Сбросить флаг вскрытия корпуса (после того, |
| | | | как корпус был закрыт). |
| ipmicfg -clear_system_event| Да| Да | Альтернативная команда очистки SEL (перезапуск |
| | | | не требуется). |
| ipmicfg -cfg save <file>| Да | Да | Сохранить полную конфигурацию IPMI в файл. |
| ipmicfg -cfg load <file>| Да | Да | Восстановить конфигурацию IPMI из файла. |
| ipmicfg -fgc | Да | Да | Запустить проверку целостности прошивки BMC. |
| ipmicfg -update <file>| Да | Да | Обновить прошивку BMC из указанного файла. |
| ipmicfg -tty <port>| Да | Да | Перенаправить вывод на последовательный порт. |
| ipmicfg -bomb | Нет | Да | Специальный режим для отладки (UEFI). |
+----------------------+--------+--------+--------------------------------------------------+9. Практические примеры использования
Для закрепления материала приведём несколько типовых сценариев работы с IPMICFG.
9.1. Просмотр текущего IP-адреса BMC (DOS)
C:\> IPMICFG.exe -m
IP Address : 192.168.1.120
Subnet Mask : 255.255.255.0
Default Gateway : 192.168.1.1
MAC Address : 00:25:90:AB:CD:EF9.2. Установка статического IP-адреса и отключение DHCP (UEFI)
Shell> ipmicfg.efi -dhcp off
Shell> ipmicfg.efi -m 10.10.10.50
Shell> ipmicfg.efi -k 255.255.255.0
Shell> ipmicfg.efi -g 10.10.10.1
Shell> ipmicfg.efi -reset9.3. Сброс забытого пароля администратора (создание нового пользователя)
C:\> IPMICFG.exe -user list
ID Name Privilege Level
2 ADMIN Administrator
C:\> IPMICFG.exe -user add 3 newadmin MyNewPass123
C:\> IPMICFG.exe -user level 3 4
C:\> IPMICFG.exe -user enable 39.4. Очистка журнала событий SEL
Shell> ipmicfg.efi -sel del
Are you sure to delete all SEL records? (y/n): y
SEL cleared successfully.9.5. Полный сброс BMC до заводских настроек
C:\> IPMICFG.exe -fd
This command will reset all settings to factory defaults.
Continue? (y/n): y
Factory reset completed. BMC will reboot.
Советы по использованию:
- Перед выполнением критических операций (сброс, обновление прошивки) убедитесь, что сервер подключён к ИБП.
- В среде DOS утилита работает медленнее, чем в UEFI. По возможности используйте UEFI Shell.
- Некоторые старые версии BMC не поддерживают отдельные OEM-команды. Сверяйтесь с документацией к вашей материнской плате.
- Для массового развёртывания используйте файлы конфигурации (
-cfg save/-cfg load).
10. Заключение
IPMICFG — это швейцарский нож для администратора серверов Supermicro. Умение быстро найти нужную команду в этом справочнике и применить её в среде DOS или UEFI позволит вам восстанавливать доступ к серверу, настраивать сеть и диагностировать проблемы даже в самых сложных ситуациях, когда веб-интерфейс недоступен, а операционная система не загружается.
Сохраните этот справочник в закладки или распечатайте — он пригодится при каждом выезде в ЦОД или удалённой сессии.