نام (NAME)

keepalived - دیمون مسیریابی بار و پایش در دسترس بودن سیستم (VRRP)

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

keepalived [-f|--use-file=FILE] [-P|--vrrp] [-C|--check] [-B|--no_bfd] [--all] [-l|--log-console] [-D|--log-detail] [-S|--log-facility={0-7|local{0-7}|user|daemon}] [-g|--log-file=FILE] [--flush-log-file] [-G|--no-syslog] [-X|--release-vips] [-V|--dont-release-vrrp] [-I|--dont-release-ipvs] [-R|--dont-respawn] [-n|--dont-fork] [-d|--dump-conf] [-p|--pid=FILE] [-r|--vrrp_pid=FILE] [-T|--genhash] [-c|--checkers_pid=FILE] [-a|--address-monitoring] [-b|--bfd_pid=FILE] [-s|--namespace=NAME] [-e|--all-config] [-i|--config-id id] [-x|--snmp] [-A|--snmp-agent-socket=FILE] [-u|--umask=NUMBER] [-m|--core-dump] [-M|--core-dump-pattern[=PATTERN]] [--signum=SIGFUNC] [-t|--config-test[=FILE]] [--perf[={all|run|end}]] [--debug[=debug-options]] [--no-mem-check] [--ignore-sigint] [-v|--version] [-h|--help]

توضیحات (DESCRIPTION)

برنامه keepalived امکانات ساده و قدرتمندی را برای متعادل‌سازی بار و دسترسی‌پذیری بالا فراهم می‌کند. چارچوب متعادل‌سازی بار بر پایه ماژول هسته شناخته‌شده و پرکاربرد Linux Virtual Server (IPVS) استوار است که متعادل‌سازی بار لایه ۴ را ارائه می‌دهد. همچنین keepalived مجموعه‌ای از بررسی‌کننده‌ها (checkers) را پیاده‌سازی می‌کند تا یک استخر سرور دارای متعادل‌سازی بار را به صورت پویا و تطبیقی بر اساس وضعیت سلامت آن‌ها نگهداری و مدیریت کند. علاوه بر این، keepalived پروتکل‌های VRRPv2 و VRRPv3 را برای دستیابی به دسترسی‌پذیری بالا به همراه تغییر خودکار سرور در صورت خرابی هدایت‌کننده (director failover) پیاده‌سازی می‌کند.

گزینه‌ها (OPTIONS)

-f, --use-file=FILE

استفاده از فایل پیکربندی مشخص‌شده. فایل پیکربندی پیش‌فرض "/etc/keepalived/keepalived.conf" است.

-P, --vrrp

فقط اجرای زیرسیستم VRRP. این گزینه برای پیکربندی‌هایی مفید است که از متعادل‌کننده بار IPVS استفاده نمی‌کنند.

-C, --check

فقط اجرای زیرسیستم بررسی سلامت (healthcheck). این گزینه برای پیکربندی‌هایی مفید است که از متعادل‌کننده بار IPVS با یک هدایت‌کننده (director) منفرد و بدون سازوکار بازگشت از خرابی (failover) استفاده می‌کنند.

-B, --no_bfd

عدم اجرای زیرسیستم BFD.

--all

اجرای تمامی زیرسیستم‌ها، حتی اگر فاقد هرگونه پیکربندی باشند.

-l, --log-console

ثبت پیام‌های لاگ در کنسول محلی. رفتار پیش‌فرض، ثبت پیام‌ها در syslog است.

-D, --log-detail

ثبت پیام‌های لاگ با جزئیات کامل.

-S, --log-facility={0-7|local{0-7}|user|daemon}

تنظیم بخش لاگ syslog روی LOG_LOCAL[0-7]، LOG_USER یا LOG_DAEMON. بخش پیش‌فرض syslog مقدار LOG_DAEMON است.

-g, --log-file=FILE

نوشتن پیام‌های لاگ در FILE. عبارت‌های _vrrp، _healthcheckers و _bfd برای خروجی لاگ مربوط به هر فرآیند، قبل از آخرین '.' در نام FILE اضافه خواهند شد.

--flush-log-file

در صورت استفاده از گزینه -g، جریان فایل لاگ پس از هر نوشتن تخلیه (flush) می‌شود.

-G, --no-syslog

عدم نوشتن پیام‌های لاگ در syslog. این گزینه زمانی مفید است که نرخ تولید پیام‌های لاگ آن‌قدر بالا باشد که syslog برای آن‌ها محدودیت نرخ اعمال کند و در عوض از گزینه -g استفاده شده باشد.

