IPMI-PET(8) System Commands IPMI-PET(8)

ipmi-pet - مفسر تله رخداد بستر (PET) در سامانه IPMI

ipmi-pet [گزینه‌ها...] [SPECIFIC TRAP] [VARIABLE BINDING HEX BYTES...]

دستور ipmi-pet بایت‌های هگزادسیمال دریافتی از یک تله رخداد بستر (PET یا Platform Event Trap) را تفسیر کرده و رشته‌ای به عنوان نمایش محتوای آن در خروجی چاپ می‌کند. مقادیر هگزادسیمال می‌توانند در خط فرمان، از طریق یک فایل با گزینه --file، یا از طریق ورودی استاندارد (stdin) در صورت عدم تعیین دو مورد قبل، وارد شوند.

دستور ipmi-pet معمولاً همراه با دیمون تله SNMP برای تفسیر نتایج یک تله PET ارسالی از IPMI که توسط دیمون ضبط شده است استفاده می‌شود. اگرچه ipmi-pet می‌تواند مستقیماً از چنین دیمونی فراخوانی شود، معمولاً اسکریپتی برای تجزیه خروجی دیمون SNMP و تبدیل آن به قالبی که قابل ورود به ipmi-pet باشد فراخوانی می‌گردد.

در برخی سیستم‌ها، ممکن است بخواهید یک تاییدیه PET (یا PET acknowledge) نیز به سیستم راه دور ارسال کنید تا به آن اطلاع دهید که تله دریافت و تجزیه شده است. این تاییدیه می‌تواند با استفاده از گزینه --pet-acknowledge ارسال شود.

اگرچه یک نشست IPMI برای تفسیر PET الزامی نیست، اما داده‌های مخزن داده‌های سنسور (SDR) برای تفسیر صحیح نام سنسورها و سایر اطلاعات موجود در PET مورد نیاز است. پیکربندی نشست IPMI در زیر، مانند درایور، نام میزبان، نام کاربری و غیره، باید برای بارگذاری SDR میزبانی که تله از آن سرچشمه گرفته است تنظیم شود. اگر انجام این کار دشوار است، شاید بهتر باشد که یک کش SDR خاص را ذخیره کرده و با استفاده از گزینه --sdr-cache-file بارگذاری کنید.

اگر دسترسی به SDR دشوار باشد، می‌توان گزینه --ignore-sdr-cache را تعیین کرد تا SDR بارگذاری نشود و نیازی به نشست IPMI نباشد. در این حالت PET تا حد امکان بدون وجود SDR تفسیر خواهد شد. گزینه --ignore-sdr-cache ممکن است گزینه‌های دیگری مانند --interpret-oem-data را نیز تحت تأثیر قرار دهد. برخی گزینه‌ها مانند --manufacturer-id و --product-id ممکن است بخشی از این مشکلات را کاهش دهند.

اگر دیمون SNMP به خودی خود مقدار specific trap در SNMPv1 را خروجی ندهد، این مقدار معمولاً به عنوان آخرین عنصر OID در SNMPv2 خروجی داده می‌شود. چنانچه به هر دلیلی مقدار specific trap قابل تعیین نباشد، می‌توان مقدار NA را برای specific trap وارد کرد تا نشان دهد در دسترس نیست.

دستور ipmi-pet بر اساس اطلاعات متغیرهای متصل (variable bindings) تا حد ممکن خروجی تولید خواهد کرد. بخشی از اطلاعات تله خاص ممکن است از طریق اطلاعات SDR به دست آید.

در ادامه گزینه‌های عمومی IPMI، گزینه‌های اختصاصی ابزار، اطلاعات عیب‌یابی، راهکارهای دور زدن مشکلات، مثال‌ها و مسائل شناخته‌شده فهرست شده‌اند. برای آشنایی عمومی با FreeIPMI لطفاً به freeipmi(7) مراجعه کنید.

گزینه‌های زیر گزینه‌های عمومی برای پیکربندی ارتباطات IPMI و اجرای دستورات کلی ابزار هستند.

