| IPMI-FRU(8) | System Commands | IPMI-FRU(8) |
نام (NAME)
ipmi-fru - نمایش اطلاعات واحدهای قابل تعویض در محل (FRU)
خلاصه دستور (SYNOPSIS)
ipmi-fru [گزینه...]
توضیحات (DESCRIPTION)
دستور ipmi-fru اطلاعات واحدهای قابل تعویض در محل (FRU) را نمایش میدهد. واحد FRU ممکن است شامل اطلاعات گوناگونی از قبیل اطلاعات دستگاه، اطلاعات سختافزاری، شمارههای سریال و شمارههای قطعه باشد.
در زیر گزینههای عمومی IPMI، گزینههای اختصاصی این ابزار، اطلاعات عیبیابی، راهکارهای دور زدن ناسازگاریها، مثالها و مشکلات شناختهشده فهرست شدهاند. برای آشنایی عمومی با FreeIPMI لطفاً به freeipmi(7) مراجعه کنید.
گزینههای عمومی (GENERAL OPTIONS)
گزینههای زیر گزینههایی عمومی برای پیکربندی ارتباط IPMI و اجرای دستورات کلی ابزار هستند.
- -D IPMIDRIVER, --driver-type=IPMIDRIVER
- نوع درایور مورد استفاده را بهجای انتخاب خودکار مشخص میکند. درایورهای خارج از باند (out-of-band) موجود در حال حاضر LAN و LAN_2_0 هستند که به ترتیب IPMI 1.5 و IPMI 2.0 را اجرا میکنند. درایورهای درونباندی (in-band) موجود در حال حاضر KCS، SSIF، OPENIPMI، SUNBMC و INTELDCMI هستند.
- --disable-auto-probe
- دستگاههای IPMI درونباندی را برای تنظیمات پیشفرض کاوش و جستجو نمیکند.
- --driver-address=DRIVER-ADDRESS
- آدرس درایور درونباندی را بهجای مقدار کاوششده تعیین میکند. DRIVER-ADDRESS برای مقادیر هگزادسیمال باید پیشوند «0x» و برای مقادیر اکتال پیشوند «0» داشته باشد.
- --driver-device=DEVICE
- مسیر فایل دستگاه درایور درونباندی را بهجای مسیر کاوششده مشخص میکند.
- --register-spacing=REGISTER-SPACING
- فاصلهگذاری رجیسترهای درایور درونباندی را بهجای مقدار کاوششده تعیین میکند. مقدار آرگومان بر حسب بایت است (مثلاً فاصلهگذاری رجیستر ۳۲ بیتی = ۴).
- --target-channel-number=CHANNEL-NUMBER
- شماره کانال مقصد درایور درونباندی را برای ارسال درخواستهای IPMI تعیین میکند.
- --target-slave-address=SLAVE-ADDRESS
- شماره اسلیو مقصد درایور درونباندی را برای ارسال درخواستهای IPMI تعیین میکند.
- -h IPMIHOST1,IPMIHOST2,..., --hostname=IPMIHOST1[:PORT],IPMIHOST2[:PORT],...
- میزبان(های) دوردست را برای برقراری ارتباط مشخص میکند. چندین نام میزبان را میتوان با کاما از هم جدا کرد یا در قالب بازه مشخص نمود؛ بخش «پشتیبانی از بازه میزبانها» را در ادامه ببینید. میتوان یک درگاه (پورت) اختیاری را برای هر میزبان مشخص کرد که در موارد هدایت درگاه (port forwarding) یا شرایط مشابه کاربرد دارد. هنگام تعیین آدرس IPv6 و درگاه، از قالب [ADDRESS]:PORT استفاده کنید.
- -u USERNAME, --username=USERNAME
- نام کاربری مورد استفاده برای احراز هویت با میزبان دوردست را تعیین میکند. در صورت عدم تعیین، نام کاربری تهی (ناشناس) در نظر گرفته میشود. کاربر برای کارکرد کامل این ابزار باید حداقل دارای سطح دسترسی USER باشد.
- -p PASSWORD, --password=PASSWORD
- گذرواژه مورد استفاده برای احراز هویت با میزبان دوردست را مشخص میکند. در صورت عدم تعیین، گذرواژه تهی در نظر گرفته میشود. حداکثر طول گذرواژه برای IPMI 1.5 برابر ۱۶ و برای IPMI 2.0 برابر ۲۰ کاراکتر است.
- -P, --password-prompt
- گذرواژه را از طریق اعلان ورودی میپرسد تا از احتمال نمایش آن در فهرست فرآیندها جلوگیری شود.
- -k K_G, --k-g=K_G
- کلید K_g BMC را برای احراز هویت با میزبان دوردست در IPMI 2.0 تعیین میکند. در صورت عدم تعیین، یک کلید تهی در نظر گرفته میشود. برای وارد کردن کلید در قالب هگزادسیمال، پیشوند «0x» به ابتدای رشته بیفزایید. برای نمونه، کلید «abc» را میتوان با رشته «abc» یا رشته «0x616263» وارد کرد.
- -K, --k-g-prompt
- کلید k-g را از طریق اعلان ورودی میپرسد تا از احتمال نمایش آن در فهرست فرآیندها جلوگیری شود.
- --session-timeout=MILLISECONDS
- مهلت زمانی نشست (session timeout) را بر حسب میلیثانیه تعیین میکند. در صورت عدم تعیین، مقدار پیشفرض ۲۰۰۰۰ میلیثانیه (۲۰ ثانیه) است.
- --retransmission-timeout=MILLISECONDS
- مهلت زمانی ارسال مجدد بسته را بر حسب میلیثانیه تعیین میکند. در صورت عدم تعیین، مقدار پیشفرض ۱۰۰۰ میلیثانیه (۱ ثانیه) است. مهلت زمانی ارسال مجدد نمیتواند بزرگتر از مهلت زمانی نشست باشد.
- -a AUTHENTICATION-TYPE, --authentication-type=AUTHENTICATION-TYPE
- نوع احراز هویت IPMI 1.5 را مشخص میکند. انواع احراز هویت موجود در حال حاضر عبارتند از NONE، STRAIGHT_PASSWORD_KEY، MD2 و MD5. در صورت عدم تعیین، پیشفرض MD5 است.
- -I CIPHER-SUITE-ID, --cipher-suite-id=CIPHER-SUITE-ID
- شناسه Cipher Suite در
IPMI 2.0 را مشخص
میکند.
شناسه Cipher Suite
مجموعهای
از
الگوریتمهای
احراز
هویت،
یکپارچگی
داده و
محرمانگی
را برای
ارتباط IPMI 2.0
مشخص
میکند.
الگوریتم
احراز هویت
برای
برپایی
نشست،
الگوریتم
یکپارچگی
برای امضای
بستههای
نشست و
الگوریتم
محرمانگی
برای
رمزنگاری
دادههای
ارسالی
بهکار
میرود. در
صورت عدم
تعیین،
پیشفرض
شناسه ۳
است.
شناسههای
Cipher Suite زیر در
حال حاضر
پشتیبانی
میشوند:
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
- -l PRIVILEGE-LEVEL, --privilege-level=PRIVILEGE-LEVEL
- سطح دسترسی مورد استفاده را تعیین میکند. سطوح دسترسی موجود در حال حاضر عبارتند از USER، OPERATOR و ADMIN. در صورت عدم تعیین، پیشفرض USER است.
- --config-file=FILE
- یک فایل پیکربندی جایگزین را مشخص میکند.
- -W WORKAROUNDS, --workaround-flags=WORKAROUNDS
- راهکارهای دور زدن مشکلات عدم تطابق سازندگان را مشخص میکند. چندین راهکار را میتوان با کاما از هم جدا کرد. پرچم ویژه «none» در خط فرمان نشاندهنده عدم استفاده از هرگونه راهکار است (برای لغو پیشفرضهای پیکربندیشده کاربرد دارد). بخش «راهکارهای دور زدن ناسازگاری» را در ادامه برای فهرست راهکارهای موجود ببینید.
- --debug
- اشکالزدایی (دیباگ) را فعال میکند.
- -?, --help
- فهرست راهنما را نمایش داده و خارج میشود.
- --usage
- پیام نحوه استفاده کوتاه را نمایش داده و خارج میشود.
- -V, --version
- نسخه برنامه را نمایش داده و خارج میشود.
گزینههای IPMI-FRU (IPMI-FRU OPTIONS)
گزینههای زیر مختص ipmi-fru هستند.
- -e, --device-id=IDNUM
- شناسه دستگاه FRU خاصی را تعیین میکند.
- -v, --verbose
- جزئیات خروجی را برای در بر گرفتن اطلاعات اضافی افزایش میدهد.
- --bridge-fru
- بهطور پیشفرض، ورودیهای FRU روی سایر کنترلکنندههای ماهوارهای خوانده نخواهند شد. ممکن است پلزنی (bridging) روی برخی رابطها/انواع درایور کار نکند.
- --interpret-oem-data
- تلاش میکند دادههای سازنده اصلی تجهیزات (OEM) مانند دادههای رخداد، قرائتهای حسگرها یا اطلاعات اضافی عمومی و غیره را تفسیر کند. اگر تفسیری برای OEM در دسترس نباشد، خروجی پیشفرض تولید خواهد شد. صحت تفسیر دادههای OEM به دلیل تغییرات احتمالی سازندگان در محصولات، سفتافزار و غیره قابل تضمین نیست. بخش «تفسیر دادههای OEM» را در ادامه برای مادربوردهای پشتیبانیشده بررسی کنید.
- --fru-file=FILENAME
- بهجای خواندن دادههای FRU از روی برد، اطلاعات را از فایل باینری FRU مشخصشده نمایش میدهد.
گزینههای حافظه موقت SDR (SDR CACHE OPTIONS)
این ابزار برای عملکرد عمومی به حافظه موقت مخزن دادههای حسگر (SDR) نیاز دارد. بهطور پیشفرض، دادههای SDR دریافت شده و روی سیستم محلی ذخیره موقت میشوند. گزینههای زیر برای حافظه موقت SDR اعمال میشوند.
- --flush-cache
- نسخه ذخیرهشده از حافظه موقت مخزن دادههای حسگر (SDR) را پاکسازی (فلاش) میکند. SDR معمولاً برای دسترسیهای سریعتر بعدی ذخیره موقت میشود. با این حال، در صورت بهروزرسانی SDR در سیستم، ممکن است نیاز به پاکسازی و تولید مجدد آن باشد.
- --quiet-cache
- اطلاعات مربوط به ایجاد یا حذف حافظه موقت را در خروجی چاپ نمیکند. برای استفاده در اسکریپتها کاربرد دارد.
- --sdr-cache-recreate
- در صورتی که حافظه موقت SDR منسوخ یا نامعتبر باشد، حافظه موقت مخزن دادههای حسگر (SDR) را بهطور خودکار مجدداً ایجاد میکند. این گزینه برای مقاصد اسکریپتنویسی مفید است.
- --sdr-cache-file=FILE
- فایل حافظه موقت مخزن دادههای حسگر (SDR) خاصی را برای ذخیره یا خواندن مشخص میکند. در صورت استفاده از این گزینه هنگام تعیین چندین میزبان، همان فایل یکسان برای همه میزبانها استفاده خواهد شد.
- --sdr-cache-directory=DIRECTORY
- یک پوشه جایگزین را برای ذخیره یا خواندن حافظههای موقت مخزن دادههای حسگر (SDR) تعیین میکند. در صورت عدم تعیین، پیشفرض پوشه خانگی کاربر است.
- --ignore-sdr-cache
- پردازشهای مربوط به حافظه موقت SDR را نادیده میگیرد. این امر ممکن است منجر به ناقص بودن یا کاهش سودمندی اطلاعات خروجی شود، اما امکان کارکرد در سیستمهای بدون SDR یا در زمان بارگذاری ناموفق SDR صحیح را فراهم میسازد.
گزینههای زمان (TIME OPTIONS)
طبق تعاریف IPMI، تمام زمانها و برچسبهای زمانی IPMI در زمان محلی (localtime) ذخیره میشوند. با این حال در بسیاری از شرایط، برچسبهای زمانی در زمان محلی ذخیره نخواهند شد. این که آیا یک سیستم واقعاً برچسبهای زمانی را در زمان محلی ذخیره کرده است یا خیر، به عوامل متعددی از جمله سازنده، بایوس (BIOS) و سیستمعامل بستگی دارد. گزینههای زیر به کاربر اجازه میدهند نحوه تفسیر برچسبهای زمانی ذخیرهشده و نحوه خروجی آنها را تنظیم کند.
- --utc-to-localtime
- فرض میکند تمام زمانها به وقت جهانی (UTC) گزارش شدهاند و زمان را پیش از نمایش در خروجی به زمان محلی تبدیل میکند.
- --localtime-to-utc
- تمام برچسبهای زمانی زمان محلی را پیش از نمایش در خروجی به UTC تبدیل میکند.
- --utc-offset=SECONDS
- یک آفست اختصاصی UTC بر حسب ثانیه را برای افزودن به برچسبهای زمانی تعیین میکند. مقدار میتواند در بازه ۸۶۴۰۰- تا ۸۶۴۰۰ ثانیه باشد. پیشفرض ۰ است.
گزینههای بازه میزبانها (HOSTRANGED OPTIONS)
گزینههای زیر خروجی مبتنی بر بازه میزبانها را مدیریت میکنند. برای اطلاعات تکمیلی درباره بازه میزبانها، بخش «پشتیبانی از بازه میزبانها» را در ادامه ببینید.
- -B, --buffer-output
- خروجی بازه میزبانها را بافر میکند. برای هر گره، خروجی استاندارد را تا زمان پایان عملیات IPMI آن گره بافر میکند. با تعیین این گزینه، خروجی ممکن است کندتر به نظر برسد زیرا باید کل عملیات IPMI قبل از چاپ هرگونه داده به پایان برسد. برای اطلاعات بیشتر بخش «پشتیبانی از بازه میزبانها» را در ادامه ببینید.
- -C, --consolidate-output
- خروجی بازه میزبانها را تجمیع و ادغام میکند. خروجی استاندارد کامل از هر گره مشخصشده تجمیع میشود تا گرههای دارای خروجی یکسان دو بار چاپ نشوند. یک هدر گرههای مربوط به خروجی ادغامشده را فهرست خواهد کرد. هنگام تعیین این گزینه، هیچ خروجی تا زمان اتمام عملیات IPMI در تمام گرهها دیده نخواهد شد. در صورتی که کاربر برنامه را زودتر متوقف کند، تمام خروجیهای تجمیعشده تا آن لحظه تخلیه میشوند. برای اطلاعات تکمیلی بخش «پشتیبانی از بازه میزبانها» را در ادامه ببینید.
- -F NUM, --fanout=NUM
- تعداد گسترش (fanout) همزمان چند میزبان را تعیین میکند. یک الگوریتم «پنجره لغزان» (یا fanout) برای ارتباط موازی IPMI استفاده میشود تا گرههای کندتر یا منقضیشده مانع ارتباط موازی نشوند. حداکثر تعداد ریسمانهای همزمان در دسترس با fanout محدود میشود. مقدار پیشفرض ۶۴ است.
- -E, --eliminate
- میزبانهایی را که توسط ipmidetect شناسایینشده تشخیص داده شدهاند حذف میکند. این کار تلاشی است برای برطرف کردن مشکل رایج منقضی شدن اجرای بازه میزبانها به دلیل خارج شدن چندین گره از سرویس در یک کلاستر بزرگ. دیمن ipmidetectd باید روی گره اجراکننده دستور در حال اجرا باشد.
- --always-prefix
- همیشه پیشوند خروجی را درج میکند، حتی اگر تنها یک میزبان مشخص شده باشد یا ارتباط درونباندی باشد. این گزینه در درجه اول برای اهداف اسکریپتنویسی مفید است. اگر همراه با گزینه -C تعیین شود، نادیده گرفته خواهد شد.
پشتیبانی از بازه میزبانها (HOSTRANGED SUPPORT)
چندین میزبان را میتوان به عنوان یک فهرست جداشده با کاما از میزبانها یا یک بازه از نامهای میزبان در قالب عمومی زیر وارد کرد: prefix[n-m,l-k,...] بهطوری که n < m و l < k و غیره. قالب دوم نباید با کلاسهای کاراکتری عبارات منظم (که با [] نیز مشخص میشوند) اشتباه گرفته شود. برای نمونه، foo[19] نمایانگر foo1 یا foo9 نیست، بلکه یک بازه تبهگن (دژنره) یعنی foo19 را نشان میدهد.
این نحو بازهای صرفاً برای راحتی در کلاسترهایی با قرارداد نامگذاری prefixNN در نظر گرفته شده است و مشخص کردن بازهها نباید ضروری تلقی شود -- فهرست foo1,foo9 را میتوان دقیقاً به همین صورت یا با بازه foo[1,9] مشخص کرد.
چند نمونه از کاربرد بازه در ادامه آمده است:
foo[01-05] بهجای foo01,foo02,foo03,foo04,foo05 foo[7,9-10] بهجای foo7,foo9,foo10 foo[0-3] بهجای foo0,foo1,foo2,foo3
به عنوان یادآوری، برخی پوستهها قلابها ([ و ]) را برای تطبیق الگو تفسیر میکنند. بسته به پوسته شما، ممکن است لازم باشد فهرستهای بازهای را داخل علامتهای نقلقول (کوتیشن) قرار دهید.
هنگامی که چندین میزبان توسط کاربر مشخص میشود، یک ریسمان برای هر میزبان به صورت موازی تا سقف fanout پیکربندیشده (که از طریق گزینه -F قابل تنظیم است) اجرا خواهد شد. این کار امکان برقراری ارتباط با تعداد زیادی از گرهها را بسیار سریعتر از حالت ترتیبی فراهم میکند.
بهطور پیشفرض، خروجی استاندارد از هر گره مشخصشده با نام میزبان پیشوندشده در ابتدای هر خط چاپ خواهد شد. گرچه این خروجی در بسیاری از شرایط خواناست، اما در شرایط دیگر ممکن است خواندن آن دشوار باشد. برای نمونه، ممکن است خروجی گرههای مختلف با هم مخلوط شود. از گزینههای -B و -C میتوان برای تغییر این رفتار پیشفرض استفاده کرد.
هنگامی که میزبان "localhost" مشخص شود، از ارتباط IPMI درونباندی استفاده خواهد شد. این ویژگی به کاربر امکان میدهد میزبان محلی را نیز به خروجی بازه میزبانها اضافه کند.
عیبیابی عمومی (GENERAL TROUBLESHOOTING)
در بیشتر مواقع، مشکلات IPMI ناشی از اشکالات پیکربندی است.
مشکلات IPMI از طریق LAN شامل پیکربندی نادرست BMC در ماشین دوردست است. مجدداً بررسی کنید که موارد زیر در BMC ماشین دوردست به درستی پیکربندی شده باشند: آدرس IP، آدرس MAC، ماسک زیرشبکه، نام کاربری، فعالسازی کاربر، سطح دسترسی کاربر، گذرواژه، مجوز LAN، فعالسازی LAN و نوع/انواع احراز هویت مجاز. برای اتصالات IPMI 2.0، مجدداً بررسی کنید که مجوز(های) Cipher Suite و کلید K_g به درستی پیکربندی شده باشند. ابزار ipmi-config(8) میتواند برای بررسی یا تغییر این تنظیمات پیکربندی استفاده شود.
مشکلات IPMI درونباندی معمولاً به دلیل درایورهای با پیکربندی نامناسب یا BMCهای غیراستاندارد ایجاد میشوند.
علاوه بر نکات عیبیابی زیر، لطفاً بخش «راهکارهای دور زدن ناسازگاری» را در ادامه ببینید تا از باگهای کشفشده ویژه سازندگان و راهکارهای آنها نیز مطلع شوید.
در زیر بسیاری از مشکلات رایج پیامهای خطا فهرست شدهاند. برای پشتیبانی بیشتر، لطفاً به فهرست پستی <freeipmi-users@gnu.org> ایمیل ارسال کنید.
"username invalid" - نام کاربری واردشده (یا نام کاربری NULL در صورت عدم ورود) در ماشین دوردست در دسترس نیست. همچنین ممکن است پیکربندی نام کاربری BMC دوردست نادرست باشد.
"password invalid" - گذرواژه واردشده (یا گذرواژه NULL در صورت عدم ورود) درست نیست. همچنین ممکن است گذرواژه کاربر در BMC دوردست به درستی پیکربندی نشده باشد.
"password verification timeout" - مهلت زمانی تایید گذرواژه به پایان رسیده است. خطای «password invalid» (شرح دادهشده در بالا) یا یک «session timeout» عمومی (شرح دادهشده در زیر) رخ داده است. در این مرحله از پروتکل نمیتوان تشخیص داد کدام مورد اتفاق افتاده است.
"k_g invalid" - کلید K_g واردشده (یا کلید 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" - شناسه Cipher Suite که میخواهید با آن احراز هویت کنید در BMC دوردست در دسترس نیست. لطفاً مجدداً با یک شناسه Cipher Suite جایگزین امتحان کنید. همچنین ممکن است شناسههای موجود Cipher Suite در 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> ایمیل ارسال کنید.
راهکارهای دور زدن ناسازگاری (WORKAROUNDS)
با وجود تعداد زیادی از سازندگان مختلف که راهحلهای 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) چرخش مکرر انجام دهند. این کار ممکن است زمان اجرای ابزارها را به میزان قابل توجهی بهبود بخشد زیرا دانهبندی زمانبند سیستمعامل ممکن است بسیار بیشتر از زمان لازم برای انجام یک تراکنش پیام 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 میگوید که مجموع مقابلهای (checksum) بازگرداندهشده از پاسخهای دستورات 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 را بررسی نکند. این کار مشکل سیستمهایی را دور میزند که به دلیل خطاهای درهمسازی (hashing) یا پیادهسازی، کدهای احراز هویت نامعتبر بازمیگردانند. به کاربران در مورد استفاده از این گزینه هشدار داده میشود، زیرا بررسی احراز هویت تأییدکننده اعتبار بسته را حذف میکند. با این حال، در بیشتر سازمانها بعید است که این یک مشکل امنیتی باشد. افرادی که با این مشکل مواجه میشوند ممکن است خطاهای «connection timeout» یا «session timeout» یا «password verification timeout» را مشاهده کنند. مشکل در Xyratex FB-H8-SRAY، Intel Windmill، Quanta Winterfell و Wiwynn Windmill مشاهده شده است.
intel20 - این پرچم راهکار چندین مشکل احراز هویت Intel IPMI 2.0 را دور میزند. مشکلات پوششدادهشده شامل افزودن فاصلهگذاری به نامهای کاربری و کوتاهسازی گذرواژه در صورت استفاده از الگوریتم احراز هویت HMAC-MD5-128 است. افرادی که با این مشکل مواجه میشوند ممکن است خطاهای «username invalid» یا «password invalid» یا «k_g invalid» را مشاهده کنند. مشکل در Intel SE7520AF2 با Intel Server Management Module (نسخه Professional) مشاهده شده است.
supermicro20 - این پرچم راهکار چندین مشکل احراز هویت Supermicro IPMI 2.0 را روی مادربوردهای دارای سفتافزار Peppercon IPMI دور میزند. مشکلات پوششدادهشده شامل مدیریت کدهای احراز هویت با طول نامعتبر است. افرادی که با این مشکل مواجه میشوند ممکن است خطاهای «password invalid» را مشاهده کنند. مشکل در Supermicro H8QME با کارت دختر SIMSO مشاهده شده است. رفع مشکل در سفتافزارهای جدیدتر تأیید شده است.
sun20 - این پرچم راهکار چندین مشکل احراز هویت Sun IPMI 2.0 را دور میزند. مشکلات پوششدادهشده شامل کلیدهای درهمسازی با طول نامعتبر، کلیدهای درهمسازی نادرست و رکوردهای Cipher Suite نامعتبر است. افرادی که با این مشکل مواجه میشوند ممکن است خطاهای «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 و OpenIPMI نرمافزاری BMC مشاهده شده است. این راهکار بهطور خودکار با راهکار «sun20» فعال میشود.
integritycheckvalue - این پرچم راهکار یک مقدار بررسی یکپارچگی نامعتبر را در زمان برپایی نشست IPMI 2.0 هنگام استفاده از شناسه Cipher Suite صفر دور میزند. مقدار بررسی یکپارچگی باید دارای طول ۰ باشد، اما مادربورد دوردست با یک فیلد غیرخالی پاسخ میدهد. افرادی که با این مشکل مواجه میشوند ممکن است خطاهای «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 مشاهده شده است.
skipchecks - این گزینه راهکار از بررسیهای مجموع مقابلهای FRU صرفنظر میکند. برخی از FRUها مجموع مقابلهای نادرست دارند، اما دادههای FRU صحیح هستند. افرادی که با این مشکل مواجه میشوند ممکن است خطاهای «checksum invalid» را در خروجی FRU خود مشاهده کنند. خروجی ممکن است نامشخص باشد و باید به بهترین نتیجه امیدوار بود. تأیید شده است که این گزینه مشکلات انطباق را در مادربوردهای Inventec 5441/Dell Xanadu II، Dell Poweredge R610 و Dell Poweredge R710 دور میزند.
عدم پشتیبانی از 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 مشاهده شده است.
تفسیر دادههای OEM (OEM INTERPRETATION)
تأیید شده است که مادربوردهای زیر حداقل تا حدی توسط گزینه --interpret-oem-data پشتیبانی میشوند. اگرچه بسیار محتمل است که تفسیر دادههای OEM روی سایر مادربوردهای همان سازنده نیز کار کند، اما هیچ تضمینی وجود ندارد. برخی از مادربوردهای زیر ممکن است توسط فروشندگان/توزیعکنندگان با نام تجاری دیگری عرضه شده باشند.
Wistron/Dell Poweredge C6220
مثالها (EXAMPLES)
# ipmi-fru
دریافت اطلاعات FRU ماشین محلی.
# ipmi-fru --verbose
دریافت اطلاعات کامل و باجزئیات FRU ماشین محلی.
# ipmi-fru -h ahost -u myusername -p mypassword
دریافت اطلاعات FRU یک ماشین دوردست با استفاده از IPMI بر روی LAN.
# ipmi-fru -h mycluster[0-127] -u myusername -p mypassword
دریافت اطلاعات FRU در سراسر یک کلاستر با استفاده از IPMI بر روی LAN.
مشکلات شناختهشده IPMI-FRU (IPMI-FRU KNOWN ISSUES)
همه کدهای زبان در ipmi-fru پشتیبانی نمیشوند. در صورت نیاز به پشتیبانی از کدهای زبان بیشتر، لطفاً با توسعهدهندگان FreeIPMI تماس بگیرید.
عیبیابی (DIAGNOSTICS)
پس از اجرای موفقیتآمیز، وضعیت خروج ۰ است. در صورت بروز خطا، وضعیت خروج ۱ خواهد بود.
اگر چندین میزبان برای برقراری ارتباط مشخص شده باشند، وضعیت خروج ۰ خواهد بود اگر و تنها اگر تمام اهداف با موفقیت اجرا شوند. در غیر این صورت وضعیت خروج ۱ است.
مشکلات شناختهشده (KNOWN ISSUES)
در سیستمعاملهای قدیمیتر، اگر نام کاربری، گذرواژه و سایر اطلاعات بالقوه حساس امنیتی خود را در خط فرمان وارد کنید، این اطلاعات ممکن است توسط سایر کاربران هنگام استفاده از ابزارهایی مانند دستور ps(1) یا بررسی در فایلسیستم /proc کشف شود. بهطور کلی وارد کردن اطلاعات گذرواژه با گزینههایی مانند -P یا -K امنتر است. پیکربندی اطلاعات مربوط به امنیت در فایل پیکربندی FreeIPMI نیز روش مناسبی برای پنهان کردن این اطلاعات خواهد بود.
برای جلوگیری از حملات بروت فورس (brute force)، برخی از BMCها پس از چندین خطای احراز هویت از راه دور موقتاً «قفل» میشوند. ممکن است لازم باشد مدتی صبر کنید تا این «قفل موقت» برطرف شود و بتوانید دوباره احراز هویت کنید.
گزارش باگها (REPORTING BUGS)
گزارش باگها را به <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org> ارسال کنید.
حق نشر (COPYRIGHT)
حق نشر 2007-2015 Lawrence
Livermore National Security, LLC.
حق نشر 2007 The Regents of the University
of California.
این برنامه یک نرمافزار آزاد است؛ شما میتوانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرمافزارهای آزاد منتشر شده است، چه نسخه ۳ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید.
همچنین ببینید (SEE ALSO)
freeipmi(7), ipmi-config(8)
| 2026-08-27 | ipmi-fru 1.6.19 |