ipmi_ui(1) Crude interface to an IPMI system ipmi_ui(1)

ipmi_ui - رابط کاربری ابتدایی برای یک سامانهٔ IPMI

ipmiui [-dmsg] [-dmem] [-c] connection-1[connection-2]

اتصال‌ها به یکی از دو روش زیر مشخص می‌شوند:

smi smi-num

یا

lan IP-addr port [IP-addr-2 port-2] auth privilege username password

برنامهٔ ipmi_ui به یک سامانهٔ IPMI متصل شده و امکان دسترسی به نهادها (entities) و حسگرهای IPMI و کنترل‌های OpenIPMI را فراهم می‌کند. این ابزار نسبتاً ابتدایی است و عمدتاً برای آزمایش OpenIPMI طراحی شده، اما کاربردهایی فراتر از آن نیز دارد و به همین دلیل ارائه شده است.

در حالت عادی، ipmi_ui در حالت تمام‌صفحه اجرا می‌شود. پنجرهٔ سمت چپ خروجی دستورها را نمایش می‌دهد و پنجرهٔ سمت راست لاگ‌های OpenIPMI را نشان می‌دهد. هر دو پنجره با کلیدهای page up و page down قابل پیمایش هستند؛ کلید «F1» را فشار دهید تا پنجرهٔ سمت چپ برای پیمایش انتخاب شود و کلید «F2» را برای پیمایش پنجرهٔ سمت راست فشار دهید.

توجه داشته باشید که باید متغیر محیطی TERM را متناسب با ترمینال خود به درستی تنظیم کنید، در غیر این صورت ipmi_ui اطلاعات را به صورت نامفهوم و به‌هم‌ریخته روی صفحه نمایش خواهد داد.

توجه داشته باشید که می‌توانید مشخصات دو اتصال را در خط فرمان وارد کنید، در این صورت ipmi_ui دو اتصال برقرار خواهد کرد. این کار تنها در صورتی مجاز است که اتصال‌ها از طریق کنترل‌کننده‌های مدیریت (management controllers) متفاوت به یک دامنهٔ IPMI یکسان برقرار شوند. همچنین، هر اتصال LAN می‌تواند دارای دو آدرس IP باشد. این‌ها دو آدرس متفاوت به یک کنترل‌کنندهٔ مدیریت یکسان هستند. بنابراین در کل ممکن است ۴ آدرس IP به یک دامنهٔ IPMI داشته باشید: دو کنترل‌کنندهٔ مدیریت، و دو آدرس IP برای هر کنترل‌کنندهٔ مدیریت.

اشکال‌زدایی پیام‌ها را فعال می‌کند؛ این کار تمام پیام‌ها را به پنجرهٔ لاگ ارسال (dump) می‌کند.
اشکال‌زدایی حافظه را فعال می‌کند؛ این کار باعث بررسی تخصیص‌ها و آزادسازی‌های حافظه می‌شود. هنگامی که برنامه پایان می‌یابد، تمام حافظه‌هایی که به درستی آزاد نشده‌اند (نشت حافظه) گزارش داده می‌شوند.
گردانندهٔ تلهٔ SNMP (SNMP trap handler) را فعال می‌کند. برای در دسترس بودن این گزینه، ipmi_ui باید با کدهای فعال SNMP کامپایل شده باشد.
اجرای برنامه در حالت خط فرمان. این حالت برای اسکریپت‌نویسی مفید است. تمام خروجی‌ها به خروجی استاندارد ارسال شده و هیچ رابط پنجره‌ای نمایش داده نمی‌شود.
شمارهٔ SMI برای اتصال، ویژهٔ سامانه‌هایی با بیش از یک رابط سامانه (system interface). معمولاً این مقدار «0» است.
آدرس IP مربوط به رابط LAN.
درگاه UDP رابط LAN؛ معمولاً 623.
برخی سامانه‌ها از چندین اتصال IP پشتیبانی می‌کنند؛ این گزینه آدرس دوم را مشخص می‌کند و اختیاری است. در صورت تعیین، OpenIPMI از هر دو آدرس IP استفاده کرده و در صورت بروز خطا در یکی از آن‌ها، به آدرس سالم تغییر مسیر می‌دهد (failover).
درگاه مربوط به اتصال دوم IP؛ معمولاً 623.
روش احراز هویت مورد استفاده برای اتصال، که می‌تواند یکی از موارد «none»،‏ «straight»،‏ «md5» یا «md2» باشد.
سطح دسترسی مورد استفاده برای اتصال، که می‌تواند یکی از موارد «callback»،‏ «user»،‏ «operator» یا «admin» باشد. توجه داشته باشید که برخی از عملیات‌های IPMI بدون سطح دسترسی مناسب ناموفق خواهند بود.
نام کاربری مورد استفاده برای اتصال. در صورت استفاده از کاربر ناشناس، این مقدار باید رشتهٔ خالی «""» باشد.
گذرواژهٔ مورد استفاده برای اتصال..SH "موجودیت‌ها (ENTITIES)"