نوع درایور مورد استفاده را به جای انتخاب خودکار مشخص می‌کند. درایورهای خارج از باند (outofband) که در حال حاضر موجود هستند عبارتند از LAN و LAN_2_0 که به ترتیب IPMI 1.5 و IPMI 2.0 را اجرا می‌کنند. درایورهای درون باند (inband) که در حال حاضر موجود هستند عبارتند از KCS، SSIF، OPENIPMI، SUNBMC و INTELDCMI.
از پویش خودکار دستگاه‌های IPMI درون‌باند برای تنظیمات پیش‌فرض جلوگیری می‌کند.
آدرس درایور درون‌باند را به جای مقدار پویش‌شده مشخص می‌کند. DRIVER-ADDRESS برای مقدار هگزادسیمال باید پیشوند "0x" و برای مقدار هشت‌هشتی پیشوند '0' داشته باشد.
مسیر دستگاه درایور درون‌باند را به جای مسیر پویش‌شده مشخص می‌کند.
فاصله‌گذاری رجیستر درایور درون‌باند را به جای مقدار پویش‌شده مشخص می‌کند. آرگومان بر حسب بایت است (مثلاً فاصله‌گذاری رجیستر ۳۲ بیتی = ۴).
شماره کانال مقصد درایور درون‌باند را برای ارسال درخواست‌های IPMI مشخص می‌کند.
آدرس برده (slave) مقصد درایور درون‌باند را برای ارسال درخواست‌های IPMI مشخص می‌کند.
میزبان راه دور را برای ارتباط مشخص می‌کند. یک پورت اختیاری می‌تواند مشخص شود که ممکن است در فوروارد پورت یا شرایط مشابه کاربرد داشته باشد. در صورت تعیین آدرس و پورت IPv6، از قالب [ADDRESS]:PORT استفاده کنید.
نام کاربری مورد استفاده برای احراز هویت با میزبان راه دور را مشخص می‌کند. در صورت عدم تعیین، یک نام کاربری تهی (ناشناس) در نظر گرفته می‌شود. کاربر باید حداقل دارای امتیازات OPERATOR باشد تا این ابزار به طور کامل عمل کند.
رمز عبور مورد استفاده برای احراز هویت با میزبان راه دور را مشخص می‌کند. در صورت عدم تعیین، یک رمز عبور تهی در نظر گرفته می‌شود. حداکثر طول رمز عبور ۱۶ کاراکتر برای IPMI 1.5 و ۲۰ کاراکتر برای IPMI 2.0 است.
درخواست ورود تعاملی رمز عبور برای جلوگیری از احتمال مشاهده آن در فهرست پردازش‌ها.
کلید BMC با نام K_g را برای احراز هویت با میزبان راه دور در IPMI 2.0 مشخص می‌کند. در صورت عدم تعیین، یک کلید تهی در نظر گرفته می‌شود. برای ورود کلید به فرم هگزادسیمال، رشته را با '0x' شروع کنید. برای مثال، کلید 'abc' می‌تواند با رشته 'abc' یا رشته '0x616263' وارد شود.
درخواست ورود تعاملی k-g برای جلوگیری از احتمال نمایش آن در فهرست پردازش‌ها.
مهلت زمانی نشست را بر حسب میلی‌ثانیه مشخص می‌کند. در صورت عدم تعیین، مقدار پیش‌فرض ۲۰۰۰۰ میلی‌ثانیه (۲۰ ثانیه) است.
مهلت زمانی ارسال مجدد بسته را بر حسب میلی‌ثانیه مشخص می‌کند. در صورت عدم تعیین، مقدار پیش‌فرض ۱۰۰۰ میلی‌ثانیه (۱ ثانیه) است. مهلت ارسال مجدد نمی‌تواند بزرگ‌تر از مهلت زمانی نشست باشد.
نوع احراز هویت IPMI 1.5 را مشخص می‌کند. انواع احراز هویت موجود در حال حاضر عبارتند از NONE، STRAIGHT_PASSWORD_KEY، MD2 و MD5. در صورت عدم تعیین، مقدار پیش‌فرض MD5 است.
شناسه مجموعه رمزنگاری (Cipher Suite ID) در IPMI 2.0 را مشخص می‌کند. شناسه مجموعه رمزنگاری، مجموعه‌ای از الگوریتم‌های احراز هویت، یکپارچگی و محرمانگی را برای ارتباط IPMI 2.0 تعیین می‌کند. الگوریتم احراز هویت، الگوریتم مورد استفاده برای برپایی نشست، الگوریتم یکپارچگی، الگوریتم مورد استفاده برای امضای بسته‌های نشست، و الگوریتم محرمانگی، الگوریتم مورد استفاده برای رمزنگاری داده‌ها را مشخص می‌نماید. در صورت عدم تعیین، مقدار پیش‌فرض شناسه ۳ است. شناسه‌های مجموعه رمزنگاری زیر در حال حاضر پشتیبانی می‌شوند:

0 - الگوریتم احراز هویت = None؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None

1 - الگوریتم احراز هویت = HMAC-SHA1؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None

2 - الگوریتم احراز هویت = HMAC-SHA1؛ الگوریتم یکپارچگی = HMAC-SHA1-96؛ الگوریتم محرمانگی = None

3 - الگوریتم احراز هویت = HMAC-SHA1؛ الگوریتم یکپارچگی = HMAC-SHA1-96؛ الگوریتم محرمانگی = AES-CBC-128

6 - الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None

7 - الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = HMAC-MD5-128؛ الگوریتم محرمانگی = None

8 - الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = HMAC-MD5-128؛ الگوریتم محرمانگی = AES-CBC-128

11 - الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = MD5-128؛ الگوریتم محرمانگی = None

12 - الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = MD5-128؛ الگوریتم محرمانگی = AES-CBC-128

15 - الگوریتم احراز هویت = HMAC-SHA256؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None

16 - الگوریتم احراز هویت = HMAC-SHA256؛ الگوریتم یکپارچگی = HMAC_SHA256_128؛ الگوریتم محرمانگی = None

17 - الگوریتم احراز هویت = HMAC-SHA256؛ الگوریتم یکپارچگی = HMAC_SHA256_128؛ الگوریتم محرمانگی = AES-CBC-128

سطح دسترسی مورد استفاده را مشخص می‌کند. سطوح دسترسی موجود در حال حاضر عبارتند از USER، OPERATOR و ADMIN. در صورت عدم تعیین، مقدار پیش‌فرض OPERATOR است.
یک فایل پیکربندی جایگزین را مشخص می‌کند.
راهکارهای دور زدن مشکلات عدم انطباق سازندگان سخت‌افزار را مشخص می‌کند. چندین راهکار می‌توانند با کاما از یکدیگر جدا شوند. پرچم ویژه خط فرمان "none" نشان‌دهنده عدم استفاده از راهکارها خواهد بود (می‌تواند برای لغو پیش‌فرض‌های پیکربندی‌شده مفید باشد). برای مشاهده فهرست راهکارهای موجود، بخش راهکارهای دور زدن مشکلات را در زیر ببینید.
فعال کردن حالت اشکال‌زدایی (دیباگ).
-?, --help
نمایش فهرست راهنما و خروج.
نمایش پیام نحوه استفاده و خروج.
نمایش نسخه برنامه و خروج.

