نام (NAME)

mariadbd-multi - مدیریت چندین سرور ماریا‌دی‌بی (MariaDB)

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

mariadbd-multi [options] {start|stop|report} [GNR[,GNR] ...]

توضیحات (DESCRIPTION)

برنامهٔ mariadbd-multi برای مدیریت چندین فرایند mariadbd طراحی شده است که به اتصالات روی فایل‌های سوکت یونیکس و درگاه‌های TCP/IP مختلف گوش می‌دهند. این برنامه می‌تواند سرورها را راه‌اندازی یا متوقف کند، یا وضعیت فعلی آن‌ها را گزارش دهد.

برنامهٔ mariadbd-multi به دنبال گروه‌هایی با نام [mariadbdN] در my.cnf (یا در فایل مشخص‌شده توسط گزینهٔ --config-file) می‌گردد. N می‌تواند هر عدد صحیح مثبتی باشد. از این عدد در ادامه به عنوان شماره گروه گزینه‌ها یا GNR یاد می‌شود. شماره گروه‌ها، گروه‌های گزینه‌ها را از یکدیگر متمایز می‌کنند و به عنوان آرگومان به mariadbd-multi داده می‌شوند تا مشخص شود قصد راه‌اندازی، توقف یا دریافت گزارش وضعیت کدام سرورها را دارید. گزینه‌های فهرست‌شده در این گروه‌ها همان گزینه‌هایی هستند که در گروه [mariadbd] برای راه‌اندازی mariadbd استفاده می‌کنید. با این حال، هنگام استفاده از چندین سرور، ضروری است که هر کدام از مقادیر اختصاصی خود برای گزینه‌هایی مانند فایل سوکت یونیکس و شماره درگاه TCP/IP استفاده کنند.

برای فراخوانی mariadbd-multi، از نحو زیر استفاده کنید:

shell> mariadbd-multi [options] {start|stop|report} [GNR[,GNR] ...]

دستورهای start، stop و report مشخص می‌کنند چه عملیاتی انجام شود. می‌توانید عملیات تعیین‌شده را بسته به فهرست GNR که پس از نام گزینه می‌آید، برای یک سرور یا چندین سرور اجرا کنید. اگر هیچ فهرستی ارائه نشود، mariadbd-multi عملیات را برای تمامی سرورهای موجود در فایل گزینه‌ها انجام می‌دهد.

هر مقدار GNR نشان‌دهنده یک شماره گروه گزینه یا بازه‌ای از شماره گروه‌ها است. این مقدار باید عددی باشد که در انتهای نام گروه در فایل گزینه‌ها قرار دارد. برای مثال، GNR برای گروهی به نام [mariadbd17] برابر با 17 است. برای تعیین بازه‌ای از اعداد، عدد اول و آخر را با خط تیره از هم جدا کنید. مقدار GNR به صورت 10-13 نشان‌دهنده گروه‌های [mariadbd10] تا [mariadbd13] است. چندین گروه یا بازه گروه را می‌توان در خط فرمان مشخص کرد که با کاما از هم جدا می‌شوند. در فهرست GNR نباید هیچ نویسه فاصله‌ای (فاصله یا تب) وجود داشته باشد؛ هر چیزی پس از نویسه فاصله نادیده گرفته می‌شود.

این دستور یک سرور منفرد را با استفاده از گروه گزینه‌های [mariadbd17] راه‌اندازی می‌کند:

shell> mariadbd-multi start 17

این دستور چندین سرور را با استفاده از گروه‌های گزینه‌های [mariadbd8] و [mariadbd10] تا [mariadbd13] متوقف می‌کند:

shell> mariadbd-multi stop 8,10-13

برای مشاهده نمونه‌ای از نحوه تنظیم فایل گزینه‌ها، از این دستور استفاده کنید:

shell> mariadbd-multi --example

برنامهٔ mariadbd-multi فایل‌های گزینه‌ها را به شرح زیر جستجو می‌کند:

در فایل‌های گزینه‌های خوانده‌شده، گروه‌های گزینه‌های [mariadbd-multi] و [mariadbdN] جستجو می‌شوند. گروه [mariadbd-multi] می‌تواند برای گزینه‌های مربوط به خود mariadbd-multi استفاده شود. گروه‌های [mariadbdN] می‌توانند برای گزینه‌های ارسال‌شده به نمونه‌های خاص mariadbd به کار روند.

