ipmitool(1)

نام (NAME)

ipmitool - ابزاری برای کنترل دستگاه‌های مجهز به IPMI

خلاصه دستور (SYNOPSIS)

ipmitool [ <options> ] <command> [ <sub-commands and sub-options> ]

<options> := [ <general-options> | <conditional-opts> ]

هر گزینه شناخته‌شده‌ای پذیرفته می‌شود. گزینه‌های شرطی ممکن است نادیده گرفته شوند یا استفاده از آن‌ها تا زمان پردازش دستور مربوطه توسط پوسته یا exec به تعویق بیفتد.

<conditional-opts> := [ <lan-options> | <lanplus-options> |
<command-options> ]
پل‌زدن (Bridging):
<bridge-options> := -t <target_address> [ -b <channel> |
[ -T <address> | -B <channel> ] ]

گزینه‌های مورد استفاده با -I lan:
<lan-options> := [ -A <authtype> ]

گزینه‌های مورد استفاده با -I lanplus:
<lanplus-options> := [ -C <ciphersuite> | <key-option> ]

گروه‌های گزینه‌ای که مقدار یکسانی را تنظیم می‌کنند:
<key-option> := [ -k <key> | -K | -y <hex_key> | -Y ]
<password-option> := [ -f <password_file> | -a | -P <password> | -E ]
<oem-option> := [ -o <oemtype> | -g | -s ]

گزینه‌های مورد استفاده با دستور خاص <command-options>:
<options-sdr> := [ -S <sdr_cache_file> ]
<options-sel> := [ -O <sel_oem> ]
<options-sol> := [ -e <sol_escape_char> ]

توضیحات (DESCRIPTION)

این برنامه به شما امکان می‌دهد عملکردهای «رابط مدیریت هوشمند پلتفرم» (IPMI) را چه برای سیستم محلی از طریق درایور دستگاه هسته، و چه برای یک سیستم دوردست با استفاده از IPMI v1.5 و IPMI v2.0 مدیریت کنید. این عملکردها شامل چاپ اطلاعات FRU، پیکربندی LAN، خواندن مقادیر حسگرها، و کنترل از راه دور توان شاسی است.

مدیریت IPMI روی یک رابط سیستم محلی مستلزم نصب و پیکربندی یک درایور سازگار هسته برای IPMI است. در Linux این درایور OpenIPMI نامیده می‌شود و در توزیع‌های استاندارد گنجانده شده است. در Solaris این درایور BMC نام دارد و در Solaris 10 موجود است. مدیریت یک ایستگاه دوردست نیازمند فعال و پیکربندی بودن رابط IPMI-over-LAN است. بسته به نیازمندی‌های خاص هر سیستم، ممکن است فعال‌سازی رابط LAN با استفاده از ipmitool از طریق رابط سیستم امکان‌پذیر باشد.

گزینه‌ها (OPTIONS)

-a: درخواست گذرواژه کارساز دوردست از کاربر.
-A <authtype>: مشخص کردن نوع احراز هویت برای استفاده در طول فعال‌سازی نشست lan در IPMIv1.5. انواع پشتیبانی‌شده عبارتند از NONE، PASSWORD، MD2، MD5، یا OEM.
-b <channel>: تنظیم کانال مقصد برای درخواست پل‌شده (bridged).
-B <channel>: تنظیم کانال عبوری برای درخواست پل‌شده (پل دوگانه).
-b <channel>: تنظیم کانال مقصد برای درخواست پل‌شده (bridged).
-B <channel>: تنظیم کانال عبوری برای درخواست پل‌شده (پل دوگانه).
-c: نمایش خروجی در قالب CSV (مقادیر جداشده با کاما). این قابلیت برای همه دستورها در دسترس نیست.
-C <ciphersuite>: الگوریتم‌های احراز هویت، یکپارچگی و رمزنگاری کارساز دوردست برای استفاده در اتصالات lanplus در IPMIv2.0. به جدول 22-20 در مشخصات IPMI v2.0 مراجعه کنید. مقدار پیش‌فرض 17 است که الگوریتم‌های احراز هویت RAKP-HMAC-SHA256، یکپارچگی HMAC-SHA256-128 و رمزنگاری AES-CBC-128 را مشخص می‌کند.
نکته: در ipmitool نسخه 1.8.18 و قبل از آن مقدار پیش‌فرض 3 بود که ناامن بوده و توسط برخی از پیاده‌سازی‌های جدیدتر BMC پشتیبانی نمی‌شد.
-d N: استفاده از شماره دستگاه N برای مشخص کردن دستگاه /dev/ipmiN (یا /dev/ipmi/N یا /dev/ipmidev/N) جهت ارتباط درون‌باندی (in-band) با BMC. برای هدف قرار دادن یک BMC خاص روی یک سیستم چندگره‌ای و چند-BMC از طریق رابط درایور دستگاه ipmi استفاده می‌شود. مقدار پیش‌فرض 0 است.
-e <sol_escape_char>: استفاده از نویسه ارائه‌شده به عنوان نویسه گریز (escape) نشست SOL. پیش‌فرض استفاده از ~ است، اما ممکن است با نشست‌های ssh تداخل ایجاد کند.
-E: گذرواژه کارساز دوردست توسط متغیر محیطی IPMI_PASSWORD یا IPMITOOL_PASSWORD مشخص می‌شود. متغیر IPMITOOL_PASSWORD اولویت دارد.
-f <password_file>: فایلی حاوی گذرواژه کارساز دوردست را مشخص می‌کند. اگر این گزینه وجود نداشته باشد، یا اگر password_file خالی باشد، گذرواژه به طور پیش‌فرض NULL خواهد بود.
-g: منسوخ شده است. از این مورد استفاده کنید: -o intelplus
-h: دریافت راهنمای پایه نحوه استفاده از طریق خط فرمان.
-H <address>: نشانی کارساز دوردست؛ می‌تواند نشانی IP یا نام میزبان باشد. این گزینه برای رابط‌های lan و lanplus الزامی است.
-I <interface>: رابط IPMI مورد استفاده را انتخاب می‌کند. رابط‌های پشتیبانی‌شده‌ای که کامپایل شده‌اند در خروجی راهنمای برنامه قابل مشاهده هستند.
-k <key>: استفاده از کلید ارائه‌شده Kg برای احراز هویت IPMIv2.0. حالت پیش‌فرض عدم استفاده از هرگونه کلید Kg است.
-K: خواندن کلید Kg از متغیر محیطی IPMI_KGKEY.
-l <lun>: تنظیم LUN مقصد برای دستورات خام (raw).
-L <privlvl>: تحمیل سطح دسترسی نشست. می‌تواند CALLBACK، USER، OPERATOR، یا ADMINISTRATOR باشد. پیش‌فرض ADMINISTRATOR است. این مقدار هنگام ترکیب با -t target address نادیده گرفته شده و همواره روی ADMINISTRATOR تنظیم می‌شود.
-m <local_address>: تنظیم نشانی محلی IPMB. در صورتی که -m مشخص نشده باشد، نشانی محلی به صورت پیش‌فرض 0x20 است یا روی بسترهای PICMG به طور خودکار شناسایی می‌شود. در شرایط عادی نیازی به تغییر نشانی محلی وجود ندارد.
-N <sec>: مشخص کردن تعداد ثانیه‌های بین ارسال مجدد پیام‌های lan/lanplus. مقادیر پیش‌فرض ۲ ثانیه برای رابط‌های lan و ۱ ثانیه برای رابط‌های lanplus است. دستور raw از مقدار ثابت ۱۵ ثانیه استفاده می‌کند. دستور sol از مقدار ثابت ۱ ثانیه استفاده می‌کند.
-o <oemtype>: انتخاب نوع OEM برای پشتیبانی. این مورد معمولاً شامل وصله‌های جزئی در کد است تا با رفتارهای خاص BMCهای سازندگان مختلف سازگار شود. از -o list برای مشاهده فهرست انواع OEM پشتیبانی‌شده فعلی استفاده کنید.
-O <sel oem>: فایل انتخاب‌شده را باز کرده و شرح رویدادهای OEM SEL را جهت استفاده هنگام فهرست‌گیری SEL می‌خواند. برای ساختار فایل، مثال‌های موجود در دایرکتوری contrib را ببینید.
-p <port>: درگاه UDP کارساز دوردست برای اتصال. مقدار پیش‌فرض 623 است.
-P <password>: گذرواژه کارساز دوردست در خط فرمان مشخص می‌شود. در صورت پشتیبانی، در فهرست فرایندها پنهان خواهد شد. نکته! تعیین گذرواژه به عنوان یک گزینه در خط فرمان توصیه نمی‌شود.
-R <count>: تنظیم تعداد تلاش‌های مجدد برای رابط lan/lanplus (پیش‌فرض=۴). دستور raw از مقدار ثابت یک تلاش (بدون تلاش مجدد) استفاده می‌کند. دستور hpm از مقدار ثابت ۱۰ بار تلاش مجدد استفاده می‌کند.
-s: منسوخ شده است. از این مورد استفاده کنید: -o supermicro
-S <sdr_cache_file>: استفاده از فایل محلی برای حافظه نهان (cache) دوردست SDR. استفاده از یک حافظه نهان محلی SDR می‌تواند عملکرد دستورهایی را که برای انجام وظیفه خود نیازمند آگاهی از کل SDR هستند به شدت افزایش دهد. حافظه نهان محلی SDR از یک سیستم دوردست را می‌توان با دستور sdr dump ایجاد کرد..TP -t <target_address> پل‌زدن (Bridge) درخواست‌های IPMI به نشانی هدف دوردست. پیش‌فرض 32 است. گزینه -L privlvl همواره نادیده گرفته شده و مقدار آن روی ADMINISTRATOR تنظیم می‌شود.
-T <address>: تنظیم نشانی عبور (transit address) برای درخواست پل (پل دوگانه).
-T <transmit_address>: تنظیم نشانی عبور برای درخواست پل. (پل دوگانه)
-U <username>: نام کاربری سرور دوردست، پیش‌فرض کاربر NULL است.
-v: افزایش سطح پرگویی خروجی (verbose). این گزینه می‌تواند چندین بار مشخص شود تا سطح خروجی اشکال‌زدایی (debug) افزایش یابد. در صورت سه بار مشخص کردن، رونوشت هگزادسیمال (hexdump) تمام بسته‌های ورودی و خروجی را دریافت خواهید کرد. استفاده پنج باره از آن، جزئیات مربوط به پردازش درخواست و پاسخ‌های مورد انتظار را ارائه می‌دهد. دستورهای hpm شامل targetcap compprop abort upgstatus rollback rollbackstatus selftestresult سطح پرگویی را افزایش می‌دهند
-V: نمایش اطلاعات نسخه.
-y <hex key>: استفاده از کلید Kg ارائه‌شده برای احراز هویت IPMIv2.0. انتظار می‌رود که کلید در قالب هگزادسیمال باشد و می‌تواند برای تعیین کلیدهایی با نویسه‌های غیرقابل‌چاپ استفاده شود. به عنوان مثال، '-k PASSWORD' و '-y 50415353574F5244' معادل یکدیگر هستند. پیش‌فرض، عدم استفاده از هیچ کلید Kg است.
-Y: درخواست تعاملی برای دریافت کلید Kg جهت احراز هویت IPMIv2.0.
-z <size>: تغییر اندازه کانال ارتباطی. (OEM)

اگر هیچ روش گذرواژه‌ای مشخص نشده باشد، ipmitool گذرواژه را از کاربر درخواست خواهد کرد. اگر هیچ گذرواژه‌ای در اعلان وارد نشود، گذرواژه سرور دوردست به‌طور پیش‌فرض NULL خواهد بود.

امنیت (SECURITY)

پیش از فعال‌سازی رابط IPMI LAN، چندین مسئله امنیتی باید در نظر گرفته شود. یک ایستگاه دوردست توانایی کنترل وضعیت توان سیستم و همچنین توانایی جمع‌آوری اطلاعات مشخصی از پلتفرم را دارد. برای کاهش آسیب‌پذیری، اکیداً توصیه می‌شود که رابط IPMI LAN تنها در محیط‌های «مورد اعتماد» که امنیت سیستم در آن‌ها مسئله‌ساز نیست یا در جایی که یک «شبکه مدیریت» اختصاصی و امن وجود دارد، فعال شود.

علاوه بر این، اکیداً توصیه می‌شود که IPMI را برای دسترسی از راه دور بدون تنظیم گذرواژه فعال نکنید، و این گذرواژه نباید مشابه هیچ گذرواژه دیگری روی آن سیستم باشد.

هنگامی که یک گذرواژه IPMI در یک ماشین دوردست با رابط IPMIv1.5 lan تغییر داده می‌شود، گذرواژه جدید به صورت متن آشکار (clear text) از طریق شبکه ارسال می‌شود. این مورد می‌تواند شنود شده و سپس برای حمله به سیستم دوردست استفاده شود. از این رو توصیه می‌شود که مدیریت گذرواژه IPMI تنها از طریق رابط IPMIv2.0 lanplus یا رابط سیستمی روی ایستگاه محلی انجام گیرد.

برای IPMI v1.5، بیشینه طول گذرواژه ۱۶ نویسه است؛ گذرواژه‌های طولانی‌تر ممکن است کوتاه شده یا توسط سرور، یا توسط ipmitool رد شوند.

برای IPMI v2.0، بیشینه طول گذرواژه ۲۰ نویسه است؛ گذرواژه‌های طولانی‌تر توسط ipmitool رد خواهند شد.

دستورها (COMMANDS)

help: این دستور می‌تواند برای دریافت راهنمای خط فرمان درباره دستورهای ipmitool استفاده شود. همچنین ممکن است در انتهای دستورها برای دریافت راهنمای استفاده از گزینه‌ها قرار گیرد.
> ipmitool help
Commands:
bmc Deprecated. Use mc
channel Configure Management Controller channels
chassis Get chassis status and set power state
dcmi Data Center Management Interface
delloem Manage Dell OEM Extensions.
echo Used to echo lines to stdout in scripts
ekanalyzer run FRU-Ekeying analyzer using FRU files
event Send events to MC
exec Run list of commands from file
firewall Configure Firmware Firewall
fru Print built-in FRU and scan for FRU locators
fwum Update IPMC using Kontron OEM Firmware Update Manager
gendev Read/Write Device associated with Generic Device locators sdr
hpm Update HPM components using PICMG HPM.1 file
i2c Send an I2C Master Write-Read command and print response
ime Upgrade/Query Intel ME firmware
isol Configure and connect Intel IPMIv1.5 Serial-over-LAN
kontronoem Manage Kontron OEM Extensions
lan Configure LAN Channels
mc Management Controller status and global enables
nm Node Manager
pef Configure Platform Event Filtering (PEF)
picmg Run a PICMG/ATA extended command
power Shortcut to chassis power commands
raw Send a RAW IPMI request and print response
sdr Print Sensor Data Repository entries and readings
sel Print System Event Log (SEL)
sensor Print detailed sensor information
session Print session information
set Set runtime variable for shell and exec
shell Launch interactive IPMI shell
sol Configure and connect IPMIv2.0 Serial-over-LAN
spd Print SPD info from remote I2C device
sunoem Manage Sun OEM Extensions
tsol Configure and connect Tyan IPMIv1.5 Serial-over-LAN
user Configure Management Controller users
channel