گزینه‌های زیر مختص ipmi-pet هستند.

تولید خروجی با جزئیات بیشتر (verbose). این گزینه جهت رخداد و پیام‌های سفارشی سازنده (OEM) را از تله خروجی می‌دهد.
تولید خروجی با جزئیات بسیار بیشتر. این گزینه اطلاعات تکمیلی موجود در تله مانند GUID، شناسه سازنده (manufacturer ID) و شناسه سیستم را خروجی می‌دهد.
تولید خروجی با حداکثر جزئیات. این گزینه اطلاعات بیشتری نسبت به حالت پرجزئیات خروجی می‌دهد؛ به ویژه کدهای هگزادسیمال اضافی را برای ارائه اطلاعات در مورد رخدادهای مبهم خروجی خواهد داد. به عنوان مثال، کدهای هگز شناسه تولیدکننده (Generator ID) را برای سنسورهای بدون نام نمایش می‌دهد.
ارسال تاییدیه PET با استفاده از داده‌های تله ورودی به جای خروجی دادن داده‌ها. در برخی شرایط، این قابلیت ممکن است برای آگاه ساختن یک سیستم راه دور از دریافت و پردازش تله مفید باشد. در صورت تعیین این گزینه، یک نام میزبان باید از طریق -h یا --hostname مشخص شود تا به ipmi-pet اطلاع داده شود تاییدیه به کجا ارسال گردد. هنگامی که این گزینه تعیین می‌شود، کش SDR بارگذاری نشده و نیازی به آن نیست.
تعیین یک فایل برای خواندن تله خاص PET و بایت‌های هگز اتصالات متغیر به جای خط فرمان.
نمایش شدت رخداد در خروجی. این گزینه یک فیلد اضافی حاوی شدت رخداد به خروجی اضافه می‌کند. خروجی‌ها ممکن است Monitor، Information، OK، وضعیت غیربحرانی (Non-critical condition)، وضعیت بحرانی (Critical condition) یا وضعیت غیرقابل‌بازیابی (Non-recoverable condition) باشند. این مورد با خروجی --output-event-state تفاوت دارد، زیرا شدت رخداد تفسیر نمی‌شود، بلکه مقداری است که مستقیماً در تله SNMP گزارش شده است. با این حال، ممکن است همه رخدادها شدت را گزارش نکنند، یا برخی سازندگان از گزارش شدت پشتیبانی ننمایند. شدت رخداد به طور خودکار در حالت خروجی پرجزئیات (verbose) نمایش داده می‌شود.
نمایش وضعیت رخداد در خروجی. این گزینه یک خروجی اضافی اضافه می‌کند که گزارش می‌دهد آیا یک رخداد باید به عنوان عادی (NOMINAL)، هشدار (WARNING) یا بحرانی (CRITICAL) دیده شود. این با خروجی --output-event-severity تفاوت دارد، زیرا این خروجی یک مقدار تفسیرشده است که دقیقاً مشابه خروجی --output-event-state در ipmi-sel(8) تفسیر خواهد شد. تا زمانی که تفسیر رخداد پشتیبانی شود، تمام رخدادها دارای وضعیت خروجی خواهند بود. وضعیت رخداد مقداری تفسیرشده بر اساس فایل پیکربندی /etc/freeipmi/freeipmi_interpret_sel.conf و جهت رخداد است. برای اطلاعات بیشتر به freeipmi_interpret_sel.conf(5) مراجعه کنید.
تعیین فایل پیکربندی وضعیت رخداد جایگزین. در صورت عدم تعیین --output-event-state، این گزینه نادیده گرفته می‌شود.
تعیین یک شناسه سازنده خاص برای فرض شدن. در صورتی مفید است که بخواهید --interpret-oem-data را تعیین کنید، اما شناسه سازنده از طریق دسترسی IPMI قابل تشخیص نبوده یا در تله SNMP موجود نباشد. شناسه سازنده مادربورد می‌تواند با bmc-info(8) تعیین شود. اگر این گزینه مشخص شود، --product-id نیز باید مشخص گردد.
تعیین یک شناسه محصول خاص برای فرض شدن. در صورتی مفید است که بخواهید --interpret-oem-data را تعیین کنید، اما شناسه محصول از طریق دسترسی IPMI قابل تشخیص نبوده یا در تله SNMP موجود نباشد. شناسه محصول مادربورد می‌تواند با bmc-info(8) تعیین شود. اگر این گزینه مشخص شود، --manufacturer-id نیز باید مشخص گردد.
تلاش برای تفسیر داده‌های سازنده اصلی (OEM)، مانند داده‌های رخداد، خوانش سنسورها، یا اطلاعات اضافی عمومی و غیره. چنانچه تفسیر OEM در دسترس نباشد، خروجی پیش‌فرض تولید خواهد شد. درستی تفاسیر OEM به دلیل تغییرات احتمالی سازندگان OEM در محصولات، سفت‌افزار و غیره قابل تضمین نیست. برای مشاهده تفاسیر تاییدشده مادربوردهای پشتیبانی‌شده، بخش تفسیر OEM را در زیر ببینید.
خروجی دادن نام سنسورها با پیشوند شناسه موجودیت (entity id) و شماره نمونه (instance number) در زمان‌های مناسب. این ممکن است در برخی مادربوردها برای کمک به شناسایی سنسورهای ارجاع‌شده ضروری باشد. به عنوان مثال، یک مادربورد ممکن است چندین سنسور به نام 'TEMP' داشته باشد. شناسه موجودیت و شماره نمونه ممکن است به روشن شدن اینکه کدام سنسور به "پردازنده ۱" در مقابل "پردازنده ۲" اشاره دارد کمک کند.
عدم نمایش نوع سنسور برای هر مدخل در خروجی. در بسیاری از سیستم‌ها، نوع سنسور نسبت به نام سنسور حشو و تکراری است. این موضوع به ویژه در صورت تعیین --entity-sensor-names صادق است. اگر نام سنسور کافی باشد، یا اگر نوع سنسور مورد علاقه کاربر نباشد، می‌توان این گزینه را برای خلاصه‌سازی خروجی مشخص کرد.
نمایش فیلدهای خروجی در قالب تفکیک‌شده با کاما (CSV).
عدم چاپ سرستون‌ها در خروجی. ممکن است در اسکریپت‌نویسی مفید باشد.
نمایش واحدهای غیرمخفف (مثلاً 'Amps' به جای 'A'). ممکن است در ابهام‌زدایی واحدها کمک کند (مثلاً 'C' برای سلسیوس یا کولن).