-X, --release-vips

رهاسازی و حذف آدرس‌های آی‌پی مجازی (VIP) هنگام گذار ناشی از دریافت سیگنال.

-V, --dont-release-vrrp

عدم حذف آدرس‌های VIP و مسیرهای VROUTE مربوط به VRRP هنگام توقف دیمون. رفتار پیش‌فرض این است که هنگام خروج keepalived تمامی VIPها و VROUTEها حذف شوند.

-I, --dont-release-ipvs

عدم حذف توپولوژی IPVS هنگام توقف دیمون. رفتار پیش‌فرض این است که هنگام خروج keepalived تمامی مدخل‌ها از جدول سرور مجازی IPVS حذف شوند.

-R, --dont-respawn

عدم راه‌اندازی مجدد (respawn) فرآیندهای فرزند. رفتار پیش‌فرض این است که در صورت خروج هر یک از فرآیندهای VRRP یا بررسی‌کننده (checker)، آن فرآیند مجدداً راه‌اندازی شود.

-n, --dont-fork

عدم اجرای فرآیند دیمون در پس‌زمینه (عدم fork). این گزینه موجب می‌شود keepalived در پیش‌زمینه (foreground) اجرا شود.

-d, --dump-conf

تخلیه و نمایش داده‌های پیکربندی (dump).

-p, --pid=FILE

استفاده از فایل pidfile مشخص‌شده برای فرآیند والد keepalived. فایل pid پیش‌فرض برای keepalived مسیر "/run/keepalived.pid" است، مگر اینکه از فضای‌نام شبکه استفاده شده باشد. برای جزئیات بیشتر بخش فضاهای نام (NAMESPACES) در ادامه را ببینید.

-r, --vrrp_pid=FILE

استفاده از فایل pidfile مشخص‌شده برای فرآیند فرزند VRRP. فایل pid پیش‌فرض برای فرآیند فرزند VRRP مسیر "/run/keepalived_vrrp.pid" است، مگر اینکه از فضای‌نام شبکه استفاده شده باشد.

-T, --genhash

ورود به حالت ابزار genhash. نسخه‌های پیشین keepalived همراه با یک ابزار اختصاصی به نام genhash عرضه می‌شدند. ابزار genhash اکنون بخشی از کد اصلی برنامه است. ما سازگاری با گزینه‌های خط فرمان ابزار قبلی genhash را حفظ کرده‌ایم. برای اطلاعات بیشتر لطفاً به صفحه راهنمای genhash(1) مراجعه کنید.

-c, --checkers_pid=FILE

استفاده از فایل pidfile مشخص‌شده برای فرآیند فرزند بررسی‌کننده‌ها (checkers). فایل pid پیش‌فرض برای فرآیند فرزند بررسی‌کننده مسیر "/run/keepalived_checkers.pid" است، مگر اینکه از فضای‌نام شبکه استفاده شده باشد.

-a, --address-monitoring

ثبت گزارش تمامی افزودن‌ها و حذف‌های آدرس که از سوی netlink گزارش می‌شوند.

-b, --bfd_pid=FILE

استفاده از فایل pidfile مشخص‌شده برای فرآیند فرزند BFD. فایل pid پیش‌فرض برای فرآیند فرزند BFD مسیر "/run/keepalived_bfd.pid" است، مگر اینکه از فضای‌نام شبکه استفاده شده باشد.

-s, --namespace=NAME

اجرای keepalived در فضای‌نام شبکه با نام NAME. برای جزئیات بیشتر بخش فضاهای نام (NAMESPACES) در ادامه را ببینید.

-e, --all-config

عدم بارگذاری در صورتی که هر یک از فایل‌های پیکربندی ناموجود باشد یا امکان خواندن آن وجود نداشته باشد.

-i, --config-id ID

استفاده از شناسه پیکربندی ID برای پیکربندی مشروط (پیش‌فرض آن نام میزبان بدون نام دامنه است).

-x, --snmp

فعال‌سازی زیرسیستم SNMP.

-A, --snmp-agent-socket=FILE

استفاده از سوکت مشخص‌شده برای اتصال به کارگزار اصلی (master agent) پروتکل SNMP.

-u, --umask=NUMBER

تعیین مقدار umask به شیوه عددی معمول؛ به صفحه راهنمای umask(2) مراجعه کنید.

-m, --core-dump

