UCARP(8) System Manager's Manual UCARP(8) نام (NAME) ucarp - جابه‌جایی خودکار IP هنگام خرابی (Failover) خلاصه دستور (SYNOPSIS) ucarp [-i, --interface=INTERFACE] [-s, --srcip=IPADDRESS] [-v, --vhid=VHID] [-p, --pass=PASSWORD] [-o, --passfile=PASSFILE] [-P, --preempt] [-n, --neutral] [-a, --addr=IPADDR] [-h, --help] [-b, --advbase=SECS] [-k, --advskew=SKEW] [-u, --upscript=SCRIPT] [-d, --downscript=SCRIPT] [-r, --deadratio=RATIO] [-z, --shutdown] [-B, --daemonize] [-f, --facility=FACILITY] [-x, --xparam PARAM] [-S, --ignoreifstate] [-M, --nomcast] توضیحات (DESCRIPTION) برنامه ucarp به یک جفت میزبان اجازه می‌دهد تا نشانی‌های IP مشترکی را به اشتراک بگذارند تا امکان جابه‌جایی خودکار نشانی (failover) از یک ماشین به ماشین دیگر در هنگام خرابی فراهم شود. این برنامه یک پیاده‌سازی پرتابل در فضای کاربری از پروتکل امن و بدون حق‌اختراع افزونگی نشانی مشترک (CARP)، یعنی جایگزین OpenBSD برای VRRP است. گزینه‌ها (OPTIONS) برنامه ucarp از گزینه‌های خط فرمان زیر پشتیبانی می‌کند: -i INTERFACE --interface=INTERFACE رابط شبکه‌ای که برنامه باید به آن متصل (bind) شود. -s IPADDRESS --srcip=IPADDRESS نشانی مبدأ پایدار (IP واقعی) مرتبط با این رابط شبکه. -v VHID --vhid=VHID شناسه کارگزار مجازی [1-255]. -p PASSWORD --pass=PASSWORD گذرواژه مشترک (رمزگذاری می‌شود و به‌صورت متن آشکار ارسال نمی‌شود). -o PASSFILE --passfile=PASSFILE پرونده‌ای که گذرواژه مشترک از آن خوانده می‌شود. پرونده مشخص‌شده باید گذرواژه را در خط اول خود داشته باشد. -P --preempt فعال‌سازی جابه‌جایی پیش‌دستانه (preemptive failover). این گزینه باعث می‌شود یک نمونه از ucarp بلافاصله وضعیت master را بر عهده بگیرد. -n --neutral هنگام شروع به کار زمانی که وضعیت اولیه backup است، اسکریپت downscript اجرا نشود. -a IPADDRESS --addr=IPADDRESS نشانی IP مربوط به کارگزار مجازی. -h --help نمایش خلاصه کوتاهی از گزینه‌های خط فرمان. -b SECONDS --advbase=SECONDS بازه زمانی بر حسب ثانیه برای ارسال اعلان‌ها (پیش‌فرض: ۱ ثانیه). -k SKEW --advskew=SKEW اریبی اعلان (advskew) بین [1-255] (پیش‌فرض: ۰). -u COMMAND --upscript=COMMAND دستوری را مشخص می‌کند که پس از اینکه ucarp با موفقیت به master تبدیل شد اجرا شود؛ نام رابط به عنوان آرگومان ارسال می‌شود. معمولاً اسکریپتی است که برای بالا آوردن نشانی مجازی، ثبت نتیجه در لاگ، افزودن مسیرها، پاک کردن ورودی‌های حافظه نهان ARP و غیره استفاده می‌شود. -d COMMAND --downscript=COMMAND دستوری را مشخص می‌کند که پس از گذار ucarp به وضعیت backup اجرا شود؛ نام رابط به عنوان آرگومان ارسال می‌شود. این دستور معمولاً اسکریپتی است که برای پایین آوردن رابط مجازی، ثبت اقدام در لاگ، حذف مسیرها و غیره به کار می‌رود. -r RATIO --deadratio=RATIO نسبتی که توسط گره backup استفاده می‌شود تا مشخص کند چه مدت باید منتظر یک master پاسخ‌نداده بماند قبل از اینکه آن را از دست رفته در نظر بگیرد. -z --shutdown استفاده از این گزینه باعث می‌شود دستوری که با آرگومان -d مشخص شده است، هنگام خاموش شدن ucarp فراخوانی شود. -B --daemonize باعث می‌شود ucarp از ترمینال جدا شده و در پس‌زمینه به عنوان یک دیمن اجرا شود. -f --facility تنظیم بخش (facility) مربوط به syslog (پیش‌فرض: daemon). -x PARAMETER --xparam=PARAMETER مشخص کردن یک پارامتر اضافی که به اسکریپت‌های up/down ارسال شود. -S --ignoreifstate نادیده گرفتن کابل‌های شبکه جداشده. این گزینه زمانی مفید است که گره‌های ucarp با یک کابل متقاطع (crossover) متصل شده باشند. بدون این گزینه، هنگامی که گره دیگر خاموش شود، گره master به حالت backup می‌رود زیرا دیگر پیوندی (NO-CARRIER) ندارد. -M --nomcast استفاده از اعلان‌های پخشی (broadcast) به‌جای چندپخشی (multicast). مثال‌ها (EXAMPLES) یک میزبان با IP واقعی 10.1.1.10 که در یک پیکربندی پیش‌دستانه به عنوان master با IP مجازی 10.1.1.252 پیکربندی شده است: ucarp -i eth0 -s 10.1.1.10 -v 10 -p secret -a 10.1.1.252 \ --upscript=/usr/local/sbin/vip-up.sh --downscript=/usr/local/sbin/vip-down.sh -P گره پشتیبان (backup) ممکن است به شکلی شبیه به این پیکربندی شود: ucarp -i eth0 -s 10.1.1.11 -v 10 -p secret -a 10.1.1.252 \ --upscript=/usr/local/sbin/vip-up.sh --downscript=/usr/local/sbin/vip-down.sh ماشینی با IP واقعی 192.168.1.19 که master ترجیح‌داده‌شده برای یک IP مجازی 10.1.12.7 است؛ اعلان‌های برودکست هر ۵ ثانیه یک‌بار ارسال می‌شوند: ucarp -b 5 -s 192.168.1.19 -v 27 -p badpass -a 10.1.12.7 \ -u /usr/local/sbin/vip-up.sh -d /usr/local/sbin/vip-down.sh -z گره آماده‌باش فعال (hot standby) با IP برابر 192.168.1.20 از دستور زیر استفاده می‌کند (توجه داشته باشید که advskew برابر با ۵۰ آن را در موقعیت با اولویت کمتر قرار داده و باعث می‌شود ماشین اول اولویت داشته باشد): ucarp -b 5 -k 50 -s 192.168.1.20 -v 27 -p badpass -a 10.1.12.7 \ -u /usr/local/sbin/vip-up.sh -d /usr/local/sbin/vip-down.sh -z سیگنال‌ها (SIGNALS) ارسال سیگنال SIGUSR1 به فرآیند ucarp باعث می‌شود یک خط وضعیت در syslog ثبت کند، مانند: «Sep 13 12:59:56 localhost ucarp[2654]: [INFO] MASTER on eth0 id 1» یا «Sep 13 13:00:25 localhost ucarp[2644]: [INFO] BACKUP on eth0 id 1» ارسال سیگنال SIGUSR2 به فرآیند ucarp باعث می‌شود خود را از وضعیت master به backup تنزل دهد، ۳ ثانیه مکث کند و سپس مانند معمول به شنود سایر masterها ادامه دهد و در صورت نیاز خود را ارتقا دهد. این امر می‌تواند زمانی مفید باشد که بخواهید گره دیگری نقش master را بر عهده بگیرد. نویسنده (AUTHOR) نرم‌افزار ucarp توسط Frank Denis به نشانی نوشته شده است. این صفحه راهنما توسط Eric Evans برای Debian نوشته شده و توسط Sébastien Luttringer برای Archlinux تطبیق داده شده است. اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو، نگارش ۲ یا هر نگارش بالاتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود. در سیستم‌های Arch Linux، متن کامل مجوز عمومی همگانی گنو را می‌توان در /usr/share/licenses/common/GPL یافت. UCARP(8)