این ابزار برای عملکرد عمومی نیازمند دسترسی به حافظه کش مخزن داده‌های سنسور (SDR) است. به طور پیش‌فرض، داده‌های SDR دانلود شده و در ماشین محلی کش می‌شوند. گزینه‌های زیر برای کش SDR اعمال می‌شوند:

پاکسازی نسخه کش‌شده مخزن داده‌های سنسور (SDR). کش SDR معمولاً برای دسترسی‌های بعدی سریع‌تر نگهداری می‌شود. با این حال، اگر SDR در سیستمی به‌روزرسانی شده باشد، ممکن است نیاز به تخلیه و بازتولید مجدد آن باشد.
عدم نمایش اطلاعات مربوط به ایجاد/حذف کش. ممکن است در اسکریپت‌نویسی مفید باشد.
چنانچه کش SDR قدیمی یا نامعتبر باشد، به طور خودکار کش مخزن داده‌های سنسور (SDR) را مجدداً ایجاد می‌کند. این گزینه ممکن است برای اهداف اسکریپت‌نویسی مفید باشد.
تعیین یک فایل خاص برای ذخیره یا خواندن کش مخزن داده‌های سنسور (SDR). اگر این گزینه در هنگام تعیین چند میزبان استفاده شود، همان فایل کش SDR برای تمام میزبان‌ها استفاده خواهد شد.
تعیین یک دایرکتوری جایگزین برای ذخیره یا خواندن کش‌های مخزن داده‌های سنسور (SDR). در صورت عدم تعیین، به طور پیش‌فرض پوشه خانگی (home) استفاده می‌شود.
نادیده گرفتن پردازش‌های مربوط به کش SDR. ممکن است منجر به خروجی اطلاعات ناقص یا با فایده کمتر شود، با این حال قابلیت استفاده را برای سیستم‌های بدون SDR یا زمانی که SDR صحیح بارگذاری نمی‌شود فراهم می‌کند.

در اغلب موارد، مشکلات IPMI ناشی از پیکربندی نادرست هستند.

مشکلات IPMI بر روی LAN شامل پیکربندی نادرست BMC ماشین راه دور است. مجدداً بررسی کنید که موارد زیر به درستی در BMC ماشین راه دور پیکربندی شده باشند: آدرس IP، آدرس MAC، ماسک زیرشبکه، نام کاربری، فعال بودن کاربر، دسترسی کاربر، رمز عبور، دسترسی LAN، فعال بودن LAN و نوع(های) مجاز احراز هویت. برای اتصالات IPMI 2.0، مجدداً بررسی کنید که دسترسی(های) مجموعه رمزنگاری و کلید K_g به درستی پیکربندی شده باشند. ابزار ipmi-config(8) می‌تواند برای بررسی و/یا تغییر این تنظیمات پیکربندی استفاده شود.

مشکلات IPMI درون‌باند معمولاً ناشی از درایورهای نادرست پیکربندی‌شده یا BMCهای غیراستاندارد هستند.

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

در زیر بسیاری از خطاهای متداول ذکر شده است. برای پشتیبانی بیشتر، لطفاً به فهرست پستی <freeipmi-users@gnu.org> ایمیل بزنید.

"username invalid" - نام کاربری واردشده (یا نام کاربری تهی اگر مقداری وارد نشده باشد) در ماشین راه دور موجود نیست. همچنین ممکن است پیکربندی نام کاربری BMC راه دور نادرست باشد.

"password invalid" - رمز عبور واردشده (یا رمز عبور تهی اگر مقداری وارد نشده باشد) صحیح نیست. همچنین ممکن است رمز عبور کاربر به درستی در BMC راه دور پیکربندی نشده باشد.

