| ipmiconsole(8) | System Commands | ipmiconsole(8) |
نام (NAME)
ipmiconsole - کنسول IPMI برای Serial-over-LAN (SOL)
خلاصه دستور (SYNOPSIS)
ipmiconsole [OPTION...]
توضیحات (DESCRIPTION)
دستور ipmiconsole یک ابزار کنسول Serial-over-LAN (SOL) است. این ابزار میتواند برای برقراری نشستهای کنسول به ماشینهای راه دور با استفاده از پروتکل IPMI 2.0 SOL استفاده شود. دستور ipmiconsole با کنترلکننده مدیریت برد پایه (BMC) ماشین راه دور ارتباط برقرار میکند تا یک نشست کنسول برقرار سازد. قبل از اینکه هرگونه ارتباط SOL انجام شود، BMC ماشین راه دور باید به درستی پیکربندی شده باشد. ابزار FreeIPMI یعنی ipmi-config(8) میتواند برای انجام این پیکربندی استفاده شود.
اغلب (اگرچه نه همیشه)، هدایت مجدد کنسول (console redirection) باید در BIOS و/یا سیستمعامل نیز به درستی پیکربندی شود. هر دو باید طوری پیکربندی شوند که ترافیک کنسول را از پورت COM مناسب هدایت کنند. لطفاً برای دستورالعملهای راهاندازی صحیح به مستندات مادربورد و سیستمعامل خود مراجعه کنید.
در ادامه، گزینههای عمومی IPMI، گزینههای اختصاصی ابزار، اطلاعات عیبیابی، راهکارهای دور زدن مشکلات (workarounds)، مثالها و مشکلات شناختهشده آورده شدهاند. برای آشنایی عمومی با FreeIPMI لطفاً به freeipmi(7) مراجعه کنید.
گزینههای عمومی (GENERAL OPTIONS)
گزینههای زیر گزینههای عمومی برای پیکربندی ارتباطات IPMI و اجرای دستورات کلی ابزار هستند.
- -h IPMIHOST, --hostname=IPMIHOST[:PORT]
- میزبان راه دور را برای برقراری ارتباط مشخص میکند. یک پورت اختیاری را میتوان مشخص کرد که ممکن است در هدایت پورت (port forwarding) یا شرایط مشابه مفید باشد. اگر آدرس و پورت IPv6 مشخص میکنید، از قالب [ADDRESS]:PORT استفاده کنید.
- -u USERNAME, --username=USERNAME
- نام کاربری مورد استفاده هنگام احراز هویت با میزبان راه دور را مشخص میکند. در صورت عدم تعیین، یک نام کاربری تهی (یعنی ناشناس) در نظر گرفته میشود. کاربر باید از امتیاز کافی برای برقراری یک نشست SOL و تواناییهای نشست SOL برخوردار باشد.
- -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
- مهلت زمانی نشست را بر حسب میلیثانیه مشخص میکند. در صورت عدم تعیین، پیشفرض ۶۰۰۰۰ میلیثانیه (۶۰ ثانیه) است.
- --retransmission-timeout=MILLISECONDS
- مهلت زمانی ارسال مجدد بسته را بر حسب میلیثانیه مشخص میکند. در صورت عدم تعیین، پیشفرض ۵۰۰ میلیثانیه (۰٫۵ ثانیه) است.
- -I, --cipher-suite-id=CIPHER-SUITE-ID
- شناسه
مجموعهرمز
(Cipher Suite ID) در IPMI 2.0 را
برای
استفاده
مشخص
میکند.
شناسه
مجموعهرمز
مجموعهای
از
الگوریتمهای
احراز
هویت،
یکپارچگی و
محرمانگی
را برای
استفاده در
ارتباطات IPMI 2.0
تعیین
میکند.
الگوریتم
احراز
هویت،
الگوریتم
مورد
استفاده
برای
برپایی
نشست،
الگوریتم
یکپارچگی،
الگوریتم
مورد
استفاده
برای امضای
بستههای
نشست و
الگوریتم
محرمانگی،
الگوریتم
مورد
استفاده
برای
رمزنگاری
بار داده (payload)
را مشخص
میکند. در
صورت عدم
تعیین،
پیشفرض
شناسه
مجموعهرمز
3 است. کاربر
باید آگاه
باشد که
تنها
شناسههای
مجموعهرمز
3، 8 و 12 بارهای
داده کنسول
را
رمزنگاری
میکنند. در
صورت
انتخاب
شناسه
مجموعهرمز
دیگر،
اطلاعات
کنسول به
صورت متنی و
ناامن (در
قالب متن
آشکار)
ارسال
خواهد شد.
شناسههای
مجموعهرمز
زیر در حال
حاضر
پشتیبانی
میشوند:
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 هستند. در صورت عدم تعیین، پیشفرض ADMIN است.
- --config-file=FILE
- یک فایل پیکربندی جایگزین را مشخص میکند.
- -W WORKAROUNDS, --workaround-flags=WORKAROUNDS
- راهکارهای دور زدن مشکلات عدم انطباق سازندگان را مشخص میکند. چندین راهکار را میتوان با کاما جدا کرد. پرچم ویژه "none" در خط فرمان، عدم استفاده از هیچ راهکاری را نشان میدهد (ممکن است برای بازنویسی مقادیر پیشفرض پیکربندیشده مفید باشد). برای فهرستی از راهکارهای موجود به بخش «راهکارهای دور زدن مشکلات» در زیر مراجعه کنید.
- --debug
- اشکالزدایی (دیباگ) را فعال میکند.
- -?, --help
- نمایش پیام راهنما و خروج.
- --usage
- نمایش نحوه استفاده کوتاه و خروج.
- -V, --version
- نمایش نسخه برنامه و خروج.
گزینههای IPMICONSOLE (IPMICONSOLE OPTIONS)
گزینههای زیر مختص ipmiconsole هستند.
- -e CHAR, --escape-char=CHAR
- یک نویسه گریز (escape) جایگزین را مشخص میکند (نویسه پیشفرض '&' است).
- --dont-steal
- در صورتی که تشخیص داده شود نشست SOL از قبل در حال استفاده است، آن را تصاحب (steal) نمیکند. در بیشتر شرایط، اگر تشخیص داده شود که SOL در حال استفاده است، ipmiconsole تلاش میکند تا نشست SOL را از نشست قبلی برباید. این رفتار پیشفرض به چند دلیل وجود دارد، به ویژه اینکه نشستهای SOL پیشین ممکن است قادر به غیرفعالسازی صحیح نبوده باشند.
- --deactivate
- در صورتی که یک نشست SOL در حال استفاده تشخیص داده شود، آن را غیرفعال کرده و خارج میشود.
- --serial-keepalive
- گاهی اوقات نویسههای NUL ارسال میکند تا اتصالات سریال غیرفعال را تشخیص دهد. این گزینه بهویژه برای کسانی که قصد دارند ipmiconsole را بدون تعامل زیاد اجرا کنند، مانند اهداف ثبت وقایع (logging)، مفید است. در حالی که ممکن است اتصالات IPMI هنوز زنده باشند، برخی از مادربوردها اشکالاتی نشان دادهاند که در آنها دادههای سریال زیربنایی دیگر ارسال/دریافت نمیشوند. از دیدگاه ipmiconsole , دادهها صرفاً از سیستم راه دور ارسال نمیشوند و این مشکل تنها زمانی تشخیص داده میشود که تعامل کاربر وجود داشته باشد. با ارسال گاهبهگاه نویسه NUL، قطع انتقال دادههای سریال زیربنایی بسیار سریعتر قابل تشخیص است. این گزینه با خطراتی همراه است، زیرا بایت نویسه NUL بسته به دادههایی که سیستم راه دور انتظار دریافت آنها را دارد یا ندارد، ممکن است بر سیستم راه دور تأثیر بگذارد. برای مثال، دریافت یک نویسه NUL توسط getty(8) و مشتقات آن (مانند agetty(8)) باعث تغییر نرخ باود (baud rate) میشود که ممکن است پایانه را قفل کند.
- --serial-keepalive-empty
- این گزینه مشابه --serial-keepalive است با این تفاوت که بستههای SOL فاقد هرگونه داده نویسه NUL خواهند بود. در برخی از مادربوردها، این مقدار ممکن است برای مدیریت یک نشست IPMI معلق بدون خطراتی که ارسال منظم بایت نویسه NUL دارد، کافی باشد. با این حال، برخی از سیستمها ممکن است یک بسته SOL بدون داده نویسه را ACK نکنند، به این معنی که این بستههای زنده نگه داشتن (keepalive) هیچ اثری نخواهند داشت.
- --sol-payload-instance=NUM
- شماره نمونه بار داده SOL را مشخص میکند. مقدار پیشفرض 1 است و مقادیر معتبر از 1 تا 15 متغیر هستند. بیشتر سیستمها تنها از یک نمونه پشتیبانی میکنند، با این حال تعداد کمی به کاربران اجازه دسترسی به چند نمونه را میدهند.
- --deactivate-all-instances
- هنگامی که همراه با گزینه --deactivate استفاده شود، تمام نمونههای فعال SOL را به جای تنها نمونه بار دادهای که در حال حاضر پیکربندی شده است، غیرفعال میکند.
- --lock-memory
- اطلاعات حساس (مانند نامهای کاربری و گذرواژهها) را در حافظه قفل میکند.
- --proxy
- یک پروکسی TCP را اجرا میکند که تمام ورودی/خروجی سوکت را به کنسول راه دور هدایت مینماید. برای اشکالزدایی کرنل راه دور با gdb مفید است. لطفاً برای اطلاعات بیشتر درباره این حالت، به بخش «حالت پروکسی SOL به TCP» در زیر مراجعه کنید.
- --proxyport=PORTNUMBER
- یک شماره پورت TCP سفارشی را برای حالت پروکسی TCP پیکربندی میکند. پورت پیشفرض 6023 است.
- --proxyaddr=ADDRESS
- یک آدرس شنود سفارشی را برای حالت پروکسی TCP پیکربندی میکند. آدرس پیشفرض 127.0.0.1 است. لطفاً برای هشدارهای امنیتی مربوط به بازنویسی این مقدار، به بخش «حالت پروکسی SOL به TCP» در زیر مراجعه کنید.
نویسههای گریز (ESCAPE CHARACTERS)
توالیهای گریز زیر پشتیبانی میشوند. نویسه گریز پیشفرض پشتیبانیشده '&' است، اما میتوان آن را با گزینه -e تغییر داد.
- &?
- نمایش فهرستی از توالیهای گریز موجود در حال حاضر.
- &.
- پایان دادن به اتصال.
- &B
- ارسال یک "serial-break" به کنسول راه دور.
- &D
- ارسال یک نویسه DEL.
- &&
- ارسال یک نویسه گریز تکی.
عیبیابی عمومی (GENERAL TROUBLESHOOTING)
در بیشتر مواقع، مشکلات IPMI به دلیل مشکلات پیکربندی رخ میدهند.
مشکلات IPMI بر روی LAN شامل پیکربندی نادرست BMC ماشین راه دور است. مجدداً بررسی کنید تا مطمئن شوید موارد زیر به درستی در BMC ماشین راه دور پیکربندی شدهاند: آدرس IP، آدرس MAC، ماسک زیرشبکه (subnet mask)، نام کاربری، فعال بودن کاربر، دسترسی کاربر، گذرواژه، دسترسی LAN، فعال بودن LAN، و نوع(های) احراز هویت مجاز. برای اتصالات IPMI 2.0، مجدداً بررسی کنید تا مطمئن شوید دسترسی(های) مجموعهرمز و کلید K_g به درستی پیکربندی شدهاند. ابزار ipmi-config(8) میتواند برای بررسی و/یا تغییر این تنظیمات پیکربندی استفاده شود.
علاوه بر نکات عیبیابی زیر، لطفاً به بخش «راهکارهای دور زدن مشکلات» در زیر نیز مراجعه کنید تا ببینید آیا باگهای خاصی برای سازندگان وجود دارند که کشف شده و دور زده شده باشند.
در زیر بسیاری از مشکلات رایج مربوط به پیامهای خطا آورده شده است. برای پشتیبانی بیشتر، لطفاً به فهرست پستی <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 از نوع NULL در صورت عدم ورود) صحیح نیست. همچنین ممکن است کلید 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های راه دور به میزان قابل توجهی کندتر از بقیه هستند.
"internal IPMI error" - یک خطای داخلی IPMI رخ داده است که FreeIPMI نحوه مدیریت آن را نمیداند. لطفاً برای گزارش مشکل به <freeipmi-users@gnu.org> ایمیل بفرستید.
عیبیابی IPMICONSOLE (IPMICONSOLE TROUBLESHOOTING)
موارد زیر مشکلات رایج مربوط به پیامهای خطا در ipmiconsole هستند.
"SOL unavailable" - پروتکل SOL برای استفاده در BMC راه دور پیکربندی نشده است. ممکن است بهطور کلی یا برای کاربر مشخصشده پیکربندی نشده باشد. احراز هویت با یک کاربر دیگر ممکن است کافی باشد، با این حال پروتکل IPMI جزئیاتی درباره اینکه چه چیزی در BMC راه دور پیکربندی نشده است ارائه نمیدهد.
"SOL in use" - نشست SOL از قبل در BMC راه دور در حال استفاده است. اگر گزینه --dont-steal را مشخص نکنید، ipmiconsole تلاش خواهد کرد تا نشست SOL را از نشست دیگر برباید. همه BMCها از قابلیت ربودن نشست SOL پشتیبانی نمیکنند.
"SOL session stolen" - نشست SOL شما توسط نشست دیگری ربوده شده است. ممکن است بخواهید تلاش کنید تا با اتصال مجدد، نشست را پس بگیرید.
"SOL requires encryption" - پروتکل SOL به یک شناسه مجموعهرمز نیاز دارد که شامل رمزنگاری باشد. لطفاً تلاش کنید از شناسههای مجموعهرمز 3، 8 یا 12 استفاده کنید. همچنین ممکن است الزامات رمزنگاری به درستی در BMC راه دور پیکربندی نشده باشند.
"SOL requires no encryption" - پروتکل SOL به یک شناسه مجموعهرمز نیاز دارد که از رمزنگاری استفاده نکند. لطفاً تلاش کنید از شناسههای مجموعهرمز 0، 1، 2، 6، 7 یا 11 استفاده کنید. همچنین ممکن است الزامات رمزنگاری به درستی در BMC راه دور پیکربندی نشده باشند.
"BMC Implementation" - پردازنده BMC در ماشین راه دور دارای مشکل شدیدی در پیادهسازی خود است. لطفاً برای راهکارهای ممکن به بخش «راهکارهای دور زدن مشکلات» در زیر مراجعه کنید. در صورتی که راهکارهای سازنده بیشتری مورد نیاز است، لطفاً با نویسندگان تماس بگیرید.
"excess retransmissions sent" - تعداد بیش از حدی از ارسال مجدد بستههای SOL رخ داده و ipmiconsole از تلاش دست کشیده است. این ممکن است به دلیل مشکلات شبکه یا مشکلات SOL باشد. برخی از همان مشکلاتی که با خطاهای "connection timeout" یا "session timeout" همراه هستند ممکن است دخیل باشند. لطفاً تلاش کنید دوباره متصل شوید.
"excess errors received" - تعداد بیش از حدی از خطاهای بستههای SOL رخ داده و ipmiconsole از تلاش دست کشیده است. این ممکن است به دلیل مشکلات شبکه یا مشکلات SOL باشد. لطفاً تلاش کنید دوباره متصل شوید.
"BMC Error" - این خطا معمولاً به این معنی است که پیادهسازی SOL یک سازنده نیازمند ترکیبی از احراز هویت، رمزنگاری، امتیاز، و غیره است که با انتخابهای کاربر برآورده نشده است. لطفاً ترکیبی از مجموعهرمزها، سطوح دسترسی و غیره مختلف را امتحان کنید تا مشکل برطرف شود. لطفاً برای راهکارهای ممکن به بخش «راهکارهای دور زدن مشکلات» در زیر نیز مراجعه کنید.
راهکارهای دور زدن مشکلات (WORKAROUNDS)
با توجه به اینکه سازندگان متعددی راهکارهای IPMI خود را پیادهسازی میکنند، سازندگان مختلف ممکن است پروتکلهای IPMI خود را به صورت نادرست پیادهسازی کرده باشند. موارد زیر تعدادی از راهکارهای دور زدن موجود در حال حاضر را برای مدیریت مشکلات عدم انطباق کشفشده شرح میدهند. در صورت امکان، راهکارها به گونهای پیادهسازی شدهاند که برای کاربر شفاف باشند. با این حال، برخی از آنها مستلزم این خواهند بود که کاربر از طریق گزینه -W مشخص کند که از یک راهکار استفاده شود.
سختافزار فهرستشده در زیر ممکن است تنها نشاندهنده سختافزاری باشد که مشکل در آن کشف شده است. نسخههای جدیدتر سختافزار ممکن است مشکلات ذکر شده در زیر را برطرف کرده باشند. ماشینهای مشابه از سازندگان ممکن است مشکلات یکسانی را نشان دهند یا ندهند. سازندگان مختلف ممکن است سفتافزار خود را از یک توسعهدهنده سفتافزار IPMI مشترک مجوزدهی کنند، بنابراین ممکن است ارزش داشته باشد که راهکارهای فهرستشده در زیر را حتی اگر مادربورد شما فهرست نشده است، امتحان کنید.
اگر فکر میکنید سختافزار شما مشکل انطباق اضافی دارد که نیاز به پیادهسازی یک راهکار دور زدن دارد، لطفاً با نگهدارندگان FreeIPMI در <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org> تماس بگیرید.
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 مشاهده شده است.
intel20 - این پرچم راهکار چندین مشکل احراز هویت Intel IPMI 2.0 را دور میزند. مشکلات تحت پوشش شامل پدگذاری نامهای کاربری و کوتاه کردن گذرواژه در صورتی است که الگوریتم احراز هویت HMAC-MD5-128 باشد. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "username invalid"، "password invalid" یا "k_g invalid" را مشاهده کنند. مشکل در Intel SE7520AF2 با ماژول مدیریت سرور اینتل (نسخه حرفهای) مشاهده شده است.
supermicro20 - این پرچم راهکار چندین مشکل احراز هویت Supermicro IPMI 2.0 را در مادربوردهای دارای سفتافزار Peppercon IPMI دور میزند. مشکلات تحت پوشش شامل مدیریت کدهای احراز هویت با طول نامعتبر است. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "password invalid" را مشاهده کنند. مشکل در Supermicro H8QME با کارت دختر SIMSO مشاهده شده است. رفع این مشکل در سفتافزارهای جدیدتر تأیید شده است.
sun20 - این پرچم راهکار چندین مشکل احراز هویت Sun 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 در زمان استفاده از شناسه مجموعهرمز 0 دور میزند. مقدار بررسی یکپارچگی باید طول 0 داشته باشد، با این حال مادربورد راه دور با یک فیلد غیرخالی پاسخ میدهد. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "k_g invalid" را مشاهده کنند. مشکل در Supermicro X8DTG، Supermicro X8DTU، Intel S5500WBV/Penguin Relion 700 و Intel S2600JF/Appro 512X مشاهده شده است.
solpayloadsize - این پرچم راهکار اندازههای معتبر بار داده SOL را بررسی نمیکند و یک مجموعه مناسب را فرض میگیرد. این گزینه مشکل سیستمهای راه دور را که اندازههای نامعتبر بار داده IPMI 2.0 SOL را گزارش میدهند دور میزند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "BMC Implementation" را مشاهده کنند. مشکل در Asus P5M2/RS162-E4/RX4، Intel SR1520ML/X38ML، Inventec 5441/Dell Xanadu II، Sun x4100، Supermicro X8DTH، Supermicro X8DTG، Supermicro X8DTU و Quanta QSSC-S4R//Appro GB812X-CN مشاهده شده است.
solport - این پرچم راهکار پورتهای جایگزین SOL مشخصشده در طول پروتکل را نادیده میگیرد. این گزینه مشکل سیستمهای راه دور را که پورتهای جایگزین نامعتبر SOL را گزارش میدهند دور میزند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "connection timeout" را مشاهده کنند. مشکل در Asus P5MT-R و Supermicro X8DTH-iF مشاهده شده است.
solstatus - این پرچم راهکار وضعیت فعالسازی فعلی SOL را در حین راهاندازی پروتکل بررسی نمیکند. این گزینه مشکل سیستمهای راه دور را که به درستی از این دستور پشتیبانی نمیکنند دور میزند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "BMC Error" را مشاهده کنند. مشکل در Supermicro X8SIL-F مشاهده شده است.
solchannelsupport - این پرچم راهکار بررسی نمیکند که آیا SOL در کانال فعلی پشتیبانی میشود یا خیر. این گزینه مشکل سیستمهای راه دور را که به درستی از این دستور پشتیبانی نمیکنند دور میزند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "BMC Error" را مشاهده کنند. مشکل در Intel Windmill، Quanta Winterfell و Wiwynn Windmill مشاهده شده است.
serialalertsdeferred - این گزینه راهکار هشدارهای سریال را به جای اینکه منجر به شکست شوند، به حالت تعویق تنظیم میکند. این گزینه مشکل مادربوردهایی را دور میزند که IPMI بر روی سریال را همزمان با IPMI سریال بر روی LAN (SOL) انجام میدهند. کسانی که با این مشکل مواجه میشوند ممکن است هنگام تلاش برای ورود داده از طریق SOL، خطاهای "excess retransmissions sent" را مشاهده کنند. مشکل در Intel Windmill، Quanta Winterfell و Wiwynn Windmill مشاهده شده است.
solpacketseq - این گزینه راهکار شماره توالی بسته بار داده SOL را در شرایط بحرانی افزایش میدهد. بهطور معمول SOL هرگز نباید این کار را انجام دهد، با این حال مشخص شده است برخی از مادربوردها به دلیل یک باگ داخلی مادربورد "گیر" میکنند. این راهکار میتواند به خروج BMC از حالت گیرکرده کمک کند. کسانی که با این مشکل مواجه میشوند ممکن است هنگام تلاش برای ورود داده از طریق SOL، خطاهای "excess retransmissions sent" را مشاهده کنند. مشکل در Intel Windmill، Quanta Winterfell و Wiwynn Windmill مشاهده شده است.
مشکلات شناختهشده (KNOWN ISSUES)
در سیستمعاملهای قدیمیتر، اگر نام کاربری، گذرواژه و سایر اطلاعات بالقوه حساس به امنیت را در خط فرمان وارد کنید، ممکن است این اطلاعات توسط سایر کاربران هنگام استفاده از ابزارهایی مانند دستور ps(1) یا بررسی سیستمفایل /proc کشف شود. بهطور کلی امنتر است که اطلاعات گذرواژه را با گزینههایی مانند گزینههای -P یا -K وارد کنید. پیکربندی اطلاعات حساس به امنیت در فایل پیکربندی FreeIPMI نیز روش مناسبی برای پنهان کردن این اطلاعات خواهد بود.
به منظور جلوگیری از حملات جستجوی فراگیر (brute force)، برخی از BMCها پس از چند بار خطای احراز هویت از راه دور، موقتاً قفل میشوند. ممکن است لازم باشد مدتی صبر کنید تا این قفل موقت برطرف شود و بتوانید دوباره احراز هویت کنید.
برخی از مادربوردها یک مهلت زمانی عدم فعالیت OEM SOL را برای نشستهای SOL تعیین میکنند. اگر نشستهای SOL برای مدت طولانی غیرفعال بمانند، ممکن است نشستهای ipmiconsole بهطور ناگهانی بسته شوند که به احتمال زیاد منجر به خطاهای مهلت زمانی نشست (session timeout) میشود. لطفاً در صورت تمایل به فعال ماندن طولانیتر نشستها، برای اطلاعات مربوط به اصلاح این پارامتر به یادداشتهای سازنده اصلی تجهیزات (OEM) مراجعه کنید.
نکات سختافزاری خاص (SPECIFIC HARDWARE NOTES)
مدل Intel SR1520ML/X38ML: پس از راهاندازی مجدد (reboot)، به نظر میرسد نشست SOL از مادربورد "قطع" میشود اما زنده میماند. دادههای نویسهای وارد شده از کلاینت ipmiconsole توسط ماشین راه دور پذیرفته میشود، اما هیچ داده نویسهای یا داده کنسول هرگز از ماشین راه دور بازگردانده نمیشود. متعاقباً نشست SOL بیاستفاده میشود. در حال حاضر هیچ راهکاری برای رفع این مشکل وجود ندارد. نشست باید بسته شده و دوباره راهاندازی شود.
حالت پروکسی SOL به TCP (SOL-TO-TCP PROXY MODE)
بهطور پیشفرض ipmiconsole از ترمینال فعلی برای ورودی/خروجی کنسول راه دور استفاده میکند. از گزینه --proxy استفاده کنید تا ipmiconsole به یک پروکسی TCP تبدیل شود که یک اتصال TCP تکی را میپذیرد و از آن برای ورودی/خروجی کنسول راه دور استفاده میکند.
فعال کردن این حالت به هر کاربری که به سوکت TCP دسترسی دارد اجازه میدهد تا بدون هیچگونه احراز هویت به نمونه راه دور SOL متصل شود.
آدرس اتصال پروکسی را بازنویسی نکنید مگر اینکه اقداماتی را برای جلوگیری از دسترسیهای غیرمجاز انجام دهید.
حالت پروکسی را بر روی یک میزبان غیرقابل اعتماد اجرا نکنید.
مثالها (EXAMPLES)
# ipmiconsole -h ahost -u myusername -p mypassword
برقراری یک نشست کنسول با یک میزبان راه دور.
گزارش باگها (REPORTING BUGS)
گزارش باگها را به <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org> ارسال کنید.
حق نشر (COPYRIGHT)
حق نشر (C) 2007-2015
متعلق به Lawrence Livermore
National Security, LLC.
حق نشر (C) 2006-2007
متعلق به
هیئت امنای
دانشگاه
کالیفرنیا
(Regents of the University of California).
این برنامه یک نرمافزار آزاد است؛ شما میتوانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همانطور که توسط بنیاد نرمافزارهای آزاد منتشر شده است، چه نسخه ۳ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید.
همچنین ببینید (SEE ALSO)
freeipmi.conf(5), freeipmi(7), ipmi-config(8)
| 2026-08-27 | ipmiconsole 1.6.19 |