authcap <channel number> <max priv>: نمایش اطلاعات درباره قابلیت‌های احراز هویت کانال انتخاب‌شده در سطح دسترسی مشخص‌شده.

سطوح دسترسی ممکن عبارتند از:: 1 سطح Callback
2 سطح User
3 سطح Operator
4 سطح Administrator
5 سطح اختصاصی OEM
15 بدون دسترسی

info [channel number]: نمایش اطلاعات درباره کانال انتخاب‌شده. اگر هیچ کانالی داده نشود، اطلاعات مربوط به کانال در حال استفاده فعلی را نمایش می‌دهد.

> ipmitool channel info
Channel 0xf info:
Channel Medium Type : System Interface
Channel Protocol Type : KCS
Session Support : session-less
Active Session Count : 0
Protocol Vendor ID : 7154

getaccess <channel number> [<userid>]

پیکربندی userid داده‌شده به عنوان پیش‌فرض روی شماره کانال مشخص‌شده. هنگامی که کانال داده‌شده متعاقباً استفاده شود، کاربر به‌طور ضمنی توسط userid مشخص‌شده شناسایی می‌شود.

setaccess <channel number> <userid> [<callin=on|off>]: [<ipmi=on|off>] [<link=on|off>] [<privilege=level>]
پیکربندی اطلاعات دسترسی کاربر روی کانال داده‌شده برای userid مشخص‌شده.
getciphers <ipmi|sol> [<channel>]: نمایش فهرست مجموعه‌های رمزی (cipher suites) پشتیبانی‌شده برای برنامه داده‌شده (ipmi یا sol) روی کانال مشخص‌شده.

chassis

status: اطلاعات وضعیت مربوط به برق، دکمه‌ها، خنک‌سازی، درایوها و خطاها.
power

status
on.TP: off
cycle
reset
diag
soft

identify [<seconds>|force]: بازه زمانی شناسایی (identify).
پیش‌فرض ۱۵ ثانیه است.
0 - خاموش
force - روشن نگه‌داشتن به مدت نامحدود
policy: اقدام در زمان وصل مجدد برق.

list: نمایش گزینه‌های موجود.
always-on
previous
always-off

restart_cause: علت آخرین راه‌اندازی مجدد (restart).
poh: دریافت ساعات روشن بودن (power on hours).
bootdev

none: ترتیب دستگاه‌های بوت تغییر نکند.
pxe: بوت اجباری از طریق PXE.
disk: بوت اجباری از دیسک‌سخت پیش‌فرض.
safe: بوت اجباری از دیسک‌سخت پیش‌فرض، درخواست حالت امن (Safe Mode).
diag: بوت اجباری از پارتیشن عیب‌یابی (Diagnostic Partition).
cdrom: بوت اجباری از CD/DVD.
bios: بوت اجباری به تنظیمات BIOS Setup.
floppy: بوت اجباری از فلاپی/رسانه جداشدنی اولیه.