"password verification timeout" - تأیید اعتبار رمز عبور با مهلت زمانی روبرو شده است. خطای "password invalid" (توصیف‌شده در بالا) یا یک خطای عمومی "session timeout" (توصیف‌شده در زیر) رخ داده است. در این نقطه از پروتکل نمی‌توان تشخیص داد کدام یک رخ داده است.

"k_g invalid" - کلید K_g واردشده (یا کلید تهی اگر مقداری وارد نشده باشد) صحیح نیست. همچنین ممکن است کلید K_g به درستی در BMC راه دور پیکربندی نشده باشد.

"privilege level insufficient" - یک دستور IPMI نیازمند سطح دسترسی کاربری بالاتری نسبت به دسترسی احراز هویت‌شده است. لطفاً احراز هویت را با دسترسی بالاتری امتحان کنید. این ممکن است نیازمند احراز هویت با کاربر دیگری باشد که حداکثر سطح دسترسی بالاتری دارد.

"privilege level cannot be obtained for this user" - سطح دسترسی که تلاش می‌کنید با آن احراز هویت کنید بالاتر از حداکثر سطح مجاز برای این کاربر است. لطفاً با دسترسی پایین‌تری دوباره تلاش کنید. همچنین ممکن است حداکثر سطح دسترسی مجاز برای یک کاربر به درستی در BMC راه دور پیکربندی نشده باشد.

"authentication type unavailable for attempted privilege level" - نوع احراز هویتی که می‌خواهید با آن احراز هویت کنید برای این سطح دسترسی در دسترس نیست. لطفاً مجدداً با نوع احراز هویت جایگزین یا سطح دسترسی متناوب تلاش کنید. همچنین ممکن است انواع احراز هویت موجود که می‌توانید با آن‌ها احراز هویت کنید به درستی در BMC راه دور پیکربندی نشده باشند.

"cipher suite id unavailable" - شناسه مجموعه رمزنگاری که می‌خواهید با آن احراز هویت کنید در BMC راه دور در دسترس نیست. لطفاً مجدداً با یک شناسه مجموعه رمزنگاری جایگزین تلاش کنید. همچنین ممکن است شناسه‌های مجموعه رمزنگاری در دسترس به درستی در BMC راه دور پیکربندی نشده باشند.

"ipmi 2.0 unavailable" - استاندارد IPMI 2.0 در ماشین راه دور شناسایی نشد. لطفاً به جای آن از IPMI 1.5 استفاده نمایید.

"connection timeout" - ارتباط اولیه IPMI با شکست مواجه شد. تعدادی خطای بالقوه محتمل است، از جمله تعیین نام میزبان نامعتبر، عدم امکان تجزیه آدرس IP مربوط به IPMI، فعال نبودن IPMI روی سرور راه دور، نامناسب بودن اتصال شبکه و غیره. لطفاً پیکربندی و اتصال شبکه را بررسی کنید.

"session timeout" - مهلت زمانی نشست IPMI به پایان رسیده است. لطفاً مجدداً متصل شوید. اگر این خطا زیاد رخ می‌دهد، ممکن است مایل باشید مهلت ارسال مجدد را افزایش دهید. برخی BMCهای راه دور به طور قابل توجهی کندتر از دیگران هستند.

"device not found" - دستگاه مشخص‌شده یافت نشد. لطفاً پیکربندی یا ورودی‌ها را بررسی کرده و مجدداً تلاش کنید.

"driver timeout" - ارتباط با درایور یا دستگاه با مهلت زمانی مواجه شد. لطفاً مجدداً تلاش کنید.

"message timeout" - ارتباط با درایور یا دستگاه با مهلت زمانی مواجه شد. لطفاً مجدداً تلاش کنید.

"BMC busy" - تراشه BMC در حال حاضر مشغول است. ممکن است در حال پردازش اطلاعات باشد یا نشست‌های همزمان زیادی برای مدیریت داشته باشد. لطفاً صبر کرده و دوباره تلاش کنید.

"could not find inband device" - دستگاه درون‌باند یافت نشد. لطفاً پیکربندی را بررسی کرده یا دستگاه و درایور خاصی را در خط فرمان مشخص کنید.

"driver timeout" - درایور درون‌باند در برقراری ارتباط با BMC محلی یا پردازنده خدمات با مهلت زمانی مواجه شد. تراشه BMC یا پردازنده خدمات ممکن است مشغول بوده یا (در بدترین حالت) احتمالاً کار نکند.

"internal IPMI error" - یک خطای داخلی IPMI رخ داده است که FreeIPMI نحوه مدیریت آن را نمی‌داند. لطفاً برای گزارش موضوع به <freeipmi-users@gnu.org> ایمیل بزنید.

با توجه به پیاده‌سازی راهکارهای IPMI توسط سازندگان مختلف، برخی سازندگان ممکن است پروتکل‌های IPMI خود را نادرست پیاده‌سازی کنند. در ادامه تعدادی از راهکارهای موجود برای مدیریت مشکلات انطباق کشف‌شده تشریح شده است. در صورت امکان، راهکارها به گونه‌ای پیاده‌سازی شده‌اند که برای کاربر شفاف باشند. با این حال، برخی نیاز به تعیین صریح توسط کاربر از طریق گزینه -W دارند.