گروه‌های [mariadbd] یا [mariadbd_safe] می‌توانند برای گزینه‌های مشترکی استفاده شوند که توسط تمام نمونه‌های mariadbd یا mariadbd_safe خوانده می‌شوند. می‌توانید گزینهٔ --defaults-file=file_name را برای استفاده از فایل پیکربندی متفاوت برای آن نمونه مشخص کنید که در این صورت گروه‌های [mariadbd] یا [mariadbd_safe] از همان فایل برای آن نمونه استفاده خواهند شد.

برنامهٔ mariadbd-multi از گزینه‌های زیر پشتیبانی می‌کند.

[mariadbd38]
mariadbd = mariadbd-debug
ledir  = /opt/local/mysql/libexec

چند نکته دربارهٔ mariadbd-multi:

shell> mariadb -u root -S /tmp/mariadb.sock -p
Enter password:
mariadb> GRANT SHUTDOWN ON *.*
    -> TO 'multi_admin'@'localhost' IDENTIFIED BY 'multipass';

----------------------------------------------------------------
MY_PWD=`pwd`
# Check if we are starting this relative (for the binary release)
if test -d $MY_PWD/data/mariadb -a \
   -f ./share/mariadb/english/errmsg.sys -a \
   -x ./bin/mariadbd
----------------------------------------------------------------

مثال زیر نشان می‌دهد که چگونه می‌توانید یک فایل گزینه‌ها را برای استفاده با mariadbd-multi تنظیم کنید. ترتیبی که برنامه‌های mariadbd راه‌اندازی یا متوقف می‌شوند به ترتیبی بستگی دارد که در فایل گزینه‌ها ظاهر می‌شوند. شماره گروه‌ها نیازی نیست که یک دنبالهٔ بدون وقفه تشکیل دهند. گروه‌های [mariadbdN] اول و پنجم عمداً در مثال حذف شده‌اند تا نشان داده شود که می‌توان “شکاف‌هایی” در فایل گزینه‌ها داشت. این به شما انعطاف‌پذیری بیشتری می‌دهد.

# This file should probably be in your home dir (~/.my.cnf)
# or /etc/my.cnf
# Version 2.1 by Jani Tolonen
[mariadbd-multi]
mariadbd     = /usr/local/bin/mariadbd-safe
mariadb-admin = /usr/local/bin/mariadb-admin
user       = multi_admin
password   = multipass
[mariadbd2]
socket     = /tmp/mariadb.sock2
port       = 3307
pid-file   = /usr/local/mysql/var2/hostname.pid2
datadir    = /usr/local/mysql/var2
language   = /usr/local/share/mariadb/english
user       = john
[mariadbd3]
socket     = /tmp/mysql.sock3
port       = 3308
pid-file   = /usr/local/mysql/var3/hostname.pid3
datadir    = /usr/local/mysql/var3
language   = /usr/local/share/mariadb/swedish
user       = monty
[mariadbd4]
socket     = /tmp/mysql.sock4
port       = 3309
pid-file   = /usr/local/mysql/var4/hostname.pid4
datadir    = /usr/local/mysql/var4
language   = /usr/local/share/mariadb/estonia
user       = tonu
[mariadbd6]
socket     = /tmp/mysql.sock6
port       = 3311
pid-file   = /usr/local/mysql/var6/hostname.pid6
datadir    = /usr/local/mysql/var6
language   = /usr/local/share/mariadb/japanese
user       = jani

حق نشر (COPYRIGHT)

Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2025 MariaDB Foundation

این مستندات نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ نگارش ۲ بازتوزیع نموده یا تغییر دهید.

این مستندات با این امید توزیع شده که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای هدفی معین. برای جزئیات بیشتر متن پروانه عمومی همگانی گنو را ببینید.

شما باید نسخه‌ای از پروانه عمومی همگانی گنو را به همراه برنامه دریافت کرده باشید؛ در غیر این صورت به نشانی زیر مراجعه نمایید: http://www.gnu.org/licenses

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

برای اطلاعات بیشتر، لطفاً به مستندات برخط ماریا‌دی‌بی مراجعه کنید: https://mariadb.com/docs

نویسنده (AUTHOR)

بنیاد ماریا‌دی‌بی (http://www.mariadb.org).