نادیده‌گرفتن محدودیت‌های سخت و نرم RLIMIT_CORE برای فعال‌سازی امکان ایجاد فایل coredump توسط keepalived در صورت بروز خطای تقسیم‌بندی حافظه (segfault) یا سایر خرابی‌ها. این گزینه زمانی بیشترین کاربرد را دارد که keepalived با دستور 'make debug' کامپایل شده باشد. فایل‌های core dump در شاخه / ایجاد خواهند شد، مگر اینکه keepalived با گزینه --dont-fork اجرا شده باشد؛ در این حالت در دایرکتوری‌ای که keepalived از آنجا اجرا شده ایجاد می‌شوند، یا در صورتی که خطا هنگام خواندن یک فایل پیکربندی رخ دهد، در دایرکتوری همان فایل پیکربندی ایجاد خواهند شد.

-M, --core-dump-pattern[=PATTERN]

گزینه --core-dump را تنظیم می‌کند و همچنین مقدار /proc/sys/kernel/core_pattern را به الگوی مشخص‌شده تغییر می‌دهد، یا در صورت عدم تعیین به 'core' تنظیم می‌کند. در صورتی که فرآیند والد دچار خاتمه غیرعادی نشود، مقدار /proc/sys/kernel/core_pattern هنگام خروج به مقدار اولیه آن بازگردانده خواهد شد.

نکته: این کار بر روی هر فرآیند دیگری که در طول اجرای keepalived خروجی core dump تولید کند نیز اثر خواهد گذاشت.

--signum=PATTERN

شماره سیگنال مورد استفاده برای STOP، RELOAD، DATA، STATS، STATS_CLEAR، JSON و TDATA را برمی‌گرداند. برای نمونه، جهت متوقف کردن اجرای keepalived دستور زیر را اجرا کنید:

kill -s $(keepalived --signum=STOP) $(cat /run/keepalived.pid)

-t, --config-test[=FILE]

برنامه keepalived فایل پیکربندی را بررسی کرده و در صورت وجود خطا در پیکربندی با وضعیت غیرصفر خارج می‌شود، در غیر این صورت با وضعیت 0 خاتمه می‌یابد (برای جزئیات به بخش وضعیت خروج (Exit status) در زیر مراجعه کنید).

به جای ثبت در syslog، پیام‌های تشخیصی در stderr نوشته می‌شوند مگر آنکه یک فایل مشخص شده باشد که در آن صورت خروجی در آن فایل ثبت می‌گردد.

--perf[={all|run|end}]

ثبت داده‌های کارایی (perf) برای فرآیند vrrp. این داده‌ها در مسیر /perf_vrrp.data نوشته خواهند شد. داده‌های ثبت‌شده برای استفاده با ابزار perf هستند.

--no-mem-check

غیرفعال‌سازی بررسی‌های حافظه ()malloc و غیره، در صورتی که در keepalived کامپایل شده باشند.

--ignore-sigint

غیرفعال‌سازی مدیریت سیگنال SIGINT (که به طور پیش‌فرض موجب توقف keepalived می‌شود). این گزینه برای اجرای keepalived درون GDB مورد نیاز است.

--debug[=debug-options]]

فعال‌سازی گزینه‌های اشکال‌زدایی در صورتی که در keepalived کامپایل شده باشند. مقدار debug-options از دنباله‌ای از رشته‌ها به صورت Ulll تشکیل می‌شود.
حرف بزرگ مشخص‌کننده گزینه اشکال‌زدایی است و حروف کوچک تعیین می‌کنند که گزینه برای کدام فرآیندها باید فعال گردد.
اگر به دنبال یک گزینه اشکال‌زدایی هیچ حرف کوچکی نیاید، آن گزینه اشکال‌زدایی برای تمامی فرآیندها فعال می‌شود.

-v, --version

نمایش نسخه برنامه و خروج.

-h, --help

نمایش این پیام راهنما و خروج.

فضاهای نام (NAMESPACES)

برنامه keepalived می‌تواند در یک فضای‌نام شبکه (network namespace) اجرا شود (برای جزئیات پیکربندی به keepalived.conf(5) مراجعه کنید). هنگامی که در یک فضای‌نام شبکه اجرا می‌شود، یک فضای‌نام سوارکردن محلی (local mount namespace) نیز ایجاد شده و مسیر /run/keepalived/keepalived_NamespaceName بر روی /run/keepalived سوار (mount) می‌شود. به طور پیش‌فرض، فایل‌های pid با همان نام‌های پیش‌فرض معمول از دید یک فرآیند در فضای‌نام سوارکردن در /run/keepalived ایجاد می‌شوند، و برای فرآیندی که در فضای‌نام سوارکردن پیش‌فرض اجرا می‌شود در مسیر /run/keepalived/keepalived_NamespaceName قابل مشاهده خواهند بود.