موجودیت‌ها بر پایه شناسه موجودیت (entity id، نوع موجودیتی که هستند) و نمونه موجودیت (entity instance) فهرست می‌شوند. موجودیت‌ها ممکن است در سیستم فعال یا غیرفعال باشند؛ برای تعیین این موضوع از الگوریتم استاندارد IPMI استفاده می‌شود. دستورهای مربوط به موجودیت‌ها عبارتند از:

فهرست کردن تمام موجودیت‌های موجود در سیستم. خروجی شامل مشخصه‌ساز موجودیت (entity specifier) است که به دنبال آن یک نام موجودیت اختیاری در پرانتز، و سپس "present" یا "not present" می‌آید.
برای بررسی حضور تمامی موجودیت‌ها.
فهرست کردن اطلاعات FRU مرتبط با موجودیت (entity).
تخلیه (dump) اطلاعات خام از دستگاه FRU مشخص‌شده.

حسگرها دستگاه‌های ورودی را تعریف می‌کنند که OpenIPMI می‌تواند آن‌ها را پایش کند.

فهرست کردن تمام حسگرهایی که موجودیت داده‌شده را پایش می‌کنند. خروجی شامل مشخصه‌ساز حسگر (مشخصه‌ساز موجودیت به همراه نام حسگر، که فاصله‌ها با ~ جایگزین شده‌اند) و به دنبال آن نام حسگر است.
فراخوانی حسگر داده‌شده و نمایش تمامی اطلاعات آن. در حالت تمام‌صفحه، وضعیت حسگر هر ثانیه مجدداً استعلام می‌شود.
مسلح‌سازی مجدد (rearm) حسگر داده‌شده. اگر global برابر 1 باشد، کل حسگر مجدداً مسلح می‌شود. اگر global برابر 0 باشد، باید assertion-mask و deassertion-mask مشخص شوند تا تعیین کنند کدام آستانه‌ها یا وضعیت‌ها باید مجدداً مسلح گردند.
فعال یا غیرفعال کردن رویدادها برای حسگر داده‌شده. events رویدادهای حسگر را روشن یا خاموش می‌کند (0 یا 1). scanning پویش را برای حسگر روشن یا خاموش می‌کند (0 یا 1). assertion-bitmask بیت‌ماسکِ آستانه‌ها یا وضعیت‌هایی را مشخص می‌کند که باید هنگام برقرار شدن (asserted) یک آستانه یا وضعیت، فعال یا غیرفعال شوند. این مقدار رشته‌ای از 0ها و 1ها است که در آن، اولی برای آستانه/وضعیت ۰، دومی برای آستانه/وضعیت ۱ و غیره است. deassertion-bitmask بیت‌ماسکِ آستانه‌ها یا وضعیت‌هایی را مشخص می‌کند که باید هنگام لغو شدن (deasserted) یک آستانه یا وضعیت، فعال یا غیرفعال شوند.

کنترل‌ها دستگاه‌های خروجی هستند که می‌توانند مواردی مانند LEDها، برق، خطوط راه‌اندازی مجدد (reset lines) و نظایر آن را کنترل کنند.

فهرست کردن تمام کنترل‌هایی که موجودیت داده‌شده را کنترل می‌کنند. خروجی شامل مشخصه‌ساز کنترل (مشخصه‌ساز موجودیت به همراه نام کنترل، که فاصله‌ها با ~ جایگزین شده‌اند) و به دنبال آن نام کنترل است.
فراخوانی کنترل داده‌شده و نمایش وضعیت فعلی آن.
تغییر مقدار یک کنترل. توجه داشته باشید که برای کنترل‌هایی با چندین مقدار، هر مقدار باید مشخص شود..SH "رویدادها (EVENTS)"

