| openipmi_eventd(1) | IPMI event handler | openipmi_eventd(1) |
نام (NAME)
openipmi_eventd - یک مدیریت‌کننده رویدادهای IPMI
خلاصه دستور (SYNOPSIS)
openipmi_eventd <domain name> <connection parms> <options> <program> [<parm1> [<parm2> [...]]]
توضیحات (DESCRIPTION)
برنامه openipmi_eventd به رویدادهای IPMI برای اتصال داده‌شده گوش می‌دهد و آن‌ها را برای پردازش به برنامه‌ای دیگر یا به یک فایل ارسال می‌کند.
پارامترها (PARAMETERS)
- <domain name>
- نامی که برای دامنه OpenIPMI استفاده می‌شود. این نام در گزارش‌ها و برخی شناسه‌ها نمایش داده خواهد شد.
- <connection parms>
- پارامترهای اتصال بسته به نوع اتصال متغیر هستند. تمامی این موارد در openipmi_conparms (7) شرح داده شده‌اند.
- <options>
- صفر یا چند مورد از گزینه‌های تعریف‌شده در بخش گزینه‌ها در زیر.
- <program> [<parm1> [<parm2> [...]]]
- برنامه‌ای که باید اجرا شود. این مقدار باید مسیر کامل به برنامه باشد. هر پارامتر ارائه‌شده قبل از هر پارامتر IPMI به برنامه ارسال می‌شود.
گزینه‌ها (OPTIONS)
- -f filename, --outfile filename
- تمام رویدادها را به فایل مشخص‌شده ارسال می‌کند.
- -k, --exec-now
- برنامه داده‌شده را بلافاصله اجرا کرده و اطلاعات رویداد را به ورودی استاندارد آن برنامه ارسال می‌کند. برنامه نباید خارج شود؛ اگر خاتمه یابد، این برنامه با خطا به کار خود پایان می‌دهد.
- -i, --event-stdin
- اطلاعات رویداد را به جای خط فرمان، به ورودی استاندارد برنامه ارسال می‌کند.
- -e, --delete-events
- رویدادها را پس از پردازش، از SEL (گزارش رویداد سیستم یا System Event Log) حذف می‌کند. توجه داشته باشید که برنامه باید رویداد را بدون خطا پردازش کرده باشد تا رویداد حذف شود؛ در غیر این صورت رویدادها از SEL حذف نخواهند شد.
- -b, --dont-daemonize
- برنامه را به صورت دیمن درنمی‌آورد و آن را به عنوان یک پردازش پیش‌زمینه اجرا می‌کند.
- -d, --debug
- برنامه را اشکال‌زدایی می‌کند، خروجی را فعال می‌سازد، تمام گزارش‌ها را به stderr ارسال می‌کند و فرآیند را به صورت دیمن اجرا نمی‌کند.
نحوه استفاده (USAGE)
این برنامه پس از راه‌اندازی، به دامنه مشخص‌شده IPMI متصل می‌شود، تمام لاگ‌های موجود را نادیده می‌گیرد و برای گوش دادن به گزارش‌ها از تمامی منابع آماده می‌شود. هنگامی که یک رویداد دریافت می‌شود، بسته به نحوه پیکربندی، به آن رسیدگی خواهد کرد.
به‌طور پیش‌فرض، برنامه به‌ازای هر گزارش فراخوانی شده و اطلاعات رویداد در خط فرمان برنامه ارسال می‌شود. اولین پارامتر (پس از پارامترهای داده‌شده در خط فرمان openipmi_eventd ) نوع رویداد خواهد بود، و باقی موارد جفت‌های کلید-مقدار هستند که در زیر تعریف شده‌اند.
اگر -i در خط فرمان مشخص شود، به‌جای ارسال اطلاعات رویداد در خط فرمان، به ورودی استاندارد برنامه ارسال خواهد شد. خط اول نوع رویداد خواهد بود و هر خط شامل یک جفت کلید-مقدار است تا خط آخر که عبارت endevent خواهد بود.
اگر -k در خط فرمان مشخص شود، برنامه بلافاصله اجرا شده و انتظار می‌رود رویدادها را هنگام ورود در ورودی استاندارد خود دریافت کند. هر رویداد با یک نوع رویداد شروع می‌شود، شامل جفت‌های کلید-مقدار است و با endevent به پایان می‌رسد.
جفت‌های کلید-مقدار رویداد (EVENT KEY-VALUE PAIRS)
اولین خط و پارامتر یک رویداد همیشه نوع رویداد است (یکی از موارد threshold ، discrete یا unknown ). سپس موارد زیر بدون ترتیب خاصی می‌آیند. هنگام ارسال به یک فایل یا به برنامه‌ای دیگر از طریق ورودی استاندارد، endevent نشان‌دهنده پایان یک رویداد خواهد بود.
- assert true|false
- اگر true باشد، رویداد برقرار (assert) شده است (هشدار فعال است). اگر false باشد، هشدار وجود داشته اما اکنون برطرف شده است.
- eventtype <num>
- نوع رویداد، طبق مشخصات IPMI.
- eventtime <num>
- زمان (به ثانیه) برای رویداد IPMI. این یک مقدار ۶۴ بیتی است.
- eventdata <vals>
- داده‌های خام رویداد؛ vals فهرستی از مقادیر هگزادسیمال است.
- id <name>
- شناسه OpenIPMI سنسور. این مقدار در قالب زیر است: <entity_id>.<entity_instance>.<sensor_name> که در آن شناسه موجودیت (entity id) و نمونه (instance) شیء تحت نظارت را مشخص می‌کنند و نام سنسور از سنسور دریافت می‌شود. فقط برای رویدادهای discrete و threshold.
- val <floatnum>
- مقدار سنسور که باعث ایجاد رویداد شده است، در قالب ممیز شناور (floating point). اختیاری است و فقط برای سنسورهای threshold وجود دارد.
- raw <hexnum>
- مقدار سنسور که باعث ایجاد رویداد شده است، در قالب خام (هگزادسیمال). اختیاری است و فقط برای سنسورهای threshold وجود دارد.
- off <num>
- بیتی در سنسور که باعث ایجاد رویداد شده است؛ فقط برای سنسورهای discrete وجود دارد.
- severity
- شدت رویداد. برای سنسورهای discrete این مورد اختیاری بوده و عددی بین 0 تا 14 است. معنای آن به نوع سنسور خاص بستگی دارد. برای سنسورهای threshold یکی از موارد زیر است:
- prevseverity
- - شدت قبل از رویداد؛ اختیاری است و فقط برای سنسورهای discrete وجود دارد.
- direction going_low|going_high
- جهت رویداد، فقط برای سنسورهای threshold. درک این موضوع ممکن است دشوار باشد و در سیستم‌های IPMI یکپارچه نیست. مشخصات IPMI معنای آن را تعریف می‌کند. به عنوان مثال، برقراری (assertion) یک رویداد بحرانی بالایی (upper critical) در حال رفتن به پایین (going low) به چه معناست؟
همچنین ببینید (SEE ALSO)
مشکلات شناخته‌شده (KNOWN PROBLEMS)
هیچ موردی گزارش نشده است.
نویسنده (AUTHOR)
Corey Minyard <cminyard@mvista.com>
| 03/4/15 | OpenIPMI |