نام (NAME)

mysqld_multi - مدیریت و اجرای چندین سرور پایگاه‌داده MariaDB روی یک سیستم

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

mysqld_multi [گزینه‌ها] {start|stop|report} [GNR[,GNR] ...]

توضیحات (DESCRIPTION)

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

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

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

shell> mysqld_multi [گزینه‌ها] {start|stop|report} [GNR[,GNR] ...]

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

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

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

shell> mysqld_multi start 17

این دستور چندین سرور را با استفاده از گروه‌های گزینه‌های [mysqld8] و [mysqld10] تا [mysqld13] متوقف می‌کند:

shell> mysqld_multi stop 8,10-13

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

shell> mysqld_multi --example

ابزار mysqld_multi به ترتیب زیر فایل‌های پیکربندی را جستجو می‌کند:

فایل‌های پیکربندی خوانده‌شده برای یافتن گروه‌های [mysqld_multi] و [mysqldN] (یا [mariadbdN]) بررسی می‌شوند. گروه [mysqld_multi] را می‌توان برای گزینه‌های مربوط به خود mysqld_multi استفاده کرد. گروه‌های [mysqldN] را می‌توان برای گزینه‌های ارسالی به نمونه‌های خاص mariadbd به کار برد.

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

گزینه‌ها (OPTIONS)

ابزار mysqld_multi از گزینه‌های زیر پشتیبانی می‌کند:

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

نکاتی پیرامون mysqld_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
----------------------------------------------------------------

مثال زیر نشان می‌دهد چگونه می‌توانید یک فایل پیکربندی برای استفاده با mysqld_multi آماده کنید. ترتیبی که برنامه‌های mariadbd راه‌اندازی یا متوقف می‌شوند بستگی به ترتیبی دارد که در فایل پیکربندی ظاهر می‌شوند. نیازی نیست شماره گروه‌ها یک دنباله پیوسته باشند. گروه‌های اول و پنجم [mysqldN] عمداً در این مثال حذف شده‌اند تا نشان داده شود که می‌توانید در فایل پیکربندی «فاصله‌ها و شکاف‌ها» داشته باشید. این به شما انعطاف‌پذیری بیشتری می‌دهد.

# This file should probably be in your home dir (~/.my.cnf)
# or /etc/my.cnf
# Version 2.1 by Jani Tolonen
[mysqld_multi]
mariadbd     = /usr/local/bin/mariadbd_safe
mariadb-admin = /usr/local/bin/mariadb-admin
user         = multi_admin
password     = multipass
[mysqld2]
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
[mysqld3]
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
[mysqld4]
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
[mysqld6]
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 General Public License) نسخه ۲ که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است بازتوزیع نموده یا تغییر دهید.

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

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

Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA

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

برای اطلاعات بیشتر، لطفاً به مستندات MariaDB که به صورت آنلاین در دسترس است مراجعه کنید:

https://mariadb.com/docs

نویسنده (AUTHOR)

بنیاد MariaDB (http://www.mariadb.org)