سیگنال‌ها (SIGNALS)

برنامه keepalived به مجموعه‌ای از سیگنال‌ها واکنش نشان می‌دهد. می‌توانید با دستور زیر یک سیگنال به فرآیند والد keepalived ارسال کنید:

kill -SIGNAL $(cat /run/keepalived.pid)

یا بهتر از آن:

kill -s $(keepalived --signum=SIGFUNC) $(cat /run/keepalived.pid)

توجه داشته باشید که اگر از گزینه اول استفاده شود، باید -SIGNAL با سیگنال واقعی که قصد ارسال آن را دارید جایگزین شود؛ برای نمونه با HUP. در این صورت دستور به شکل زیر درمی‌آید:

kill -HUP $(cat /run/keepalived.pid)

سیگنال‌های غیر از STOP، RELOAD، DATA و STATS ممکن است بسته به هسته سیستم‌عامل و همچنین قابلیت‌های موجود در آن نسخه از keepalived بر پایه گزینه‌های ساخت (build options) تغییر کنند.

HUP یا SIGFUNC=RELOAD

این سیگنال باعث می‌شود keepalived تمامی رابط‌ها را ببندد، پیکربندی خود را مجدداً بارگذاری کرده و با پیکربندی جدید شروع به کار کند.

نکته: اگر یک virtual_ipaddress، virtual_route یا virtual_rule از یک نمونه VRRP به نمونه دیگری منتقل می‌شود، دو بار بارگذاری مجدد لازم خواهد بود؛ اولی برای حذف virtual ipaddress/route/rule و بارگذاری مجدد دوم برای افزودن آن به نمونه VRRP جدیدی که قرار است روی آن پیکربندی شود. در صورت عدم انجام این کار، اگر هر دو نمونه قبلی و جدید در وضعیت master باشند ممکن است ipaddress/route/rule بر روی نمونه جدید پیکربندی نشود. با این حال، معمولاً با یک بار بارگذاری مجدد کار خواهد کرد اگر هر یک از نمونه‌های VRRP در وضعیت MASTER نباشند یا نمونه VRRP که ipaddress/route/rule به آن افزوده می‌شود در فایل پیکربندی اصلی پس از نمونه‌ای باشد که از آن حذف می‌گردد.

نکته ۲: اگر یک پیکربندی با SNMP فعال در حال اجرا باشد و سپس بارگذاری مجدد با پیکربندی‌ای انجام گیرد که SNMP در آن فعال نیست، فعال‌سازی مجدد بعدی SNMP امکان‌پذیر نخواهد بود. دلیل این موضوع در حال حاضر ناشناخته است.

TERM، INT یا SIGFUNC=STOP

برنامه keepalived خاموش و متوقف می‌شود.

USR1 یا SIGFUNC=DATA

نوشتن داده‌های پیکربندی در /tmp/keepalived.data یا فایلی که با state_dump_file پیکربندی شده است.

USR2 یا SIGFUNC=STATS

نوشتن اطلاعات آماری در /tmp/keepalived.stats یا فایلی که با stats_dump_file پیکربندی شده است.

SIGFUNC=STATS_CLEAR

نوشتن اطلاعات آماری در /tmp/keepalived.stats یا فایلی که با stats_dump_file پیکربندی شده است و پاک کردن شمارنده‌های آماری.

SIGFUNC=JSON

نوشتن داده‌های پیکربندی در قالب JSON در /tmp/keepalived.json یا فایلی که با json_dump_file پیکربندی شده است.

SIGFUNC=TDATA

این مورد باعث می‌شود keepalived وضعیت جاری ریسمان‌های داخلی خود را در لاگ ثبت کند.

استفاده از KEEPALIVED با FIREWALLD (USING KEEPALIVED WITH FIREWALLD)

اگر یک فایروال اجرا می‌کنید (صفحه راهنمای firewalld(8) را ببینید) باید ترافیک پروتکل VRRP را از طریق فایروال مجاز کنید. برای نمونه، اگر این نمونه از keepalived(8) دارای یک گره همتا (peer node) با آدرس IPv4 برابر با 192.168.0.1 باشد:

# firewall-cmd \
    --add-rich-rule="rule family='ipv4' \
                     source address='192.168.0.1' \
                     protocol value='vrrp' accept" --permanent
# firewall-cmd --reload

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

keepalived.conf(5), ipvsadm(8)

نویسنده (AUTHOR)

این صفحه راهنما توسط Ryan O'Hara <rohara@redhat.com> نوشته شده است.