ipmievd(8)                                                          ipmievd(8)

نام (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

Duncan Laurie                                                       ipmievd(8)