نام (NAME)

ipmievd - دیمن رخداد IPMI برای ارسال رخدادها به syslog

خلاصه دستور (SYNOPSIS)

ipmievd [-c|-h|-d N|-v|-V] -I open <open | sel> [<option>]

ipmievd [-c|-h|-v|-V] -I lan -H <hostname>
[-p <port>]
[-U <username>]
[-A <authtype>]
[-L <privlvl>]
[-a|-E|-P|-f <password>]
[-o <oemtype>]
[-O <sel oem>]
sel [<option>]

ipmievd [-c|-h|-v|-V] -I lanplus -H <hostname>
[-p <port>]
[-U <username>]
[-L <privlvl>]
[-a|-E|-P|-f <password>]
[-o <oemtype>]
[-O <sel oem>]
[-C <ciphersuite>]
sel [<option>]

توضیحات (DESCRIPTION)

ipmievd دیمنی است که به رخدادهای ارسالی از سوی BMC به SEL گوش فرا داده و این پیام‌ها را در syslog نیز ثبت می‌کند. این دیمن قادر است در یکی از دو حالت اجرا شود: استفاده از بافر پیام رخداد (Event Message Buffer) و اعلان غیرهمگام رخداد از طریق درایور هسته OpenIPMI، یا نظرسنجی دوره‌ای (polling) فعال محتویات SEL برای رخدادهای جدید. پس از دریافت یک رخداد از طریق هر یک از این سازوکارها، در syslog با امکانات LOG_LOCAL4 ثبت خواهد شد.

این دیمن بر پایه ابزار کاربردی ipmitool ساخته شده است و از همان گزینه‌های پشتیبانی از رابط‌های IPMI و راه‌اندازی نشست استفاده می‌کند. لطفاً برای کسب اطلاعات بیشتر در مورد رابط‌های IPMI پشتیبانی‌شده به صفحه راهنمای ipmitool مراجعه کنید.

گزینه‌ها (OPTIONS)

-a: درخواست ورود گذرواژه کارساز راه دور.
-A <authtype>: تعیین نوع احراز هویت برای استفاده در طول فعال‌سازی نشست lan در IPMIv1.5. انواع پشتیبانی‌شده عبارتند از NONE، PASSWORD، MD2، MD5 یا OEM.
-c: نمایش خروجی در قالب CSV (متغیرهای جداشده با کاما). این گزینه برای تمام دستورها در دسترس نیست.
-C <ciphersuite>: الگوریتم‌های احراز هویت، یکپارچگی و رمزنگاری کارساز راه دور برای استفاده در اتصالات lanplus در IPMIv2. جدول 22-19 را در مشخصات فنی IPMIv2 ببینید. مقدار پیش‌فرض 3 است که احراز هویت RAKP-HMAC-SHA1، یکپارچگی HMAC-SHA1-96 و الگوریتم‌های رمزنگاری AES-CBC-128 را مشخص می‌کند.
-E: گذرواژه کارساز راه دور توسط متغیر محیطی IPMI_PASSWORD مشخص می‌شود.
-f <password_file>: فایلی حاوی گذرواژه کارساز راه دور را مشخص می‌کند. اگر این گزینه ارائه نشود، یا اگر password_file خالی باشد، گذرواژه به‌طور پیش‌فرض NULL خواهد بود.
-h: دریافت راهنمای کاربرد پایه از خط فرمان.
-H <address>: نشانی کارساز راه دور؛ می‌تواند نشانی IP یا نام میزبان (hostname) باشد. این گزینه برای رابط‌های lan و lanplus الزامی است.
-I <interface>: رابط IPMI مورد استفاده را انتخاب می‌کند. رابط‌های پشتیبانی‌شده که در برنامه کامپایل شده‌اند در خروجی راهنمای استفاده قابل مشاهده هستند.
-L <privlvl>: اجبار سطح دسترسی (امتیاز) نشست. می‌تواند CALLBACK، USER، OPERATOR یا ADMIN باشد. مقدار پیش‌فرض ADMIN است.
-m <local_address>: تنظیم نشانی محلی IPMB. مقدار پیش‌فرض 0x20 است و در عملکرد عادی نیازی به تغییر آن نیست.
-o <oemtype>: انتخاب نوع OEM برای پشتیبانی. این گزینه معمولاً شامل اصلاحات و ترفندهای جزئی در کد برای رفع رفتارهای نامتعارف و خاص در BMCهای مختلف از سازندگان گوناگون است. از -o list برای مشاهده فهرستی از انواع OEM پشتیبانی‌شده فعلی استفاده کنید.
-O <sel oem>: باز کردن فایل انتخاب‌شده و خواندن توضیحات رخدادهای OEM SEL برای استفاده در فهرست‌بندی‌های SEL. برای مشاهده قالب فایل، مثال‌های موجود در شاخه contrib را ببینید.
-p <port>: پورت UDP کارساز راه دور برای اتصال. مقدار پیش‌فرض 623 است.
-P <password>: گذرواژه کارساز راه دور در خط فرمان مشخص می‌شود. در صورت پشتیبانی، در فهرست فرایندها پنهان خواهد شد. توجه! مشخص کردن گذرواژه به‌عنوان یک گزینه در خط فرمان توصیه نمی‌شود.
-S <sdr_cache_file>: استفاده از فایل محلی برای حافظه نهان (cache) مربوط به SDR راه دور. استفاده از کش محلی SDR می‌تواند کارایی را برای دستورهایی که جهت اجرای وظیفه خود نیازمند آگاهی از کل SDR هستند، به طرز چشمگیری افزایش دهد.
-t <target_address>: پل زدن (Bridge) درخواست‌های IPMI به نشانی هدف راه دور.
-U <username>: نام کاربری کارساز راه دور، مقدار پیش‌فرض کاربر NULL است.
-d N: استفاده از شماره دستگاه N برای تعیین دستگاه /dev/ipmiN (یا /dev/ipmi/N یا /dev/ipmidev/N) جهت استفاده در ارتباطات درون‌باندی (in-band) با BMC. برای هدف قرار دادن یک BMC خاص در سامانه‌های چندگره‌ای و چند BMC از طریق رابط درایور دستگاه ipmi استفاده می‌شود. مقدار پیش‌فرض 0 است.
-v: افزایش سطح جزئیات خروجی (verbose). این گزینه می‌تواند چندین بار مشخص شود تا سطح خروجی اشکال‌زدایی افزایش یابد. اگر سه بار تکرار شود، نمایش هگزادسیمال (hexdump) تمام بسته‌های ورودی و خروجی ارائه خواهد شد.
-V: نمایش اطلاعات نسخه.

