| ovsdb.local-config(5) | راهنمای Open vSwitch | ovsdb.local-config(5) |
نام (NAME)
ovsdb.local-config - طرح‌واره پایگاه‌داده پیکربندی محلی ovsdb-server
این پایگاه‌داده برای پیکربندی محلی یک ovsdb-server استفاده می‌شود. این پایگاه‌داده به‌گونه‌ای در نظر گرفته شده که حتی میان چندین سرور خوشه‌ای پایگاه‌داده نیز منحصر‌به‌فرد باشد، تا پیکربندی مختص به آن سرور بتواند به‌طور جداگانه تنظیم شود (برای نمونه اطلاعات اتصال).
خلاصه جدول‌ها (TABLE SUMMARY)
فهرست زیر هدف هر یک از جدول‌های پایگاه‌داده Local_Config را خلاصه می‌کند. هر جدول در صفحات بعدی با جزئیات بیشتر شرح داده شده است.
- جدول
- هدف
- Config
- پیکربندی
ovsdb-server
- Connection
- اتصالات کلاینت OVSDB.
جدول Config (Config TABLE)
جدول ریشه پیکربندی محلی برای یک ovsdb-server. این جدول باید دقیقاً یک ردیف داشته باشد.
چکیده:
- گزینه‌های اتصال:
- connections
- مجموعه‌ای از Connectionها
جزئیات:
- connections: مجموعه‌ای از Connectionها
- کلاینت‌های پایگاه‌داده‌ای که سرور پایگاه‌داده Open vSwitch باید به آن‌ها متصل شود یا روی آن‌ها شنود کند، همراه با گزینه‌هایی برای نحوه پیکربندی این اتصالات. برای اطلاعات بیشتر به جدول Connection مراجعه فرمایید.
جدول Connection (Connection TABLE)
پیکربندی برای یک اتصال پایگاه‌داده به کلاینت پایگاه‌داده Open vSwitch (OVSDB).
این جدول اساساً سرور پایگاه‌داده Open vSwitch یعنی (ovsdb-server) را پیکربندی می‌کند.
سرور پایگاه‌داده Open vSwitch می‌تواند اتصالات فعال به کلاینت‌های راه دور را برقرار و نگهداری کند. همچنین می‌تواند برای اتصالات پایگاه‌داده به شنود بپردازد.
چکیده:
- ویژگی‌های اصلی:
- تشخیص و مدیریت خرابی کلاینت:
- max_backoff
- عدد صحیح
اختیاری،
حداقل
۱٬۰۰۰
- inactivity_probe
- عدد صحیح اختیاری
- وضعیت:
- is_connected
- بولی
- status : last_error
- رشته
اختیاری
- status : state
- رشته
اختیاری،
یکی از ACTIVE،
BACKOFF، CONNECTING، IDLE
یا VOID
- status : sec_since_connect
- رشته
اختیاری،
شامل عدد
صحیح،
حداقل ۰
- status : sec_since_disconnect
- رشته
اختیاری،
شامل عدد
صحیح،
حداقل ۰
- status : locks_held
- رشته
اختیاری
- status : locks_waiting
- رشته
اختیاری
- status : locks_lost
- رشته
اختیاری
- status : n_connections
- رشته
اختیاری،
شامل عدد
صحیح،
حداقل ۲
- status : bound_port
- رشته اختیاری، شامل عدد صحیح
- پارامترهای اتصال:
- other_config : dscp
- رشته اختیاری، شامل عدد صحیح
- پیکربندی:
- external_ids
- نگاشتی از جفت‌های رشته-رشته
جزئیات:
- target: رشته (باید درون جدول یکتا باشد)
- روش‌های اتصال برای کلاینت‌ها.
- روش‌های اتصال زیر در حال حاضر پشتیبانی می‌شوند:
- ssl:host[:port]
- پورت مشخص‌شده SSL/TLS بر روی میزبان در host داده‌شده، که می‌تواند یک نام DNS (در صورت ساخت با کتابخانه unbound) یا یک نشانی IP باشد. هنگام استفاده از این قالب باید یک پیکربندی معتبر SSL/TLS ارائه شود؛ این پیکربندی می‌تواند از طریق گزینه‌های خط فرمان یا جدول SSL مشخص گردد.
- اگر port مشخص نشود، پیش‌فرض آن 6640 است.
- پشتیبانی از SSL/TLS یک ویژگی اختیاری است که همیشه به عنوان بخشی از Open vSwitch ساخته نمی‌شود.
- tcp:host[:port]
- پورت مشخص‌شده TCP بر روی میزبان در host داده‌شده، که می‌تواند یک نام DNS (در صورت ساخت با کتابخانه unbound) یا یک نشانی IP باشد. اگر host یک نشانی IPv6 است، آن را داخل کروشه قرار دهید؛ برای نمونه: tcp:[::1]:6640.
- اگر port مشخص نشود، پیش‌فرض آن 6640 است.
- pssl:[port][:host]
- شنود برای اتصالات SSL/TLS روی پورت مشخص‌شده TCP. مقدار 0 را برای port تعیین کنید تا هسته به‌طور خودکار یک پورت آزاد را انتخاب کند. اگر host، که می‌تواند نام DNS یا نشانی IP باشد، مشخص شود، اتصالات به نشانی IP محلی تعیین‌شده یا تحلیل‌شده (IPv4 یا IPv6) محدود می‌شوند. اگر host یک نشانی IPv6 است، در کروشه قرار دهید؛ مثلاً pssl:6640:[::1]. اگر host مشخص نشود، تنها روی نشانی‌های IPv4 (و نه IPv6) شنود می‌کند. هنگام استفاده از این قالب باید پیکربندی معتبر SSL/TLS ارائه گردد.
- اگر port مشخص نشود، پیش‌فرض آن 6640 است.
- پشتیبانی از SSL/TLS یک ویژگی اختیاری است که همیشه به عنوان بخشی از Open vSwitch ساخته نمی‌شود.
- ptcp:[port][:host]
- شنود برای اتصالات روی پورت مشخص‌شده TCP. مقدار 0 را برای port مشخص کنید تا هسته پورت آزاد را به‌طور خودکار برگزیند. اگر host مشخص شود، اتصالات به نشانی IP محلی محدود می‌گردند. اگر host نشانی IPv6 است، در کروشه قرار دهید؛ مثلاً ptcp:6640:[::1]. اگر host تعیین نشود، تنها روی نشانی‌های IPv4 شنود خواهد شد.
- اگر port مشخص نشود، پیش‌فرض آن 6640 است.
- هنگامی که چندین کلاینت پیکربندی می‌شوند، مقادیر target باید یکتا باشند. مقادیر تکراری target نتایج نامشخصی تولید می‌کنند.
- read_only: بولی
- مقدار true برای محدود کردن این اتصالات به تراکنش‌های فقط‌خواندنی، و false برای اجازه دادن به آن‌ها جهت تغییر پایگاه‌داده.
- role: رشته
- رشته‌ای حاوی نام نقش (role) برای این ورودی اتصال.
- max_backoff: عدد صحیح اختیاری، حداقل ۱٬۰۰۰
- حداکثر تعداد میلی‌ثانیه‌ها برای انتظار میان تلاش‌های برقراری اتصال. مقدار پیش‌فرض وابسته به پیاده‌سازی است.
- inactivity_probe: عدد صحیح اختیاری
- حداکثر زمان بیکاری بر حسب میلی‌ثانیه روی اتصال به کلاینت پیش از ارسال پیام کاوشگر عدم فعالیت (inactivity probe). اگر Open vSwitch برای تعداد ثانیه‌های مشخص‌شده با کلاینت ارتباط برقرار نکند، یک پیام کاوشگر ارسال می‌کند. اگر در همین مدت‌زمان پاسخی دریافت نشود، Open vSwitch اتصال را قطع‌شده تلقی کرده و برای اتصال مجدد تلاش می‌کند. پیش‌فرض وابسته به پیاده‌سازی است. مقدار 0 کاوشگرها را غیرفعال می‌سازد.
جفت کلید-مقدار is_connected همیشه به‌روزرسانی می‌شود. سایر جفت‌های کلید-مقدار در ستون‌های وضعیت ممکن است بسته به نوع target به‌روز شوند.
هنگامی که target روش اتصالی را مشخص می‌کند که به اتصالات ورودی گوش فرا می‌دهد (مانند ptcp: یا punix:)، هر دو فیلد n_connections و is_connected نیز ممکن است به‌روزرسانی شوند در حالی که باقی جفت‌های کلید-مقدار حذف می‌گردند.
از سوی دیگر، هنگامی که target یک اتصال خروجی را تعیین می‌کند، تمام جفت‌های کلید-مقدار ممکن است به‌روزرسانی شوند، به جز دو جفت کلید-مقدار یادشده در بالا مربوط به اهداف اتصال ورودی.
- is_connected: بولی
- مقدار true در صورتی که در حال حاضر به این کلاینت متصل باشد، و false در غیر این صورت.
- status : last_error: رشته اختیاری
- شرح قابل فهم برای انسان از آخرین خطای رخ‌داده روی اتصال به مدیر؛ یعنی strerror(errno). این کلید تنها در صورت وقوع خطا وجود خواهد داشت.
- status : state: رشته اختیاری، یکی از ACTIVE، BACKOFF، CONNECTING، IDLE یا VOID
- وضعیت اتصال به مدیر:
- VOID
- اتصال غیرفعال است.
- BACKOFF
- تلاش برای اتصال مجدد با دوره‌های زمانی افزایشی.
- CONNECTING
- در حال تلاش برای برقراری اتصال.
- ACTIVE
- متصل است و میزبان راه دور پاسخگو می‌باشد.
- IDLE
- اتصال بیکار است؛ در انتظار پاسخ به پیام زنده‌داری (keep-alive).
- این مقادیر ممکن است در آینده تغییر کنند و صرفاً برای آگاهی انسان ارائه شده‌اند.
- status : sec_since_connect: رشته اختیاری، شامل عدد صحیح، حداقل ۰
- مدت‌زمان سپری‌شده از آخرین اتصال موفق این کلاینت به پایگاه‌داده (بر حسب ثانیه). اگر کلاینت هرگز متصل نشده باشد، این مقدار خالی است.
- status : sec_since_disconnect: رشته اختیاری، شامل عدد صحیح، حداقل ۰
- مدت‌زمان سپری‌شده از آخرین قطع اتصال این کلاینت از پایگاه‌داده (بر حسب ثانیه). اگر هرگز قطع نشده باشد، خالی است.
- status : locks_held: رشته اختیاری
- فهرستی جداشده با فاصله از نام‌های قفل‌های OVSDB که اتصال در اختیار دارد. اگر قفلی در اختیار نداشته باشد، حذف می‌شود.
- status : locks_waiting: رشته اختیاری
- فهرستی جداشده با فاصله از نام‌های قفل‌های OVSDB که اتصال در حال حاضر منتظر دریافت آن‌هاست.
- status : locks_lost: رشته اختیاری
- فهرستی جداشده با فاصله از نام‌های قفل‌های OVSDB که از این اتصال توسط کلاینت دیگری ربوده شده است.
- status : n_connections: رشته اختیاری، شامل عدد صحیح، حداقل ۲
- هنگامی که target روش اتصالی شنودکننده (مانند ptcp: یا pssl:) را مشخص می‌کند و بیش از یک اتصال فعال است، مقدار برابر با تعداد اتصالات فعال خواهد بود.
- status : bound_port: رشته اختیاری، شامل عدد صحیح
- هنگامی که target برابر ptcp: یا pssl: است، این مقدار پورت TCP شنود سرور OVSDB است (به‌ویژه وقتی پورت 0 تعیین شده باشد تا هسته پورت تصادفی برگزیند مفید است).
- other_config : dscp: رشته اختیاری، شامل عدد صحیح
- نقطه کد خدمات تمایزیافته (DSCP) با استفاده از ۶ بیت در فیلد نوع خدمات (TOS) در سرآیند IP مشخص می‌شود. DSCP سازوکاری برای طبقه‌بندی ترافیک شبکه و ارائه کیفیت خدمات (QoS) در شبکه‌های IP فراهم می‌آورد. مقدار DSCP مشخص‌شده در اینجا هنگام برقراری اتصال میان مدیر و Open vSwitch استفاده می‌شود. اگر مقداری مشخص نشود، پیش‌فرض ۴۸ است. مقادیر معتبر DSCP باید در بازه ۰ تا ۶۳ باشند.
گزینه‌های پیکربندی خارجی
- external_ids: نگاشتی از جفت‌های رشته-رشته
- جفت‌های کلید-مقدار تعریف‌شده توسط کلاینت خارجی.
| DB Schema 1.0.0 | Open vSwitch 4.0.0 |