سخت‌افزار فهرست‌شده در زیر ممکن است تنها نشان‌دهنده سخت‌افزاری باشد که مشکل در آن کشف شده است. نسخه‌های جدیدتر سخت‌افزار ممکن است مشکلات ذکرشده در زیر را برطرف کرده باشند. ماشین‌های مشابه از سازندگان ممکن است همان مشکلات را نشان دهند یا ندهند. سازندگان مختلف ممکن است سفت‌افزار خود را از یک توسعه‌دهنده سفت‌افزار IPMI مشترک خریداری کرده باشند، بنابراین ممکن است ارزش داشته باشد حتی اگر مادربورد شما در فهرست نیست، راهکارهای فهرست‌شده در زیر را امتحان کنید.

اگر معتقدید سخت‌افزار شما دارای مشکل انطباق دیگری است که نیاز به پیاده‌سازی یک راهکار دارد، لطفاً با نگهدارندگان FreeIPMI در <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org> تماس بگیرید.

assumeio - این پرچم فرض می‌کند که رابط‌های درون‌باند به جای نگاشت در حافظه، با I/O سیستم ارتباط برقرار می‌کنند. این کار مشکل سیستم‌هایی را دور می‌زند که آدرس‌های پایه نامعتبر گزارش می‌دهند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "device not supported" یا "could not find inband device" را مشاهده کنند. این مشکل در HP ProLiant DL145 G1 مشاهده شده است.

spinpoll - این پرچم به برخی درایورهای درون‌باند (به ویژه درایور KCS) اطلاع می‌دهد که در هنگام نظرسنجی (polling) به جای به خواب بردن پردازش، چرخش مداوم (spin) انجام دهند. این کار ممکن است زمان اجرای ابزارها را به طور چشمگیری بهبود بخشد، زیرا دقت زمان‌بند سیستم‌عامل ممکن است بسیار بزرگ‌تر از زمان لازم برای انجام یک تراکنش پیام منفرد IPMI باشد. با این حال، با چرخش مداوم، سیستم شما ممکن است با خارج نکردن ابزار از زمینه برای یک کار مفیدتر، کار مفید کمتری انجام دهد.

authcap - این پرچم از بررسی‌های اولیه برای قابلیت‌های نام کاربری، قابلیت‌های احراز هویت و پشتیبانی K_g صرف‌نظر کرده و اجازه می‌دهد احراز هویت IPMI موفق شود. این گزینه مشکلات متعددی را که در آن سیستم راه دور قابلیت‌های نام کاربری، احراز هویت یا وضعیت K_g را به درستی گزارش نمی‌کند دور می‌زند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "username invalid"، "authentication type unavailable for attempted privilege level" یا "k_g invalid" را مشاهده کنند. این مشکل در Asus P5M2/P5MT-R/RS162-E4/RX4، Intel SR1520ML/X38ML و Sun Fire 2200/4150/4450 با ELOM مشاهده شده است.

nochecksumcheck - این پرچم به FreeIPMI می‌گوید که مجموع‌های مقابله‌ای (checksums) بازگردانده‌شده از پاسخ‌های دستورات IPMI را بررسی نکند. این گزینه مشکل سیستم‌هایی را دور می‌زند که به دلیل خطاهای پیاده‌سازی، مجموع مقابله‌ای نامعتبر بازمی‌گردانند، اما بسته در غیر این صورت معتبر است. به کاربران در مورد استفاده از این گزینه هشدار داده می‌شود، زیرا اعتبارسنجی یکپارچگی بسته را در شرایط متعددی حذف می‌کند. با این حال، در اکثر موقعیت‌ها بعید است که مشکلی ایجاد کند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "connection timeout"، "session timeout" یا "password verification timeout" را مشاهده کنند. در اتصالات IPMI 1.5، ممکن است به راهکار "noauthcodecheck" نیز نیاز باشد. مشکل در Supermicro X9SCM-iiF، Supermicro X9DRi-F و Supermicro X9DRFR مشاهده شده است.

idzero - این پرچم اجازه می‌دهد شناسه‌های نشست خالی توسط کلاینت پذیرفته شوند. این گزینه مشکل نشست‌های IPMI را دور می‌زند که شناسه‌های نشست خالی را به کلاینت گزارش می‌کنند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در Tyan S2882 با M3289 BMC مشاهده شده است.

unexpectedauth - این پرچم اجازه می‌دهد کدهای احراز هویت غیرتهی غیرمنتظره به گونه‌ای بررسی شوند که گویی مورد انتظار بوده‌اند. این کار مشکلی را دور می‌زند که در آن بسته‌ها حاوی داده‌های احراز هویت غیرتهی هستند در حالی که به دلیل غیرفعال بودن احراز هویت به ازای هر پیام، باید تهی باشند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در Dell PowerEdge 2850,SC1425 مشاهده شده و در سفت‌افزارهای جدیدتر رفع شده است.

forcepermsg - این پرچم احراز هویت به ازای هر پیام را اجباری می‌کند، بدون توجه به آنچه توسط سیستم راه دور اعلام شده است. این گزینه مشکلی را دور می‌زند که در آن احراز هویت به ازای هر پیام به عنوان غیرفعال در سیستم راه دور اعلام شده است، اما در واقع برای پروتکل الزامی است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در IBM eServer 325 مشاهده شده است.

endianseq - این پرچم ترتیب بایت‌ها (endianness) در شماره‌های توالی نشست را تغییر می‌دهد تا به نشست اجازه دهد به درستی ادامه یابد. این گزینه مشکل شماره‌های توالی نشست در IPMI 1.5 را که دارای ترتیب بایت نادرست هستند برطرف می‌کند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در برخی نسخه‌های Sun ILOM 1.0/2.0 مشاهده شده است (بستگی به ترتیب بایت پردازنده خدمات دارد).