bootmbox get [text] [block <block#>]

خواندن صندوق پستی راه‌انداز بوت (Boot Initiator Mailbox) به صورت دامپ هگزادسیمال یا در حالت متنی.

به‌طور پیش‌فرض تمام صندوق پستی خوانده می‌شود. اگر شماره بلوک مشخص شده باشد، همان بلوک خاص خوانده می‌شود. برای بلوک ۰ یا هنگامی که کل صندوق پستی خوانده می‌شود، شماره سازمانی Boot Initiator IANA و نام سازمانی متناظر با آن چاپ می‌شوند.

bootmbox set text [block <block#>] <IANA_PEN> "<data_string>"

نوشتن در <block> مشخص‌شده یا کل Boot Initiator Mailbox در حالت متنی. مشخص کردن یک IANA Enterprise Number دهدهی که توسط راه‌انداز بوت روی سیستم هدف شناخته شود، الزامی است. برای جزئیات به سازنده سیستم هدف خود مراجعه کنید. بقیه آرگومان‌ها یک رشته متنی هستند.

هنگامی که نوشتن یک بلوک منفرد درخواست می‌شود، طول کل <data> نباید برای بلوک ۰ از ۱۳ بایت، یا در غیر این صورت از ۱۶ بایت تجاوز کند.

bootmbox set [block <block#>] <IANA_PEN> <data_byte> [<data_byte> ...]

مشابه بالا، اما آرگومان‌های بعد از IANA PEN مقادیر بایتی داده‌ای مجزایی هستند که با فاصله از یکدیگر جدا شده‌اند.

bootparam get <opt_id> [<opt_param>]

دریافت مقدار گزینه بوت سیستم به شماره <opt_id>. برخی از گزینه‌های بوت (مانند گزینه ۷) می‌توانند یک پارامتر عددی اختیاری نیز دریافت کنند.

bootparam set bootflag <device> [options=...]

تنظیم یک پرچم بوت (boot flag). دستگاه‌های معتبر عبارتند از:

force_pxe: بوت اجباری از طریق PXE
force_disk: بوت اجباری از دیسک‌سخت پیش‌فرض
force_safe: بوت اجباری از دیسک‌سخت پیش‌فرض، درخواست حالت امن (Safe Mode)
force_diag: بوت اجباری از پارتیشن عیب‌یابی (Diagnostic Partition)
force_cdrom: بوت اجباری از CD/DVD
force_bios: بوت اجباری به تنظیمات BIOS Setup

گزینه‌های معتبر عبارتند از:

PEF: پاک کردن بیت معتبر در زمان ریست/چرخه برق ناشی از PEF
timeout: پاک کردن خودکار بیت معتبر پرچم بوت پس از پایان مهلت زمانی (timeout)
watchdog: پاک کردن بیت معتبر در زمان ریست/چرخه برق ناشی از watchdog
reset: پاک کردن بیت معتبر در زمان ریست با دکمه/ریست نرم (soft reset)
power: پاک کردن بیت معتبر در زمان روشن شدن از طریق دکمه پاور یا رویداد بیدارباش (wake event)

selftest: دریافت نتایج خودآزمایی شاسی (chassis self-test)

dcmi

discover: این دستور برای شناسایی قابلیت‌های پشتیبانی‌شده در DCMI استفاده می‌شود.
power <command>: گزینه‌های دستور محدودیت توان پلتفرم عبارتند از:

reading

دریافت مقادیر خوانده‌شده مربوط به توان از سیستم.

get_limit

دریافت محدودیت‌های توان پیکربندی‌شده.

set_limit <parameter> <value>

تنظیم یک گزینه محدودیت توان.

پارامترها/مقادیر ممکن عبارتند از:

action <No Action | Hard Power Off & Log Event to SEL | Log Event to SEL>

اقدامات شرایط استثنا (Exception Actions) به صورت «No Action»، «Hard Power Off system and log events to SEL» یا «Log event to SEL only» انجام می‌شوند.

limit <number in Watts>

حد توان درخواستی بر حسب وات.

correction <number in milliseconds>

حد زمان اصلاح بر حسب میلی‌ثانیه.

sample <number in seconds>

دوره نمونه‌برداری آماری بر حسب ثانیه.

activate: فعال‌سازی حد توان تعیین‌شده.
deactivate: غیرفعال‌سازی حد توان تعیین‌شده.

sensors: حسگرهای DCMI موجود را چاپ می‌کند.
asset_tag: برچسب اموال (asset tag) پلتفرم را چاپ می‌کند.
set_asset_tag <string>: برچسب اموال پلتفرم را تنظیم می‌کند.
get_mc_id_string: دریافت رشته شناسه کنترل‌کننده مدیریت (MC).
set_mc_id_string <string>: تنظیم رشته شناسه کنترل‌کننده مدیریت. حداکثر طول شامل نویسه تهی پایانی (null terminator) ۶۴ بایت است.
thermalpolicy [<get | set>]: دریافت/تنظیم سیاست حد حرارتی (Thermal Limit).

دستورها عبارتند از:

Get <entityID> <instanceID>

دریافت مقادیر حد حرارتی.

entityID موجودیت فیزیکی است که حسگر یا دستگاه با آن مرتبط است. instanceID نمونه خاصی از یک موجودیت است. نمونه موجودیت (Entity Instance) می‌تواند در یکی از دو محدوده مرتبط با سیستم (system-relative) یا مرتبط با دستگاه (device-relative) باشد. برای نمونه، سیستمی با چهار پردازنده می‌تواند از مقدار «0» برای Entity Instance جهت شناسایی نخستین پردازنده استفاده کند.

Set <entityID> <instanceID>

تنظیم مقادیر حد حرارتی.

get_temp_reading: دریافت خوانش‌های حسگر دما.
get_conf_param: دریافت پارامترهای پیکربندی DCMI.
set_conf_param <parameters>: تنظیم پارامترهای پیکربندی DCMI.

پارامترهای پیکربندی عبارتند از:
activate_dhcp: فعال‌سازی/راه‌اندازی مجدد DHCP
dhcp_config: شناسایی پیکربندی DHCP.
init: تنظیم بازه زمانی مهلت اولیه DHCP، بر حسب ثانیه. مقدار پیش‌فرض پیشنهادی چهار ثانیه است.
timeout: تنظیم بازه زمانی مهلت برقراری ارتباط با کارساز DHCP، بر حسب ثانیه. مهلت پیش‌فرض پیشنهادی دو دقیقه است.
retry: تنظیم بازه زمانی تلاش مجدد برای تماس با کارساز DHCP، بر حسب ثانیه. مهلت پیش‌فرض پیشنهادی شصت و چهار ثانیه است.

oob_discover: پیام پینگ/پونگ (Ping/Pong) برای شناسایی DCMI.

delloem

دستورهای delloem اطلاعاتی درباره قابلیت‌های اختصاصی Dell ارائه می‌دهند.

setled {b:d.f} {state..}

LEDهای بک‌پ‌لین درایو را برای یک دستگاه تنظیم می‌کند.
{b:d.f} = آدرس PCI دستگاه (مانند 06:00.0)
{state} = یک یا چند مورد از موارد زیر:

lcd

set {mode}|{lcdqualifier}|{errordisplay}

به شما امکان می‌دهد حالت LCD و رشته تعریف‌شده توسط کاربر را تنظیم کنید.

lcd set mode

{none}|{modelname}|{ipv4address}|{macaddress}|
{systemname}|{servicetag}|{ipv6address}|
{ambienttemp}|{systemwatt}|{assettag}|
{userdefined}<text>

به شما امکان می‌دهد حالت نمایشگر LCD را روی هر یک از پارامترهای پیشین تنظیم کنید.

lcd set lcdqualifier

{watt}|{btuphr}|
{celsius}|{fahrenheit}

به شما امکان می‌دهد واحد را برای حالت دمای محیط سیستم تنظیم کنید.

lcd set errordisplay

{sel}|{simple}

امکان تنظیم نحوه نمایش خطا را فراهم می‌کند.

lcd info

اطلاعات صفحه نمایش LCD را نشان می‌دهد.

lcd set vkvm

{active}|{inactive}

امکان تنظیم وضعیت vKVM به فعال (active) یا غیرفعال (inactive) را فراهم می‌کند. هنگامی که فعال باشد و نشستی در جریان باشد، پیامی روی LCD نمایش داده می‌شود.

lcd status

وضعیت LCD را برای فعال یا غیرفعال بودن نمایش vKVM و حالت دسترسی Front Panel (شامل viewandmodify،‏ view-only یا disabled) نمایش می‌دهد.

mac

اطلاعات مربوط به NICهای سیستم را نمایش می‌دهد.

mac list: آدرس MAC و وضعیت تمام NICها را نمایش می‌دهد. همچنین آدرس MAC مربوط به DRAC/iDRAC را نیز نمایش می‌دهد.
mac get

<NIC number>

آدرس MAC و وضعیت NICهای انتخاب‌شده را نمایش می‌دهد.

lan

اطلاعات Lan را نمایش می‌دهد.

lan set

<Mode>

حالت انتخاب NIC را تعیین می‌کند (dedicated،‏ shared with lom1،‏ shared with lom2،‏ shared with lom3،‏ shared with lom4،‏ shared with failover lom1،‏ shared with failover lom2،‏ shared with failover lom3،‏ shared with failover lom4،‏ shared with Failover all loms،‏ shared with Failover None).

lan get: حالت فعلی انتخاب NIC را بازمی‌گرداند (dedicated،‏ shared with lom1،‏ shared with lom2،‏ shared with lom3،‏ shared with lom4،‏ shared with failover lom1،‏ shared with failover lom2،‏ shared with failover lom3،‏ shared with failover lom4،‏ shared with Failover all loms،‏ shared with Failover None).
lan get active: کارت شبکه (NIC) فعال فعلی را بازمی‌گرداند (dedicated،‏ LOM1،‏ LOM2،‏ LOM3 یا LOM4).

powermonitor

آمار رهگیری توان مصرفی را نمایش می‌دهد.

powermonitor clear cumulativepower

بازنشانی مقدار توان تجمعی خوانده‌شده.

powermonitor clear peakpower

بازنشانی مقدار بیشینه توان (peak power) خوانده‌شده.

powermonitor powerconsumption

<watt>|<btuphr>
میزان توان مصرفی را بر حسب watt یا btuphr نمایش می‌دهد.

powermonitor powerconsumptionhistory

<watt>|<btuphr>
تاریخچه توان مصرفی را بر حسب watt یا btuphr نمایش می‌دهد.

powermonitor getpowerbudget

<watt>|<btuphr>
سقف توان (power cap) را بر حسب watt یا btuphr نمایش می‌دهد.

powermonitor setpowerbudget

<val><watt|btuphr|percent>
امکان تعیین سقف توان (power cap) را بر حسب watt،‏ BTU/hr یا درصد فراهم می‌کند.

powermonitor enablepowercap

سقف توان (power cap) تنظیم‌شده را فعال می‌کند.

powermonitor disablepowercap

سقف توان (power cap) تنظیم‌شده را غیرفعال می‌کند.

vFlash info Card

اطلاعات Extended SD Card را نمایش می‌دهد.

echo: برای چاپ خطوط در stdout درون اسکریپت‌ها.
ekanalyzer <command> <xx=filename1> <xx=filename2> [<rc=filename3>] ...

NOTE : این دستور می‌تواند حداکثر از ۸ فایل در هر خط فرمان پشتیبانی کند
filename1 : فایل باینری که داده‌های FRU یک برد Carrier یا یک ماژول AMC را ذخیره می‌کند
filename2 : فایل باینری که داده‌های FRU یک ماژول AMC را ذخیره می‌کند.
این فایل‌های باینری می‌توانند با این دستور تولید شوند:
ipmitool fru read <id> <filename>
filename3 : فایل پیکربندی مورد استفاده برای پیکربندی On-Carrier Device ID یا OEM GUID. این فایل اختیاری است.
xx : نوع فایل را مشخص می‌کند. می‌تواند مقادیر زیر را داشته باشد:

oc : دستگاه On-Carrier
a1 : اسلات AMC شماره A1
a2 : اسلات AMC شماره A2
a3 : اسلات AMC شماره A3
a4 : اسلات AMC شماره A4
b1 : اسلات AMC شماره B1
b2 : اسلات AMC شماره B2.TP
b3 : اسلات AMC B3
b4 : اسلات AMC B4
sm : Shelf Manager

دستورهای موجود برای ekanalyzer عبارتند از:

print [<carrier | power | all>]

carrier (پیش‌فرض) <oc=filename1> <oc=filename2> ...: نمایش اتصال فیزیکی نقطه به نقطه (point to point) میان carrierها و ماژول‌های AMC.
مثال:
> ipmitool ekanalyzer print carrier oc=fru oc=carrierfru
From Carrier file: fru
Number of AMC bays supported by Carrier: 2
AMC slot B1 topology:
Port 0 =====> On Carrier Device ID 0, Port 16
Port 1 =====> On Carrier Device ID 0, Port 12
Port 2 =====> AMC slot B2, Port 2
AMC slot B2 topology:
Port 0 =====> On Carrier Device ID 0, Port 3
Port 2 =====> AMC slot B1, Port 2
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
From Carrier file: carrierfru
On Carrier Device ID 0 topology:
Port 0 =====> AMC slot B1, Port 4
Port 1 =====> AMC slot B1, Port 5
Port 2 =====> AMC slot B2, Port 6
Port 3 =====> AMC slot B2, Port 7
AMC slot B1 topology:
Port 0 =====> AMC slot B2, Port 0
AMC slot B1 topology:
Port 1 =====> AMC slot B2, Port 1
Number of AMC bays supported by Carrier: 2
power <xx=filename1> <xx=filename2> ...: نمایش اطلاعات منبع تغذیه (power supply) میان carrier و ماژول‌های AMC.
all <xx=filename> <xx=filename> ...: نمایش هر دو مورد اتصال فیزیکی و وضعیت منبع تغذیه برای هر یک از carrierها و ماژول‌های AMC.

frushow <xx=filename>: تبدیل یک فایل باینری FRU به قالب متنی خوانا برای انسان. برای دریافت اطلاعات نمایشی بیشتر از گزینهٔ -v استفاده کنید.

summary [<match | unmatch | all>]

match (پیش‌فرض) <xx=filename> <xx=filename> ...: نمایش تنها نتایج تطبیق‌یافتهٔ مطابقت Ekeying میان یک دستگاه On-Carrier و یک ماژول AMC یا میان ۲ ماژول AMC. مثال:
> ipmitool ekanalyzer summary match oc=fru b1=amcB1 a2=amcA2
On-Carrier Device vs AMC slot B1
AMC slot B1 port 0 ==> On-Carrier Device 0 port 16
Matching Result
- From On-Carrier Device ID 0
-Channel ID 11 || Lane 0: enable
-Link Type: AMC.2 Ethernet
-Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
-Link Group ID: 0 || Link Asym. Match: exact match
- To AMC slot B1
-Channel ID 0 || Lane 0: enable
-Link Type: AMC.2 Ethernet
-Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
-Link Group ID: 0 || Link Asym. Match: exact match
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
AMC slot B1 port 1 ==> On-Carrier Device 0 port 12
Matching Result
- From On-Carrier Device ID 0
-Channel ID 6 || Lane 0: enable
-Link Type: AMC.2 Ethernet
-Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
-Link Group ID: 0 || Link Asym. Match: exact match
- To AMC slot B1
-Channel ID 1 || Lane 0: enable
-Link Type: AMC.2 Ethernet
-Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
-Link Group ID: 0 || Link Asym. Match: exact match
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
On-Carrier Device vs AMC slot A2
AMC slot A2 port 0 ==> On-Carrier Device 0 port 3
Matching Result
- From On-Carrier Device ID 0
-Channel ID 9 || Lane 0: enable
-Link Type: AMC.2 Ethernet
-Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
-Link Group ID: 0 || Link Asym. Match: exact match
- To AMC slot A2
-Channel ID 0 || Lane 0: enable
-Link Type: AMC.2 Ethernet
-Link Type extension: 1000BASE-BX (SerDES Gigabit) Ethernet link
-Link Group ID: 0 || Link Asym. Match: exact match
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
AMC slot B1 vs AMC slot A2
AMC slot A2 port 2 ==> AMC slot B1 port 2
Matching Result
- From AMC slot B1
-Channel ID 2 || Lane 0: enable
-Link Type: AMC.3 Storage
-Link Type extension: Serial Attached SCSI (SAS/SATA)
-Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match}
- To AMC slot A2
-Channel ID 2 || Lane 0: enable
-Link Type: AMC.3 Storage
-Link Type extension: Serial Attached SCSI (SAS/SATA)
-Link Group ID: 0 || Link Asym. Match: FC or SAS interface {exact match}
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
unmatch <xx=filename> <xx=filename> ...: نمایش نتایج تطبیق‌نیافتهٔ مطابقت Ekeying میان یک دستگاه On-Carrier و یک ماژول AMC یا میان ۲ ماژول AMC.
all <xx=filename> <xx=filename> ...: نمایش هر دو نتیجهٔ تطبیق‌یافته و تطبیق‌نیافتهٔ مطابقت Ekeying میان دو کارت یا دو ماژول.

event

<predefined event number N>

ارسال یک رویداد آزمایشی از پیش تعریف‌شده به System Event Log. رویدادهای زیر به عنوان روشی برای آزمایش عملکرد مؤلفهٔ System Event Log در BMC گنجانده شده‌اند (هر بار که دستور event N اجرا شود، یک مدخل اضافه خواهد شد).

مقدارهای پشتیبانی‌شده کنونی برای N عبارتند از:
1 Temperature: Upper Critical: Going High (دما: بحرانی بالایی: رو به افزایش)
2 Voltage Threshold: Lower Critical: Going Low (آستانه ولتاژ: بحرانی پایینی: رو به کاهش)
3 Memory: Correctable ECC (حافظه: ECC تصحیح‌پذیر)

نکته: این رویدادهای از پیش تعریف‌شده احتمالاً رکوردهای SEL «دقیق» برای یک سیستم خاص تولید نخواهند کرد چرا که به درستی به یک شماره سنسور معتبر متصل نمی‌شوند، اما برای راستی‌آزمایی کارکرد صحیح SEL کافی هستند.

file <filename>

رکوردهای لاگ رویداد مشخص‌شده در <filename> به System Event Log افزوده خواهند شد.

قالب هر خط در فایل به صورت زیر است:

<{EvM Revision} {Sensor Type} {Sensor Num} {Event Dir/Type} {Event Data 0} {Event Data 1} {Event Data 2}>[# COMMENT]

به عنوان مثال: 0x4 0x2 0x60 0x1 0x52 0x0 0x0 # Voltage threshold: Lower Critical: Going Low

EvM Revision - مقدار «Event Message Revision» برای پیام‌هایی که با مشخصات IPMI 2.0 مطابقت دارند 0x04 و برای پیام‌هایی که با مشخصات IPMI 1.0 مطابقت دارند 0x03 است.

Sensor Type - نوع یا کلاس رویداد را مشخص می‌کند.

Sensor Num - نشان‌دهندهٔ «سنسور» موجود در کنترلر مدیریتی (management controller) است که پیام رویداد را تولید کرده است.

Event Dir/Type - این فیلد با جهت رویداد به عنوان بیت بالا (بیت ۷) و نوع رویداد به عنوان ۷ بیت پایین کدگذاری می‌شود. جهت رویداد برای یک رویداد assertion برابر 0 و برای یک رویداد deassertion برابر 1 است.

برای جزئیات بیشتر پیرامون تعاریف هر فیلد، به مشخصات IPMI 2.0 مراجعه کنید..TP <sensorid> <list>

دریافت فهرستی از تمام وضعیت‌های حسگر (Sensor States) ممکن و میان‌برهای از پیش تعریف‌شده وضعیت حسگر (Sensor State Shortcuts) موجود برای یک حسگر خاص. sensorid بازنمایی رشته نویسه‌ای حسگر است و در صورتی که شامل فاصله باشد باید درون علامت نقل‌قول قرار گیرد. چندین دستور مختلف از جمله ipmitool sensor list می‌توانند برای به دست آوردن فهرستی شامل رشته‌های sensorid که نشان‌دهنده حسگرهای یک سیستم مشخص هستند استفاده شوند.

> ipmitool -I open event "PS 2T Fan Fault" list
Finding sensor PS 2T Fan Fault... ok
Sensor States:
State Deasserted
State Asserted
Sensor State Shortcuts:
present absent
assert deassert
limit nolimit
fail nofail
yes no
on off
up down

<sensorid> <sensor state> [<direction>]: تولید یک رویداد سفارشی بر اساس اطلاعات حسگر موجود. جهت اختیاری رویداد (direction) می‌تواند assert (پیش‌فرض) یا deassert باشد.

> ipmitool event "PS 2T Fan Fault" "State Asserted"
Finding sensor PS 2T Fan Fault... ok
0 | Pre-Init Time-stamp | Fan PS 2T Fan Fault | State Asserted

> ipmitool event "PS 2T Fan Fault" "State Deasserted"
Finding sensor PS 2T Fan Fault... ok
0 | Pre-Init Time-stamp | Fan PS 2T Fan Fault | State Desserted

exec <filename>

اجرای دستورهای ipmitool از filename. هر خط یک دستور کامل است. نحو دستورها در بخش COMMANDS این صفحه‌راهنما تعریف شده است. هر خط می‌تواند یک توضیح اختیاری در انتهای خط داشته باشد که با نماد «#» جدا می‌شود.

برای مثال، یک فایل دستور با دو خط:

sdr list # get a list of sdr records
sel list # get a list of sel records

firewall

این دستور از قابلیت دیوار آتش میان‌افزار (Firmware Firewall) پشتیبانی می‌کند. ممکن است برای افزودن یا حذف محدودیت‌های امنیتی روی برخی دستورها یا زیرتوابع دستور، یا برای فهرست کردن محدودیت‌های فعلی فایروال میان‌افزار اعمال‌شده روی هر دستوری استفاده شود. برای هر دستور فایروال میان‌افزار که در ادامه فهرست شده است، می‌توان پارامترهایی را اضافه کرد تا اجرای دستور با دقت و تفکیک‌پذیری افزایشی روی یک LUN خاص، برای یک NetFn خاص، برای یک دستور IPMI خاص و در نهایت برای یک زیرتابع دستور خاص انجام گیرد (برای دیدن فهرستی از شماره‌های زیرتابع که ممکن است به یک دستور خاص مرتبط باشند، به پیوست H در مشخصات IPMI 2.0 مراجعه کنید).

نحو و وابستگی‌های پارامترها به صورت زیر است:

[<channel H>] [<lun L> [ <netfn N> [<command C [<subfn S>]]]]

توجه داشته باشید که اگر «netfn <N>» مشخص شده باشد، آنگاه «lun <L>» نیز باید مشخص شود؛ اگر «command <C>» مشخص شده باشد، آنگاه «netfn <N>» (و در نتیجه «lun <L>») نیز باید مشخص شود، و به همین ترتیب.

پارامتر «channel <H>» اختیاری و مستقل است. در صورت مشخص نشدن، عملیات درخواستی روی کانال فعلی انجام خواهد شد. توجه داشته باشید که پشتیبانی از دستورها ممکن است از کانالی به کانال دیگر متفاوت باشد.

دستورهای فایروال میان‌افزار:

info [<Parms as described above>]

فهرست کردن اطلاعات فایروال میان‌افزار برای LUN، NetFn و Command مشخص‌شده (در صورت ارائه) روی کانال فعلی یا مشخص‌شده. اطلاعات فهرست‌شده شامل بیت‌های پشتیبانی (support)، قابل‌پیکربندی (configurable) و فعال (enabled) برای دستور یا دستورهای مشخص‌شده است.

چند مثال کاربردی:

info [<channel H>] [<lun L>]: این دستور اطلاعات فایروال میان‌افزار را برای تمامی NetFnها مربوط به LUN مشخص‌شده روی کانال فعلی یا مشخص‌شده فهرست می‌کند.
info [<channel H>] [<lun L> [ <netfn N> ]: این دستور تمام اطلاعات دستور را برای یک جفت LUN/NetFn چاپ می‌کند.
info [<channel H>] [<lun L> [ <netfn N> [<command C] ]]: این دستور اطلاعات تفصیلی و خوانا برای انسان را چاپ می‌کند که بیت‌های پشتیبانی، قابل‌پیکربندی و فعال را برای دستور مشخص‌شده روی جفت LUN/NetFn تعیین‌شده نشان می‌دهد. اطلاعات مربوط به هر یک از زیرتوابع دستور چاپ خواهد شد.
info [<channel H>] [<lun L> [ <netfn N> [<command C [<subfn S>]]]]: چاپ اطلاعات مربوط به یک زیرتابع خاص.

enable [<Parms as described above>]: این دستور برای فعال‌سازی دستورها برای یک ترکیب NetFn/LUN مشخص روی کانال تعیین‌شده استفاده می‌شود.
disable [<Parms as described above>] [force]: این دستور برای غیرفعال‌سازی دستورها برای یک ترکیب NetFn/LUN مشخص روی کانال تعیین‌شده استفاده می‌شود. در صورت استفاده از گزینه «force» باید دقت زیادی به خرج داد تا دستور «Set Command Enables» غیرفعال نشود.
reset [<Parms as described above>]: این دستور می‌تواند برای بازنشانی فایروال میان‌افزار به وضعیتی که تمام دستورها و زیرتوابع دستور فعال هستند استفاده شود.

fru

print

خواندن تمامی داده‌های موجودی واحد قابل تعویض در محل (FRU) و استخراج اطلاعاتی نظیر شماره سریال، شماره قطعه، برچسب‌های اموال و رشته‌های کوتاهی که شاسی، برد یا محصول را توصیف می‌کنند.

read <fru id> <fru file>

fru id شناسه عددی FRU است (خروجی «fru print» را ببینید). fru file مسیر مطلق فایلی است که داده‌های باینری FRU مربوط به موجودیت FRU مشخص‌شده در آن ذخیره می‌شود.

write <fru id> <fru file>

fru id شناسه عددی FRU است (خروجی «fru print» را ببینید). fru file مسیر مطلق فایلی است که پیش از بارگذاری در FRU مشخص‌شده، داده‌های باینری FRU از آن خوانده می‌شود.

upgEkey <fru id> <fru file>

به‌روزرسانی یک مکان FRU چندرکوردی (multirecord). fru id شناسه عددی FRU است (خروجی «fru print» را ببینید). fru file مسیر مطلق فایلی است که داده‌های باینری FRU برای بارگذاری در موجودیت FRU چندرکوردی مشخص‌شده از آن خوانده می‌شود..TP edit <fru id>

این دستور امکان ویرایش تعاملی برخی رکوردهای پشتیبانی‌شده، به‌ویژه «PICMG Carrier Activation Record» را فراهم می‌کند. fru id شناسه رقمی FRU است (خروجی دستور 'fru print' را ببینید)؛ مقدار پیش‌فرض 0 است.

edit <fru id> field <section> <index> <string>

این دستور می‌تواند برای تنظیم یک رشته فیلد روی مقداری جدید استفاده شود. این دستور داده‌های FRU یافت‌شده در index واقع در section مشخص‌شده را با string ارائه‌شده جایگزین می‌کند.

fru id شناسه رقمی FRU است (خروجی دستور 'fru print' را ببینید).
<section> رشته‌ای است که به نواحی ذخیره‌سازی اطلاعات موجودی FRU (موسوم به FRU Inventory Information Storage Areas) اشاره دارد و می‌تواند به موارد زیر ارجاع دهد:

c ناحیه اطلاعات شاسی موجودی FRU (FRU Inventory Chassis Info Area)
b ناحیه اطلاعات برد موجودی FRU (FRU Inventory Board Info Area)
p ناحیه اطلاعات محصول موجودی FRU (FRU Inventory Product Info Area)

<index> شماره فیلد را مشخص می‌کند. شماره‌گذاری فیلدها از نخستین نوع فیلد 'english text' آغاز می‌شود. برای مثال در ناحیه اطلاعاتی <board>، فیلد '0' برابر با <Board Manufacturer> و فیلد '2' برابر با <Board Serial Number> است؛ برای آگاهی از جایگاه فیلدها، مستند «IPMI Platform Management FRU Information Storage Definition v1.0 R1.1» را ببینید.
<string> باید طولی برابر با رشته‌ای که جایگزین آن می‌شود داشته و یک رشته 8-bit ASCII (0xCx) باشد.

edit <fru id> oem iana <record> <format> [<args>]: این دستور داده‌های موجود در ناحیه multirecord را ویرایش می‌کند. پشتیبانی از رکوردهای خاص OEM محدود است.

fwum

به‌روزرسانی IPMC با استفاده از Kontron OEM Firmware Update Manager.

info: نمایش اطلاعات درباره میان‌افزار فعلی.
status: نمایش وضعیت هر یک از بانک‌های میان‌افزار موجود در سخت‌افزار.
download <filename>: بارگیری میان‌افزار مشخص‌شده.
upgrade [filename]: نصب ارتقای میان‌افزار. اگر نام فایل مشخص شده باشد، ابتدا فایل بارگیری می‌شود؛ در غیر این صورت، از آخرین میان‌افزار بارگیری‌شده استفاده خواهد شد.
rollback: درخواست از IPMC برای بازگشت به نسخه قبلی.
tracelog: نمایش گزارش وقایع ارتقای میان‌افزار.

gendev

list: فهرست کردن تمام Generic Device Locatorها.
read <sdr name> <file>: خواندن داده‌های eeprom مشخص‌شده توسط Generic Device Locators و ذخیره در فایل.
write <sdr name> <file>: نوشتن روی eeprom مشخص‌شده توسط Generic Device Locators از روی فایل.

hpm

عامل ارتقای PICMG HPM.1

check: بررسی اطلاعات هدف.
check <filename>: نمایش هر دو نسخه موجود روی هدف و نسخه ایمیج بر روی صفحه نمایش.
download <filename>: بارگیری میان‌افزار مشخص‌شده.
upgrade <filename> [all] [component <x>] [activate]: ارتقای میان‌افزار با استفاده از یک فایل ایمیج معتبر HPM.1. در صورتی که هیچ گزینه‌ای مشخص نشده باشد، نسخه‌های میان‌افزار ابتدا بررسی شده و ارتقا تنها در صورت تفاوت آن‌ها انجام می‌گیرد.

all: ارتقای تمام مؤلفه‌ها حتی در صورتی که نسخه‌های میان‌افزار یکسان باشند (تنها پس از استفاده از دستور "check" از این گزینه استفاده کنید).
component <x>: ارتقای تنها مؤلفه داده‌شده از فایل مشخص‌شده.
مؤلفه 0 - BOOT
مؤلفه 1 - RTK
activate: فعال‌سازی فوری میان‌افزار جدید.

activate: فعال‌سازی میان‌افزار جدید بارگذاری‌شده.
targetcap: دریافت قابلیت‌های ارتقای هدف.
compprop <id> <select>: دریافت ویژگی‌های مؤلفه مشخص‌شده. مقادیر معتبر id مؤلفه: 0-7 است. Select می‌تواند یکی از موارد زیر باشد:
0 - ویژگی‌های عمومی (General properties)
1 - نسخه میان‌افزار فعلی (Current firmware version)
2 - رشته توضیحات (Description string)
3 - نسخه میان‌افزار برای بازگشت (Rollback firmware version)
4 - نسخه میان‌افزار تعویق‌یافته (Deferred firmware version)
abort: لغو فرایند ارتقای میان‌افزار در حال انجام.
upgstatus: نمایش وضعیت آخرین دستور طولانی‌مدت.
rollback: انجام بازگشت دستی (manual rollback) در میان‌افزار IPM Controller..TP rollbackstatus
نمایش وضعیت بازگردانی (rollback).
selftestresult: پرس‌وجوی نتایج خودآزمایی (self test).

i2c <i2caddr> <read bytes> [<write data>]: این دستور می‌تواند برای اجرای دستورات خام I2C با استفاده از دستور Master Write-Read در IPMI به کار رود.

ime

help: چاپ اطلاعات نحوه استفاده
info: نمایش اطلاعات مربوط به Manageability Engine (ME)
update <file>: ارتقای میان‌افزار (firmware) ME با فایل ایمیج مشخص‌شده
هشدار شما باید حتماً از یک ایمیج پشتیبانی‌شده ارائه‌شده توسط سازندهٔ برد خود استفاده کنید
rollback: انجام بازگردانی دستی میان‌افزار ME

isol

info: دریافت اطلاعات دربارهٔ پیکربندی Intel IPMI v1.5 Serial-Over-LAN.
set <parameter> <value>: پیکربندی پارامترها برای Intel IPMI v1.5 Serial-over-LAN.

پارامترها و مقادیر معتبر عبارتند از:
enabled: true, false.
privilege-level: user, operator, admin, oem.
bit-rate: 9.6, 19.2, 38.4, 57.6, 115.2.

activate: باعث می‌شود ipmitool وارد حالت Intel IPMI v1.5 Serial Over LAN شود. یک اتصال RMCP+ به BMC برقرار می‌شود، ترمینال روی حالت خام (raw) تنظیم شده و ورودی کاربر به کنسول سریال روی سرور راه دور ارسال می‌شود. هنگام خروج، حالت SOL payload غیرفعال شده و ترمینال به تنظیمات اولیه خود بازنشانی می‌شود.

توالی‌های گریز (escape sequences) ویژه‌ای برای کنترل نشست SOL ارائه شده است:

~. قطع اتصال
~^Z معلق کردن ipmitool
~^X معلق کردن ipmitool، بدون بازیابی tty در راه‌اندازی مجدد
~B ارسال break
~~ ارسال نویسهٔ گریز با دو بار تایپ کردن آن
~? چاپ توالی‌های گریز پشتیبانی‌شده

توجه داشته باشید که توالی‌های گریز تنها بلافاصله پس از خط جدید (newline) شناسایی می‌شوند.

kontronoem

دستورات OEM مختص دستگاه‌های Kontron.

setsn: تنظیم شماره سریال FRU.
setmfgdate: تنظیم تاریخ ساخت FRU.
nextboot <boot device>: انتخاب اولویت بوت بعدی در Kontron CP6012.

lan

این دستورات به شما اجازه می‌دهند کانال‌های IPMI LAN را با اطلاعات شبکه پیکربندی کنید تا بتوان از آن‌ها به همراه رابط‌های lan و lanplus در استفاده کرد. نکته: برای تشخیص اینکه رابط LAN روی کدام کانال قرار دارد، دستور `channel info number' را تا زمانی که به یک کانال LAN معتبر 802.3 برسید، اجرا کنید. برای مثال:

> ipmitool -I open channel info 1
Channel 0x1 info:
Channel Medium Type : 802.3 LAN
Channel Protocol Type : IPMB-1.0
Session Support : session-based
Active Session Count : 8
Protocol Vendor ID : 7154

print [<channel>]: چاپ پیکربندی فعلی برای کانال داده‌شده. حالت پیش‌فرض، اطلاعات اولین کانال LAN یافت‌شده را چاپ خواهد کرد.
set <channel number> <command> <parameter>: تنظیم دستور و پارامتر داده‌شده روی کانال مشخص‌شده. گزینه‌های معتبر دستور/پارامتر عبارتند از:

ipaddr <x.x.x.x>

تنظیم آدرس IP برای این کانال.

netmask <x.x.x.x>

تنظیم netmask برای این کانال.

macaddr <xx:xx:xx:xx:xx:xx>

تنظیم آدرس MAC برای این کانال.

defgw ipaddr <x.x.x.x>

تنظیم آدرس IP گیت‌وی پیش‌فرض.

defgw macaddr <xx:xx:xx:xx:xx:xx>

تنظیم آدرس MAC گیت‌وی پیش‌فرض.

bakgw ipaddr <x.x.x.x>

تنظیم آدرس IP گیت‌وی پشتیبان.

bakgw macaddr <xx:xx:xx:xx:xx:xx>

تنظیم آدرس MAC گیت‌وی پشتیبان.

password <pass>

تنظیم گذرواژه کاربر تهی (null user)..TP snmp <community string>

تنظیم رشته جامعه (community string) پروتکل SNMP.

user

فعال‌سازی حالت دسترسی کاربر برای userid شماره ۱ (برای نمایش اطلاعات مربوط به شناسه‌های کاربری در یک کانال مشخص، دستور 'user' را اجرا کنید).

access <on|off>

تنظیم حالت دسترسی کانال LAN.

alert <on|off>

فعال یا غیرفعال کردن هشداردهی PEF برای این کانال.

ipsrc <source>

تنظیم منبع آدرس IP:
none مشخص‌نشده
static آدرس IP ایستا که به‌صورت دستی پیکربندی شده است
dhcp آدرس دریافت‌شده توسط BMC با اجرای DHCP
bios آدرس بارگذاری‌شده توسط BIOS یا نرم‌افزار سیستم

arp respond <on|off>

تنظیم پاسخ‌های ARP تولیدشده توسط BMC.

arp generate <on|off>

تنظیم ارسال بسته‌های gratuitous ARP تولیدشده توسط BMC.

arp interval <seconds>

تنظیم بازه زمانی ارسال gratuitous ARP تولیدشده توسط BMC.

vlan id <off|id>

غیرفعال‌سازی عملکرد VLAN یا فعال‌سازی VLAN و تنظیم شناسه (ID).
شناسه (ID): مقدار شناسه شبکه محلی مجازی بین ۱ تا ۴۰۹۴ (شامل هر دو).

vlan priority <priority>

تنظیم اولویت مرتبط با فریم‌های VLAN.
شناسه (ID): اولویت فریم‌های شبکه محلی مجازی بین ۰ تا ۷ (شامل هر دو).

auth <level,...> <type,...>

تنظیم authtypeهای معتبر برای یک سطح احراز هویت (auth level) معین.
سطوح (Levels): callback, user, operator, admin
انواع (Types): none, md2, md5, password, oem

cipher_privs <privlist>

شماره‌های مجموعه رمزنگاری (cipher suite) را به حداکثر سطح دسترسی (privilege level) مجاز برای استفاده از آن مرتبط می‌کند. به این ترتیب، مجموعه‌های رمزنگاری را می‌توان برای کاربران با یک سطح دسترسی معین محدود کرد، به‌طوری که برای مثال مدیران سیستم ملزم به استفاده از مجموعه رمزنگاری قوی‌تری نسبت به کاربران عادی باشند.

قالب privlist به شرح زیر است. هر نویسه نشان‌دهنده یک سطح دسترسی است و موقعیت مکانی نویسه، شماره مجموعه رمزنگاری (cipher suite) را مشخص می‌کند. به عنوان مثال، اولین نویسه نشان‌دهنده cipher suite 0، دومین نویسه نشان‌دهنده cipher suite 1 و به همین ترتیب است. طول privlist باید دقیقاً ۱۵ نویسه باشد.

نویسه‌های مورد استفاده در privlist و سطوح دسترسی مرتبط با آن‌ها:

X Cipher Suite استفاده‌نشده
c CALLBACK
u USER
o OPERATOR
a ADMIN
O OEM

بنابراین، برای تنظیم حداکثر سطح دسترسی مجموعه ۰ به USER و مجموعه ۱ به ADMIN، دستور زیر را اجرا کنید:

> ipmitool -I interface lan set channel cipher_privs uaXXXXXXXXXXXXX

bad_pass_thresh <thresh_num> <1|0> <reset_interval> <lockout_interval>

آستانه گذرواژه نادرست (Bad Password Threshold) را تنظیم می‌کند.

<thresh_num> در صورت غیرصفر بودن، این مقدار تعداد دفعات متوالی مجاز برای ورود گذرواژه نادرست توسط کاربر مشخص‌شده را پیش از غیرفعال شدن خودکار دسترسی وی در این کانال تعیین می‌کند.

<1|0> ۱ = تولید پیام رویداد "Invalid password disable" توسط حسگر Session Audit. ۰ = عدم تولید پیام رویداد هنگام غیرفعال شدن کاربر.

<reset_interval> بازه زمانی بازنشانی شمارش تلاش‌ها. بازه‌ای برحسب مضارب ۱۰ ثانیه‌ای که شمارش تجمیعی تلاش‌های گذرواژه نادرست پیش از بازنشانی خودکار به صفر، نگهداری می‌شود.

<lockout_interval> بازه زمانی قفل شدن کاربر. بازه‌ای برحسب مضارب ۱۰ ثانیه‌ای که کاربر پس از غیرفعال شدن به دلیل رسیدن به آستانه گذرواژه نادرست، در حالت غیرفعال باقی خواهد ماند.

alert print [<channel>] [<alert destination>]: نمایش اطلاعات هشدار برای کانال و مقصد مشخص‌شده. حالت پیش‌فرض تمام هشدارها را برای تمام مقصدهای هشدار روی اولین کانال LAN یافت‌شده چاپ می‌کند.
alert set <channel number> <alert destination> <command> <parameter>: تنظیم یک هشدار روی کانال LAN و مقصد مشخص‌شده. مقصدهای هشدار (Alert Destinations) از طریق دستور 'lan alert print' فهرست می‌شوند. گزینه‌های معتبر command/parameter عبارتند از:

ipaddr <x.x.x.x>: تنظیم آدرس IP هشدار.
macaddr <xx:xx:xx:xx:xx:xx>: تنظیم آدرس MAC هشدار.
gateway <default | backup>: تنظیم gateway کانال برای استفاده در هشدارها.
ack <on | off>: روشن یا خاموش کردن تایید دریافت هشدار (Alert Acknowledge).
type <pet | oem1 | oem2>: تنظیم نوع مقصد به صورت PET یا OEM.
time <seconds>: تنظیم زمان انقضای ack یا بازه زمانی تلاش مجدد در صورت unack.
retry <number>: تنظیم تعداد دفعات تلاش مجدد هشدار.

stats get [<channel number>]: دریافت اطلاعات درباره اتصالات IP روی کانال مشخص‌شده. حالت پیش‌فرض آمار اولین کانال LAN یافت‌شده را دریافت خواهد کرد.
stats clear [<channel number>]: پاک‌سازی و صفر کردن تمام آمارهای IP/UDP/RMCP روی کانال مشخص‌شده. حالت پیش‌فرض آمار اولین کانال LAN یافت‌شده را پاک می‌کند.

mc | bmc

reset <warm|cold>

به BMC دستور می‌دهد تا یک بازنشانی گرم (warm) یا سرد (cold) انجام دهد..TP guid [smbios|rfc4122|ipmi|dump]

شناسه یکتای سراسری کنترل‌کننده مدیریت (Management Controller Globally Unique IDentifier) را نمایش می‌دهد.

auto

این رفتار پیش‌فرض برای ipmitool(1) است.

تلاش می‌کند بر اساس مقدار فیلد نسخه (version) و (برای نسخه ۱) برچسب زمانی (timestamp)، کدگذاری را به‌طور خودکار تشخیص دهد. نسخه در صورتی معتبر دانسته می‌شود که بین ۱ تا ۵ باشد، و برچسب زمانی نیز زمانی معتبر است که سال آن بزرگ‌تر یا مساوی با مبدأ یونیکس (UNIX Epoch یا ۱۹۷۰) و کوچک‌تر یا مساوی سال جاری باشد.

اگر چندین کدگذاری دارای فیلدهای نسخه معتبر باشند، اولویت با گزینه‌ای است که دارای نسخه ۱ و برچسب زمانی معتبر باشد. اگر هیچ‌کدام واجد این شرایط نباشند، ترتیب اولویت بدین صورت خواهد بود: smbios، ipmi، rfc4122.

چنانچه هیچ‌کدام از کدگذاری‌ها فیلد نسخه معتبری تولید نکنند، ipmitool(1) به حالت پیش‌فرض dump عمل می‌کند.

اگر این گزینه استفاده شود، ipmitool(1) همچنین کدگذاری شناسایی‌شده را چاپ کرده و در صورتی که کدگذاری چیزی جز ipmi باشد، در رابطه با نقض مشخصات IPMI هشدار می‌دهد.

smbios

شناسه GUID را به گونه‌ای رمزگشایی می‌کند که گویی توسط BMC طبق مشخصات SMBIOS ارسال شده است.

نکته: این کار نقض مشخصات IPMI است، اما بسیاری از پیاده‌سازی‌های BMC به همین شیوه عمل می‌کنند. اگر شناسه GUID مربوط به BMC شما با استفاده از این گزینه به‌درستی نمایش داده می‌شود، ممکن است بخواهید به سازنده BMC خود اطلاع دهید که دارای باگ است.

ipmi

شناسه GUID را طبق مشخصات IPMI رمزگشایی می‌کند. این گزینه باید حتماً شناسه GUID صحیح را نشان دهد. اگر نمایش نداد، گزینه‌های دیگر را امتحان کرده و وجود این اشکال را به سازنده BMC خود گزارش دهید.

rfc4122 یا rfc

شناسه GUID را به گونه‌ای رمزگشایی می‌کند که گویی توسط BMC طبق مشخصات RFC4122 ارسال شده است.

نکته: این یک نقض در مشخصات IPMI است. اگر شناسه GUID مربوط به BMC شما با استفاده از این گزینه به‌درستی نمایش داده می‌شود، ممکن است بخواهید سازنده BMC خود را از وجود این باگ مطلع سازید.

dump

داده‌های دریافتی از BMC در پاسخ به دستور Get Device GUID را به صورت هگزادسیمال تخلیه (dump) می‌کند. هیچ‌گونه رمزگشایی یا تفسیری انجام نمی‌گیرد. اولین بایت دریافت‌شده، زودتر از همه تخلیه می‌شود.

info: اطلاعات مربوط به سخت‌افزار BMC، شامل بازنگری دستگاه، نگارش میان‌افزار (firmware)، نسخه IPMI پشتیبانی‌شده، شناسه سازنده (manufacturer ID) و اطلاعات مربوط به پشتیبانی از دستگاه‌های جانبی را نمایش می‌دهد.
watchdog: این دستورها به کاربر اجازه می‌دهند وضعیت فعلی تایمر سگ نگهبان (watchdog timer) را مشاهده کرده و تغییر دهند.

get: تنظیمات فعلی Watchdog Timer و وضعیت شمارش معکوس را نمایش می‌دهد.
reset: تایمر Watchdog را به تازه‌ترین وضعیت آن بازنشانی کرده و شمارش معکوس تایمر را از نو آغاز می‌کند.
off: تایمر شمارش معکوس Watchdog در حال اجرا را خاموش می‌کند.

selftest: سلامت اولیه BMC را با اجرای دستور Get Self Test بررسی کرده و نتایج را گزارش می‌کند.
getenables: فهرستی از گزینه‌های فعال فعلی را برای BMC نمایش می‌دهد.
setenables <option>=[on|off]: گزینه option مشخص‌شده را فعال یا غیرفعال می‌کند. این دستور طبق مشخصات IPMI، تنها بر روی رابط سیستم (system interface) پشتیبانی می‌شود. مقادیر فعلی پشتیبانی‌شده برای option عبارتند از:

recv_msg_intr: وقفه صف دریافت پیام (Receive Message Queue Interrupt)
event_msg_intr: وقفه پر شدن میانگیر پیام رویداد (Event Message Buffer Full Interrupt)
event_msg: میانگیر پیام رویداد (Event Message Buffer)
system_event_log: ثبت وقایع سیستم (System Event Logging)
oem0: گزینه شماره ۰ تعریف‌شده توسط سازنده (OEM-Defined option #0)
oem1: گزینه شماره ۱ تعریف‌شده توسط سازنده (OEM-Defined option #1)
oem2: گزینه شماره ۲ تعریف‌شده توسط سازنده (OEM-Defined option #2)

getsysinfo <argument>: اطلاعات سیستم را از BMC برای آرگومان داده‌شده دریافت می‌کند.
برای تعاریف آرگومان‌ها به setsysinfo مراجعه کنید
setsysinfo <argument> <string>: رشته اطلاعات سیستم را برای آرگومان داده‌شده در BMC ذخیره می‌کند

آرگومان‌های ممکن عبارتند از:

primary_os_name نام سیستم‌عامل اصلی
os_name نام سیستم‌عامل
system_name نام سیستمی سرور
delloem_os_version نگارش در حال اجرای سیستم‌عامل
delloem_URL نشانی اینترنتی (URL) وب‌سرور BMC

chassis

status

اطلاعات مربوط به وضعیت سطح‌بالای شاسی سیستم و زیرسیستم برق اصلی را نمایش می‌دهد.

poh

این دستور شمارنده ساعات روشن بودن دستگاه (Power-On Hours) را برمی‌گرداند.

identify <interval>

چراغ شناسایی (identify) پنل جلویی را کنترل می‌کند. بازه زمانی پیش‌فرض ۱۵ ثانیه است. از 0 برای خاموش کردن استفاده کنید. برای روشن ماندن نامحدود از "force" استفاده کنید..TP restart_cause

پرس‌وجو از شاسی برای یافتن علت آخرین راه‌اندازی مجدد سیستم.

selftest

بررسی سلامت پایه‌ای BMC از طریق اجرای دستور دریافت نتایج خودآزمایی (Get Self Test results) و گزارش نتایج آن.

policy

تنظیم خط‌مشی برق شاسی در هنگام وقوع قطعی برق.

list: بازگرداندن خط‌مشی‌های پشتیبانی‌شده.
always-on: روشن شدن هنگام وصل مجدد برق.
previous: بازگشت به وضعیت قبلی هنگام وصل مجدد برق.
always-off: خاموش ماندن پس از وصل مجدد برق.

power: اجرای یک دستور کنترلی شاسی برای مشاهده و تغییر وضعیت برق.

status: نمایش وضعیت کنونی برق شاسی.
on: روشن کردن شاسی.
off: خاموش کردن شاسی و انتقال به خاموشی نرم (وضعیت S4/S5). هشدار: این دستور پیش از خاموش کردن سیستم، یک خاموش‌سازی تمیز (clean shutdown) برای سیستم‌عامل آغاز نمی‌کند.
cycle: یک بازهٔ خاموشی حداقل ۱ ثانیه‌ای ایجاد می‌کند. اگر برق شاسی در وضعیت S4/S5 باشد نباید هیچ عملی رخ دهد، اما توصیه می‌شود ابتدا وضعیت برق بررسی شود و تنها در صورتی که برق سیستم روشن است یا در وضعیت خواب پایین‌تری نسبت به S4/S5 قرار دارد، دستور چرخهٔ برق (power cycle) صادر گردد.
reset: این دستور یک بازنشانی سخت‌افزاری (hard reset) انجام می‌دهد.
diag: ارسال پالس وقفهٔ عیب‌یابی (NMI) مستقیماً به پردازنده‌(ها).
soft: آغاز خاموش‌سازی نرم سیستم‌عامل از طریق ACPI. این کار می‌تواند به روش‌های گوناگونی انجام شود، معمولاً با شبیه‌سازی افزایش بیش‌ازحد دما یا شبیه‌سازی فشردن دکمهٔ روشن/خاموش. برای کارکرد این قابلیت خاموش‌سازی نرم، سیستم‌عامل باید از ACPI پشتیبانی کند و نوعی دیمن ناظر بر رویدادها در حال اجرا باشد.

bootdev <device> [<clear-cmos=yes|no>] [<options=help,...>]: درخواست از سیستم برای راه‌اندازی (بوت) از یک دستگاه بوت جایگزین در راه‌اندازی مجدد بعدی. گزینهٔ clear-cmos در صورت مشخص شدن، به BIOS دستور می‌دهد تا در راه‌اندازی مجدد بعدی CMOS خود را پاک کند. می‌توان از گزینه‌های مختلفی برای تغییر تنظیمات دستگاه بوت استفاده کرد. برای دریافت فهرستی از گزینه‌ها/اصلاح‌کننده‌های موجود دستگاه بوت، دستور "bootdev none options=help" را اجرا کنید.

مقدارهای کنونی پشتیبانی‌شده برای <device> عبارتند از:
none: عدم تغییر دستگاه بوت
pxe: راه‌اندازی اجباری از PXE
disk: راه‌اندازی اجباری از دستگاه بوت پیش‌فرض BIOS
safe: راه‌اندازی اجباری از دستگاه بوت پیش‌فرض BIOS با درخواست حالت امن (Safe Mode)
diag: راه‌اندازی اجباری از پارتیشن عیب‌یابی
cdrom: راه‌اندازی اجباری از CD/DVD
bios: راه‌اندازی اجباری به صفحهٔ تنظیمات BIOS
floppy: راه‌اندازی اجباری از فلاپی/رسانهٔ جداشدنی اصلی

bootparam: دریافت یا تنظیم پارامترهای گوناگون گزینه‌های بوت سیستم.

get <param #>

دریافت پارامتر بوت. مقدارهای کنونی پشتیبانی‌شده برای <param #> عبارتند از:

0 - Set In Progress

1 - Service Partition Selector

2 - Service Partition Scan

3 - BMC Boot Flag Valid Bit Clearing

4 - Boot Info Acknowledge

5 - Boot Flags

6 - Boot Initiator Info

7 - Boot Initiator Mailbox

set <device> [<options=help,...>]

تنظیم پارامتر دستگاه بوت مورداستفاده برای بوت بعدی. گزینه‌های مختلفی می‌توانند برای تغییر زمان پاک شدن دستگاه بوت بعدی استفاده شوند. برای دریافت فهرستی از گزینه‌های موجودِ تنظیم دستگاه bootparam، دستور "options=help" را اجرا کنید.

تنظیمات پشتیبانی‌شدهٔ کنونی برای device در bootparam عبارتند از:

force_pxe

راه‌اندازی اجباری از PXE

force_disk

راه‌اندازی اجباری از دیسک سخت پیش‌فرض

force_safe

راه‌اندازی اجباری از دیسک سخت پیش‌فرض با درخواست Safe Mode.TP force_diag

اجبار به راه‌اندازی از پارتیشن عیب‌یابی (diagnostic)

force_cdrom

اجبار به راه‌اندازی از CD/DVD

force_bios

اجبار به ورود به تنظیمات BIOS هنگام راه‌اندازی

تنظیمات options در حال حاضر پشتیبانی‌شده برای bootparam با پاک‌سازی بیت معتبر راه‌اندازی BMC (BMC Boot Valid Bit Clearing) مرتبط هستند و به شرح زیر می‌باشند: هر گزینه‌ای می‌تواند با پیشوند "no-" همراه شود تا مفهوم عملیات معکوس گردد.
PEF: پاک‌سازی بیت معتبر در هنگام بازنشانی یا چرخه برق ناشی از PEF
timeout: پاک‌سازی خودکار بیت معتبر پرچم راه‌اندازی در صورتی که دستور Chassis Control ظرف 60 ثانیه دریافت نشود.
watchdog: پاک‌سازی بیت معتبر در هنگام بازنشانی یا چرخه برق ناشی از اتمام زمان watchdog
reset: پاک‌سازی بیت معتبر در هنگام بازنشانی با دکمه فشاری یا بازنشانی نرم‌افزاری (soft-reset)
power: پاک‌سازی بیت معتبر در هنگام روشن شدن از طریق دکمه فشاری پاور یا رویداد بیدارباش (wake event)

nm

alert

clear dest <dest>: پاک کردن مقصد شبکه محلی (lan destination) برای هشدار Node Manager.

get: دریافت تنظیمات هشدار Node Manager.

set chan <chan> dest <dest> string <string>: تنظیم کانال هشدار، مقصد شبکه محلی (lan destination) و شماره رشته هشدار برای Node Manager.

capability: دریافت قابلیت‌ها و محدوده‌های کنترل مصرف برق Node Manager.
control

enable|disable

global: فعال/غیرفعال کردن تمام خط‌مشی‌ها برای همه دامنه‌ها.
per_domain <platform|CPU|Memory>: فعال/غیرفعال کردن تمام خط‌مشی‌های دامنه مشخص‌شده.
per_policy <0-7>: فعال/غیرفعال کردن خط‌مشی برای ترکیب دامنه/خط‌مشی مشخص‌شده.

discover: شناسایی حضور Node Manager و همچنین نسخه، بازبینی (revision) و شماره وصله (patch number) مربوط به Node Manager.
policy

add

power <watts> policy_id <0-7> [correction auto|soft|hard] trig_lim <seconds> stats <seconds> [domain <platform|CPU|Memory>] enable|disable: افزودن یک خط‌مشی توان جدید یا بازنویسی یک خط‌مشی موجود. پارامتر correction شدت محدودسازی فرکانس را تعیین می‌کند؛ مقدار پیش‌فرض auto است. پارامتر trig_lim محدودیت زمانی تصحیح است و باید حداقل 6000 و حداکثر 65535 باشد. تنظیم stats دوره میانگین‌گیری بر حسب ثانیه است و در محدوده 1-65535 قرار دارد. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.
inlet <temp> policy_id <0-7> [correction auto|soft|hard] trig_lim <seconds> stats <seconds> [domain <platform|CPU|Memory>] enable|disable: افزودن یک خط‌مشی جدید برای دمای ورودی (inlet temp) یا بازنویسی یک خط‌مشی موجود. پارامتر correction شدت محدودسازی فرکانس را تعیین می‌کند؛ مقدار پیش‌فرض auto است. پارامتر trig_lim محدودیت زمانی تصحیح است و باید حداقل 6000 و حداکثر 65535 باشد. تنظیم stats دوره میانگین‌گیری بر حسب ثانیه است و در محدوده 1-65535 قرار دارد. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.

get policy_id <0-7>: دریافت یک خط‌مشی از پیش ذخیره‌شده.
limiting: گزارش شماره خط‌مشی در صورتی که هر خط‌مشی‌ای در حال محدود کردن توان باشد.
remove policy_id <0-7> [domain <platform|CPU|Memory>]: حذف یک خط‌مشی. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.

power min <minimum> max <maximum> [domain <platform|CPU|Memory>]: پیکربندی حدود حداقل و حداکثر مصرف توان Node Manager. مقادیر min و max باید در محدوده 0-65535 باشند. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.

reset

comm policy_id <0-7> [domain <platform|CPU|Memory>]

بازنشانی آمار ارتباطات (communication) مربوط به Node Manager. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.

global

بازنشانی آمار سراسری (global) مربوط به Node Manager.

memory policy_id <0-7> [domain <platform|CPU|Memory>]

بازنشانی آمار تعدیل فرکانس حافظه (memory throttling) در Node Manager. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.

per_policy policy_id <0-7> [domain <platform|CPU|Memory>]

بازنشانی آمار به ازای خط‌مشی (per policy) در Node Manager. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود.

requests policy_id <0-7> [domain <platform|CPU|Memory>]

بازنشانی آمار درخواست‌های رسیدگی‌نشده (unhandled requests) در Node Manager. اگر domain مشخص نشود، مقدار پیش‌فرض platform استفاده می‌شود..TP response policy_id <0-7> [domain <platform|CPU|Memory>]

بازنشانی آمار زمان پاسخ (response time) در Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.

throttling policy_id <0-7> [domain <platform|CPU|Memory>]

بازنشانی آمار throttling در Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.

statistics

comm_fail: گزارش آمار خطاهای ارتباطی در Node Manager.
cpu_throttling: گزارش آمار throttling پردازنده در Node Manager.
mem_throttling: گزارش آمار throttling حافظه در Node Manager.
policy_power policy_id <0-7> [domain <platform|CPU|Memory>]: گزارش آمار توان مصرفی به ازای هر سیاست در Node Manager (نوع سیاست باید از نوع محدودیت توان یا power limit باشد). در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.
policy_temps policy_id <0-7> [domain <platform|CPU|Memory>]: گزارش آمار دمای به ازای هر سیاست در Node Manager (نوع سیاست باید از نوع محدودیت دمای ورودی یا inlet temp limit باشد). در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.
policy_throt policy_id <0-7> [domain <platform|CPU|Memory>]: گزارش آمار throttling به ازای هر سیاست در Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.
requests: گزارش آمار درخواست‌های رسیدگی‌نشده در Node Manager.
response: گزارش آمار زمان پاسخ در Node Manager.

suspend

get policy_id <0-7> [domain <platform|CPU|Memory>]: دریافت دوره‌های تعلیق (suspend periods) سیاست Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.
set policy_id <0-7> [domain <platform|CPU|Memory>] <start> <stop> <repeat>: تنظیم دوره‌های تعلیق سیاست Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود. مقادیر <start> و <stop> باید در بازه 0-239 باشند که بیانگر تعداد دقیقه‌های سپری‌شده از نیمه‌شب تقسیم بر ۶ است. مقدار <repeat> الگوی تکرار روزانه است. بیت ۰ تکرار در هر دوشنبه، بیت ۱ تکرار در هر سه‌شنبه، تا بیت ۶ برای یکشنبه است.

threshold

get policy_id <0-7> [domain <platform|CPU|Memory>]: دریافت تنظیمات آستانه هشدار (Alert Threshold) سیاست Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود.
set policy_id <0-7> [domain <platform|CPU|Memory>] thresh_array: تنظیم مقادیر آستانه هشدار (Alert Threshold) سیاست Node Manager. در صورت مشخص نشدن domain، به‌طور پیش‌فرض از platform استفاده می‌شود. آرگومان thresh_array شامل ۱، ۲ یا ۳ عدد صحیح است که سه تنظیم آستانه هشدار را تعیین می‌کنند. نوع مقدار تنظیمی یک مقدار توان یا دما است که باید با نوع سیاست مطابقت داشته باشد.

pef

info: این دستور از BMC استعلام گرفته و اطلاعات مربوط به قابلیت‌های پشتیبانی‌شده‌ی PEF را نمایش می‌دهد.
status: این دستور وضعیت فعلی PEF (آخرین مدخل SEL پردازش‌شده توسط BMC و غیره) را نمایش می‌دهد.
policy: این دستور مدخل‌های جدول سیاست PEF را فهرست می‌کند. هر مدخل سیاست یک مقصد هشدار را توصیف می‌کند. یک مجموعه سیاست (policy set) مجموعه‌ای از مدخل‌های جدول است. اقدامات هشدار PEF به مجموعه‌های سیاست ارجاع می‌دهند.
list: این دستور مدخل‌های جدول PEF را فهرست می‌کند. هر مدخل PEF یک رویداد حسگر را به یک کنش مرتبط می‌سازد. هنگامی که PEF فعال است، هر رویداد پلتفرم موجب می‌شود BMC این جدول را برای یافتن مدخل‌های منطبق با رویداد و کنش‌های ممکن برای اجرا بررسی کند. کنش‌ها به ترتیب اولویت انجام می‌شوند (ابتدا موارد با درجه بحرانی بالاتر).

picmg <properties>

اجرای یک دستور گسترش‌یافته‌ی PICMG/ATA. ویژگی‌های Get PICMG می‌تواند برای دریافت و چاپ اطلاعات نسخه اصلی افزونه (Extension major version)، شناسه PICMG، شناسه FRU Device ID و Max FRU Device ID استفاده شود.

addrinfo: دریافت اطلاعات آدرس. این دستور ممکن است اطلاعاتی درباره آدرس سخت‌افزار، آدرس IPMB-0، شناسه FRU ID، شناسه Site/Entity ID و Site/Entity Type بازگرداند.
frucontrol <fru id> <options>: تنظیم گزینه‌های کنترلی گوناگون:

0x00 - راه‌اندازی مجدد سرد (Cold Reset)
0x01 - راه‌اندازی مجدد گرم (Warm Reset)
0x02 - راه‌اندازی مجدد آرام (Graceful Reboot)
0x03 - ارسال وقفه عیب‌یابی (Issue Diagnostic Interrupt)
0x04 - تعلیق موقت فعالیت‌ها (Quiesce) [فقط AMC]
0x05-0xFF - راه‌اندازی مجدد سرد (Cold Reset)

activate <fru id>: فعال‌سازی FRU مشخص‌شده.
deactivate <fru id>: غیرفعال‌سازی FRU مشخص‌شده.
policy get <fru id>: دریافت سیاست فعال‌سازی FRU.
policy set <fru id> <lockmask> <lock>: تنظیم سیاست فعال‌سازی FRU. آرگومان lockmask مقدار ۱ یا ۰ است که به ترتیب کنش روی بیت قفل غیرفعال‌سازی یا فعال‌سازی را مشخص می‌کند. آرگومان lock مقدار ۱ یا ۰ برای تنظیم/پاک کردن (set/clear) بیت قفل است..TP portstate set|getall|getgranted|getdenied <parameters>
دریافت یا تنظیم وضعیت‌های مختلف پورت. برای جزئیات پارامترها به راهنمای نحوهٔ استفاده مراجعه کنید.

power <chassis power command>: میانبری برای دستورهای chassis power. برای اطلاعات نحوهٔ استفاده، دستورهای chassis power را ببینید.

raw <netfn> <cmd> [<data>]

این دستور به شما امکان می‌دهد دستورهای خام IPMI را اجرا کنید. برای مثال، برای پرس‌وجوی شمارندهٔ POH با یک دستور خام:

> ipmitool -v raw 0x0 0xf
RAW REQ (netfn=0x0 cmd=0xf data_len=0)
RAW RSP (5 bytes)
3c 72 0c 00 00

توجه داشته باشید که درایور OpenIPMI ارائه‌شده توسط هستهٔ Linux، دستورهای Get Message،‏ Send Message و Read Event Message Buffer را رد خواهد کرد؛ زیرا ترتیب‌بندی پیام‌ها را به صورت داخلی مدیریت می‌کند.

sdr

get <id> ... [<id>]

اطلاعات رکوردهای داده‌های حسگر (SDR) مشخص‌شده با شناسهٔ حسگر را چاپ می‌کند.

info

این دستور اطلاعات مخزن رکورد داده‌های حسگر (SDR Repository) را از BMC استعلام می‌کند.

type [<sensor type>]

این دستور تمام رکوردهای یک نوع خاص را از مخزن SDR نمایش می‌دهد. برای مشاهدهٔ فهرست انواع موجود، آن را با نوع list (یا بدون مشخص کردن نوع) اجرا کنید. به عنوان مثال، برای پرس‌وجوی تمام حسگرهای Temperature (دما):

> ipmitool sdr type Temperature
Baseboard Temp | 30h | ok | 7.1 | 28 degrees C
FntPnl Amb Temp | 32h | ok | 12.1 | 24 degrees C
Processor1 Temp | 98h | ok | 3.1 | 57 degrees C
Processor2 Temp | 99h | ok | 3.2 | 53 degrees C

این دستور رکوردهای داده‌های حسگر (SDR) را خوانده و اطلاعات حسگر مربوط به یک نوع مشخص را استخراج می‌کند، سپس هر حسگر را استعلام کرده و نام، مقدار خوانده‌شده و وضعیت آن را چاپ می‌کند. اگر به صورت elist فراخوانی شود، شمارهٔ حسگر، شناسه و نمونهٔ موجودیت (entity id and instance)، و وضعیت‌های مجزای فعال‌شده را نیز چاپ خواهد کرد.

خروجی پیش‌فرض فقط انواع حسگر full و compact را نمایش می‌دهد؛ برای دیدن تمام حسگرها از نوع all با این دستور استفاده کنید.

انواع معتبر عبارتند از:

all: تمام رکوردهای SDR (حسگر و مکان‌یاب)
full: رکورد حسگر کامل (Full Sensor Record)
compact: رکورد حسگر فشرده (Compact Sensor Record)
event: رکورد حسگر فقط-رویداد (Event-Only Sensor Record)
mcloc: رکورد مکان‌یاب کنترل‌کنندهٔ مدیریت (Management Controller Locator Record)
fru: رکورد مکان‌یاب FRU
generic: رکوردهای عمومی SDR

entity <id>[.<instance>]: تمام حسگرهای مرتبط با یک موجودیت (entity) را نمایش می‌دهد. با اجرای دستور sdr elist فهرستی از شناسه‌های معتبر موجودیت را در سیستم هدف دریافت کنید. فهرستی از تمام شناسه‌های موجودیت در مشخصات IPMI یافت می‌شود.
dump <file>: داده‌های خام SDR را در یک فایل ذخیره می‌کند (dump). سپس این فایل داده می‌تواند به عنوان حافظهٔ موقت (cache) محلی SDR سیستم هدف با گزینهٔ -S <file> در خط فرمان ipmitool استفاده شود. این کار می‌تواند کارایی را در رابط سیستم یا LAN ازراه‌دور به میزان چشمگیری بهبود بخشد.
fill sensors: مخزن SDR را برای پیکربندی فعلی ایجاد می‌کند. این دستور یک فرمان 'Clear SDR Repository' اجرا خواهد کرد، بنابراین احتیاط کنید.
fill file <filename>: مخزن SDR را با استفاده از رکوردهای ذخیره‌شده در یک فایل دادهٔ باینری پر می‌کند. این دستور یک فرمان 'Clear SDR Repository' اجرا خواهد کرد، بنابراین احتیاط کنید.

sel: نکته: در صورتی که ساعت SEL نیاز به تنظیم داشته باشد، زمان‌های ورودی گزارش وقایع سیستم (SEL) به صورت “Pre-Init Time-stamp” نمایش داده می‌شوند. با فراخوانی دستورهای sel time get و sel time set <time string> از دقیق بودن ساعت SEL اطمینان حاصل کنید.

info: این دستور اطلاعات مربوط به گزارش وقایع سیستم (SEL) و محتویات آن را از BMC استعلام می‌کند.
clear: این دستور محتویات SEL را پاک می‌کند. این عملیات غیرقابل بازگشت است، بنابراین احتیاط کنید.
list | elist: هنگامی که این دستور بدون آرگومان فراخوانی شود، کل محتویات گزارش وقایع سیستم نمایش داده می‌شود. اگر به صورت elist (فهرست گسترش‌یافته) فراخوانی شود، از ورودی‌های رکورد داده‌های حسگر نیز برای نمایش شناسهٔ حسگری که باعث بروز هر رویداد شده استفاده می‌کند. توجه داشته باشید که این کار از طریق رابط سیستم ممکن است زمان زیادی ببرد.

<count> | first <count>: تعداد count ورودی نخست (قدیمی‌ترین‌ها) را در SEL نمایش می‌دهد. اگر count صفر باشد، تمام ورودی‌ها نمایش داده می‌شوند.
last <count>: تعداد count ورودی پایانی (جدیدترین‌ها) را در SEL نمایش می‌دهد. اگر count صفر باشد، تمام ورودی‌ها نمایش داده می‌شوند.

delete <SEL Record ID> ... <SEL Record ID>

یک یا چند رکورد رویداد SEL را حذف می‌کند.

add <filename ID>

ورودی‌های رویداد را از یک فایل می‌خواند و آن‌ها را به SEL اضافه می‌کند. ورودی‌های جدید SEL پس از آخرین رکورد در SEL افزوده می‌شوند. رکورد اضافه‌شده از نوع ۲ بوده و به صورت خودکار برچسب زمانی می‌خورد..TP get <SEL Record ID>

اطلاعات مربوط به مدخل رکورد SEL مشخص‌شده را نمایش می‌دهد.

save <file>

رکوردهای SEL را در یک فایل متنی ذخیره می‌کند که می‌تواند مجدداً به دستور event file در ipmitool داده شود. این قابلیت می‌تواند برای آزمایش تولید رخداد (Event) از طریق ساخت یک فایل مناسب از پیام‌های رخداد پلتفرم (Platform Event Message) بر اساس رخدادهای موجود، مفید باشد. لطفاً برای توضیحات قالب این فایل، به راهنمای موجود برای دستور '... event file' مراجعه کنید.

writeraw <file>

رکوردهای SEL را در یک فایل با قالب خام و باینری ذخیره می‌کند. این فایل را می‌توان برای مشاهده، دوباره به دستور sel readraw در ipmitool داد.

readraw <file>

خواندن و نمایش رکوردهای SEL از یک فایل باینری. چنین فایلی را می‌توان با استفاده از دستور sel writeraw در ipmitool ایجاد کرد.

time

get: زمان فعلی ساعت SEL را نمایش می‌دهد.
set <time string>: ساعت SEL را تنظیم می‌کند. مدخل‌های آتی SEL از زمان تنظیم‌شده توسط این دستور استفاده خواهند کرد. <time string> به قالب "MM/DD/YYYY HH:MM:SS" است. توجه داشته باشید که ساعت‌ها در قالب ۲۴-ساعته هستند. توصیه می‌شود پیش از تنظیم زمان، SEL پاک‌سازی شود.

sensor

list: فهرست کردن حسگرها و آستانه‌ها در قالبی از یک جدول عریض.
get <id> ... [<id>]: اطلاعات حسگرهایی که با نام مشخص شده‌اند را نمایش می‌دهد.
thresh <id> <threshold> <setting>: امکان تنظیم مقدار یک آستانه خاص برای حسگر را فراهم می‌کند. حسگر با نام مشخص می‌شود.

مقادیر مجاز thresholds عبارتند از:: unr غیرقابل‌بازیابی بالایی (Upper Non-Recoverable)
ucr بحرانی بالایی (Upper Critical)
unc غیربحرانی بالایی (Upper Non-Critical)
lnc غیربحرانی پایینی (Lower Non-Critical)
lcr بحرانی پایینی (Lower Critical)
lnr غیرقابل‌بازیابی پایینی (Lower Non-Recoverable)

thresh <id> lower <lnr> <lcr> <lnc>: امکان تنظیم هم‌زمان تمامی آستانه‌های پایینی یک حسگر را فراهم می‌کند. حسگر با نام مشخص شده و آستانه‌ها به ترتیبِ غیرقابل‌بازیابی پایینی، بحرانی پایینی، و غیربحرانی پایینی درج می‌شوند.
thresh <id> upper <unc> <ucr> <unr>: امکان تنظیم هم‌زمان تمامی آستانه‌های بالایی یک حسگر را فراهم می‌کند. حسگر با نام مشخص شده و آستانه‌ها به ترتیبِ غیربحرانی بالایی، بحرانی بالایی، و غیرقابل‌بازیابی بالایی درج می‌شوند.

session

info <active|all|id 0xnnnnnnnn|handle 0xnn>: دریافت اطلاعات درباره نشست(ها)ی مشخص‌شده. می‌توانید نشست‌ها را با شناسه (id)، با شماره دستگیره (handle)، با وضعیت فعال بودن، یا با استفاده از کلمه کلیدی «all» برای مشخص کردن همه نشست‌ها تعیین کنید.

set

hostname <host>: نام میزبان نشست.
username <user>: نام کاربری نشست.
password <pass>: گذرواژه نشست.
privlvl <level>: اجبار سطح دسترسی نشست (privilege level).
authtype <type>: اجبار نوع احراز هویت.
localaddr <addr>: نشانی محلی IPMB.
targetaddr <addr>: نشانی مقصد دوردست IPMB.
port <port>: درگاه دوردست RMCP.
csv [level]: فعال‌سازی خروجی در قالب مقادیر جداشده با کاما (CSV). بر دستورهای زیر تأثیر می‌گذارد: user، channel، isol، sunoem، sol، sensor، sdr، sel، session.
verbose [verbose]: سطح پرگویی (میزان جزئیات خروجی).

shell

این دستور یک پوسته تعاملی را اجرا می‌کند که می‌توانید از آن برای ارسال چندین دستور ipmitool به یک BMC و مشاهده پاسخ‌ها استفاده کنید. این کار می‌تواند به‌جای اجرای کامل دستور ipmitool در هر بار، بسیار کاربردی باشد. برخی دستورها از حافظه موقت (کَش) Sensor Data Record استفاده می‌کنند و چنانچه این دستورها بتوانند از همان کَش در نشست پوسته استفاده مجدد کنند، متوجه بهبود چشمگیری در سرعت خواهید شد. نشست‌های LAN یک دستور دوره‌ای نگه‌داری ارتباط (keepalive) ارسال می‌کنند تا از وقفه زمانی نشست IPMI جلوگیری شود.

sol

info [<channel number>]: بازیابی اطلاعات مربوط به پیکربندی Serial-Over-LAN روی کانال مشخص‌شده. اگر کانالی داده نشود، داده‌های پیکربندی SOL برای کانال جاریِ مورد استفاده نمایش داده خواهد شد.
payload <enable | disable | status> <channel number> <userid>: فعال‌سازی، غیرفعال‌سازی یا نمایش وضعیت پی‌لود (payload) پروتکل SOL برای کاربر روی کانال مشخص‌شده.
set <parameter> <value> [<channel>]: پیکربندی پارامترها برای Serial Over Lan. اگر کانالی داده نشود، داده‌های پیکربندی SOL برای کانال جاریِ مورد استفاده را نمایش می‌دهد. به‌روزرسانی پارامترهای پیکربندی به‌طور خودکار با به‌روزرسانی‌های پارامتر set-in-progress محافظت می‌شوند.

پارامترها و مقادیر معتبر عبارتند از:
set-in-progress: set-complete set-in-progress commit-write
enabled: true false.TP force-encryption true false
force-authentication: true false
privilege-level: user operator admin oem
character-accumulate-level: عدد ده‌دهی با گام‌های ۵ میلی‌ثانیه‌ای
character-send-threshold: عدد ده‌دهی
retry-count: عدد ده‌دهی. مقدار ۰ نشان‌دهنده عدم تلاش مجدد پس از ارسال بسته است.
retry-interval: عدد ده‌دهی با گام‌های ۱۰ میلی‌ثانیه‌ای. مقدار ۰ نشان می‌دهد که تلاش‌های مجدد باید بلافاصله و پشت سر هم ارسال شوند.
non-volatile-bit-rate: serial، 19.2، 38.4، 57.6، 115.2. تنظیم این مقدار روی serial مشخص می‌کند که BMC باید از پیکربندی استفاده‌شده توسط کانال IPMI over serial استفاده کند.
volatile-bit-rate: serial، 19.2، 38.4، 57.6، 115.2. تنظیم این مقدار روی serial مشخص می‌کند که BMC باید از پیکربندی استفاده‌شده توسط کانال IPMI over serial استفاده کند.

activate [usesolkeepalive | nokeepalive] [instance=<number>]

باعث می‌شود که ipmitool وارد حالت Serial Over LAN شود و تنها هنگام استفاده از رابط lanplus در دسترس است. یک اتصال RMCP+ با BMC برقرار شده، پایانه روی حالت خام (raw) تنظیم می‌شود و ورودی کاربر به کنسول سریال روی کارساز دوردست فرستاده می‌شود. هنگام خروج، حالت بار مفید (payload) SOL غیرفعال شده و پایانه به تنظیمات اولیه خود بازگردانده می‌شود.

اگر instance مشخص شده باشد، با استفاده از شماره نمونه مشخص‌شده فعال خواهد شد. مقدار پیش‌فرض ۱ است.

دنباله‌های گریز (escape sequences) ویژه‌ای برای کنترل نشست SOL در نظر گرفته شده است:

~. خاتمه دادن به اتصال
~^Z تعلیق ipmitool
~^X تعلیق ipmitool، اما بدون بازگردانی tty پس از راه‌اندازی مجدد
~B ارسال break
~~ ارسال نویسه گریز با تایپ دوباره آن
~? چاپ دنباله‌های گریز پشتیبانی‌شده

توجه داشته باشید که دنباله‌های گریز تنها بلافاصله پس از خط جدید (newline) شناسایی می‌شوند.

deactivate [instance=<number>]

حالت Serial Over LAN را روی BMC غیرفعال می‌کند. خروج از حالت Serial Over LAN باید به‌طور خودکار باعث ارسال این دستور به BMC شود، اما در صورت خروج ناخواسته از حالت SOL، این دستور ممکن است برای بازنشانی وضعیت BMC لازم باشد.

اگر instance مشخص شده باشد، شماره نمونه مشخص‌شده را غیرفعال خواهد کرد. مقدار پیش‌فرض ۱ است.

spd <i2cbus> <i2caddr> [<channel>] [<axread>]: این دستور می‌تواند برای خواندن داده‌های SPD (Serial Presence Detect) با استفاده از دستور IPMI از نوع I2C Master Write-Read استفاده شود.
sunoem

cli [<command string> ...]: اجرای دستورات رابط خط فرمان پردازشگر خدمات (service processor). بدون تعیین هرگونه رشته دستور، یک نشست تعاملی در محیط خط فرمان پردازشگر خدمات آغاز می‌شود. در صورت تعیین رشته دستور، آن رشته روی پردازشگر خدمات اجرا شده و اتصال بسته می‌شود.
led

این دستورات روشی برای دریافت و تنظیم وضعیت LEDها روی یک کارساز Sun Microsystems فراهم می‌کنند. از 'sdr list generic' برای دریافت فهرست دستگاه‌هایی که LEDهای قابل کنترل دارند استفاده کنید. پارامتر ledtype اختیاری است و نیازی به وارد کردن آن در خط فرمان نیست، مگر اینکه توسط سخت‌افزار الزامی شده باشد.

get <sensorid> [<ledtype>]: دریافت وضعیت یک LED خاص که با رکورد Generic Device Locator در SDR توصیف شده است. مقدار all برای sensorid، وضعیت تمام LEDهای موجود را دریافت خواهد کرد.
set <sensorid> <ledmode> [<ledtype>]: تنظیم وضعیت یک LED خاص که با رکورد Generic Device Locator در SDR توصیف شده است. مقدار all برای sensorid، وضعیت تمام LEDهای موجود را روی ledmode و ledtype مشخص‌شده تنظیم می‌کند.
حالت LED (LED Mode) برای عملیات set الزامی است:: OFF خاموش
ON روشن مداوم
STANDBY نرخ چشمک‌زن ۱۰۰ میلی‌ثانیه روشن، ۲۹۰۰ میلی‌ثانیه خاموش
SLOW نرخ چشمک‌زن ۱ هرتز
FAST نرخ چشمک‌زن ۴ هرتز
نوع LED (LED Type) اختیاری است:: OK2RM Ok to Remove (آماده برای جداسازی)
SERVICE Service Required (نیازمند سرویس)
ACT Activity (فعالیت)
LOCATE Locate (مکان‌یابی)

nacname <ipmi name>

نام کامل NAC هدفی که توسط ipmi name مشخص شده است را برمی‌گرداند.

ping <count> [<q>]

ارسال و دریافت بسته‌ها به تعداد count. هر بسته ۶۴ بایت است.

q - بی‌صدا (Quiet). خروجی را تنها در ابتدا و انتهای فرایند نمایش می‌دهد.

getval <property name>

مقدار ویژگی (property) مشخص‌شده در ILOM را برمی‌گرداند.

setval <property name> <property value> [<timeout>]

مقدار ویژگی ILOM را تنظیم می‌کند. در صورت عدم تعیین مهلت زمانی (timeout)، مقدار پیش‌فرض ۵ ثانیه است. نکته: setval باید به‌صورت محلی روی میزبان اجرا شود!

sshkey

set <userid> <keyfile>: این دستور به شما امکان می‌دهد یک کلید SSH برای استفاده توسط یک کاربر خاص روی پردازشگر خدمات (Service Processor) مشخص کنید. این کلید برای ورودهای CLI به SP استفاده می‌شود و برای نشست‌های IPMI کاربرد ندارد. کاربران موجود و شناسه‌های کاربری (userids) آن‌ها را با دستور 'user list' مشاهده کنید.
del <userid>: این دستور کلید SSH مربوط به userid مشخص‌شده را حذف می‌کند.

version: نسخه سفت‌افزار (firmware) ILOM را نمایش می‌دهد.
getfile <file identifier> <destination file name>: این دستور فایل‌های مختلف را از پردازشگر خدمات دریافت کرده و در فایل مقصد مشخص‌شده ذخیره می‌کند. توجه داشته باشید که ممکن است برخی از این فایل‌ها وجود نداشته باشند یا توسط SP شما پشتیبانی نشوند.

شناسه‌های فایل:

SSH_PUBKEYS
DIAG_PASSED
DIAG_FAILED
DIAG_END_TIME
DIAG_INVENTORY
DIAG_TEST_LOG
DIAG_START_TIME
DIAG_UEFI_LOG
DIAG_TEST_LOG
DIAG_LAST_LOG
DIAG_LAST_CMD

getbehavior <feature identifier>

این دستور بررسی می‌کند که آیا ویژگی‌های گوناگون ILOM فعال هستند یا خیر.

شناسه‌های ویژگی:

SUPPORTS_SIGNED_PACKAGES
REQUIRES_SIGNED_PACKAGES

tsol

این دستور امکان برقراری نشست‌های Serial-over-LAN را با Tyan IPMIv1.5 SMDC مانند M3289 یا M3290 فراهم می‌کند. اجرای پیش‌فرض دستور بدون هیچ آرگومانی، نشست پیش‌فرض SOL را به آدرس IP محلی برقرار می‌کند. آرگومان‌های اختیاری را می‌توان به هر ترتیبی وارد کرد.

<ipaddr>: آدرس IP گیرنده را به SMDC ارسال می‌کند که از آن برای فرستادن ترافیک سریال استفاده خواهد شد. به‌طور پیش‌فرض، این گزینه آدرس IP محلی را شناسایی کرده و یک نشست دوطرفه برقرار می‌کند. قالب ipaddr به‌صورت XX.XX.XX.XX است.
port=NUM: پورت UDP را برای دریافت ترافیک سریال پیکربندی می‌کند. به‌طور پیش‌فرض این مقدار 6230 است.
ro|rw: نشست SOL را به‌صورت فقط‌خواندنی (ro) یا خواندنی-نوشتنی (rw) پیکربندی می‌کند. نشست‌ها به‌طور پیش‌فرض خواندنی-نوشتنی هستند.

user

summary: خلاصه‌ای از اطلاعات userid را نمایش می‌دهد، شامل بیشینه تعداد useridها، تعداد کاربران فعال و تعداد نام‌های ثابت تعریف‌شده.
list: فهرستی از اطلاعات کاربران را برای تمام useridهای تعریف‌شده نمایش می‌دهد.
set

name <userid> <username>: نام کاربری مرتبط با userid داده‌شده را تنظیم می‌کند.
password <userid> [<password> [<16|20>]]: گذرواژه را برای userid داده‌شده تنظیم می‌کند. اگر گذرواژه‌ای مشخص نشود، گذرواژه پاک می‌شود (روی گذرواژه NULL تنظیم می‌شود). هنگام حذف گذرواژه‌ها از حساب‌های سطح مدیر سیستم (administrator-level) احتیاط کنید. در صورت مشخص شدن، 16 یا 20 حداکثر طول گذرواژه را تعیین می‌کند.

disable <userid>: دسترسی به BMC را برای userid داده‌شده غیرفعال می‌کند.
enable <userid>: دسترسی به BMC را برای userid داده‌شده فعال می‌کند.
priv <userid> <privilege level> [<channel number>]: سطح دسترسی کاربر را روی کانال مشخص‌شده تنظیم می‌کند. اگر کانال مشخص نشود، از کانال فعلی استفاده خواهد شد.
test <userid> <16|20> [<password>]: تعیین می‌کند که آیا گذرواژه به‌صورت ۱۶ بایتی یا ۲۰ بایتی ذخیره شده است یا خیر.

رابط OPEN (OPEN INTERFACE)

رابط ipmitool open از درایور دستگاه هسته OpenIPMI استفاده می‌کند. این درایور در تمام هسته‌های مدرن 2.4 و تمام هسته‌های 2.6 وجود دارد و باید در هسته توزیع‌های اخیر لینوکس نیز موجود باشد. همچنین وصله‌های هسته درایور IPMI برای نسخه‌های گوناگون هسته در صفحه خانگی OpenIPMI در دسترس هستند.

ماژول‌های مورد نیاز هسته برای هسته‌های 2.4 و 2.6 متفاوت است. ماژول‌های هسته زیر باید روی یک هسته مبتنی بر 2.4 بارگذاری شوند تا ipmitool کار کند:

ipmi_msghandler: مدیریت‌کننده پیام‌های ورودی و خروجی برای رابط‌های IPMI.
ipmi_kcs_drv: یک درایور رابط IPMI Keyboard Controller Style (KCS) برای مدیریت‌کننده پیام.
ipmi_devintf: رابط دستگاه نویسه‌ای (character device) لینوکس برای مدیریت‌کننده پیام.

ماژول‌های هسته زیر باید روی یک هسته مبتنی بر 2.6 بارگذاری شوند تا ipmitool کار کند:

ipmi_msghandler: مدیریت‌کننده پیام‌های ورودی و خروجی برای رابط‌های IPMI.
ipmi_si: یک درایور رابط سیستمی IPMI برای مدیریت‌کننده پیام. این ماژول از رابط‌های سیستمی گوناگون IPMI مانند KCS، BT، SMIC و حتی SMBus در هسته‌های 2.6 پشتیبانی می‌کند.
ipmi_devintf: رابط دستگاه نویسه‌ای لینوکس برای مدیریت‌کننده پیام.

پس از بارگذاری ماژول‌های لازم، یک مدخل دستگاه نویسه‌ای پویا ایجاد می‌شود که باید در /dev/ipmi0 وجود داشته باشد. برای سیستم‌هایی که از devfs یا udev استفاده می‌کنند، این مدخل در /dev/ipmi/0 نمایش داده خواهد شد.

برای ساخت گره دستگاه، ابتدا با بررسی /proc/devices و بررسی مدخل ipmidev، شماره اصلی (major number) پویایی را که هسته به آن اختصاص داده است مشخص کنید. معمولاً اگر این نخستین دستگاه پویا باشد، شماره اصلی 254 خواهد بود و شماره فرعی (minor number) برای نخستین رابط سیستمی 0 است؛ بنابراین می‌توانید مدخل دستگاه را با این دستور بسازید:

mknod /dev/ipmi0 c 254 0

برنامه ipmitool شامل چند اسکریپت راه‌اندازی نمونه است که می‌توانند این کار را به‌طور خودکار هنگام راه‌اندازی سیستم (start-up) انجام دهند.

برای اینکه ipmitool از رابط دستگاه OpenIPMI استفاده کند، می‌توانید آن را در خط فرمان مشخص کنید:

> ipmitool -I open <command>.SH "رابط BMC (BMC INTERFACE)" رابط bmc در ipmitool از درایور دستگاه bmc ارائه‌شده در Solaris 10 و بالاتر استفاده می‌کند. برای وادار کردن ipmitool به استفاده از این رابط، می‌توانید آن را در خط فرمان مشخص کنید:

> ipmitool -I bmc <command>

فایل‌های زیر با درایور bmc مرتبط هستند:

/platform/i86pc/kernel/drv/bmc: ماژول ۳۲ بیتی هسته در قالب ELF برای درایور bmc.
/platform/i86pc/kernel/drv/amd64/bmc: ماژول ۶۴ بیتی هسته در قالب ELF برای درایور bmc.
/dev/bmc: گره دستگاه نویسه‌ای که برای ارتباط با درایور bmc به کار می‌رود.

رابط LIPMI (LIPMI INTERFACE)

رابط lipmi در ipmitool از درایور دستگاه هسته IPMI در Solaris 9 استفاده می‌کند. این رابط در Solaris 10 جای خود را به رابط bmc داده است. می‌توانید با مشخص کردن آن در خط فرمان، به ipmitool اعلام کنید از این رابط استفاده کند.

> ipmitool -I lipmi <expression>

رابط LAN (LAN INTERFACE)

رابط lan در ipmitool از طریق اتصال Ethernet LAN با استفاده از UDP بر بستر IPv4 با BMC ارتباط برقرار می‌کند. دیتگرام‌های UDP طوری قالب‌بندی شده‌اند که شامل پیام‌های درخواست/پاسخ IPMI به همراه سرآیندهای نشست IPMI و سرآیندهای RMCP باشند.

‏IPMI-over-LAN از نگارش ۱ پروتکل مدیریت کنترل از راه دور (RMCP) برای پشتیبانی از مدیریت پیش از سیستم‌عامل (pre-OS) و در غیاب سیستم‌عامل (OS-absent) استفاده می‌کند. ‏RMCP یک پروتکل درخواست-پاسخ است که با استفاده از دیتگرام‌های UDP به درگاه ۶۲۳ تحویل داده می‌شود.

رابط LAN یک اتصال چندنشستی احراز هویت‌شده است؛ پیام‌های تحویل داده‌شده به BMC می‌توانند (و باید) با یک پروتکل چالش/پاسخ (challenge/response) چه با گذرواژه/کلید مستقیم و چه با الگوریتم خلاصه‌ساز پیام MD5 احراز هویت شوند. ipmitool تلاش خواهد کرد با سطح دسترسی مدیر سیستم (administrator) متصل شود، زیرا این سطح دسترسی برای انجام عملکردهای توان شاسی (chassis power) الزامی است.

می‌توانید با گزینهٔ -I lan به ipmitool بگویید از رابط lan استفاده کند:

> ipmitool -I lan -H <hostname> [-U <username>] [-P <password>] <command>

برای استفاده از رابط lan با ipmitool، باید یک نام میزبان در خط فرمان مشخص شود. فیلد گذرواژه اختیاری است؛ اگر در خط فرمان گذرواژه‌ای تعیین نکنید، ipmitool تلاش خواهد کرد بدون احراز هویت متصل شود. اگر گذرواژه‌ای مشخص کنید، در صورت پشتیبانی توسط BMC از احراز هویت MD5 و در غیر این صورت از گذرواژه/کلید مستقیم استفاده خواهد کرد، مگر اینکه با یک گزینه در خط فرمان نادیده گرفته شود.

رابط LANPLUS (LANPLUS INTERFACE)

همانند رابط lan، رابط lanplus نیز از طریق اتصال Ethernet LAN با استفاده از UDP بر بستر IPv4 با BMC ارتباط برقرار می‌کند. تفاوت در این است که رابط lanplus از پروتکل +RMCP به شرح ارائه‌شده در مشخصات فنی IPMI v2.0 استفاده می‌کند. پروتکل +RMCP امکان احراز هویت بهبودیافته و بررسی‌های یکپارچگی داده‌ها را به همراه رمزنگاری و قابلیت حمل انواع متعددی از محموله‌ها (payloads) فراهم می‌آورد. پشتیبانی عمومی از Serial Over LAN مستلزم +RMCP است، بنابراین دستور ipmitool sol activate نیازمند استفاده از رابط lanplus می‌باشد.

برقراری نشست +RMCP از یک پروتکل متقارن چالش-پاسخ موسوم به RAKP (Remote Authenticated Key-Exchange Protocol) بهره می‌برد که امکان مذاکره بر سر گزینه‌های متعددی را فراهم می‌سازد. ipmitool هنوز به کاربر اجازه نمی‌دهد که مقدار هر گزینه را مشخص کند و به طور پیش‌فرض واضح‌ترین تنظیماتِ مشخص‌شده به عنوان الزامی در مشخصات فنی نگارش 2.0 را به کار می‌برد. کدهای HMAC احراز هویت و یکپارچگی با SHA1 تولید می‌شوند و رمزنگاری با AES-CBC-128 انجام می‌گیرد. ورود به سیستم بر اساس سطح نقش (Role-level) هنوز پشتیبانی نمی‌شود.

برای انجام توابع رمزنگاری و پشتیبانی از رابط lanplus، برنامه ipmitool باید با کتابخانهٔ OpenSSL پیوند (link) داده شده باشد. در صورتی که بسته‌های لازم یافت نشوند، این قابلیت‌ها کامپایل نشده و پشتیبانی نخواهند شد.

می‌توانید با گزینهٔ -I lanplus به ipmitool بگویید از رابط lanplus استفاده کند:

> ipmitool -I lanplus -H <hostname> [-U <username>] [-P <password>] <command>

برای استفاده از رابط lan با ipmitool، باید یک نام میزبان در خط فرمان مشخص شود. به استثنای گزینه‌های -A و -C، سایر گزینه‌های خط فرمان با موارد موجود برای رابط lan یکسان هستند.

گزینهٔ -C به شما امکان می‌دهد بر اساس شناسهٔ مجموعهٔ رمزشناسی (cipher suite ID) موجود در جدول ۲۰-۲۲ از مشخصات IPMIv2.0، الگوریتم‌های احراز هویت، یکپارچگی و رمزنگاری مورد استفاده برای نشست lanplus را تعیین کنید. مجموعه رمزشناسی پیش‌فرض 17 است که الگوریتم‌های احراز هویت RAKP-HMAC-SHA256، یکپارچگی HMAC-SHA256-128 و رمزنگاری AES-CBC-128 را مشخص می‌کند.

رابط FREE (FREE INTERFACE)

رابط free در ipmitool از درایورهای libfreeipmi مربوط به FreeIPMI بهره می‌برد.

می‌توانید با گزینهٔ -I به ipmitool اعلام کنید از رابط FreeIPMI استفاده کند:

> ipmitool -I free <command>.SH "رابط IMB (IMB INTERFACE)"

رابط imb در ipmitool از رابط Intel IMB (Intel Inter-module Bus) از طریق دستگاه /dev/imb پشتیبانی می‌کند.

می‌توانید با استفاده از گزینهٔ -I به ipmitool بگویید تا از رابط IMB استفاده کند:

> ipmitool -I imb <command>

مثال‌ها (EXAMPLES)

مثال ۱: فهرست کردن حسگرهای راه دور: > ipmitool -I lan -H 1.2.3.4 -f passfile sdr list
Baseboard 1.25V | 1.24 Volts | ok
Baseboard 2.5V | 2.49 Volts | ok
Baseboard 3.3V | 3.32 Volts | ok
مثال ۲: نمایش وضعیت یک حسگر راه دور: > ipmitool -I lan -H 1.2.3.4 -f passfile sensor get "Baseboard 1.25V"
Locating sensor record...
Sensor ID : Baseboard 1.25V (0x10)
Sensor Type (Analog) : Voltage
Sensor Reading : 1.245 (+/- 0.039) Volts
Status : ok
Lower Non-Recoverable : na
Lower Critical : 1.078
Lower Non-Critical : 1.107
Upper Non-Critical : 1.382
Upper Critical : 1.431
Upper Non-Recoverable : na
مثال ۳: نمایش وضعیت برق یک شاسی راه دور: > ipmitool -I lan -H 1.2.3.4 -f passfile chassis power status
Chassis Power is on
مثال ۴: کنترل برق در یک شاسی راه دور: > ipmitool -I lan -H 1.2.3.4 -f passfile chassis power on
Chassis Power Control: Up/On

فایل‌ها (FILES)

/usr/share/misc/enterprise-numbers: رجیستری IANA PEN سیستم، برگرفته از http://www.iana.org/assignments/enterprise-numbers
~/.local/usr/share/misc/enterprise-numbers: جایگزین سفارشی کاربر برای رجیستری IANA PEN سیستم؛ در صورت وجود، این فایل به جای رجیستری سیستم بارگذاری می‌شود (به بالا مراجعه کنید).

نویسندگان (AUTHORS)

در ابتدا توسط Duncan Laurie <duncan@iceblink.org> نوشته شد.
همراه با مشارکت‌کنندگان پرشمار در طول زمان.

گزارش باگ‌ها (BUGS)

لطفاً هرگونه باگ یافت‌شده در ipmitool را از طریق سامانهٔ ثبت issue در GitHub به نشانی https://github.com/ipmitool/ipmitool/issues گزارش دهید.

همچنین ببینید (SEE ALSO)

وبگاه IPMItool: http://github.com/ipmitool/ipmitool
مشخصات رابط مدیریت بستر هوشمند (IPMI): http://www.intel.com/design/servers/ipmi
وبگاه OpenIPMI: http://openipmi.sourceforge.net
وبگاه FreeIPMI: http://www.gnu.org/software/freeipmi

Duncan Laurie