ipmitool(1) ipmitool(1) نام (NAME) ipmitool - ابزاری برای کنترل دستگاه‌های مجهز به IPMI خلاصه دستور (SYNOPSIS) ipmitool [ ] [ ] := [ | ] هر گزینه شناخته‌شده‌ای پذیرفته می‌شود. گزینه‌های شرطی ممکن است نادیده گرفته شوند یا استفاده از آن‌ها تا زمان پردازش دستور مربوطه توسط پوسته یا exec به تعویق بیفتد. := [ -h | -V | -v | -I | -H
| -d | -p | -c | -U | -L | -l | -m | -N | -R | | | ] := [ | | ] پل‌زدن (Bridging): := -t [ -b | [ -T
| -B ] ] گزینه‌های مورد استفاده با -I lan: := [ -A ] گزینه‌های مورد استفاده با -I lanplus: := [ -C | ] گروه‌های گزینه‌ای که مقدار یکسانی را تنظیم می‌کنند: := [ -k | -K | -y | -Y ] := [ -f | -a | -P | -E ] := [ -o | -g | -s ] گزینه‌های مورد استفاده با دستور خاص : := [ -S ] := [ -O ] := [ -e ] توضیحات (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 مشخص کردن نوع احراز هویت برای استفاده در طول فعال‌سازی نشست lan در IPMIv1.5. انواع پشتیبانی‌شده عبارتند از NONE، PASSWORD، MD2، MD5، یا OEM. -b تنظیم کانال مقصد برای درخواست پل‌شده (bridged). -B تنظیم کانال عبوری برای درخواست پل‌شده (پل دوگانه). -b تنظیم کانال مقصد برای درخواست پل‌شده (bridged). -B تنظیم کانال عبوری برای درخواست پل‌شده (پل دوگانه). -c نمایش خروجی در قالب CSV (مقادیر جداشده با کاما). این قابلیت برای همه دستورها در دسترس نیست. -C الگوریتم‌های احراز هویت، یکپارچگی و رمزنگاری کارساز دوردست برای استفاده در اتصالات 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 استفاده از نویسه ارائه‌شده به عنوان نویسه گریز (escape) نشست SOL. پیش‌فرض استفاده از ~ است، اما ممکن است با نشست‌های ssh تداخل ایجاد کند. -E گذرواژه کارساز دوردست توسط متغیر محیطی IPMI_PASSWORD یا IPMITOOL_PASSWORD مشخص می‌شود. متغیر IPMITOOL_PASSWORD اولویت دارد. -f فایلی حاوی گذرواژه کارساز دوردست را مشخص می‌کند. اگر این گزینه وجود نداشته باشد، یا اگر password_file خالی باشد، گذرواژه به طور پیش‌فرض NULL خواهد بود. -g منسوخ شده است. از این مورد استفاده کنید: -o intelplus -h دریافت راهنمای پایه نحوه استفاده از طریق خط فرمان. -H
نشانی کارساز دوردست؛ می‌تواند نشانی IP یا نام میزبان باشد. این گزینه برای رابط‌های lan و lanplus الزامی است. -I رابط IPMI مورد استفاده را انتخاب می‌کند. رابط‌های پشتیبانی‌شده‌ای که کامپایل شده‌اند در خروجی راهنمای برنامه قابل مشاهده هستند. -k استفاده از کلید ارائه‌شده Kg برای احراز هویت IPMIv2.0. حالت پیش‌فرض عدم استفاده از هرگونه کلید Kg است. -K خواندن کلید Kg از متغیر محیطی IPMI_KGKEY. -l تنظیم LUN مقصد برای دستورات خام (raw). -L تحمیل سطح دسترسی نشست. می‌تواند CALLBACK، USER، OPERATOR، یا ADMINISTRATOR باشد. پیش‌فرض ADMINISTRATOR است. این مقدار هنگام ترکیب با -t target address نادیده گرفته شده و همواره روی ADMINISTRATOR تنظیم می‌شود. -m تنظیم نشانی محلی IPMB. در صورتی که -m مشخص نشده باشد، نشانی محلی به صورت پیش‌فرض 0x20 است یا روی بسترهای PICMG به طور خودکار شناسایی می‌شود. در شرایط عادی نیازی به تغییر نشانی محلی وجود ندارد. -N مشخص کردن تعداد ثانیه‌های بین ارسال مجدد پیام‌های lan/lanplus. مقادیر پیش‌فرض ۲ ثانیه برای رابط‌های lan و ۱ ثانیه برای رابط‌های lanplus است. دستور raw از مقدار ثابت ۱۵ ثانیه استفاده می‌کند. دستور sol از مقدار ثابت ۱ ثانیه استفاده می‌کند. -o انتخاب نوع OEM برای پشتیبانی. این مورد معمولاً شامل وصله‌های جزئی در کد است تا با رفتارهای خاص BMCهای سازندگان مختلف سازگار شود. از -o list برای مشاهده فهرست انواع OEM پشتیبانی‌شده فعلی استفاده کنید. -O فایل انتخاب‌شده را باز کرده و شرح رویدادهای OEM SEL را جهت استفاده هنگام فهرست‌گیری SEL می‌خواند. برای ساختار فایل، مثال‌های موجود در دایرکتوری contrib را ببینید. -p درگاه UDP کارساز دوردست برای اتصال. مقدار پیش‌فرض 623 است. -P گذرواژه کارساز دوردست در خط فرمان مشخص می‌شود. در صورت پشتیبانی، در فهرست فرایندها پنهان خواهد شد. نکته! تعیین گذرواژه به عنوان یک گزینه در خط فرمان توصیه نمی‌شود. -R تنظیم تعداد تلاش‌های مجدد برای رابط lan/lanplus (پیش‌فرض=۴). دستور raw از مقدار ثابت یک تلاش (بدون تلاش مجدد) استفاده می‌کند. دستور hpm از مقدار ثابت ۱۰ بار تلاش مجدد استفاده می‌کند. -s منسوخ شده است. از این مورد استفاده کنید: -o supermicro -S استفاده از فایل محلی برای حافظه نهان (cache) دوردست SDR. استفاده از یک حافظه نهان محلی SDR می‌تواند عملکرد دستورهایی را که برای انجام وظیفه خود نیازمند آگاهی از کل SDR هستند به شدت افزایش دهد. حافظه نهان محلی SDR از یک سیستم دوردست را می‌توان با دستور sdr dump ایجاد کرد..TP -t پل‌زدن (Bridge) درخواست‌های IPMI به نشانی هدف دوردست. پیش‌فرض 32 است. گزینه -L privlvl همواره نادیده گرفته شده و مقدار آن روی ADMINISTRATOR تنظیم می‌شود. -T
تنظیم نشانی عبور (transit address) برای درخواست پل (پل دوگانه). -T تنظیم نشانی عبور برای درخواست پل. (پل دوگانه) -U نام کاربری سرور دوردست، پیش‌فرض کاربر NULL است. -v افزایش سطح پرگویی خروجی (verbose). این گزینه می‌تواند چندین بار مشخص شود تا سطح خروجی اشکال‌زدایی (debug) افزایش یابد. در صورت سه بار مشخص کردن، رونوشت هگزادسیمال (hexdump) تمام بسته‌های ورودی و خروجی را دریافت خواهید کرد. استفاده پنج باره از آن، جزئیات مربوط به پردازش درخواست و پاسخ‌های مورد انتظار را ارائه می‌دهد. دستورهای hpm شامل targetcap compprop abort upgstatus rollback rollbackstatus selftestresult سطح پرگویی را افزایش می‌دهند -V نمایش اطلاعات نسخه. -y استفاده از کلید Kg ارائه‌شده برای احراز هویت IPMIv2.0. انتظار می‌رود که کلید در قالب هگزادسیمال باشد و می‌تواند برای تعیین کلیدهایی با نویسه‌های غیرقابل‌چاپ استفاده شود. به عنوان مثال، '-k PASSWORD' و '-y 50415353574F5244' معادل یکدیگر هستند. پیش‌فرض، عدم استفاده از هیچ کلید Kg است. -Y درخواست تعاملی برای دریافت کلید Kg جهت احراز هویت IPMIv2.0. -z تغییر اندازه کانال ارتباطی. (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 نمایش اطلاعات درباره قابلیت‌های احراز هویت کانال انتخاب‌شده در سطح دسترسی مشخص‌شده. سطوح دسترسی ممکن عبارتند از: 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 [] پیکربندی userid داده‌شده به عنوان پیش‌فرض روی شماره کانال مشخص‌شده. هنگامی که کانال داده‌شده متعاقباً استفاده شود، کاربر به‌طور ضمنی توسط userid مشخص‌شده شناسایی می‌شود. setaccess [] [] [] [] پیکربندی اطلاعات دسترسی کاربر روی کانال داده‌شده برای userid مشخص‌شده. getciphers [] نمایش فهرست مجموعه‌های رمزی (cipher suites) پشتیبانی‌شده برای برنامه داده‌شده (ipmi یا sol) روی کانال مشخص‌شده. chassis status اطلاعات وضعیت مربوط به برق، دکمه‌ها، خنک‌سازی، درایوها و خطاها. power status on.TP off cycle reset diag soft identify [|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 ] خواندن صندوق پستی راه‌انداز بوت (Boot Initiator Mailbox) به صورت دامپ هگزادسیمال یا در حالت متنی. به‌طور پیش‌فرض تمام صندوق پستی خوانده می‌شود. اگر شماره بلوک مشخص شده باشد، همان بلوک خاص خوانده می‌شود. برای بلوک ۰ یا هنگامی که کل صندوق پستی خوانده می‌شود، شماره سازمانی Boot Initiator IANA و نام سازمانی متناظر با آن چاپ می‌شوند. bootmbox set text [block ] "" نوشتن در مشخص‌شده یا کل Boot Initiator Mailbox در حالت متنی. مشخص کردن یک IANA Enterprise Number دهدهی که توسط راه‌انداز بوت روی سیستم هدف شناخته شود، الزامی است. برای جزئیات به سازنده سیستم هدف خود مراجعه کنید. بقیه آرگومان‌ها یک رشته متنی هستند. هنگامی که نوشتن یک بلوک منفرد درخواست می‌شود، طول کل نباید برای بلوک ۰ از ۱۳ بایت، یا در غیر این صورت از ۱۶ بایت تجاوز کند. bootmbox set [block ] [ ...] مشابه بالا، اما آرگومان‌های بعد از IANA PEN مقادیر بایتی داده‌ای مجزایی هستند که با فاصله از یکدیگر جدا شده‌اند. bootparam get [] دریافت مقدار گزینه بوت سیستم به شماره . برخی از گزینه‌های بوت (مانند گزینه ۷) می‌توانند یک پارامتر عددی اختیاری نیز دریافت کنند. bootparam set bootflag [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 گزینه‌های دستور محدودیت توان پلتفرم عبارتند از: reading دریافت مقادیر خوانده‌شده مربوط به توان از سیستم. get_limit دریافت محدودیت‌های توان پیکربندی‌شده. set_limit تنظیم یک گزینه محدودیت توان. پارامترها/مقادیر ممکن عبارتند از: action اقدامات شرایط استثنا (Exception Actions) به صورت «No Action»، «Hard Power Off system and log events to SEL» یا «Log event to SEL only» انجام می‌شوند. limit حد توان درخواستی بر حسب وات. correction حد زمان اصلاح بر حسب میلی‌ثانیه. sample دوره نمونه‌برداری آماری بر حسب ثانیه. activate فعال‌سازی حد توان تعیین‌شده. deactivate غیرفعال‌سازی حد توان تعیین‌شده. sensors حسگرهای DCMI موجود را چاپ می‌کند. asset_tag برچسب اموال (asset tag) پلتفرم را چاپ می‌کند. set_asset_tag برچسب اموال پلتفرم را تنظیم می‌کند. get_mc_id_string دریافت رشته شناسه کنترل‌کننده مدیریت (MC). set_mc_id_string تنظیم رشته شناسه کنترل‌کننده مدیریت. حداکثر طول شامل نویسه تهی پایانی (null terminator) ۶۴ بایت است. thermalpolicy [] دریافت/تنظیم سیاست حد حرارتی (Thermal Limit). دستورها عبارتند از: Get دریافت مقادیر حد حرارتی. entityID موجودیت فیزیکی است که حسگر یا دستگاه با آن مرتبط است. instanceID نمونه خاصی از یک موجودیت است. نمونه موجودیت (Entity Instance) می‌تواند در یکی از دو محدوده مرتبط با سیستم (system-relative) یا مرتبط با دستگاه (device-relative) باشد. برای نمونه، سیستمی با چهار پردازنده می‌تواند از مقدار «0» برای Entity Instance جهت شناسایی نخستین پردازنده استفاده کند. Set تنظیم مقادیر حد حرارتی. entityID موجودیت فیزیکی است که حسگر یا دستگاه با آن مرتبط است. instanceID نمونه خاصی از یک موجودیت است. نمونه موجودیت (Entity Instance) می‌تواند در یکی از دو محدوده مرتبط با سیستم (system-relative) یا مرتبط با دستگاه (device-relative) باشد. برای نمونه، سیستمی با چهار پردازنده می‌تواند از مقدار «0» برای Entity Instance جهت شناسایی نخستین پردازنده استفاده کند. get_temp_reading دریافت خوانش‌های حسگر دما. get_conf_param دریافت پارامترهای پیکربندی DCMI. set_conf_param تنظیم پارامترهای پیکربندی 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} = یک یا چند مورد از موارد زیر: online | present | hotspare | identify | rebuilding | fault | predict | critical | failed lcd set {mode}|{lcdqualifier}|{errordisplay} به شما امکان می‌دهد حالت LCD و رشته تعریف‌شده توسط کاربر را تنظیم کنید. lcd set mode {none}|{modelname}|{ipv4address}|{macaddress}| {systemname}|{servicetag}|{ipv6address}| {ambienttemp}|{systemwatt}|{assettag}| {userdefined} به شما امکان می‌دهد حالت نمایشگر 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 آدرس MAC و وضعیت NICهای انتخاب‌شده را نمایش می‌دهد. lan اطلاعات Lan را نمایش می‌دهد. lan set حالت انتخاب 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 نمایش می‌دهد. powermonitor powerconsumptionhistory | تاریخچه توان مصرفی را بر حسب watt یا btuphr نمایش می‌دهد. powermonitor getpowerbudget | سقف توان (power cap) را بر حسب watt یا btuphr نمایش می‌دهد. powermonitor setpowerbudget امکان تعیین سقف توان (power cap) را بر حسب watt،‏ BTU/hr یا درصد فراهم می‌کند. powermonitor enablepowercap سقف توان (power cap) تنظیم‌شده را فعال می‌کند. powermonitor disablepowercap سقف توان (power cap) تنظیم‌شده را غیرفعال می‌کند. vFlash info Card اطلاعات Extended SD Card را نمایش می‌دهد. echo برای چاپ خطوط در stdout درون اسکریپت‌ها. ekanalyzer [] ... NOTE : این دستور می‌تواند حداکثر از ۸ فایل در هر خط فرمان پشتیبانی کند filename1 : فایل باینری که داده‌های FRU یک برد Carrier یا یک ماژول AMC را ذخیره می‌کند filename2 : فایل باینری که داده‌های FRU یک ماژول AMC را ذخیره می‌کند. این فایل‌های باینری می‌توانند با این دستور تولید شوند: ipmitool fru read 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 (پیش‌فرض) ... نمایش اتصال فیزیکی نقطه به نقطه (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 ... نمایش اطلاعات منبع تغذیه (power supply) میان carrier و ماژول‌های AMC. all ... نمایش هر دو مورد اتصال فیزیکی و وضعیت منبع تغذیه برای هر یک از carrierها و ماژول‌های AMC. frushow تبدیل یک فایل باینری FRU به قالب متنی خوانا برای انسان. برای دریافت اطلاعات نمایشی بیشتر از گزینهٔ -v استفاده کنید. summary [] match (پیش‌فرض) ... نمایش تنها نتایج تطبیق‌یافتهٔ مطابقت 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 ... نمایش نتایج تطبیق‌نیافتهٔ مطابقت Ekeying میان یک دستگاه On-Carrier و یک ماژول AMC یا میان ۲ ماژول AMC. all ... نمایش هر دو نتیجهٔ تطبیق‌یافته و تطبیق‌نیافتهٔ مطابقت Ekeying میان دو کارت یا دو ماژول. event ارسال یک رویداد آزمایشی از پیش تعریف‌شده به 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 رکوردهای لاگ رویداد مشخص‌شده در به 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 دریافت فهرستی از تمام وضعیت‌های حسگر (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 [] تولید یک رویداد سفارشی بر اساس اطلاعات حسگر موجود. جهت اختیاری رویداد (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 اجرای دستورهای 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 مراجعه کنید). نحو و وابستگی‌های پارامترها به صورت زیر است: [] [ [ []]]] توجه داشته باشید که اگر «netfn » مشخص شده باشد، آنگاه «lun » نیز باید مشخص شود؛ اگر «command » مشخص شده باشد، آنگاه «netfn » (و در نتیجه «lun ») نیز باید مشخص شود، و به همین ترتیب. پارامتر «channel » اختیاری و مستقل است. در صورت مشخص نشدن، عملیات درخواستی روی کانال فعلی انجام خواهد شد. توجه داشته باشید که پشتیبانی از دستورها ممکن است از کانالی به کانال دیگر متفاوت باشد. دستورهای فایروال میان‌افزار: info [] فهرست کردن اطلاعات فایروال میان‌افزار برای LUN، NetFn و Command مشخص‌شده (در صورت ارائه) روی کانال فعلی یا مشخص‌شده. اطلاعات فهرست‌شده شامل بیت‌های پشتیبانی (support)، قابل‌پیکربندی (configurable) و فعال (enabled) برای دستور یا دستورهای مشخص‌شده است. چند مثال کاربردی: info [] [] این دستور اطلاعات فایروال میان‌افزار را برای تمامی NetFnها مربوط به LUN مشخص‌شده روی کانال فعلی یا مشخص‌شده فهرست می‌کند. info [] [ [ ] این دستور تمام اطلاعات دستور را برای یک جفت LUN/NetFn چاپ می‌کند. info [] [ [ [] [ [ []]]] چاپ اطلاعات مربوط به یک زیرتابع خاص. enable [] این دستور برای فعال‌سازی دستورها برای یک ترکیب NetFn/LUN مشخص روی کانال تعیین‌شده استفاده می‌شود. disable [] [force] این دستور برای غیرفعال‌سازی دستورها برای یک ترکیب NetFn/LUN مشخص روی کانال تعیین‌شده استفاده می‌شود. در صورت استفاده از گزینه «force» باید دقت زیادی به خرج داد تا دستور «Set Command Enables» غیرفعال نشود. reset [] این دستور می‌تواند برای بازنشانی فایروال میان‌افزار به وضعیتی که تمام دستورها و زیرتوابع دستور فعال هستند استفاده شود. fru print خواندن تمامی داده‌های موجودی واحد قابل تعویض در محل (FRU) و استخراج اطلاعاتی نظیر شماره سریال، شماره قطعه، برچسب‌های اموال و رشته‌های کوتاهی که شاسی، برد یا محصول را توصیف می‌کنند. read fru id شناسه عددی FRU است (خروجی «fru print» را ببینید). fru file مسیر مطلق فایلی است که داده‌های باینری FRU مربوط به موجودیت FRU مشخص‌شده در آن ذخیره می‌شود. write fru id شناسه عددی FRU است (خروجی «fru print» را ببینید). fru file مسیر مطلق فایلی است که پیش از بارگذاری در FRU مشخص‌شده، داده‌های باینری FRU از آن خوانده می‌شود. upgEkey به‌روزرسانی یک مکان FRU چندرکوردی (multirecord). fru id شناسه عددی FRU است (خروجی «fru print» را ببینید). fru file مسیر مطلق فایلی است که داده‌های باینری FRU برای بارگذاری در موجودیت FRU چندرکوردی مشخص‌شده از آن خوانده می‌شود..TP edit این دستور امکان ویرایش تعاملی برخی رکوردهای پشتیبانی‌شده، به‌ویژه «PICMG Carrier Activation Record» را فراهم می‌کند. fru id شناسه رقمی FRU است (خروجی دستور 'fru print' را ببینید)؛ مقدار پیش‌فرض 0 است. edit field
این دستور می‌تواند برای تنظیم یک رشته فیلد روی مقداری جدید استفاده شود. این دستور داده‌های FRU یافت‌شده در index واقع در section مشخص‌شده را با string ارائه‌شده جایگزین می‌کند. fru id شناسه رقمی FRU است (خروجی دستور 'fru print' را ببینید).
رشته‌ای است که به نواحی ذخیره‌سازی اطلاعات موجودی 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) شماره فیلد را مشخص می‌کند. شماره‌گذاری فیلدها از نخستین نوع فیلد 'english text' آغاز می‌شود. برای مثال در ناحیه اطلاعاتی ، فیلد '0' برابر با و فیلد '2' برابر با است؛ برای آگاهی از جایگاه فیلدها، مستند «IPMI Platform Management FRU Information Storage Definition v1.0 R1.1» را ببینید. باید طولی برابر با رشته‌ای که جایگزین آن می‌شود داشته و یک رشته 8-bit ASCII (0xCx) باشد. edit oem iana [] این دستور داده‌های موجود در ناحیه multirecord را ویرایش می‌کند. پشتیبانی از رکوردهای خاص OEM محدود است. fwum به‌روزرسانی IPMC با استفاده از Kontron OEM Firmware Update Manager. info نمایش اطلاعات درباره میان‌افزار فعلی. status نمایش وضعیت هر یک از بانک‌های میان‌افزار موجود در سخت‌افزار. download بارگیری میان‌افزار مشخص‌شده. upgrade [filename] نصب ارتقای میان‌افزار. اگر نام فایل مشخص شده باشد، ابتدا فایل بارگیری می‌شود؛ در غیر این صورت، از آخرین میان‌افزار بارگیری‌شده استفاده خواهد شد. rollback درخواست از IPMC برای بازگشت به نسخه قبلی. tracelog نمایش گزارش وقایع ارتقای میان‌افزار. gendev list فهرست کردن تمام Generic Device Locatorها. read خواندن داده‌های eeprom مشخص‌شده توسط Generic Device Locators و ذخیره در فایل. write نوشتن روی eeprom مشخص‌شده توسط Generic Device Locators از روی فایل. hpm عامل ارتقای PICMG HPM.1 check بررسی اطلاعات هدف. check نمایش هر دو نسخه موجود روی هدف و نسخه ایمیج بر روی صفحه نمایش. download بارگیری میان‌افزار مشخص‌شده. upgrade [all] [component ] [activate] ارتقای میان‌افزار با استفاده از یک فایل ایمیج معتبر HPM.1. در صورتی که هیچ گزینه‌ای مشخص نشده باشد، نسخه‌های میان‌افزار ابتدا بررسی شده و ارتقا تنها در صورت تفاوت آن‌ها انجام می‌گیرد. all ارتقای تمام مؤلفه‌ها حتی در صورتی که نسخه‌های میان‌افزار یکسان باشند (تنها پس از استفاده از دستور "check" از این گزینه استفاده کنید). component ارتقای تنها مؤلفه داده‌شده از فایل مشخص‌شده. مؤلفه 0 - BOOT مؤلفه 1 - RTK activate فعال‌سازی فوری میان‌افزار جدید. activate فعال‌سازی میان‌افزار جدید بارگذاری‌شده. targetcap دریافت قابلیت‌های ارتقای هدف. compprop