noauthcodecheck - این پرچم به FreeIPMI می‌گوید که کدهای احراز هویت بازگردانده‌شده از پاسخ‌های دستورات IPMI 1.5 را بررسی نکند. این گزینه مشکل سیستم‌هایی را دور می‌زند که به دلیل خطاهای درهم‌سازی یا پیاده‌سازی، کدهای احراز هویت نامعتبر بازمی‌گردانند. به کاربران در مورد استفاده از این گزینه هشدار داده می‌شود، زیرا بررسی احراز هویت برای تأیید اعتبار یک بسته را حذف می‌کند. با این حال، در اکثر سازمان‌ها، بعید است که این یک مشکل امنیتی باشد. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "connection timeout"، "session timeout" یا "password verification timeout" را مشاهده نمایند. مشکل در Xyratex FB-H8-SRAY، Intel Windmill، Quanta Winterfell و Wiwynn Windmill مشاهده شده است.

intel20 - این پرچم چندین مشکل احراز هویت در IPMI 2.0 اینتل را دور می‌زند. مشکلات پوشش‌داده‌شده شامل افزودن فاصله‌گذاری (padding) به نام‌های کاربری و کوتاه‌سازی رمز عبور در صورت استفاده از الگوریتم احراز هویت HMAC-MD5-128 است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "username invalid"، "password invalid" یا "k_g invalid" را مشاهده کنند. مشکل در Intel SE7520AF2 با ماژول مدیریت سرور اینتل (نسخه حرفه‌ای) مشاهده شده است.

supermicro20 - این پرچم چندین مشکل احراز هویت در IPMI 2.0 سوپرمایکرو را در مادربوردهای دارای سفت‌افزار Peppercon IPMI دور می‌زند. مسائل تحت پوشش شامل مدیریت کدهای احراز هویت با طول نامعتبر است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "password invalid" را مشاهده کنند. مشکل در Supermicro H8QME با کارت دختر SIMSO مشاهده شده و در سفت‌افزارهای جدیدتر رفع گردیده است.

sun20 - این پرچم چندین مشکل احراز هویت در IPMI 2.0 سان را دور می‌زند. مسائل تحت پوشش شامل کلیدهای درهم‌سازی با طول نامعتبر، کلیدهای نادرست درهم‌سازی‌شده و رکوردهای مجموعه رمزنگاری نامعتبر است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "password invalid" یا "bmc error" را مشاهده نمایند. مشکل در Sun Fire 4100/4200/4500 با ILOM مشاهده شده است. این راهکار به طور خودکار راهکار "opensesspriv" را نیز در بر می‌گیرد.

opensesspriv - این پرچم پروتکل اتصال IPMI 2.0 در FreeIPMI را کمی تغییر می‌دهد تا الگوریتم درهم‌سازی نامعتبر استفاده‌شده توسط سیستم راه دور را دور بزند. سطح دسترسی ارسالی در مرحله Open Session از اتصال IPMI 2.0 به جای سطح دسترسی ارسالی در مرحله اتصال RAKP1 برای درهم‌سازی کلیدها استفاده می‌شود. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "password invalid"، "k_g invalid"، "bad rmcpplus status code" یا "privilege level cannot be obtained for this user" را مشاهده کنند. مشکل در Sun Fire 4100/4200/4500 با ILOM، Inventec 5441/Dell Xanadu II، Supermicro X8DTH، Supermicro X8DTG، Intel S5500WBV/Penguin Relion 700، Intel S2600JF/Appro 512X، Quanta QSSC-S4R/Appro GB812X-CN، Dell C5220 و BMC نرم‌افزاری OpenIPMI مشاهده شده است. این راهکار به طور خودکار با راهکار "sun20" فعال می‌شود.

integritycheckvalue - این پرچم یک مقدار بررسی یکپارچگی نامعتبر را در هنگام برپایی نشست IPMI 2.0 هنگام استفاده از شناسه مجموعه رمزنگاری ۰ دور می‌زند. مقدار بررسی یکپارچگی باید دارای طول ۰ باشد، اما مادربورد راه دور با یک فیلد غیرخالی پاسخ می‌دهد. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "k_g invalid" را مشاهده کنند. مشکل در Supermicro X8DTG، Supermicro X8DTU و Intel S5500WBV/Penguin Relion 700 و Intel S2600JF/Appro 512X مشاهده شده است.

assumemaxsdrrecordcount - این راهکار به خواننده SDR اطلاع می‌دهد که پس از خوانده شدن حداکثر تعداد رکوردهای شناخته‌شده SDR، خواندن را متوقف کند. این کار مشکل سیستم‌هایی را که عملکردهای خواندن SDR را نادرست پیاده‌سازی کرده‌اند دور می‌زند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "SDR record count invalid" را مشاهده کنند. مشکل در یک مادربورد نامشخص Inspur مشاهده شده است.

malformedack - این پرچم پاسخ‌های تاییدیه PET ناقص یا بدفرم را نادیده گرفته و فرض می‌کند هر پاسخ تاییدیه PET از ماشین راه دور معتبر است. این گزینه مشکل سیستم‌های راه دور را دور می‌زند که به درخواست‌های تاییدیه PET با داده‌های بارگذاری IPMI نامعتبر یا بدفرم پاسخ می‌دهند. کسانی که با این مشکل مواجه می‌شوند ممکن است هنگام اجرای تاییدیه PET خطاهای "session timeout" را مشاهده کنند. مشکل در Dell Poweredge R610 مشاهده شده است.

