.TH IPMI-CONFIG 8 "2026-08-27" "ipmi-config 1.6.19" "دستورهای سیستمی"
.SH "نام (NAME)"
ipmi-config \- پیکربندی مقادیر و تنظیمات IPMI
.SH "خلاصه دستور (SYNOPSIS)"
.B ipmi-config
[\fIگزینه\fR...]
.SH "توضیحات (DESCRIPTION)"
.B ipmi-config
برای دریافت و تنظیم پارامترهای پیکربندی در IPMI استفاده می‌شود. می‌توان از آن برای پیکربندی نام‌های کاربری، گذرواژه‌ها، اطلاعات شبکه، امنیت، سریال از طریق LAN (یا SOL)، فیلتر کردن رخدادهای پلتفرم (PEF)، دستگاه‌های راه‌اندازی (بوت)، سیاست بازیابی برق، آستانه‌های حسگرها، رخدادهای حسگرها و بسیاری از گزینه‌های پیکربندی دیگر استفاده کرد.
معمولاً قبل از اینکه بتوان از اکثر ابزارهای IPMI برای دسترسی از راه دور به یک دستگاه استفاده کرد، مقداری پیکربندی لازم است. به‌طور پیش‌فرض،
.B ipmi-config
به شما اجازه می‌دهد فقط مقادیر
\fIcore\fR
(هسته) IPMI را که برای پیکربندی IPMI ضروری هستند، با
\fI\-\-checkout\fR
یا
\fI\-\-commit\fR
دریافت یا اعمال کنید. برای فیلدهای پیکربندی پیشرفته اضافی مربوط به پیکربندی شاسی (شامل گزینه‌های راه‌اندازی)، فیلتر کردن رخدادهای پلتفرم (PEF)، یا حسگرها، گزینه
\fI\-\-category\fR
را در زیر ببینید. برای جزئیات بیشتر در مورد پیکربندی
\fIcore\fR
در IPMI، به
.B ipmi-config.conf(5)
مراجعه کنید.
اکثریت عملیات‌های پیکربندی در هنگام استفاده از
.B ipmi-config
به صورت خارج از باند (out-of-band) نیازمند سطح دسترسی ADMIN هستند. اگرچه اتصال از طریق کاربری با دسترسی ADMIN برای استفاده خارج از باند الزامی نیست، اما بخش عمده‌ای از گزینه‌های پیکربندی بازیابی یا تنظیم نخواهند شد.
.LP
در زیر گزینه‌های عمومی IPMI، گزینه‌های اختصاصی ابزار، اطلاعات عیب‌یابی، اطلاعات راهکارهای دور زدن مشکلات، مثال‌ها و مشکلات شناخته‌شده آورده شده است. برای آشنایی عمومی با FreeIPMI لطفاً به
.B freeipmi(7)
مراجعه کنید.
برای توضیحات مربوط به کاربرد پایه
.B ipmi-config
بخش «کاربرد عمومی» را در زیر ببینید.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
گزینه‌های زیر گزینه‌های عمومی برای پیکربندی ارتباطات IPMI و اجرای دستورات کلی ابزار هستند.
.TP
\fB\-D\fR \fIIPMIDRIVER\fR, \fB\-\-driver\-type\fR=\fIIPMIDRIVER\fR
نوع درایور مورد استفاده را به جای انتخاب خودکار مشخص می‌کند. درایورهای خارج از باند (out-of-band) که در حال حاضر در دسترس هستند LAN و LAN_2_0 می‌باشند که به ترتیب IPMI 1.5 و IPMI 2.0 را اجرا می‌کنند. درایورهای درون باند (in-band) که در حال حاضر در دسترس هستند عبارتند از KCS، SSIF، OPENIPMI، SUNBMC و INTELDCMI.
.TP
\fB\-\-disable\-auto\-probe\fR
دستگاه‌های IPMI درون باند را برای تنظیمات پیش‌فرض بررسی (probe) نمی‌کند.
.TP
\fB\-\-driver\-address\fR=\fIDRIVER-ADDRESS\fR
آدرس درایور درون باند را برای استفاده به جای مقدار بررسی‌شده مشخص می‌کند. \fIDRIVER-ADDRESS\fR برای مقادیر هگزادسیمال باید با "0x" و برای مقادیر اکتال با '0' پیشوندگذاری شود.
.TP
\fB\-\-driver\-device\fR=\fIDEVICE\fR
مسیر دستگاه درایور درون باند را برای استفاده به جای مسیر بررسی‌شده مشخص می‌کند.
.TP
\fB\-\-register\-spacing\fR=\fIREGISTER-SPACING\fR
فاصله‌گذاری رجیسترهای درایور درون باند را به جای مقدار بررسی‌شده مشخص می‌کند. آرگومان بر حسب بایت است (مثلاً فاصله‌گذاری رجیستر ۳۲ بیتی = ۴).
.TP
\fB\-\-target\-channel\-number\fR=\fICHANNEL\-NUMBER\fR
شماره کانال هدف درایور درون باند را برای ارسال درخواست‌های IPMI مشخص می‌کند.
.TP
\fB\-\-target\-slave\-address\fR=\fISLAVE\-ADDRESS\fR
شماره آدرس وابسته (slave) هدف درایور درون باند را برای ارسال درخواست‌های IPMI مشخص می‌کند.
.TP
\fB\-h\fR \fIIPMIHOST1,IPMIHOST2,...\fR, \fB\-\-hostname\fR=\fIIPMIHOST1[:PORT],IPMIHOST2[:PORT],...\fR
میزبان(های) راه دور را برای برقراری ارتباط مشخص می‌کند. چندین نام میزبان را می‌توان با کاما جدا کرد یا در قالب محدوده مشخص نمود؛ به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید. یک پورت اختیاری را می‌توان برای هر میزبان مشخص کرد که ممکن است در فوروارد پورت یا شرایط مشابه مفید باشد. اگر آدرس و پورت IPv6 مشخص می‌کنید، از قالب [ADDRESS]:PORT استفاده کنید.
.TP
\fB\-u\fR \fIUSERNAME\fR, \fB\-\-username\fR=\fIUSERNAME\fR
نام کاربری مورد استفاده هنگام احراز هویت با میزبان راه دور را مشخص می‌کند. در صورت عدم تعیین، یک نام کاربری تهی (یعنی ناشناس) در نظر گرفته می‌شود. کاربر برای کارکرد کامل این ابزار باید حداقل از امتیازات ADMIN برخوردار باشد.
.TP
\fB\-p\fR \fIPASSWORD\fR, \fB\-\-password\fR=\fIPASSWORD\fR
گذرواژه مورد استفاده هنگام احراز هویت با میزبان راه دور را مشخص می‌کند. در صورت عدم تعیین، گذرواژه تهی در نظر گرفته می‌شود. حداکثر طول گذرواژه برای IPMI 1.5 برابر ۱۶ و برای IPMI 2.0 برابر ۲۰ است.
.TP
\fB\-P\fR, \fB\-\-password-prompt\fR
درخواست گذرواژه در خط فرمان برای جلوگیری از احتمال ثبت و نمایش آن در لیست پردازش‌ها.
.TP
\fB\-k\fR \fIK_G\fR, \fB\-\-k-g\fR=\fIK_G\fR
کلید K_g متعلق به BMC را برای احراز هویت با میزبان راه دور در IPMI 2.0 مشخص می‌کند. در صورت عدم تعیین، یک کلید تهی در نظر گرفته می‌شود. برای وارد کردن کلید در قالب هگزادسیمال، رشته را با '0x' پیشوندگذاری کنید. برای مثال، کلید 'abc' را می‌توان با رشته 'abc' یا رشته '0x616263' وارد کرد.
.TP
\fB\-K\fR, \fB\-\-k-g-prompt\fR
درخواست برای دریافت k-g جهت جلوگیری از احتمال ثبت و نمایش آن در لیست پردازش‌ها.
.TP
\fB\-\-session-timeout\fR=\fIMILLISECONDS\fR
مهلت زمانی نشست را بر حسب میلی‌ثانیه مشخص می‌کند. در صورت عدم تعیین، به‌طور پیش‌فرض 20000 میلی‌ثانیه (۲۰ ثانیه) است.
.TP
\fB\-\-retransmission-timeout\fR=\fIMILLISECONDS\fR
مهلت زمانی ارسال مجدد بسته را بر حسب میلی‌ثانیه مشخص می‌کند. در صورت عدم تعیین، به‌طور پیش‌فرض 1000 میلی‌ثانیه (۱ ثانیه) است. مهلت ارسال مجدد نمی‌تواند بزرگتر از مهلت زمانی نشست باشد.
.TP
\fB\-a\fR \fIAUTHENTICATION\-TYPE\fR, \fB\-\-authentication\-type\fR=\fIAUTHENTICATION\-TYPE\fR
نوع احراز هویت IPMI 1.5 را برای استفاده مشخص می‌کند. انواع احراز هویت در دسترس در حال حاضر عبارتند از NONE، STRAIGHT_PASSWORD_KEY، MD2 و MD5. در صورت عدم تعیین، به‌طور پیش‌فرض MD5 است.
.TP
\fB\-I\fR \fICIPHER-SUITE-ID\fR, \fB\-\-cipher\-suite-id\fR=\fICIPHER-SUITE-ID\fR
شناسه مجموعه‌رمز (Cipher Suite ID) در IPMI 2.0 را برای استفاده مشخص می‌کند. شناسه مجموعه‌رمز مجموعه‌ای از الگوریتم‌های احراز هویت، یکپارچگی و محرمانگی را برای استفاده در ارتباطات IPMI 2.0 تعیین می‌کند. الگوریتم احراز هویت الگوریتم مورد استفاده برای برپایی نشست، الگوریتم یکپارچگی الگوریتم مورد استفاده برای امضای بسته‌های نشست و الگوریتم محرمانگی الگوریتم مورد استفاده برای رمزنگاری داده‌ها (payload) را مشخص می‌کند. در صورت عدم تعیین، پیش‌فرض شناسه مجموعه‌رمز 3 است. شناسه‌های مجموعه‌رمز زیر در حال حاضر پشتیبانی می‌شوند:
.sp
0 \- الگوریتم احراز هویت = None؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None
.sp
1 \- الگوریتم احراز هویت = HMAC-SHA1؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None
.sp
2 \- الگوریتم احراز هویت = HMAC-SHA1؛ الگوریتم یکپارچگی = HMAC-SHA1-96؛ الگوریتم محرمانگی = None
.sp
3 \- الگوریتم احراز هویت = HMAC-SHA1؛ الگوریتم یکپارچگی = HMAC-SHA1-96؛ الگوریتم محرمانگی = AES-CBC-128
.\" .sp
.\" 4 - Authentication Algorithm = HMAC-SHA1; Integrity Algorithm = HMAC-SHA1-96; Confidentiality Algorithm = xRC4-128
.\" .sp
.\" 5 - Authentication Algorithm = HMAC-SHA1; Integrity Algorithm = HMAC-SHA1-96; Confidentiality Algorithm = xRC4-40
.sp
6 \- الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None
.sp
7 \- الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = HMAC-MD5-128؛ الگوریتم محرمانگی = None
.sp
8 \- الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = HMAC-MD5-128؛ الگوریتم محرمانگی = AES-CBC-128
.\" .sp
.\" 9 - Authentication Algorithm = HMAC-MD5; Integrity Algorithm = HMAC-MD5-128; Confidentiality Algorithm = xRC4-128
.\" .sp
.\" 10 - Authentication Algorithm = HMAC-MD5; Integrity Algorithm = HMAC-MD5-128; Confidentiality Algorithm = xRC4-40
.sp
11 \- الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = MD5-128؛ الگوریتم محرمانگی = None
.sp
12 \- الگوریتم احراز هویت = HMAC-MD5؛ الگوریتم یکپارچگی = MD5-128؛ الگوریتم محرمانگی = AES-CBC-128
.\" .sp
.\" 13 - Authentication Algorithm = HMAC-MD5; Integrity Algorithm = MD5-128; Confidentiality Algorithm = xRC4-128
.\" .sp
.\" 14 - Authentication Algorithm = HMAC-MD5; Integrity Algorithm = MD5-128; Confidentiality Algorithm = xRC4-40
.\" XXX GUESS
.sp
15 \- الگوریتم احراز هویت = HMAC-SHA256؛ الگوریتم یکپارچگی = None؛ الگوریتم محرمانگی = None
.\" XXX GUESS
.sp
16 \- الگوریتم احراز هویت = HMAC-SHA256؛ الگوریتم یکپارچگی = HMAC_SHA256_128؛ الگوریتم محرمانگی = None
.sp
17 \- الگوریتم احراز هویت = HMAC-SHA256؛ الگوریتم یکپارچگی = HMAC_SHA256_128؛ الگوریتم محرمانگی = AES-CBC-128
.\" XXX GUESS
.\" .sp
.\" 18 - Authentication Algorithm = HMAC-SHA256; Integrity Algorithm = HMAC_SHA256_128; Confidentiality Algorithm = xRC4-128
.\" XXX GUESS
.\" .sp
.\" 19 - Authentication Algorithm = HMAC-SHA256; Integrity Algorithm = HMAC_SHA256_128; Confidentiality Algorithm = xRC4-40
.TP
\fB\-l\fR \fIPRIVILEGE\-LEVEL\fR, \fB\-\-privilege-level\fR=\fIPRIVILEGE\-LEVEL\fR
سطح دسترسی مورد استفاده را مشخص می‌کند. سطوح دسترسی در دسترس در حال حاضر عبارتند از USER، OPERATOR و ADMIN. در صورت عدم تعیین، به‌طور پیش‌فرض ADMIN است.
.TP
\fB\-\-config\-file\fR=\fIFILE\fR
یک فایل پیکربندی جایگزین را مشخص می‌کند.
.TP
\fB\-W\fR \fIWORKAROUNDS\fR, \fB\-\-workaround\-flags\fR=\fIWORKAROUNDS\fR
راهکارهای دور زدن مشکلات عدم تطابق سازندگان با استاندارد را مشخص می‌کند. چندین راهکار را می‌توان با جدا کردن توسط کاما مشخص کرد. پرچم ویژه "none" در خط فرمان نشان‌دهنده عدم استفاده از هرگونه راهکار دور زدن خواهد بود (برای بازنویسی مقادیر پیش‌فرض پیکربندی‌شده مفید است). برای فهرستی از راهکارهای موجود به بخش «راهکارهای دور زدن مشکلات» در زیر مراجعه کنید.
.TP
\fB\-\-debug\fR
اشکال‌زدایی (debugging) را فعال می‌کند.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش راهنمای دستور و خروج.
.TP
\fB\-\-usage\fR
نمایش نحوه کاربرد دستور و خروج.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش نسخه برنامه و خروج.
.SH "گزینه‌های IPMI-CONFIG (IPMI-CONFIG OPTIONS)"
گزینه‌های زیر برای خواندن، نوشتن و یافتن تفاوت‌ها در مقادیر پیکربندی استفاده می‌شوند.
.TP
\fB\-g\fR \fICATEGORY\fR, \fB\-\-category\fR=\fICATEGORY\fR
دسته یا دسته‌های داده‌های پیکربندی را برای پیکربندی مشخص می‌کند. انتخاب‌های در دسترس فعلی: \fIcore\fR، \fIchassis\fR، \fIsensors\fR، \fIpef\fR و \fIdcmi\fR. چندین دسته را می‌توان با کاما از هم جدا کرد. دسته \fIcore\fR شامل تمام پیکربندی‌های اصلی IPMI است که برای عملکرد IPMI روی یک سیستم لازم است، مانند پیکربندی کاربران، گذرواژه‌ها، احراز هویت، شبکه، و سریال از طریق شبکه (SOL). دسته \fIchassis\fR شامل تمام پیکربندی‌های مربوط به شاسی از جمله گزینه‌های راه‌اندازی (بوت)، دکمه‌های پنل جلو، و رفتار برق است. دسته \fIdcmi\fR شامل توابع تخصصی ارائه‌شده توسط رابط مدیریت مرکز داده (DCMI) است. در صورت عدم تعیین، پیش‌فرض \fIcore\fR است.
.TP
\fB\-o\fR, \fB\-\-checkout\fR
واکشی اطلاعات پیکربندی.
.TP
\fB\-c\fR, \fB\-\-commit\fR
به‌روزرسانی اطلاعات پیکربندی از یک فایل پیکربندی یا جفت‌های کلید.
.TP
\fB\-d\fR, \fB\-\-diff\fR
نمایش تفاوت‌های بین اطلاعات ذخیره‌شده و یک فایل پیکربندی یا جفت‌های کلید.
.TP
\fB\-n\fR \fIFILENAME\fR, \fB\-\-filename\fR=\fIFILENAME\fR
مشخص کردن یک فایل پیکربندی برای checkout/commit/diff. در صورت مشخص شدن همراه با checkout، نمی‌توان آن را با چندین میزبان یا همراه با \fB\-\-always\-prefix\fR استفاده کرد.
.TP
\fB\-e\fR \fI"KEY=VALUE"\fR, \fB\-\-key\-pair\fR=\fI"KEY=VALUE"\fR
مشخص کردن جفت‌های KEY=VALUE برای checkout/commit/diff. مقدار KEY را به صورت SectionName:FieldName مشخص کنید. از این گزینه می‌توان چندین بار استفاده کرد. در زمان commit، هر جفت KEY=VALUE هر جفت مشخص‌شده در یک فایل را که با \fB\-\-filename\fR مشخص شده است بازنویسی می‌کند.
.TP
\fB\-S\fR \fISECTION\fR, \fB\-\-section\fR=\fISECTION\fR
مشخص کردن یک SECTION برای checkout. از این گزینه می‌توان چندین بار استفاده کرد. بخشی (SECTION) که مشخص می‌کنید باید درون دسته یا دسته‌های مشخص‌شده با \fI\-\-category\fR باشد.
.TP
\fB\-L\fR, \fB\-\-listsections\fR
فهرست کردن بخش‌های موجود برای checkout با توجه به دسته یا دسته‌های تحت \fI\-\-category\fR. برخی از بخش‌های موجود در فهرست ممکن است به‌طور پیش‌فرض checkout نشوند و نیاز به افزایش پرگویی (verbosity) داشته باشند.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش اطلاعات مشروح. هنگام استفاده همراه با \fI\-\-checkout\fR، بخش‌ها و/یا فیلدهای غیرمعمول اضافی نمایش داده خواهند شد. در دسته \fIcore\fR، این شامل استخراج پارامترهای پیکربندی سریال، پارامترهای Vlan، پارامترهای هدر IPv4، پورت RMCP، تمام آدرس‌های قابل پیکربندی IPv6 (در صورت پشتیبانی از بیش از 1 آدرس)، و بخش‌هایی برای هر کانال روی یک سیستم (در صورت وجود چندین کانال) است. در دسته \fIpef\fR، این شامل استخراج بخش‌هایی برای هر کانال روی یک سیستم (در صورت وجود چندین کانال) است.
.TP
\fB\-vv\fR
نمایش اطلاعات بسیار مشروح. خروجی دادن اطلاعات دقیق اضافی در مورد اینکه چه فیلدهایی می‌توانند و چه فیلدهایی نمی‌توانند استخراج شوند، و گاهی دلیل آن. گاهی خروجی دادن فیلدهایی که به عنوان پشتیبانی‌نشده روی مادربورد شناسایی شده‌اند.
.TP
\fB\-\-lan\-channel\-number\fR=\fINUMBER\fR
استفاده از یک شماره کانال مشخص برای پیکربندی LAN. به‌ویژه در صورتی مفید است که مادربورد شامل چندین کانال LAN باشد و کاربر بخواهد از یک کانال مشخص استفاده کند.
.TP
\fB\-\-serial\-channel\-number\fR=\fINUMBER\fR
استفاده از یک شماره کانال مشخص برای پیکربندی سریال. به‌ویژه در صورتی مفید است که مادربورد شامل چندین کانال سریال باشد و کاربر بخواهد از یک کانال مشخص استفاده کند.
.TP
\fB\-\-sol\-channel\-number\fR=\fINUMBER\fR
استفاده از یک شماره کانال مشخص برای پیکربندی SOL. به‌ویژه در صورتی مفید است که مادربورد شامل چندین کانال SOL باشد و کاربر بخواهد از یک کانال مشخص استفاده کند.
.SH "گزینه‌های حافظه موقت SDR (SDR CACHE OPTIONS)"
این ابزار برای کارکرد عمومی نیازمند دسترسی به حافظه موقت (کش) مخزن داده‌های حسگر (SDR) است. به‌طور پیش‌فرض، داده‌های SDR دانلود شده و روی دستگاه محلی ذخیره می‌شوند. گزینه‌های زیر برای حافظه موقت SDR اعمال می‌شوند.
.TP
\fB\-\-flush\-cache\fR
تخلیه نسخه ذخیره‌شده حافظه موقت مخزن داده‌های حسگر (SDR). SDR معمولاً برای دسترسی‌های سریع‌تر بعدی در حافظه موقت ذخیره می‌شود. با این حال، اگر SDR در یک سیستم به‌روز شده باشد، ممکن است نیاز به تخلیه و بازتولید مجدد داشته باشد.
.TP
\fB\-\-quiet\-cache\fR
عدم نمایش اطلاعات مربوط به ایجاد/حذف حافظه موقت. می‌تواند در اسکریپت‌نویسی مفید باشد.
.TP
\fB\-\-sdr\-cache\-recreate\fR
اگر حافظه موقت SDR منسوخ یا نامعتبر باشد، حافظه موقت مخزن داده‌های حسگر (SDR) را به‌طور خودکار دوباره ایجاد می‌کند. این گزینه ممکن است برای اهداف اسکریپت‌نویسی مفید باشد.
.TP
\fB\-\-sdr\-cache\-file\fR=\fIFILE\fR
یک فایل مشخص حافظه موقت مخزن داده‌های حسگر (SDR) را برای ذخیره‌سازی یا خواندن مشخص می‌کند. اگر این گزینه هنگام مشخص شدن چندین میزبان استفاده شود، فایل حافظه موقت SDR یکسانی برای تمام میزبان‌ها استفاده خواهد شد.
.TP
\fB\-\-sdr\-cache\-directory\fR=\fIDIRECTORY\fR
یک دایرکتوری جایگزین برای ذخیره‌سازی یا خواندن حافظه‌های موقت مخزن داده‌های حسگر (SDR) مشخص می‌کند. در صورت عدم تعیین، به‌طور پیش‌فرض به دایرکتوری خانه (home) ارجاع می‌شود.
.SH "گزینه‌های محدوده میزبان (HOSTRANGED OPTIONS)"
گزینه‌های زیر خروجی محدوده میزبان را دستکاری می‌کنند. برای اطلاعات بیشتر در مورد محدوده‌های میزبان به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید.
.TP
\fB\-B\fR, \fB\-\-buffer-output\fR
بافر کردن خروجی محدوده میزبان. برای هر گره، خروجی استاندارد را تا زمانی که گره عملیات IPMI خود را کامل کند بافر می‌کند. هنگام تعیین این گزینه، ممکن است به نظر برسد که داده‌ها با سرعت کمتری برای کاربر نمایش داده می‌شوند زیرا کل عملیات IPMI باید قبل از خروجی هر داده‌ای کامل شود. برای اطلاعات بیشتر به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید.
.TP
\fB\-C\fR, \fB\-\-consolidate-output\fR
تجمیع خروجی محدوده میزبان. خروجی استاندارد کامل از هر گره مشخص‌شده تجمیع می‌شود تا گره‌هایی با خروجی یکسان دو بار نمایش داده نشوند. یک سربرگ آن دسته از گره‌ها را با خروجی تجمیع‌شده فهرست می‌کند. هنگامی که این گزینه مشخص می‌شود، تا زمانی که عملیات IPMI روی همه گره‌ها کامل نشود، هیچ خروجی قابل مشاهده نخواهد بود. اگر کاربر برنامه را زودتر متوقف کند، تمام خروجی‌های تجمیع‌شده فعلی تخلیه خواهند شد. برای اطلاعات بیشتر به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید.
.TP
\fB\-F\fR \fINUM\fR, \fB\-\-fanout\fR=\fINUM\fR
میزان انشعاب (fanout) برای چندین میزبان را مشخص می‌کند. یک الگوریتم «پنجره لغزان» (یا fanout) برای ارتباط موازی IPMI استفاده می‌شود تا گره‌های کندتر یا گره‌هایی با وقفه زمانی مانع ارتباط موازی نشوند. حداکثر تعداد نخ‌های در دسترس به طور همزمان توسط انشعاب محدود می‌شود. مقدار پیش‌فرض 64 است.
.TP
\fB\-E\fR, \fB\-\-eliminate\fR
حذف میزبان‌هایی که توسط
.B ipmidetect
به عنوان شناسایی‌نشده تشخیص داده شده‌اند. این گزینه تلاش می‌کند مشکل رایج وقفه زمانی در اجرای محدوده میزبان به دلیل خارج شدن چندین گره از سرویس در یک کلاستر بزرگ را رفع کند. دیمن
.B ipmidetectd
باید روی گره‌ای که دستور را اجرا می‌کند در حال اجرا باشد.
.TP
\fB\-\-always\-prefix\fR
همیشه به خروجی پیشوند اضافه می‌کند، حتی اگر تنها یک میزبان مشخص شده باشد یا ارتباط به صورت درون باند باشد. این گزینه اساساً برای اهداف اسکریپت‌نویسی مفید است. اگر همراه با گزینه \fB\-C\fR مشخص شود، این گزینه نادیده گرفته خواهد شد.
.SH "کاربرد عمومی (GENERAL USE)"
اکثر کاربران مایل خواهند بود که:
.LP
الف) دستور را با \fI\-\-checkout\fR اجرا کنند تا یک رونوشت از پیکربندی فعلی دریافت کرده و آن را در یک فایل ذخیره کنند. خروجی استاندارد را می‌توان به یک فایل هدایت کرد یا فایل را می‌توان با استفاده از گزینه \fI\-\-filename\fR مشخص نمود.
.LP
ب) فایل پیکربندی را با یک ویرایشگر ویرایش کنند.
.LP
ج) پیکربندی را با استفاده از گزینه \fI\-\-commit\fR و تعیین فایل پیکربندی با گزینه \fI\-\-filename\fR به سیستم بازگردانند و اعمال کنند. پیکربندی را می‌توان از طریق پشتیبانی از محدوده میزبان، به صورت موازی روی چندین میزبان اعمال کرد.
.LP
اگرچه معمولاً ضروری نیست، اما برخی از مادربوردها مقادیر پیکربندی را در حافظه غیرفرار ذخیره نمی‌کنند. بنابراین، پس از راه‌اندازی مجدد سیستم، برخی مقادیر پیکربندی ممکن است تغییر کرده باشند. کاربر ممکن است مایل باشد ابزارهای پیکربندی را در هر بار راه‌اندازی سیستم اجرا کند تا از ماندگاری مقادیر پیکربندی اطمینان حاصل نماید.
.LP
گاهی اوقات در فایل‌های استخراج‌شده، نظراتی (توضیحات) حاوی اطلاعاتی در مورد نحوه پیکربندی فیلدها درج خواهد شد. صفحه راهنمای
.B ipmi-config.conf(5)
نیز اطلاعات اضافی درباره مفهوم فیلدهای مختلف ارائه می‌دهد.
.LP
برای کاربرانی با کلاسترهای بزرگ یا مجموعه‌ای از گره‌ها، ممکن است بخواهید از یک فایل پیکربندی یکسان برای تمام گره‌ها استفاده کنید. یک مشکل در این زمینه این است که آدرس IP و آدرس MAC روی هر گره در کلاستر شما متفاوت خواهد بود و بنابراین نمی‌توان آن‌ها را از طریق یک فایل کانفیگ یکسان پیکربندی کرد. آدرس IP و آدرس MAC موجود در فایل پیکربندی شما را می‌توان در خط فرمان با استفاده از گزینه \fI\-\-key\-pair\fR بازنویسی کرد. مثال زیر می‌تواند در یک اسکریپت برای پیکربندی هر گره در یک کلاستر با یک فایل پیکربندی BMC یکسان استفاده شود. اسکریپت فقط نیاز دارد آدرس IP و آدرس MAC صحیح را برای استفاده تعیین کند.
.LP
.B # ipmi-config --commit -k "Lan_Conf:Ip_Address=$MY_IP" -k "Lan_Conf:Mac_Address=$MY_MAC" --filename=my_bmc.conf
.SH "اطلاعات پیکربندی موارد خاص هسته (CORE SPECIAL CASE CONFIGURATION INFORMATION)"
فیلدهای
.B UserN:Password
(که در آن N یک عدد است) در برخی سیستم‌ها قابل استخراج (checkout) نیستند، بنابراین مقدار استخراج‌شده همیشه خالی خواهد بود.
.LP
فیلد
.B UserN:Enable_User
(که در آن N یک عدد است) در سیستم‌های قدیمی‌تر IPMI قابل استخراج نیست، بنابراین مقدار استخراج‌شده گاهی خالی خواهد بود.
.LP
فیلدهای
.B UserN:Lan_Session_Limit
و
.B UserN:Serial_Session_Limit
(که در آن N یک عدد است) در برخی سیستم‌ها قابل استخراج نیستند، بنابراین مقدار استخراج‌شده همیشه خالی خواهد بود. اگر در اعمال‌های بعدی پیکربندی مشخص نشود، این فیلد ممکن است به دلیل الزامی بودن مقدار ورودی برای محدودیت نشست توسط فیلدهای دیگر (که همراه با محدودیت نشست پیکربندی می‌شوند) به 0 بازنشانی شود. در بیشتر شرایط، نیازی به تنظیم این فیلد نیست و اکثر کاربران می‌توانند آن را نادیده بگیرند. این فیلد طبق استانداردهای IPMI اختیاری تلقی می‌شود و ممکن است هنگام تلاش برای پیکربندی آن روی یک مقدار غیر صفر منجر به خطا شود. در صورت بروز خطا، بازگرداندن مقدار به 0 باید مشکلات را حل کند.
.LP
فیلدهای
.B Lan_Conf:IP_Address
و
.B Lan_Conf:MAC_Address
نمی‌توانند به صورت موازی از طریق پشتیبانی از محدوده میزبان اعمال (commit) شوند. هر ماشین باید با یک زوج آدرس IP و آدرس MAC یکتا پیکربندی شود، بنابراین ما این پیکربندی را در
.B ipmi-config
غیرمجاز می‌دانیم.
.LP
در برخی مادربوردها،
.B Lan_Conf:MAC_Address
ممکن است فقط‌خواندنی باشد و آدرس MAC به صورت خودکار پیکربندی شود.
.LP
در برخی مادربوردها،
.B Lan_Conf:MAC_Address
ممکن است فقط‌خواندنی باشد و آدرس MAC از طریق یک دستور OEM پیکربندی شود. برای بررسی اینکه آیا پیکربندی OEM برای مادربورد شما پشتیبانی می‌شود یا خیر، به
.B ipmi-oem(8)
مراجعه کنید.
.LP
در برخی مادربوردها، تعدادی از فیلدهای پیکربندی کاربر تا زمانی که یک نام کاربری غیرتهی یا گذرواژه غیرتهی پیکربندی نشود، قابل خواندن یا پیکربندی نیستند. در برخی از این موارد، یک خروجی مناسب در فایل پیکربندی این وضعیت را نشان می‌دهد. با این حال، همه موارد خاص مادربوردها ممکن است شناسایی نشوند. کاربران ممکن است تمایل داشته باشند با ترتیب فیلدها برای دور زدن این مشکلات آزمون‌وخطا کنند.
.LP
در برخی مادربوردها، احراز هویت OEM در
.B Lan_Conf_Auth
نمی‌تواند فعال شود. با این حال، تنظیمات پیش‌فرض مادربورد این فیلدها را فعال دارند. به کاربران توصیه می‌شود تمام احراز هویت‌های OEM را در این بخش غیرفعال کنند.
.LP
در برخی مادربوردها، چندین کانال ممکن است برای ارتباط IPMI از طریق LAN یا سریال وجود داشته باشد. اگر چندین کانال وجود داشته باشد، پیکربندی هر دو کانال را می‌توان با اجرای \fI\-\-checkout\fR در حالت مشروح مشاهده و در نهایت پیکربندی کرد. نام هر بخش یا کلید به طور مناسب با کلمه \fIChannel\fR و شماره کانال پسوند می‌گیرد. برای مثال، ممکن است یک \fILan_Conf_Channel_1\fR و \fILan_Conf_Channel_3\fR را مشاهده کنید که می‌توانید به ترتیب پیکربندی LAN را در کانال‌های 1 و 3 پیکربندی نمایید.
.LP
در برخی مادربوردها، تغییرات پیکربندی توسط سیستم «جذب» (اعمال) نخواهد شد تا زمانی که مادربورد بازنشانی سخت‌افزاری (hard-reset) شود. این کار را می‌توان با خاموش و روشن کردن فیزیکی سیستم (مثلاً فشردن دکمه) یا از طریق راه‌اندازی مجدد سرد (cold-reset) انجام داد. یک راه‌اندازی مجدد سرد را می‌توان از طریق
.B bmc-device
اجرا کرد.
.SH "اطلاعات پیکربندی موارد خاص شاسی (CHASSIS SPECIAL CASE CONFIGURATION INFORMATION)"
فیلدهای
.B Chassis_Front_Panel_Buttons:Enable_Standby_Button_For_Entering_Standby,
.B Chassis_Front_Panel_Buttons:Enable_Diagnostic_Interrupt_Button
.B Chassis_Front_Panel_Buttons:Enable_Reset_Button,
و
.B Chassis_Front_Panel_Buttons:Enable_Power_Off_Button_For_Power_Off_Only
ممکن است در برخی سیستم‌های IPMI قابل استخراج نباشند، بنابراین مقدار استخراج‌شده ممکن است خالی باشد. برخی از این فیلدها ممکن است قابل غیرفعال‌سازی باشند، در حالی که برخی دیگر این‌گونه نیستند.
فیلد
.B Chassis_Power_Conf:Power_Control_Interval
قابل استخراج نیست. بنابراین مقدار استخراج‌شده همیشه خالی خواهد بود.
.SH "اطلاعات پیکربندی موارد خاص PEF (PEF SPECIAL CASE CONFIGURATION INFORMATION)"
در برخی مادربوردها، چندین کانال ممکن است برای ارتباط IPMI از طریق LAN وجود داشته باشد. اگر چندین کانال وجود داشته باشد، پیکربندی هر دو کانال را می‌توان با اجرای \fI\-\-checkout\fR در حالت مشروح مشاهده و در نهایت پیکربندی کرد. نام هر بخش به طور مناسب با کلمه \fIChannel\fR و شماره کانال پسوند می‌گیرد. برای مثال، ممکن است یک \fICommunity_String_Channel_1\fR و \fICommunity_String_Channel_3\fR را مشاهده کنید که می‌توانید به ترتیب Community String را در کانال‌های 1 و 3 پیکربندی نمایید.
موارد زیر گزینه‌های مناسب برای ورودی Sensor_Type در پیکربندی PEF هستند.
.TP
\fBگزینه‌های Sensor_Type\fR
Reserved, Temperature, Voltage, Current, Fan, Physical_Security,
Platform_Security_Violation_Attempt, Processor, Power_Supply,
Power_Unit, Cooling_Device, Other_Units_Based_Sensor, Memory,
Drive_Slot, Post_Memory_Resize, System_Firmware_Progress,
Event_Logging_Disabled, Watchdog1, System_Event, Critical_Interrupt,
Button_Switch, Module_Board, Microcontroller_Coprocessor, Add_In_Card,
Chassis, Chip_Set, Other_FRU, Cable_Interconnect, Terminator,
System_Boot_Initiated, Boot_Error, OS_Boot, OS_Critical_Stop,
Slot_Connector, System_ACPI_Power_State, Watchdog2, Platform_Alert,
Entity_Presence, Monitor_Asic_IC, Lan, Management_Subsystem_Health,
Battery, Session_Audit, Version_Change, FRU_State, and Any
.SH "اطلاعات پیکربندی موارد خاص حسگرها (SENSORS SPECIAL CASE CONFIGURATION INFORMATION)"
از آنجا که بسیاری از فیلدهای قابل پیکربندی شامل اعداد اعشاری هستند، ممکن است هنگام پیکربندی آستانه‌های جدید، عدم دقت در دقت/ممیز شناور رخ دهد. این عدم دقت‌ها ممکن است بلافاصله آشکار نشوند. توصیه می‌شود کاربران پس از پیکربندی آستانه‌های جدید، تغییرات خود را تأیید و بازبینی کنند.
.SH "پشتیبانی از محدوده میزبان (HOSTRANGED SUPPORT)"
میزبان‌های متعدد را می‌توان به صورت فهرست‌های صریح و جدا شده با کاما از میزبان‌ها یا یک محدوده از نام‌های میزبان در قالب کلی زیر وارد کرد:
prefix[n-m,l-k,...] که در آن n < m و l < k و غیره است. قالب دوم نباید با کلاس‌های نویسه عبارات باقاعده (که با [] نیز نشان داده می‌شوند) اشتباه گرفته شود. به عنوان مثال، foo[19] نمایانگر foo1 یا foo9 نیست، بلکه یک محدوده تک‌عضوی (منحط) را نشان می‌دهد: foo19.
.LP
این نحو محدوده صرفاً به عنوان یک سهولت در کلاسترهایی با قرارداد نام‌گذاری prefixNN در نظر گرفته شده است و تعیین محدوده‌ها نباید ضروری تلقی شود \-\-\- لیست foo1,foo9 را می‌توان به همین صورت یا با محدوده foo[1,9] مشخص کرد.
.LP
چند نمونه از کاربرد محدوده در ادامه آمده است:
.nf
    foo[01-05] به جای foo01,foo02,foo03,foo04,foo05
    foo[7,9-10] به جای foo7,foo9,foo10
    foo[0-3] به جای foo0,foo1,foo2,foo3
