" p
." -*- nroff -*-
.TH "ovsdb.local-config" 5 " DB Schema 1.0.0" "Open vSwitch 4.0.0" "راهنمای Open vSwitch"
.fp 5 L CR              \" Make fixed-width font available as \fL.
.de TQ
.  br
.  ns
.  TP "\"
..
.de ST
.  PP
.  RS -0.15in
.  I "\"
.  RE
..
.SH "نام (NAME)"
ovsdb.local-config \- طرح‌واره پایگاه‌داده پیکربندی محلی ovsdb-server
.PP
.PP
این پایگاه‌داده برای پیکربندی محلی یک ovsdb-server استفاده می‌شود. این پایگاه‌داده به‌گونه‌ای در نظر گرفته شده که حتی میان چندین سرور خوشه‌ای پایگاه‌داده نیز منحصر‌به‌فرد باشد، تا پیکربندی مختص به آن سرور بتواند به‌طور جداگانه تنظیم شود (برای نمونه اطلاعات اتصال).
.SH "خلاصه جدول‌ها (TABLE SUMMARY)"
.PP
فهرست زیر هدف هر یک از جدول‌های پایگاه‌داده \fBLocal_Config\fR را خلاصه می‌کند. هر جدول در صفحات بعدی با جزئیات بیشتر شرح داده شده است.
.IP "جدول" 1in
هدف
.TQ 1in
\fBConfig\fR
پیکربندی ovsdb-server
.TQ 1in
\fBConnection\fR
اتصالات کلاینت OVSDB.
.bp
.SH "جدول Config (Config TABLE)"
.PP
جدول ریشه پیکربندی محلی برای یک ovsdb-server. این جدول باید دقیقاً یک ردیف داشته باشد.
.SS "چکیده:"
.TQ .25in
\fIگزینه‌های اتصال:\fR
.RS .25in
.TQ 2.75in
\fBconnections\fR
مجموعه‌ای از \fBConnection\fRها
.RE
.SS "جزئیات:"
.ST "گزینه‌های اتصال:"
.PP
.IP "\fBconnections\fR: مجموعه‌ای از \fBConnection\fRها"
کلاینت‌های پایگاه‌داده‌ای که سرور پایگاه‌داده Open vSwitch باید به آن‌ها متصل شود یا روی آن‌ها شنود کند، همراه با گزینه‌هایی برای نحوه پیکربندی این اتصالات. برای اطلاعات بیشتر به جدول \fBConnection\fR مراجعه فرمایید.
.bp
.SH "جدول Connection (Connection TABLE)"
.PP
پیکربندی برای یک اتصال پایگاه‌داده به کلاینت پایگاه‌داده Open vSwitch (OVSDB).
.PP
این جدول اساساً سرور پایگاه‌داده Open vSwitch یعنی (\fBovsdb\-server\fR) را پیکربندی می‌کند.
.PP
سرور پایگاه‌داده Open vSwitch می‌تواند اتصالات فعال به کلاینت‌های راه دور را برقرار و نگهداری کند. همچنین می‌تواند برای اتصالات پایگاه‌داده به شنود بپردازد.
.SS "چکیده:"
.TQ .25in
\fIویژگی‌های اصلی:\fR
.RS .25in
.TQ 2.75in
\fBtarget\fR
رشته (باید درون جدول یکتا باشد)
.TQ 2.75in
\fBread_only\fR
بولی (boolean)
.TQ 2.75in
\fBrole\fR
رشته
.RE
.TQ .25in
\fIتشخیص و مدیریت خرابی کلاینت:\fR
.RS .25in
.TQ 2.75in
\fBmax_backoff\fR
عدد صحیح اختیاری، حداقل ۱٬۰۰۰
.TQ 2.75in
\fBinactivity_probe\fR
عدد صحیح اختیاری
.RE
.TQ .25in
\fIوضعیت:\fR
.RS .25in
.TQ 2.75in
\fBis_connected\fR
بولی
.TQ 2.75in
\fBstatus : last_error\fR
رشته اختیاری
.TQ 2.75in
\fBstatus : state\fR
رشته اختیاری، یکی از \fBACTIVE\fR، \fBBACKOFF\fR، \fBCONNECTING\fR، \fBIDLE\fR یا \fBVOID\fR
.TQ 2.75in
\fBstatus : sec_since_connect\fR
رشته اختیاری، شامل عدد صحیح، حداقل ۰
.TQ 2.75in
\fBstatus : sec_since_disconnect\fR
رشته اختیاری، شامل عدد صحیح، حداقل ۰
.TQ 2.75in
\fBstatus : locks_held\fR
رشته اختیاری
.TQ 2.75in
\fBstatus : locks_waiting\fR
رشته اختیاری
.TQ 2.75in
\fBstatus : locks_lost\fR
رشته اختیاری
.TQ 2.75in
\fBstatus : n_connections\fR
رشته اختیاری، شامل عدد صحیح، حداقل ۲
.TQ 2.75in
\fBstatus : bound_port\fR
رشته اختیاری، شامل عدد صحیح
.RE
.TQ .25in
\fIپارامترهای اتصال:\fR
.RS .25in
.TQ 2.75in
\fBother_config : dscp\fR
رشته اختیاری، شامل عدد صحیح
.RE
.TQ .25in
\fIپیکربندی:\fR
.RS .25in
.TQ 2.75in
\fBexternal_ids\fR
نگاشتی از جفت‌های رشته-رشته
.RE
.SS "جزئیات:"
.ST "ویژگی‌های اصلی:"
.PP
.IP "\fBtarget\fR: رشته (باید درون جدول یکتا باشد)"
روش‌های اتصال برای کلاینت‌ها.
.IP
روش‌های اتصال زیر در حال حاضر پشتیبانی می‌شوند:
.RS
.TP
\fBssl:\fIhost\fB\fR[\fB:\fIport\fB\fR]
پورت مشخص‌شده SSL/TLS بر روی میزبان در \fIhost\fR داده‌شده، که می‌تواند یک نام DNS (در صورت ساخت با کتابخانه unbound) یا یک نشانی IP باشد. هنگام استفاده از این قالب باید یک پیکربندی معتبر SSL/TLS ارائه شود؛ این پیکربندی می‌تواند از طریق گزینه‌های خط فرمان یا جدول \fBSSL\fR مشخص گردد.
.IP
اگر \fIport\fR مشخص نشود، پیش‌فرض آن 6640 است.
.IP
پشتیبانی از SSL/TLS یک ویژگی اختیاری است که همیشه به عنوان بخشی از Open vSwitch ساخته نمی‌شود.
.TP
\fBtcp:\fIhost\fB\fR[\fB:\fIport\fB\fR]
پورت مشخص‌شده TCP بر روی میزبان در \fIhost\fR داده‌شده، که می‌تواند یک نام DNS (در صورت ساخت با کتابخانه unbound) یا یک نشانی IP باشد. اگر \fIhost\fR یک نشانی IPv6 است، آن را داخل کروشه قرار دهید؛ برای نمونه: \fBtcp:[::1]:6640\fR.
.IP
اگر \fIport\fR مشخص نشود، پیش‌فرض آن 6640 است.
.TP
\fBpssl:\fR[\fIport\fR][\fB:\fIhost\fB\fR]
شنود برای اتصالات SSL/TLS روی پورت مشخص‌شده TCP. مقدار 0 را برای \fIport\fR تعیین کنید تا هسته به‌طور خودکار یک پورت آزاد را انتخاب کند. اگر \fIhost\fR، که می‌تواند نام DNS یا نشانی IP باشد، مشخص شود، اتصالات به نشانی IP محلی تعیین‌شده یا تحلیل‌شده (IPv4 یا IPv6) محدود می‌شوند. اگر \fIhost\fR یک نشانی IPv6 است، در کروشه قرار دهید؛ مثلاً \fBpssl:6640:[::1]\fR. اگر \fIhost\fR مشخص نشود، تنها روی نشانی‌های IPv4 (و نه IPv6) شنود می‌کند. هنگام استفاده از این قالب باید پیکربندی معتبر SSL/TLS ارائه گردد.
.IP
اگر \fIport\fR مشخص نشود، پیش‌فرض آن 6640 است.
.IP
پشتیبانی از SSL/TLS یک ویژگی اختیاری است که همیشه به عنوان بخشی از Open vSwitch ساخته نمی‌شود.
.TP
\fBptcp:\fR[\fIport\fR][\fB:\fIhost\fB\fR]
شنود برای اتصالات روی پورت مشخص‌شده TCP. مقدار 0 را برای \fIport\fR مشخص کنید تا هسته پورت آزاد را به‌طور خودکار برگزیند. اگر \fIhost\fR مشخص شود، اتصالات به نشانی IP محلی محدود می‌گردند. اگر \fIhost\fR نشانی IPv6 است، در کروشه قرار دهید؛ مثلاً \fBptcp:6640:[::1]\fR. اگر \fIhost\fR تعیین نشود، تنها روی نشانی‌های IPv4 شنود خواهد شد.
.IP
اگر \fIport\fR مشخص نشود، پیش‌فرض آن 6640 است.
.RE
.IP
هنگامی که چندین کلاینت پیکربندی می‌شوند، مقادیر \fBtarget\fR باید یکتا باشند. مقادیر تکراری \fBtarget\fR نتایج نامشخصی تولید می‌کنند.
.IP "\fBread_only\fR: بولی"
مقدار \fBtrue\fR برای محدود کردن این اتصالات به تراکنش‌های فقط‌خواندنی، و \fBfalse\fR برای اجازه دادن به آن‌ها جهت تغییر پایگاه‌داده.
.IP "\fBrole\fR: رشته"
رشته‌ای حاوی نام نقش (role) برای این ورودی اتصال.
.ST "تشخیص و مدیریت خرابی کلاینت:"
.PP
.IP "\fBmax_backoff\fR: عدد صحیح اختیاری، حداقل ۱٬۰۰۰"
حداکثر تعداد میلی‌ثانیه‌ها برای انتظار میان تلاش‌های برقراری اتصال. مقدار پیش‌فرض وابسته به پیاده‌سازی است.
.IP "\fBinactivity_probe\fR: عدد صحیح اختیاری"
حداکثر زمان بیکاری بر حسب میلی‌ثانیه روی اتصال به کلاینت پیش از ارسال پیام کاوشگر عدم فعالیت (inactivity probe). اگر Open vSwitch برای تعداد ثانیه‌های مشخص‌شده با کلاینت ارتباط برقرار نکند، یک پیام کاوشگر ارسال می‌کند. اگر در همین مدت‌زمان پاسخی دریافت نشود، Open vSwitch اتصال را قطع‌شده تلقی کرده و برای اتصال مجدد تلاش می‌کند. پیش‌فرض وابسته به پیاده‌سازی است. مقدار 0 کاوشگرها را غیرفعال می‌سازد.
.ST "وضعیت:"
.PP
.PP
جفت کلید-مقدار \fBis_connected\fR همیشه به‌روزرسانی می‌شود. سایر جفت‌های کلید-مقدار در ستون‌های وضعیت ممکن است بسته به نوع \fBtarget\fR به‌روز شوند.
.PP
هنگامی که \fBtarget\fR روش اتصالی را مشخص می‌کند که به اتصالات ورودی گوش فرا می‌دهد (مانند \fBptcp:\fR یا \fBpunix:\fR)، هر دو فیلد \fBn_connections\fR و \fBis_connected\fR نیز ممکن است به‌روزرسانی شوند در حالی که باقی جفت‌های کلید-مقدار حذف می‌گردند.
.PP
از سوی دیگر، هنگامی که \fBtarget\fR یک اتصال خروجی را تعیین می‌کند، تمام جفت‌های کلید-مقدار ممکن است به‌روزرسانی شوند، به جز دو جفت کلید-مقدار یادشده در بالا مربوط به اهداف اتصال ورودی.
.IP "\fBis_connected\fR: بولی"
مقدار \fBtrue\fR در صورتی که در حال حاضر به این کلاینت متصل باشد، و \fBfalse\fR در غیر این صورت.
.IP "\fBstatus : last_error\fR: رشته اختیاری"
شرح قابل فهم برای انسان از آخرین خطای رخ‌داده روی اتصال به مدیر؛ یعنی \fBstrerror(errno)\fR. این کلید تنها در صورت وقوع خطا وجود خواهد داشت.
.IP "\fBstatus : state\fR: رشته اختیاری، یکی از \fBACTIVE\fR، \fBBACKOFF\fR، \fBCONNECTING\fR، \fBIDLE\fR یا \fBVOID\fR"
وضعیت اتصال به مدیر:
.RS
.TP
\fBVOID\fR
اتصال غیرفعال است.
.TP
\fBBACKOFF\fR
تلاش برای اتصال مجدد با دوره‌های زمانی افزایشی.
.TP
\fBCONNECTING\fR
در حال تلاش برای برقراری اتصال.
.TP
\fBACTIVE\fR
متصل است و میزبان راه دور پاسخگو می‌باشد.
.TP
\fBIDLE\fR
اتصال بیکار است؛ در انتظار پاسخ به پیام زنده‌داری (keep-alive).
.RE
.IP
این مقادیر ممکن است در آینده تغییر کنند و صرفاً برای آگاهی انسان ارائه شده‌اند.
.IP "\fBstatus : sec_since_connect\fR: رشته اختیاری، شامل عدد صحیح، حداقل ۰"
مدت‌زمان سپری‌شده از آخرین اتصال موفق این کلاینت به پایگاه‌داده (بر حسب ثانیه). اگر کلاینت هرگز متصل نشده باشد، این مقدار خالی است.
.IP "\fBstatus : sec_since_disconnect\fR: رشته اختیاری، شامل عدد صحیح، حداقل ۰"
مدت‌زمان سپری‌شده از آخرین قطع اتصال این کلاینت از پایگاه‌داده (بر حسب ثانیه). اگر هرگز قطع نشده باشد، خالی است.
.IP "\fBstatus : locks_held\fR: رشته اختیاری"
فهرستی جداشده با فاصله از نام‌های قفل‌های OVSDB که اتصال در اختیار دارد. اگر قفلی در اختیار نداشته باشد، حذف می‌شود.
.IP "\fBstatus : locks_waiting\fR: رشته اختیاری"
فهرستی جداشده با فاصله از نام‌های قفل‌های OVSDB که اتصال در حال حاضر منتظر دریافت آن‌هاست.
.IP "\fBstatus : locks_lost\fR: رشته اختیاری"
فهرستی جداشده با فاصله از نام‌های قفل‌های OVSDB که از این اتصال توسط کلاینت دیگری ربوده شده است.
.IP "\fBstatus : n_connections\fR: رشته اختیاری، شامل عدد صحیح، حداقل ۲"
هنگامی که \fBtarget\fR روش اتصالی شنودکننده (مانند \fBptcp:\fR یا \fBpssl:\fR) را مشخص می‌کند و بیش از یک اتصال فعال است، مقدار برابر با تعداد اتصالات فعال خواهد بود.
.IP "\fBstatus : bound_port\fR: رشته اختیاری، شامل عدد صحیح"
هنگامی که \fBtarget\fR برابر \fBptcp:\fR یا \fBpssl:\fR است، این مقدار پورت TCP شنود سرور OVSDB است (به‌ویژه وقتی پورت 0 تعیین شده باشد تا هسته پورت تصادفی برگزیند مفید است).
.ST "پارامترهای اتصال:"
.PP
.IP "\fBother_config : dscp\fR: رشته اختیاری، شامل عدد صحیح"
نقطه کد خدمات تمایزیافته (DSCP) با استفاده از ۶ بیت در فیلد نوع خدمات (TOS) در سرآیند IP مشخص می‌شود. DSCP سازوکاری برای طبقه‌بندی ترافیک شبکه و ارائه کیفیت خدمات (QoS) در شبکه‌های IP فراهم می‌آورد. مقدار DSCP مشخص‌شده در اینجا هنگام برقراری اتصال میان مدیر و Open vSwitch استفاده می‌شود. اگر مقداری مشخص نشود، پیش‌فرض ۴۸ است. مقادیر معتبر DSCP باید در بازه ۰ تا ۶۳ باشند.
.ST "پیکربندی:"
.PP
گزینه‌های پیکربندی خارجی
.IP "\fBexternal_ids\fR: نگاشتی از جفت‌های رشته-رشته"
جفت‌های کلید-مقدار تعریف‌شده توسط کلاینت خارجی.