| IPMI-DCMI(8) | دستورهای سیستمی | IPMI-DCMI(8) |
نام (NAME)
ipmi-dcmi - ابزار IPMI DCMI
خلاصه دستور (SYNOPSIS)
ipmi-dcmi [گزینه...]
توضیحات (DESCRIPTION)
دستور Ipmi-dcmi برای اجرای دستورهای افزونه IPMI رابط مدیریتپذیری مرکز داده (Data Center Manageability Interface که معمولاً DCM یا DCMI نامیده میشود) به کار میرود. افزونههای DCMI شامل پشتیبانی از مدیریت داراییها (asset management) و مدیریت مصرف توان (power usage management) هستند. بیشتر کاربران به دلیل ویژگیهای مدیریت مصرف توان به DCMI علاقهمند خواهند بود. با پیکربندی یک اقدام استثنا (exception action)، حد توان (power limit) و محدودیت زمانی اصلاح (correction time limit)، مصرف توان در یک مرکز داده را میتوان با کارایی بیشتری مدیریت کرد. لطفاً برای اطلاعات بیشتر به گزینه --set-power-limit در زیر مراجعه کنید. همچنین DCMI را میتوان با استفاده از دستهبندی dcmi در ipmi-config(8) پیکربندی کرد. مشخصات DCMI شامل بسیاری از قابلیتهای سنتی IPMI است که مستقیماً در این ابزار پیادهسازی نشدهاند. لطفاً برای پشتیبانی از سریال روی شبکه محلی (SOL) به ipmiconsole(8) برای وضعیت توان، کنترل توان، شناسایی و اطلاعات وضعیت توان ACPI به ipmi-chassis(8) برای وضعیت توان و کنترل توان به ipmipower(8) برای اطلاعات گزارش رویدادهای سیستم (SEL) به ipmi-sel(8) برای اطلاعات دستگاه و شناسه یکتای سراسری (GUID) به bmc-info(8) برای مقادیر خواندهشده حسگرها به ipmi-sensors(8) و برای پیکربندی به ipmi-config(8) مراجعه کنید.
در زیر گزینههای عمومی 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 درون باند را برای تنظیمات پیشفرض بررسی (probe) نمیکند.
- --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
- شماره آدرس وابسته (slave) هدف درایور درون باند را برای ارسال درخواستهای IPMI مشخص میکند.
- -h IPMIHOST1,IPMIHOST2,..., --hostname=IPMIHOST1[:PORT],IPMIHOST2[:PORT],...
- میزبان(های) راه دور را برای برقراری ارتباط مشخص میکند. چندین نام میزبان را میتوان با کاما جدا کرد یا در قالب محدوده مشخص نمود؛ به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید. یک پورت اختیاری را میتوان برای هر میزبان مشخص کرد که ممکن است در فوروارد پورت یا شرایط مشابه مفید باشد. اگر آدرس و پورت IPv6 مشخص میکنید، از قالب [ADDRESS]:PORT استفاده کنید.
- -u USERNAME, --username=USERNAME
- نام کاربری مورد استفاده هنگام احراز هویت با میزبان راه دور را مشخص میکند. در صورت عدم تعیین، یک نام کاربری تهی (یعنی ناشناس) در نظر گرفته میشود. کاربر برای کارکرد کامل این ابزار باید حداقل از امتیازات ADMIN برخوردار باشد.
- -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
- مهلت زمانی نشست را بر حسب میلیثانیه مشخص میکند. در صورت عدم تعیین، بهطور پیشفرض 20000 میلیثانیه (۲۰ ثانیه) است.
- --retransmission-timeout=MILLISECONDS
- مهلت زمانی ارسال مجدد بسته را بر حسب میلیثانیه مشخص میکند. در صورت عدم تعیین، بهطور پیشفرض 1000 میلیثانیه (۱ ثانیه) است. مهلت ارسال مجدد نمیتواند بزرگتر از مهلت زمانی نشست باشد.
- -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 ID) در IPMI 2.0 را
برای
استفاده
مشخص
میکند.
شناسه
مجموعهرمز
مجموعهای
از
الگوریتمهای
احراز
هویت،
یکپارچگی و
محرمانگی
را برای
استفاده در
ارتباطات IPMI 2.0
تعیین
میکند.
الگوریتم
احراز هویت
الگوریتم
مورد
استفاده
برای
برپایی
نشست،
الگوریتم
یکپارچگی
الگوریتم
مورد
استفاده
برای امضای
بستههای
نشست و
الگوریتم
محرمانگی
الگوریتم
مورد
استفاده
برای
رمزنگاری
دادهها (payload)
را مشخص
میکند. در
صورت عدم
تعیین،
پیشفرض
شناسه
مجموعهرمز
3 است.
شناسههای
مجموعهرمز
زیر در حال
حاضر
پشتیبانی
میشوند:
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
- اشکالزدایی (debugging) را فعال میکند.
- -?, --help
- نمایش پیام راهنما و خروج.
- --usage
- نمایش نحوه کاربرد دستور و خروج.
- -V, --version
- نمایش نسخه برنامه و خروج.
گزینههای IPMI-DCMI (IPMI-DCMI OPTIONS)
گزینههای زیر مختص ipmi-dcmi هستند.
- --get-dcmi-capability-info
- دریافت اطلاعات قابلیتهای DCMI.
- --get-asset-tag
- دریافت برچسب دارایی (asset tag).
- --set-asset-tag=STRING
- تنظیم برچسب دارایی (asset tag).
- --get-management-controller-identifier-string
- دریافت برچسب رشته شناسایی کنترلکننده مدیریت.
- --set-management-controller-identifier-string=STRING
- تنظیم برچسب رشته شناسایی کنترلکننده مدیریت.
- --get-dcmi-sensor-info
- دریافت اطلاعات حسگرهای DCMI.
- --get-system-power-statistics
- دریافت آمار مصرف توان سیستم.
- --get-enhanced-system-power-statistics
- دریافت آمار پیشرفته و بهبودیافته مصرف توان سیستم.
- --get-power-limit
- دریافت اطلاعات حد توان.
- --set-power-limit
- تنظیم پیکربندی حد توان. میتوان پیکربندی را از طریق گزینههای --exception-actions، --power-limit-requested، --correction-time-limit و --statistics-sampling-period فهرستشده در زیر مشخص کرد. در صورت عدم تعیین یک یا چند گزینه در زیر، از پیکربندی فعلی استفاده خواهد شد.
- --exception-actions=BITMASK
- مشخص کردن اقدامات استثنا برای پیکربندی تنظیم حد توان. مقادیر مجاز حالتهای خاص: NO_ACTION، HARD_POWER_OFF_SYSTEM، LOG_EVENT_TO_SEL_ONLY. سایر مقادیر (مثلاً 0x02 تا 0x10) وابسته به OEM هستند. همراه با گزینه --set-power-limit استفاده میشود.
- --power-limit-requested=WATTS
- مشخص کردن حد توان برای پیکربندی تنظیم حد توان. ورودی بر حسب وات مشخص میشود. همراه با گزینه --set-power-limit استفاده میشود.
- --correction-time-limit=MILLISECONDS
- مشخص کردن محدودیت زمانی اصلاح برای پیکربندی تنظیم حد توان. ورودی بر حسب میلیثانیه مشخص میشود. همراه با گزینه --set-power-limit استفاده میشود.
- --statistics-sampling-period=SECONDS
- مشخص کردن دوره نمونهبرداری آماری برنامه مدیریتی برای پیکربندی تنظیم حد توان. ورودی بر حسب ثانیه مشخص میشود. همراه با گزینه --set-power-limit استفاده میشود.
- --activate-deactivate-power-limit=OPERATION
- فعالسازی یا غیرفعالسازی حد توان. مقادیر مجاز: ACTIVATE، DEACTIVATE.
- --interpret-oem-data
- تلاش برای تفسیر دادههای OEM، مانند دادههای رویداد، مقادیر خواندهشده حسگرها یا اطلاعات اضافی عمومی و غیره. در صورتی که تفسیر OEM در دسترس نباشد، خروجی پیشفرض تولید خواهد شد. به دلیل تغییرات احتمالی سازندگان OEM در محصولات، سفتافزار و غیره، صحت تفسیرهای OEM تضمین نمیشود. برای مشاهده مادربوردهای پشتیبانیشده تأییدشده، به بخش «تفسیر OEM» در زیر مراجعه کنید.
گزینههای زمان (TIME OPTIONS)
بر اساس تعریف IPMI، تمام زمانها و مهرهای زمانی IPMI در وقت محلی (localtime) ذخیره میشوند. با این حال، در بسیاری از شرایط، مهرهای زمانی در وقت محلی ذخیره نخواهند شد. اینکه آیا یک سیستم واقعاً مهرهای زمانی را در وقت محلی ذخیره کرده است یا خیر، به عوامل متعددی مانند سازنده، بایوس (BIOS) و سیستمعامل بستگی دارد. گزینههای زیر به کاربر اجازه میدهند تفسیر مهرهای زمانی ذخیرهشده و نحوه نمایش آنها در خروجی را تنظیم کند.
- --utc-to-localtime
- فرض میکند که تمام زمانها به وقت UTC گزارش شدهاند و زمان را قبل از ارسال به خروجی به وقت محلی تبدیل میکند.
- --localtime-to-utc
- قبل از ارسال به خروجی، تمام مهرهای زمانی وقت محلی را به UTC تبدیل میکند.
- --utc-offset=SECONDS
- یک اختلاف زمان مشخص با UTC بر حسب ثانیه را برای اضافه شدن به مهرهای زمانی مشخص میکند. مقدار میتواند از -86400 تا 86400 ثانیه متغیر باشد. پیشفرض 0 است.
گزینههای محدوده میزبان (HOSTRANGED OPTIONS)
گزینههای زیر خروجی مبتنی بر محدوده میزبان را دستکاری میکنند. برای اطلاعات بیشتر در مورد محدودههای میزبان به بخش «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید.
- -B, --buffer-output
- بافر کردن خروجی محدوده میزبان. برای هر گره، خروجی استاندارد را تا زمانی که گره عملیات IPMI خود را به پایان برساند بافر میکند. هنگام تعیین این گزینه، ممکن است به نظر برسد که دادهها با سرعت کمتری برای کاربر نمایش داده میشوند زیرا کل عملیات IPMI باید قبل از نمایش هرگونه داده به پایان برسد. برای اطلاعات بیشتر به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید.
- -C, --consolidate-output
- تجمیع و یکپارچهسازی خروجی محدوده میزبان. خروجی استاندارد کامل از هر گره مشخصشده تجمیع میشود تا گرههایی با خروجی یکسان دو بار نمایش داده نشوند. یک سربرگ، آن گرهها را با خروجی تجمیعشده فهرست میکند. هنگامی که این گزینه مشخص شود، تا زمانی که عملیات IPMI روی تمام گرهها به پایان نرسد، هیچ خروجی قابل مشاهده نخواهد بود. اگر کاربر برنامه را زودتر متوقف کند، تمام خروجیهای تجمیعشده فعلی تخلیه و نمایش داده میشوند. برای اطلاعات بیشتر به «پشتیبانی از محدوده میزبان» در زیر مراجعه کنید.
- -F NUM, --fanout=NUM
- مشخص کردن انشعاب چند میزبان (fanout). یک الگوریتم «پنجره لغزان» (یا fanout) برای ارتباط موازی IPMI استفاده میشود تا گرههای کندتر یا گرههایی با مهلت زمانی سپریشده مانع ارتباط موازی نشوند. حداکثر تعداد نخهای (threads) همزمان در دسترس توسط fanout محدود میشود. مقدار پیشفرض 64 است.
- -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
به عنوان یادآوری برای خواننده، برخی از پوستهها براکتها ([ و ]) را برای تطبیق الگو (pattern matching) تفسیر میکنند. بسته به پوسته شما، ممکن است لازم باشد فهرستهای دامنهدار را داخل نقل قول قرار دهید.
هنگامی که چندین میزبان توسط کاربر مشخص میشود، یک نخ (thread) برای هر میزبان به صورت موازی تا سقف انشعاب (fanout) پیکربندیشده اجرا میشود (که میتوان آن را از طریق گزینه -F تنظیم کرد). این امر امکان برقراری ارتباط با تعداد زیادی از گرهها را بسیار سریعتر از حالت سریالی فراهم میکند.
بهطور پیشفرض، خروجی استاندارد از هر گره مشخصشده با درج نام میزبان در ابتدای هر خط نمایش داده میشود. اگرچه این خروجی در بسیاری از شرایط خوانا است، اما ممکن است در شرایط دیگر خواندن آن دشوار باشد. به عنوان مثال، خروجی چند گره ممکن است با یکدیگر ترکیب شود. از گزینههای -B و -C میتوان برای تغییر این پیشفرض استفاده کرد.
هنگامی که میزبان "localhost" مشخص شود، ارتباط درون باند IPMI استفاده خواهد شد. این به کاربر اجازه میدهد localhost را به خروجی محدوده میزبان اضافه کند.
عیبیابی عمومی (GENERAL TROUBLESHOOTING)
در اغلب موارد، مشکلات IPMI به دلیل مشکلات پیکربندی است.
مشکلات IPMI از طریق شبکه محلی (LAN) مربوط به پیکربندی نادرست BMC دستگاه راه دور است. مجدداً بررسی کنید تا مطمئن شوید موارد زیر به درستی در BMC دستگاه راه دور پیکربندی شدهاند: آدرس IP، آدرس MAC، ماسک زیرشبکه (subnet mask)، نام کاربری، فعالسازی کاربر، سطح دسترسی کاربر، گذرواژه، سطح دسترسی LAN، فعالسازی LAN و نوع/انواع احراز هویت مجاز. برای اتصالات IPMI 2.0، دوباره بررسی کنید تا مطمئن شوید سطح دسترسی مجموعهرمز و کلید 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" - شناسه مجموعهرمز که میخواهید با آن احراز هویت کنید در BMC راه دور در دسترس نیست. لطفاً دوباره با یک شناسه مجموعهرمز جایگزین امتحان کنید. همچنین ممکن است شناسههای مجموعهرمز موجود در BMC راه دور به درستی پیکربندی نشده باشند.
"ipmi 2.0 unavailable" - فناوری IPMI 2.0 در دستگاه راه دور یافت نشد. لطفاً در عوض از IPMI 1.5 استفاده کنید.
"connection timeout" - ارتباط اولیه IPMI ناموفق بود. تعدادی خطای بالقوه امکانپذیر است، از جمله نام میزبان نامعتبر مشخصشده، عدم امکان تفکیک آدرس IP متعلق به IPMI، فعال نبودن IPMI روی سرور راه دور، نامناسب بودن اتصال شبکه و غیره. لطفاً پیکربندی و اتصال را بررسی کنید.
"session timeout" - مهلت زمانی نشست IPMI به پایان رسیده است. لطفاً دوباره متصل شوید. اگر این خطا زیاد رخ میدهد، ممکن است تمایل داشته باشید مهلت زمانی ارسال مجدد را افزایش دهید. برخی از BMCهای راه دور بسیار کندتر از بقیه هستند.
"device not found" - دستگاه مشخصشده پیدا نشد. لطفاً پیکربندی یا ورودیها را بررسی کرده و دوباره امتحان کنید.
"driver timeout" - ارتباط با درایور یا دستگاه با وقفه زمانی مواجه شد. لطفاً دوباره امتحان کنید.
"message timeout" - ارتباط با درایور یا دستگاه با وقفه زمانی مواجه شد. لطفاً دوباره امتحان کنید.
"BMC busy" - در حال حاضر BMC مشغول است. ممکن است در حال پردازش اطلاعات باشد یا نشستهای همزمان زیادی برای مدیریت داشته باشد. لطفاً صبر کنید و دوباره امتحان کنید.
"could not find inband device" - دستگاه درون باند پیدا نشد. لطفاً پیکربندی را بررسی کنید یا دستگاه یا درایور خاصی را در خط فرمان مشخص نمایید.
"driver timeout" - درایور درون باند هنگام برقراری ارتباط با BMC محلی یا پردازنده خدمات دچار وقفه زمانی شد. BMC یا پردازنده خدمات ممکن است مشغول باشد یا (در بدترین حالت) احتمالاً کار نکند.
"internal IPMI error" - یک خطای داخلی IPMI رخ داده است که FreeIPMI نحوه مدیریت آن را نمیداند. لطفاً برای گزارش مشکل به <freeipmi-users@gnu.org> ایمیل بزنید.
راهکارهای دور زدن مشکلات (WORKAROUNDS)
با توجه به اینکه سازندگان متعددی راهکارهای IPMI خود را پیادهسازی میکنند، سازندگان مختلف ممکن است پروتکلهای IPMI خود را به صورت نادرست پیادهسازی کرده باشند. موارد زیر تعدادی از راهکارهای دور زدن موجود در حال حاضر را برای مدیریت مشکلات عدم انطباق کشفشده شرح میدهند. در صورت امکان، راهکارها به گونهای پیادهسازی شدهاند که برای کاربر شفاف باشند. با این حال، برخی از آنها مستلزم این خواهند بود که کاربر از طریق گزینه -W مشخص کند که از یک راهکار استفاده شود.
سختافزار فهرستشده در زیر ممکن است تنها نشاندهنده سختافزاری باشد که مشکل در آن کشف شده است. نسخههای جدیدتر سختافزار ممکن است مشکلات ذکر شده در زیر را برطرف کرده باشند. ماشینهای مشابه از سازندگان ممکن است مشکلات یکسانی را نشان دهند یا ندهند. سازندگان مختلف ممکن است سفتافزار خود را از یک توسعهدهنده سفتافزار IPMI مشترک مجوزدهی کنند، بنابراین ممکن است ارزش داشته باشد که راهکارهای فهرستشده در زیر را حتی اگر مادربورد شما فهرست نشده است، امتحان کنید.
اگر فکر میکنید سختافزار شما مشکل انطباق اضافی دارد که نیاز به پیادهسازی یک راهکار دور زدن دارد، لطفاً با نگهدارندگان FreeIPMI در <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org> تماس بگیرید.
assumeio - این پرچم راهکار فرض میکند که رابطهای درون باند به جای اینکه نگاشتشده در حافظه (memory-mapped) باشند، با I/O سیستم ارتباط برقرار میکنند. این کار مشکل سیستمهایی را که آدرسهای پایه نامعتبر را گزارش میدهند دور میزند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "device not supported" یا "could not find inband device" را مشاهده کنند. مشکل در HP ProLiant DL145 G1 مشاهده شده است.
spinpoll - این پرچم راهکار به برخی از درایورهای درون باند (بهویژه درایور KCS) اطلاع میدهد که به جای به خواب بردن فرآیند، در حین نظرسنجی (polling) به صورت فعال منتظر بمانند (spin). این امر ممکن است زمان اجرای واقعی (wall clock) ابزارها را به میزان قابل توجهی بهبود بخشد، زیرا دانهبندی (granularity) زمانبند سیستمعامل ممکن است بسیار بزرگتر از زمان لازم برای انجام یک تراکنش پیام IPMI منفرد باشد. با این حال، با چرخش، سیستم شما ممکن است با خارج نکردن ابزار از زمینه برای یک کار مفیدتر، کار مفید کمتری انجام دهد.
authcap - این پرچم راهکار از بررسیهای اولیه برای قابلیتهای نام کاربری، قابلیتهای احراز هویت و پشتیبانی K_g صرفنظر میکند و اجازه میدهد احراز هویت IPMI موفق شود. این گزینه چندین مشکل را دور میزند که در آنها سیستم راه دور قابلیتهای نام کاربری، قابلیتهای احراز هویت یا وضعیت K_g را به درستی گزارش نمیکند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "username invalid"، "authentication type unavailable for attempted privilege level" یا "k_g invalid" را مشاهده کنند. مشکل در Asus P5M2/P5MT-R/RS162-E4/RX4، Intel SR1520ML/X38ML و Sun Fire 2200/4150/4450 با ELOM مشاهده شده است.
nochecksumcheck - این پرچم راهکار به FreeIPMI میگوید که مجموعهای مقابلهای (checksums) برگشتی از پاسخهای دستورات IPMI را بررسی نکند. این گزینه مشکل سیستمهایی را دور میزند که به دلیل خطاهای پیادهسازی، چکسامهای نامعتبر برمیگردانند اما بسته در غیر این صورت معتبر است. به کاربران در مورد استفاده از این گزینه هشدار داده میشود، زیرا اعتبارسنجی یکپارچگی بسته را در چندین موقعیت حذف میکند. با این حال، بعید است که در بیشتر شرایط مشکلی ایجاد کند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "connection timeout"، "session timeout" یا "password verification timeout" را مشاهده کنند. در اتصالات IPMI 1.5، ممکن است به راهکار "noauthcodecheck" نیز نیاز باشد. مشکل در Supermicro X9SCM-iiF، Supermicro X9DRi-F و Supermicro X9DRFR مشاهده شده است.
idzero - این پرچم راهکار به شناسههای نشست خالی اجازه میدهد تا توسط کلاینت پذیرفته شوند. این گزینه مشکل نشستهای IPMI را دور میزند که شناسههای نشست خالی را به کلاینت گزارش میدهند. کسانی که با این مشکل مواجه میشوند ممکن است خطاهای "session timeout" را مشاهده کنند. مشکل در Tyan S2882 با BMC مدل M3289 مشاهده شده است.
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 با ماژول مدیریت سرور اینتل (نسخه حرفهای) مشاهده شده است.
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 مشاهده شده است.
عدم پشتیبانی از 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 روی سایر مادربوردهای همان سازنده نیز کار کند، هیچ تضمینی وجود ندارد. برخی از مادربوردهای زیر ممکن است توسط فروشندگان/توزیعکنندگان با نام تجاری دیگری عرضه شده باشند.
در حال حاضر هیچ مادربوردی پشتیبانی نمیشود (Currently None)
مثالها (EXAMPLES)
# ipmi-dcmi --get-power-limit
دریافت حد توان ماشین محلی.
# ipmi-dcmi -h ahost -u myusername -p mypassword --get-power-limit
دریافت حد توان یک ماشین راه دور با استفاده از IPMI بر روی LAN.
# ipmi-dcmi -h mycluster[0-127] -u myusername -p mypassword --get-power-limit
دریافت حد توان در سراسر یک کلاستر با استفاده از IPMI بر روی LAN.
عیبیابی و وضعیت خروج (DIAGNOSTICS)
در صورت اجرای موفقیتآمیز، وضعیت خروج 0 است. در صورت بروز خطا، وضعیت خروج 1 است.
اگر چندین میزبان برای برقراری ارتباط مشخص شده باشند، وضعیت خروج فقط و فقط در صورتی 0 است که تمام اهداف با موفقیت اجرا شوند. در غیر این صورت وضعیت خروج 1 است.
مشکلات شناختهشده (KNOWN ISSUES)
در سیستمعاملهای قدیمیتر، اگر نام کاربری، گذرواژه و سایر اطلاعات مرتبط با امنیت را در خط فرمان وارد کنید، این اطلاعات ممکن است توسط کاربران دیگر در هنگام استفاده از ابزارهایی مانند دستور ps(1) یا بررسی در فایلسیستم /proc کشف شود. بهطور کلی امنتر است که اطلاعات گذرواژه را با گزینههایی مانند گزینههای -P یا -K وارد کنید. پیکربندی اطلاعات مرتبط با امنیت در فایل پیکربندی FreeIPMI نیز روش مناسبی برای مخفی کردن این اطلاعات خواهد بود.
به منظور جلوگیری از حملات جستجوی فراگیر (brute force)، برخی از BMCها پس از تعدادی خطای احراز هویت راه دور موقتاً «قفل» (lock up) میشوند. ممکن است لازم باشد مدتی صبر کنید تا این «قفل» موقت برطرف شود و بتوانید دوباره احراز هویت کنید.
گزارش باگها (REPORTING BUGS)
اشکالات را به <freeipmi-users@gnu.org> یا <freeipmi-devel@gnu.org> گزارش دهید.
حق نشر (COPYRIGHT)
حق نشر © 2009-2015 شرکت امنیت ملی لارنس لیورمور (Lawrence Livermore National Security, LLC).
این برنامه یک نرمافزار آزاد است؛ شما میتوانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) که توسط بنیاد نرمافزارهای آزاد منتشر شده است، چه نسخه ۳ پروانه و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید.
همچنین ببینید (SEE ALSO)
freeipmi(7), ipmi-chassis(8), ipmi-config(8), ipmi-sel(8), ipmi-sensors(8), ipmiconsole(8), ipmipower(8)
| 2026-08-27 | ipmi-dcmi 1.6.19 |