اگر هیچ روشی برای گذرواژه مشخص نشده باشد، ipmievd گذرواژه را از کاربر درخواست می‌کند. اگر گذرواژه‌ای در اعلان وارد نشود، گذرواژه کارساز راه دور به‌طور پیش‌فرض NULL در نظر گرفته خواهد شد.

دستورها (COMMANDS)

help: می‌توان از این دستور برای دریافت راهنمای خط فرمان استفاده کرد. همچنین می‌تواند در انتهای دستورها قرار گیرد تا راهنمای استفاده از گزینه‌ها را ارائه دهد.
> ipmievd help
Commands:
open Use OpenIPMI for asynchronous notification of events
sel Poll SEL for notification of events
open: این دستور ipmievd را با سازوکار نظارت بر رخداد OpenIPMI راه‌اندازی می‌کند که به قابلیت Event Message Buffer در IPMI وابسته است. این مورد نیازمند درایور OpenIPMI به‌درستی نصب و پیکربندی شده در لینوکس است و تنها اجرا از طریق رابط open برای آن معتبر است. برای اطلاعات بیشتر در خصوص راه‌اندازی درایور OpenIPMI به صفحه راهنمای ipmitool و مستندات مربوطه مراجعه کنید.
توجه: برخی از BMCها از قابلیت Event Message Buffer مورد نیاز این دستور پشتیبانی نمی‌کنند. برخی دیگر از BMCها ادعای پشتیبانی دارند اما در عمل رخدادها را به آن تحویل نمی‌دهند. در این صورت لطفاً از روش sel استفاده کنید.

daemon: راه‌اندازی فرایند به‌عنوان یک دیمن و واگذاری والد به فرایند init. تمام پیام‌ها به syslog ارسال خواهند شد. این اقدام پیش‌فرض است.
nodaemon: عدم تبدیل به دیمن؛ در عوض، تمام پیام‌ها در stderr ثبت می‌شوند.
pidfile=<filename>: ذخیره شناسه فرایند (PID) در این فایل هنگام اجرا در حالت دیمن. مقدار پیش‌فرض /run/ipmievd.pidN است (که در آن N شماره دستگاه ipmi است -- پیش‌فرض 0).

sel: این دستور ipmievd را با سازوکار نظارت بر رخداد مبتنی بر نظرسنجی SEL (یا SEL Polling) راه‌اندازی می‌کند. این سازوکار SEL را به صورت دوره‌ای بررسی می‌کند تا مشخص شود آیا رخدادهای جدیدی ثبت شده‌اند یا خیر. این دستور باید با تمام BMCها کار کند و همچنین قادر است از رابط LAN برای نظارت بر یک سامانه راه دور و ثبت رخدادهای آن در syslog محلی استفاده کند.

daemon: راه‌اندازی فرایند به‌عنوان یک دیمن و واگذاری والد به فرایند init. تمام پیام‌ها به syslog ارسال خواهند شد. این اقدام پیش‌فرض است.
nodaemon: عدم تبدیل به دیمن؛ در عوض، تمام پیام‌ها در stderr ثبت می‌شوند.
pidfile=<filename>: ذخیره شناسه فرایند (PID) در این فایل هنگام اجرا در حالت دیمن. مقدار پیش‌فرض /run/ipmievd.pidN است (که در آن N شماره دستگاه ipmi است -- پیش‌فرض 0).
timeout=<seconds>: مدت زمان بین بررسی‌ها برای روش نظرسنجی SEL. مقدار پیش‌فرض 10 ثانیه است.

مثال‌ها (EXAMPLES)

مثال ۱: فرایند دیمن در حال نظارت بر OpenIPMI برای رخدادها: > ipmievd -I open open daemon
مثال ۲: فرایند محلی غیردیمن در حال بررسی SEL راه دور هر ۳۰ ثانیه یک‌بار: > ipmievd -I lan -H 1.2.3.4 -f passfile sel nodaemon timeout=30
Reading Sensors...
Waiting for Events...

فایل‌ها (FILES)

/usr/share/misc/enterprise-numbers: رجیستری IANA PEN سیستمی برگرفته از http://www.iana.org/assignments/enterprise-numbers
~/.local/usr/share/misc/enterprise-numbers: جایگزین کاربری برای رجیستری IANA PEN سیستمی؛ این فایل در صورت وجود به جای رجیستری سیستم بارگذاری می‌شود (به بالا مراجعه کنید).

نویسنده (AUTHOR)

Duncan Laurie <duncan@iceblink.org>

همچنین ببینید (SEE ALSO)

وبگاه IPMItool: http://ipmitool.sourceforge.net
مشخصات فنی رابط مدیریت بستر هوشمند (Intelligent Platform Management Interface Specification): http://www.intel.com/design/servers/ipmi
وبگاه OpenIPMI: http://openipmi.sourceforge.net