عدم پشتیبانی از IPMI 1.5 - مشاهده شده است که برخی مادربوردهای پشتیبانی‌کننده از IPMI 2.0 از IPMI 1.5 پشتیبانی نمی‌کنند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "ipmi 2.0 unavailable" یا "connection timeout" را مشاهده کنند. این مشکل می‌تواند با استفاده از IPMI 2.0 به جای IPMI 1.5 از طریق تعیین --driver-type=LAN_2_0 دور زده شود. مشکل در تعدادی از مادربوردهای HP و Supermicro مشاهده شده است.

تایید شده است که مادربوردهای زیر حداقل تا حدی توسط گزینه --interpret-oem-data پشتیبانی می‌شوند. اگرچه بسیار محتمل است که تفاسیر داده‌های OEM در سایر مادربوردهای همان سازنده نیز کار کنند، اما هیچ تضمینی وجود ندارد. برخی از مادربوردهای زیر ممکن است توسط فروشندگان/توزیع‌کنندگان با نام دیگری عرضه شده باشند.

در حال حاضر هیچ‌کدام (None)

تفسیر یک PET با استفاده از حافظه کش محلی SDR:

# ipmi-pet 356224 0x44 0x45 0x4c 0x4c 0x50 0x00 0x10 0x59 0x80 0x43 0xb2 0xc0 0x4f 0x33 0x33 0x58 0x00 0x02 0x19 0xe8 0x7e 0x26 0xff 0xff 0x20 0x20 0x04 0x20 0x73 0x18 0x00 0x80 0x01 0xff 0x00 0x00 0x00 0x00 0x00 0x19 0x00 0x00 0x02 0xa2 0x01 0x00 0xc1

تفسیر یک PET با استفاده از کش راه دور SDR:

# ipmi-pet -h ahost -u myusername -p mypassword 356224 0x44 0x45 0x4c 0x4c 0x50 0x00 0x10 0x59 0x80 0x43 0xb2 0xc0 0x4f 0x33 0x33 0x58 0x00 0x02 0x19 0xe8 0x7e 0x26 0xff 0xff 0x20 0x20 0x04 0x20 0x73 0x18 0x00 0x80 0x01 0xff 0x00 0x00 0x00 0x00 0x00 0x19 0x00 0x00 0x02 0xa2 0x01 0x00 0xc1

تفسیر یک PET با استفاده از یک فایل کش SDR ذخیره‌شده از قبل:

# ipmi-pet 356224 0x44 0x45 0x4c 0x4c 0x50 0x00 0x10 0x59 0x80 0x43 0xb2 0xc0 0x4f 0x33 0x33 0x58 0x00 0x02 0x19 0xe8 0x7e 0x26 0xff 0xff 0x20 0x20 0x04 0x20 0x73 0x18 0x00 0x80 0x01 0xff 0x00 0x00 0x00 0x00 0x00 0x19 0x00 0x00 0x02 0xa2 0x01 0x00 0xc1 --sdr-cache-file=/tmp/mysdrcache

به جای چاپ تفسیر تله، ارسال یک تاییدیه PET با استفاده از داده‌های تله:

# ipmi-pet -h ahost --pet-acknowledge 356224 0x44 0x45 0x4c 0x4c 0x50 0x00 0x10 0x59 0x80 0x43 0xb2 0xc0 0x4f 0x33 0x33 0x58 0x00 0x02 0x19 0xe8 0x7e 0x26 0xff 0xff 0x20 0x20 0x04 0x20 0x73 0x18 0x00 0x80 0x01 0xff 0x00 0x00 0x00 0x00 0x00 0x19 0x00 0x00 0x02 0xa2 0x01 0x00 0xc1

پس از اجرای موفق، وضعیت خروج ۰ است. در صورت بروز خطا، وضعیت خروج ۱ خواهد بود.

در سیستم‌عامل‌های قدیمی‌تر، اگر نام کاربری، رمز عبور و سایر اطلاعات حساس امنیتی را در خط فرمان وارد کنید، ممکن است این اطلاعات توسط سایر کاربران هنگام استفاده از ابزارهایی مانند دستور ps(1) یا جستجو در سیستم فایل proc/ کشف شوند. به طور کلی وارد کردن اطلاعات رمز عبور با گزینه‌هایی مانند -P یا -K امن‌تر است. پیکربندی اطلاعات مربوط به امنیت در فایل پیکربندی FreeIPMI نیز روش مناسبی برای پنهان کردن این اطلاعات خواهد بود.

به منظور جلوگیری از حملات brute force، برخی BMCها پس از چند خطای متوالی در احراز هویت از راه دور موقتاً «قفل» می‌شوند. ممکن است لازم باشد مدتی صبر کنید تا این قفل موقت برطرف شود و بتوانید دوباره احراز هویت کنید.

گزارش باگ‌ها به <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org>.

کپی‌رایت © 2011-2015 تیم هسته FreeIPMI

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، ویرایش ۳ یا (به انتخاب خودتان) هر ویرایش بالاتری، بازتوزیع کرده یا تغییر دهید.

freeipmi(7), bmc-info(8), ipmi-config(8), ipmi-sel(8), freeipmi_interpret_sel.conf(5)

http://www.gnu.org/software/freeipmi

2026-08-27 IPMI-PET version 1.6.19