رویدادها پیام‌های ناهمگامی از حسگرها هستند که به کاربر اعلام می‌کنند حسگری کاری انجام داده است. رویدادها عموماً در یک گزارش رویداد سیستم (SEL) ذخیره می‌شوند؛ OpenIPMI رویدادها را از SELهای درون سیستم واکشی خواهد کرد.

از آنجا که ممکن است چندین SEL وجود داشته باشد، هر رویداد با MC مبدأ آن در قالب «(channel addr)» و یک شمارهٔ گزارش مشخص می‌شود. ممکن است شمارهٔ گزارش یکسانی در چندین MC وجود داشته باشد.

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

رویداد مشخص‌شده را حذف می‌کند. توجه داشته باشید که بسیاری از SELها از حذف تکی رویدادها پشتیبانی نمی‌کنند، بنابراین ممکن است این کار فقط رونوشت محلی رویداد را حذف کند و نه موردی که درون SEL قرار دارد. در این حالت، برای حذف رویدادها در SEL، باید تمام رویدادهای SEL را حذف کنید و حدود ۱۰ ثانیه منتظر بمانید تا OpenIPMI پاک‌سازی کامل SEL را به انجام برساند.
تمام رویدادهای موجود در SEL را حذف می‌کند. این فرآیند ممکن است مدتی به طول بینجامد، بنابراین اگر این دستور را اجرا کرده و بلافاصله خارج شوید، ممکن است فرآیند کامل نشود.
تمام رویدادهای موجود در رونوشت محلی SELها را فهرست می‌کند. این تنها رونوشت محلی است؛ اگر نسخه‌های اصلی تغییر کرده باشند، این تغییر در اینجا منعکس نخواهد شد.
زمان را در SEL برای MC داده‌شده دریافت می‌کند.

در OpenIPMI، شما معمولاً مستقیماً با کنترل‌کننده‌های مدیریت سر و کار ندارید. آن‌ها بخش‌های داخلی سیستم در نظر گرفته می‌شوند. با این حال، به منظور اشکال‌زدایی، اطلاعاتی دربارهٔ آن‌ها ارائه می‌شود.

تمام MCهای موجود در سیستم و وضعیت فعال بودن آن‌ها را فهرست می‌کند. MCها در قالب «(channel address)» نمایش داده می‌شوند.
نمایش حجم زیادی از اطلاعات دربارهٔ MC، که بیشتر آن‌ها از دستور get device id به دست می‌آیند.
یک دستور IPMI را به MC داده‌شده ارسال می‌کند. برای انجام این کار، MC باید وجود داشته و فعال باشد.
یک دستور راه‌اندازی مجدد گرم (warm) یا سرد (cold) را به MC داده‌شده ارسال می‌کند. اقدامی که MC انجام می‌دهد مختص به سیستم است.
برای یافتن یک MC در آدرس داده‌شده پویش می‌کند. اگر MC وجود داشته باشد اما OpenIPMI از آن آگاه نباشد، اضافه خواهد شد. اگر MC دیگر وجود نداشته باشد، حذف می‌شود.
تولید رویداد را برای MC داده‌شده فعال یا غیرفعال می‌کند.
چاپ می‌کند که آیا رویدادها برای MC داده‌شده فعال هستند یا خیر..SH "پیکربندی پارامترهای شبکه (LAN Parameter Configuration)"

OpenIPMI دارای توابعی است که پیکربندی پارامترهای LAN یک اتصال شبکه محلی (LAN) را آسان‌تر می‌کند. توجه داشته باشید که پارامترهای LAN دارای یک قفل هستند که OpenIPMI تلاش می‌کند از آن استفاده کند. اگر پارامترهای LAN را بخوانید، آن‌ها قفل خواهند شد تا زمانی که یا آن‌ها را بازنویسی کنید یا قفل را پاک نمایید.

خواندن اطلاعات lanparm از یک MC و نمایش آن در پنجره نمایش.
نمایش اطلاعات فعلی lanparm در پنجره نمایش.
نوشتن اطلاعات فعلی LANPARM روی یک MC. توجه داشته باشید که این باید همان MC باشد که پارامترها از آن خوانده شده‌اند.
پاک کردن یک قفل LANPARM. اگر MC مشخص شده باشد، قفل LANPARM مستقیماً پاک می‌شود. در صورت عدم تعیین، قفل LANPARM مربوط به پارامترهای فعلی پاک خواهد شد.
تنظیم مورد پیکربندی مشخص‌شده روی مقدار تعیین‌شده. پارامتر اختیاری selector برای مواردی استفاده می‌شود که یک انتخاب‌گر می‌پذیرند، مانند «auth» یا هر یک از موارد موجود در «destination».