.fi
.LP
به عنوان یادآوری برای خواننده، برخی از پوسته‌ها براکت‌ها ([ و ]) را برای تطبیق الگو (pattern matching) تفسیر می‌کنند. بسته به پوسته شما، ممکن است لازم باشد فهرست‌های دامنه‌دار را داخل نقل قول قرار دهید.
.LP
هنگامی که چندین میزبان توسط کاربر مشخص می‌شود، یک نخ (thread) برای هر میزبان به صورت موازی تا سقف انشعاب (fanout) پیکربندی‌شده اجرا می‌شود (که می‌توان آن را از طریق گزینه \fB\-F\fR تنظیم کرد). این امر امکان برقراری ارتباط با تعداد زیادی از گره‌ها را بسیار سریع‌تر از حالت سریالی فراهم می‌کند.
.LP
به‌طور پیش‌فرض، خروجی استاندارد از هر گره مشخص‌شده با درج نام میزبان در ابتدای هر خط نمایش داده می‌شود. اگرچه این خروجی در بسیاری از شرایط خوانا است، اما ممکن است در شرایط دیگر خواندن آن دشوار باشد. به عنوان مثال، خروجی چند گره ممکن است با یکدیگر ترکیب شود. از گزینه‌های \fB\-B\fR و \fB\-C\fR می‌توان برای تغییر این پیش‌فرض استفاده کرد.
.LP
هنگامی که میزبان "localhost" مشخص شود، ارتباط درون باند IPMI استفاده خواهد شد. این به کاربر اجازه می‌دهد localhost را به خروجی محدوده میزبان اضافه کند.
.SH "عیب‌یابی عمومی (GENERAL TROUBLESHOOTING)"
در اغلب موارد، مشکلات IPMI به دلیل مشکلات پیکربندی است.
.LP
مشکلات IPMI از طریق شبکه محلی (LAN) مربوط به پیکربندی نادرست BMC دستگاه راه دور است. مجدداً بررسی کنید تا مطمئن شوید موارد زیر به درستی در BMC دستگاه راه دور پیکربندی شده‌اند: آدرس IP، آدرس MAC، ماسک زیرشبکه (subnet mask)، نام کاربری، فعال‌سازی کاربر، سطح دسترسی کاربر، گذرواژه، سطح دسترسی LAN، فعال‌سازی LAN و نوع/انواع احراز هویت مجاز. برای اتصالات IPMI 2.0، دوباره بررسی کنید تا مطمئن شوید سطح دسترسی مجموعه‌رمز و کلید K_g به درستی پیکربندی شده‌اند. از ابزار
.B ipmi-config(8)
می‌توان برای بررسی و/یا تغییر این تنظیمات پیکربندی استفاده کرد.
.LP
مشکلات IPMI درون باند معمولاً ناشی از درایورهای پیکربندی‌نشده نامناسب یا BMCهای غیراستاندارد است.
.LP
علاوه بر نکات عیب‌یابی زیر، لطفاً به بخش «راهکارهای دور زدن مشکلات» در زیر نیز مراجعه کنید تا ببینید آیا باگ‌های خاصی مربوط به سازندگان کشف و دور زده شده‌اند یا خیر.
.LP
در زیر بسیاری از مشکلات رایج برای پیام‌های خطا فهرست شده‌اند.
برای پشتیبانی بیشتر، لطفاً به فهرست پستی <freeipmi\-users@gnu.org> ایمیل ارسال کنید.
.LP
"username invalid" \- نام کاربری وارد شده (یا نام کاربری NULL در صورت عدم ورود نام کاربری) در دستگاه راه دور در دسترس نیست. همچنین ممکن است پیکربندی نام کاربری BMC راه دور نادرست باشد.
.LP
"password invalid" \- گذرواژه وارد شده (یا یک گذرواژه NULL در صورت عدم ورود گذرواژه) صحیح نیست. همچنین ممکن است گذرواژه کاربر در BMC راه دور به درستی پیکربندی نشده باشد.
.LP
"password verification timeout" \- مهلت زمانی اعتبارسنجی گذرواژه به پایان رسیده است. یک خطای "password invalid" (شرح داده شده در بالا) یا یک خطای عمومی "session timeout" (شرح داده شده در زیر) رخ داده است. در این نقطه از پروتکل نمی‌توان تشخیص داد که کدام یک رخ داده است.
.LP
"k_g invalid" \- کلید K_g وارد شده (یا یک کلید K_g تهی در صورت عدم ورود کلید) صحیح نیست. همچنین ممکن است کلید K_g در BMC راه دور به درستی پیکربندی نشده باشد.
.LP
"privilege level insufficient" \- یک دستور IPMI نیازمند سطح دسترسی کاربری بالاتری نسبت به موردی است که با آن احراز هویت شده است. لطفاً سعی کنید با سطح دسترسی بالاتری احراز هویت کنید. این ممکن است مستلزم احراز هویت با کاربر دیگری باشد که حداکثر سطح دسترسی بالاتری دارد.
.LP
"privilege level cannot be obtained for this user" \- سطح دسترسی که می‌خواهید با آن احراز هویت کنید بالاتر از حداکثر مجاز برای این کاربر است. لطفاً دوباره با سطح دسترسی پایین‌تری امتحان کنید. همچنین ممکن است حداکثر سطح دسترسی مجاز برای یک کاربر در BMC راه دور به درستی پیکربندی نشده باشد.
.LP
"authentication type unavailable for attempted privilege level" \- نوع احراز هویتی که می‌خواهید با آن احراز هویت کنید برای این سطح دسترسی در دسترس نیست. لطفاً مجدداً با یک نوع احراز هویت جایگزین یا سطح دسترسی متناوب امتحان کنید. همچنین ممکن است انواع احراز هویت موجود که می‌توانید با آن‌ها احراز هویت کنید، در BMC راه دور به درستی پیکربندی نشده باشند.
.LP
"cipher suite id unavailable" \- شناسه مجموعه‌رمز که می‌خواهید با آن احراز هویت کنید در BMC راه دور در دسترس نیست. لطفاً دوباره با یک شناسه مجموعه‌رمز جایگزین امتحان کنید. همچنین ممکن است شناسه‌های مجموعه‌رمز موجود در BMC راه دور به درستی پیکربندی نشده باشند.
.LP
"ipmi 2.0 unavailable" \- فناوری IPMI 2.0 در دستگاه راه دور یافت نشد. لطفاً در عوض از IPMI 1.5 استفاده کنید.
.LP
"connection timeout" \- ارتباط اولیه IPMI ناموفق بود. تعدادی خطای بالقوه امکان‌پذیر است، از جمله نام میزبان نامعتبر مشخص‌شده، عدم امکان تفکیک آدرس IP متعلق به IPMI، فعال نبودن IPMI روی سرور راه دور، نامناسب بودن اتصال شبکه و غیره. لطفاً پیکربندی و اتصال را بررسی کنید.
.LP
"session timeout" \- مهلت زمانی نشست IPMI به پایان رسیده است. لطفاً دوباره متصل شوید. اگر این خطا زیاد رخ می‌دهد، ممکن است تمایل داشته باشید مهلت زمانی ارسال مجدد را افزایش دهید. برخی از BMCهای راه دور بسیار کندتر از بقیه هستند.
.LP
"device not found" \- دستگاه مشخص‌شده پیدا نشد. لطفاً پیکربندی یا ورودی‌ها را بررسی کرده و دوباره امتحان کنید.
.LP
"driver timeout" \- ارتباط با درایور یا دستگاه با وقفه زمانی مواجه شد. لطفاً دوباره امتحان کنید.
.LP
"message timeout" \- ارتباط با درایور یا دستگاه با وقفه زمانی مواجه شد. لطفاً دوباره امتحان کنید.
.LP
"BMC busy" \- در حال حاضر BMC مشغول است. ممکن است در حال پردازش اطلاعات باشد یا نشست‌های همزمان زیادی برای مدیریت داشته باشد. لطفاً صبر کنید و دوباره امتحان کنید.
.LP
"could not find inband device" \- دستگاه درون باند پیدا نشد. لطفاً پیکربندی را بررسی کنید یا دستگاه یا درایور خاصی را در خط فرمان مشخص نمایید.
.LP
"driver timeout" \- درایور درون باند هنگام برقراری ارتباط با BMC محلی یا پردازنده خدمات دچار وقفه زمانی شد. BMC یا پردازنده خدمات ممکن است مشغول باشد یا (در بدترین حالت) احتمالاً کار نکند.
.LP
"internal IPMI error" \- یک خطای داخلی IPMI رخ داده است که FreeIPMI نحوه مدیریت آن را نمی‌داند. لطفاً برای گزارش مشکل به <freeipmi\-users@gnu.org> ایمیل بزنید.
.SH "راهکارهای دور زدن مشکلات (WORKAROUNDS)"
با توجه به اینکه سازندگان متعددی راهکارهای IPMI خود را پیاده‌سازی می‌کنند، سازندگان مختلف ممکن است پروتکل‌های IPMI خود را به صورت نادرست پیاده‌سازی کرده باشند. موارد زیر تعدادی از راهکارهای دور زدن موجود در حال حاضر را برای مدیریت مشکلات عدم انطباق کشف‌شده شرح می‌دهند. در صورت امکان، راهکارها به گونه‌ای پیاده‌سازی شده‌اند که برای کاربر شفاف باشند. با این حال، برخی از آن‌ها مستلزم این خواهند بود که کاربر از طریق گزینه \-W مشخص کند که از یک راهکار استفاده شود.
.LP
سخت‌افزار فهرست‌شده در زیر ممکن است تنها نشان‌دهنده سخت‌افزاری باشد که مشکل در آن کشف شده است. نسخه‌های جدیدتر سخت‌افزار ممکن است مشکلات ذکر شده در زیر را برطرف کرده باشند. ماشین‌های مشابه از سازندگان ممکن است مشکلات یکسانی را نشان دهند یا ندهند. سازندگان مختلف ممکن است سفت‌افزار خود را از یک توسعه‌دهنده سفت‌افزار IPMI مشترک مجوزدهی کنند، بنابراین ممکن است ارزش داشته باشد که راهکارهای فهرست‌شده در زیر را حتی اگر مادربورد شما فهرست نشده است، امتحان کنید.
.LP
اگر فکر می‌کنید سخت‌افزار شما مشکل انطباق اضافی دارد که نیاز به پیاده‌سازی یک راهکار دور زدن دارد، لطفاً با نگه‌دارندگان FreeIPMI در <freeipmi\-users@gnu.org> یا <freeipmi\-devel@gnu.org> تماس بگیرید.
.LP
\fIassumeio\fR \- این پرچم راهکار فرض می‌کند که رابط‌های درون باند به جای اینکه نگاشت‌شده در حافظه (memory-mapped) باشند، با I/O سیستم ارتباط برقرار می‌کنند. این کار مشکل سیستم‌هایی را که آدرس‌های پایه نامعتبر را گزارش می‌دهند دور می‌زند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "device not supported" یا "could not find inband device" را مشاهده کنند. مشکل در HP ProLiant DL145 G1 مشاهده شده است.
.LP
\fIspinpoll\fR \- این پرچم راهکار به برخی از درایورهای درون باند (به‌ویژه درایور KCS) اطلاع می‌دهد که به جای به خواب بردن فرآیند، در حین نظرسنجی (polling) به صورت فعال منتظر بمانند (spin). این امر ممکن است زمان اجرای واقعی (wall clock) ابزارها را به میزان قابل توجهی بهبود بخشد، زیرا دانه‌بندی (granularity) زمان‌بند سیستم‌عامل ممکن است بسیار بزرگتر از زمان لازم برای انجام یک تراکنش پیام IPMI منفرد باشد. با این حال، با چرخش، سیستم شما ممکن است با خارج نکردن ابزار از زمینه برای یک کار مفیدتر، کار مفید کمتری انجام دهد.
.LP
\fIauthcap\fR \- این پرچم راهکار از بررسی‌های اولیه برای قابلیت‌های نام کاربری، قابلیت‌های احراز هویت و پشتیبانی 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 مشاهده شده است.
.LP
\fInochecksumcheck\fR \- این پرچم راهکار به FreeIPMI می‌گوید که مجموع‌های مقابله‌ای (checksums) برگشتی از پاسخ‌های دستورات IPMI را بررسی نکند. این گزینه مشکل سیستم‌هایی را دور می‌زند که به دلیل خطاهای پیاده‌سازی، چکسام‌های نامعتبر برمی‌گردانند اما بسته در غیر این صورت معتبر است. به کاربران در مورد استفاده از این گزینه هشدار داده می‌شود، زیرا اعتبارسنجی یکپارچگی بسته را در چندین موقعیت حذف می‌کند. با این حال، بعید است که در بیشتر شرایط مشکلی ایجاد کند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "connection timeout"، "session timeout" یا "password verification timeout" را مشاهده کنند. در اتصالات IPMI 1.5، ممکن است به راهکار "noauthcodecheck" نیز نیاز باشد. مشکل در Supermicro X9SCM-iiF، Supermicro X9DRi-F و Supermicro X9DRFR مشاهده شده است.
.LP
\fIidzero\fR \- این پرچم راهکار به شناسه‌های نشست خالی اجازه می‌دهد تا توسط کلاینت پذیرفته شوند. این گزینه مشکل نشست‌های IPMI را دور می‌زند که شناسه‌های نشست خالی را به کلاینت گزارش می‌دهند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در Tyan S2882 با BMC مدل M3289 مشاهده شده است.
.LP
\fIunexpectedauth\fR \- این پرچم راهکار اجازه می‌دهد کدهای احراز هویت غیرتهی غیرمنتظره به گونه‌ای بررسی شوند که گویی مورد انتظار بوده‌اند. این گزینه مشکلی را دور می‌زند که در آن بسته‌ها حاوی داده‌های احراز هویت غیرتهی هستند در حالی که باید به دلیل غیرفعال بودن احراز هویت برای هر پیام، تهی باشند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در Dell PowerEdge 2850,SC1425 مشاهده شده است. رفع این مشکل در سفت‌افزارهای جدیدتر تأیید شده است.
.LP
\fIforcepermsg\fR \- این پرچم راهکار احراز هویت برای هر پیام را بدون توجه به آنچه توسط سیستم راه دور اعلام شده است، اجباری می‌کند. این گزینه مشکلی را دور می‌زند که در آن احراز هویت برای هر پیام در سیستم راه دور به عنوان غیرفعال اعلام شده است، اما در واقع برای پروتکل مورد نیاز است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در IBM eServer 325 مشاهده شده است.
.LP
\fIendianseq\fR \- این پرچم راهکار، ترتیب بایت‌ها (انسی یا endianness) شماره‌های توالی نشست را معکوس می‌کند تا نشست به درستی ادامه یابد. این گزینه مشکل شماره‌های توالی نشست IPMI 1.5 را که دارای اندیان اشتباه هستند دور می‌زند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در برخی از سامانه‌های Sun ILOM 1.0/2.0 (بسته به اندیان پردازنده خدمات) مشاهده شده است.
.LP
\fInoauthcodecheck\fR \- این پرچم راهکار به FreeIPMI می‌گوید که کدهای احراز هویت برگشتی از پاسخ‌های دستورات IPMI 1.5 را بررسی نکند. این گزینه مشکل سیستم‌هایی را دور می‌زند که به دلیل خطاهای درهم‌سازی (hashing) یا پیاده‌سازی، کدهای احراز هویت نامعتبر برمی‌گردانند. به کاربران در مورد استفاده از این گزینه هشدار داده می‌شود، زیرا بررسی احراز هویت را که اعتبار یک بسته را تأیید می‌کند حذف می‌کند. با این حال، در بیشتر سازمان‌ها بعید است که این یک مشکل امنیتی باشد. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "connection timeout"، "session timeout" یا "password verification timeout" را مشاهده کنند. مشکل در Xyratex FB-H8-SRAY، Intel Windmill، Quanta Winterfell و Wiwynn Windmill مشاهده شده است.
.LP
\fIintel20\fR \- این پرچم راهکار چندین مشکل احراز هویت Intel IPMI 2.0 را دور می‌زند. مشکلات تحت پوشش شامل پدگذاری نام‌های کاربری و کوتاه کردن گذرواژه در صورتی است که الگوریتم احراز هویت HMAC-MD5-128 باشد. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "username invalid"، "password invalid" یا "k_g invalid" را مشاهده کنند. مشکل در Intel SE7520AF2 با ماژول مدیریت سرور اینتل (نسخه حرفه‌ای) مشاهده شده است.
.LP
\fIsupermicro20\fR \- این پرچم راهکار چندین مشکل احراز هویت Supermicro IPMI 2.0 را در مادربوردهای دارای سفت‌افزار Peppercon IPMI دور می‌زند. مشکلات تحت پوشش شامل مدیریت کدهای احراز هویت با طول نامعتبر است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "password invalid" را مشاهده کنند. مشکل در Supermicro H8QME با کارت دختر SIMSO مشاهده شده است. رفع این مشکل در سفت‌افزارهای جدیدتر تأیید شده است.
.LP
\fIsun20\fR \- این پرچم راهکار چندین مشکل احراز هویت Sun IPMI 2.0 را دور می‌زند. مشکلات تحت پوشش شامل کلیدهای هش با طول نامعتبر، کلیدهای به صورت نادرست هش‌شده و رکوردهای مجموعه‌رمز نامعتبر است. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "password invalid" یا "bmc error" را مشاهده کنند. مشکل در Sun Fire 4100/4200/4500 با ILOM مشاهده شده است. این راهکار به‌طور خودکار شامل راهکار "opensesspriv" می‌شود.
.LP
\fIopensesspriv\fR \- این پرچم راهکار پروتکل اتصال 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" فعال می‌شود.
.LP
\fIintegritycheckvalue\fR \- این پرچم راهکار مقدار نامعتبر بررسی یکپارچگی را در هنگام برقراری نشست IPMI 2.0 در زمان استفاده از شناسه مجموعه‌رمز 0 دور می‌زند. مقدار بررسی یکپارچگی باید طول 0 داشته باشد، با این حال مادربورد راه دور با یک فیلد غیرخالی پاسخ می‌دهد. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "k_g invalid" را مشاهده کنند. مشکل در Supermicro X8DTG، Supermicro X8DTU، Intel S5500WBV/Penguin Relion 700 و Intel S2600JF/Appro 512X مشاهده شده است.
.LP
عدم پشتیبانی از IPMI 1.5 \- مشخص شده است که برخی از مادربوردهایی که از IPMI 2.0 پشتیبانی می‌کنند از IPMI 1.5 پشتیبانی نمی‌کنند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای "ipmi 2.0 unavailable" یا "connection timeout" را مشاهده کنند. این مشکل را می‌توان با استفاده از IPMI 2.0 به جای IPMI 1.5 با مشخص کردن \fB\-\-driver\-type\fR=\fILAN_2_0\fR دور زد. مشکل در تعدادی از مادربوردهای HP و Supermicro مشاهده شده است.
.LP
\fIslowcommit\fR \- این راهکار با ایجاد یک ثانیه مکث (sleep) بین اعمال هر یک از بخش‌ها، سرعت اعمال تغییرات روی BMC را کاهش می‌دهد. این گزینه مشکل مادربوردهایی را دور می‌زند که دارای BMCهایی هستند که با اعمال سریع تغییرات دچار اختلال می‌شوند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای اعمال (commit) یا عدم ثبت تغییرات روی BMC را مشاهده کنند. مشکل در Supermicro H8QME مشاهده شده است.
.LP
\fIveryslowcommit\fR \- این راهکار با ایجاد یک ثانیه مکث بین اعمال هر یک از کلیدها، سرعت اعمال تغییرات روی BMC را کاهش می‌دهد. این گزینه مشکل مادربوردهایی را دور می‌زند که دارای BMCهایی هستند که با اعمال سریع تغییرات دچار اختلال می‌شوند. کسانی که با این مشکل مواجه می‌شوند ممکن است خطاهای اعمال یا عدم ثبت تغییرات روی BMC را مشاهده کنند. مشکل در Quanta S99Q/Dell FS12-TY و Dell PowerEdge T320 مشاهده شده است.
.LP
\fIsolchannelassumelanchannel\fR \- این راهکار
.B ipmi-config
را مجبور می‌کند فرض کند کانال استفاده‌شده برای SOL همان کانال استفاده‌شده برای LAN است. در برخی مادربوردها، کانال SOL به صورت نادرست گزارش می‌شود که منجر به پیکربندی نادرست می‌گردد. به‌ویژه این مشکل هنگام تلاش برای پیکربندی چندین کانال رخ داده است. مشکل در Intel S5500WBV/Penguin Relion 700 مشاهده شده است.
.SH "مثال‌ها (EXAMPLES)"
.B # ipmi-config --checkout
.PP
نمایش تمام اطلاعات پیکربندی اصلی (core) در کنسول.
.PP
.B # ipmi-config --checkout --category=pef
.PP
نمایش تمام اطلاعات پیکربندی pef در کنسول.
.PP
.B # ipmi-config --checkout --category=pef,chassis
.PP
نمایش تمام اطلاعات پیکربندی pef و chassis در کنسول.
.PP
.B # ipmi-config --checkout --filename=bmc-data1.conf
.PP
ذخیره تمام اطلاعات پیکربندی اصلی در فایل bmc-data1.conf.
.PP
.B # ipmi-config --diff --filename=bmc-data2.conf
.PP
نمایش تمام تفاوت‌های بین پیکربندی فعلی و فایل bmc-data2.conf.
.PP
.B # ipmi-config --diff --key-pair="lan_conf_misc:gratuitous_arp_interval=8"
.PP
نمایش تفاوت بین پیکربندی فعلی و 'lan_conf_misc:gratuitous_arp_interval' با مقدار '8'.
.PP
.B # ipmi-config --commit --filename=bmc-data1.conf
.PP
اعمال تمام مقادیر پیکربندی از فایل bmc-data1.conf.
.PP
.B # ipmi-config --commit --key-pair="lan_conf_misc:gratuitous_arp_interval=4"
.PP
اعمال کلید 'lan_conf_misc:gratuitous_arp_interval' با مقدار '4'.
.PP
.B # ipmi-config --commit --filename=bmc-data-updt.conf --key-pair="lan_conf_misc:gratuitous_arp_interval=4"
.PP
اعمال تمام مقادیر پیکربندی از فایل bmc-data-updt.conf و کلید 'lan_conf_misc:gratuitous_arp_interval' با مقدار '4'.
.PP
.SH "عیب‌یابی (DIAGNOSTICS)"
در صورت اجرای موفقیت‌آمیز، وضعیت خروج 0 است. در صورت بروز خطای غیرکشنده، وضعیت خروج 1 و در صورت بروز خطای کشنده (fatal error)، وضعیت خروج 2 خواهد بود.
.LP
اگر چندین میزبان برای برقراری ارتباط مشخص شده باشند، وضعیت خروج فقط و فقط در صورتی 0 است که تمام اهداف با موفقیت اجرا شوند. در صورت بروز هرگونه خطای غیرکشنده وضعیت خروج 1 و در صورت بروز هرگونه خطای کشنده وضعیت خروج 2 است.
.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
در سیستم‌عامل‌های قدیمی‌تر، اگر نام کاربری، گذرواژه و سایر اطلاعات مرتبط با امنیت را در خط فرمان وارد کنید، این اطلاعات ممکن است توسط کاربران دیگر در هنگام استفاده از ابزارهایی مانند دستور
.B ps(1)
یا بررسی در فایل‌سیستم /proc کشف شود. به‌طور کلی امن‌تر است که اطلاعات گذرواژه را با گزینه‌هایی مانند گزینه‌های \-P یا \-K وارد کنید. پیکربندی اطلاعات مرتبط با امنیت در فایل پیکربندی FreeIPMI نیز روش مناسبی برای مخفی کردن این اطلاعات خواهد بود.
.LP
به منظور جلوگیری از حملات جستجوی فراگیر (brute force)، برخی از BMCها پس از تعدادی خطای احراز هویت راه دور موقتاً «قفل» (lock up) می‌شوند. ممکن است لازم باشد مدتی صبر کنید تا این «قفل» موقت برطرف شود و بتوانید دوباره احراز هویت کنید.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
اشکالات را به <freeipmi\-users@gnu.org> یا <freeipmi\-devel@gnu.org> گزارش دهید.
.SH "حق نشر (COPYRIGHT)"
کپی‌رایت \(co 2003-2015 تیم هسته FreeIPMI.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ پروانه و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید.
.SH "همچنین ببینید (SEE ALSO)"
ipmi-config.conf(5), freeipmi(7), bmc-device(8)
.PP
http://www.gnu.org/software/freeipmi