OpenIPMI شامل توابعی برای کمک به مدیریت تنظیمات PEF روی یک BMC است. توجه داشته باشید که پارامترهای PEF دارای قفلی هستند که OpenIPMI تلاش می‌کند از آن استفاده کند. اگر پارامترهای PEF را بخوانید، قفل خواهند شد تا زمانی که یا آن‌ها را بنویسید یا قفل را پاک کنید.

خواندن اطلاعات PEF از یک MC.
پاک کردن یک قفل PEF. اگر MC مشخص شده باشد، قفل PEF روی آن MC مستقیماً پاک می‌شود. اگر هیچ MC مشخص نشده باشد، قفل PEF فعلی پاک خواهد شد.
نمایش اطلاعات فعلی pef در پنجره نمایش.
نوشتن اطلاعات فعلی PEF روی یک MC.
تنظیم مورد پیکربندی مشخص‌شده روی مقدار تعیین‌شده. پارامتر اختیاری selector برای مواردی استفاده می‌شود که یک انتخاب‌گر می‌پذیرند، مانند هر یک از موارد در فیلترهای رویداد، خط‌مشی‌های هشدار یا رشته‌های هشدار.
راه‌اندازی اتصال برای دامنه (domain) جهت ارسال تله‌های PET از اتصال داده‌شده به آدرس IP/MAC مشخص‌شده روی کانال تعیین‌شده. این دستور تمامی پیکربندی‌های LAN و PEF لازم برای تنظیم یک سیستم به‌منظور ارسال تله‌های رویداد را انجام می‌دهد.

OpenIPMI می‌تواند چندین اتصال را به یک دامنه حفظ کند. این ابزار به‌طور کلی در هر لحظه تنها از یکی از آن‌ها استفاده می‌کند (اگرچه اتصال دیگر به‌طور مداوم تحت آزمایش خواهد بود). این اتصال همان اتصال «فعال» است. شما می‌توانید وضعیت اتصال فعال را جویا شوید یا مشخص کنید کدام اتصال فعال باشد.

شماره اتصال، همان اتصال تعیین‌شده در خط فرمان است. شما می‌توانید دو اتصال را در خط فرمان مشخص کنید (بخشی که با «lan»، «smi» و غیره آغاز می‌شود). اولین اتصالی که مشخص می‌کنید اتصال صفر و دومین مورد اتصال ۱ خواهد بود.

نمایش وضعیت فعال بودن یا نبودن اتصال داده‌شده.
فعال کردن اتصال مشخص‌شده..SH "دستورهای دیگر (OTHER COMMANDS)"
یک دستور IPMI را به آدرس IPMB داده‌شده ارسال می‌کند. این دستور برای مواردی است که MC مشخص‌شده یافت نمی‌شود یا فعال‌سازی آن ممکن نیست.
تمام SDRها را از MC داده‌شده استخراج می‌کند. اگر do-sensors برابر true باشد، SDR دستگاه استخراج می‌شود. اگر false باشد، مخزن اصلی SDR بر روی MC استخراج می‌گردد.
یک پویش گذرگاه IPMB را برای IPMB داده‌شده انجام می‌دهد تا تلاش کند MC را در آدرس مشخص‌شده شناسایی کند. پویش گذرگاه IPMB می‌تواند کند باشد؛ اگر آدرس را از قبل بدانید، این دستور می‌تواند به تسریع کار کمک کند.
خروج از برنامه.
تلاش برای قطع ارتباط و اتصال مجدد به کنترل‌کنندهٔ IPMI. این دستور عمدتاً برای آزمایش کاربرد دارد.
تنظیم پنجرهٔ نمایش (پنجرهٔ سمت چپ) برای پیمایش، در صورتی که کلید «F1» کار نکند.
تنظیم پنجرهٔ گزارش (پنجرهٔ سمت راست) برای پیمایش، در صورتی که کلید «F2» کار نکند.
نمایش یک خروجی راهنمای مختصر دربارهٔ تمام دستورها.

تمام خروجی‌های خطا به پنجرهٔ گزارش هدایت می‌شوند.

ipmilan(8)

نام ما لژیون است (شمار ما بی‌شمار است).

Corey Minyard <cminyard@mvista.com>

05/13/03 OpenIPMI