نکته

در Windows Server 2008 و Windows Vista، باید mariadb-upgrade را با امتیازات مدیر سیستم (administrator) اجرا کنید. می‌توانید این کار را با اجرای Command Prompt در حالت Administrator و سپس اجرای دستور انجام دهید. عدم انجام این کار ممکن است منجر به اجرای نادرست ارتقا شود.

احتیاط

شما باید همیشه پیش از انجام ارتقا، از نصب فعلی MariaDB خود نسخه پشتیبان تهیه کنید.

shell> mariadb-upgrade [options]

mariadb-check --all-databases --check-upgrade --auto-repair
mariadb < fix_priv_tables
mariadb-check --all-databases --check-upgrade --fix-db-names --fix-table-names

•از آنجا که mariadb-upgrade دستور mariadb-check را با گزینه --all-databases فراخوانی می‌کند، تمام جدول‌ها را در همه پایگاه‌های داده پردازش می‌کند که ممکن است تکمیل آن زمان زیادی ببرد. هر جدول هنگام پردازش قفل شده و در نتیجه برای نشست‌های دیگر غیرقابل‌دسترس خواهد بود. عملیات‌های بررسی و تعمیر می‌توانند زمان‌بر باشند، به‌ویژه برای جدول‌های بزرگ.

•برای جزئیات درباره اینکه گزینه --check-upgrade شامل چه بررسی‌هایی است، به توضیحات گزینه FOR UPGRADE از دستور CHECK TABLE مراجعه کنید.

•گزاره fix_priv_tables نمایانگر اسکریپتی است که به‌صورت داخلی توسط mariadb-upgrade تولید می‌شود و شامل عبارت‌های SQL برای ارتقای جدول‌ها در پایگاه داده mysql است.

•--help, -?

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

•--basedir=path

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

•--character-sets-dir=path

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

•--check-if-upgrade-is-needed

با یک کد وضعیت خارج می‌شود که نشان می‌دهد آیا ارتقا لازم است یا خیر. در صورت نیاز به ارتقا یا عدم امکان تعیین نسخهٔ فعلی 0، و در صورتی که اقدامی لازم نباشد 1 برمی‌گرداند.

•--datadir=path

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

•--debug=path, -# path

برای ساخت‌های اشکال‌زدایی (debug)، گزارش اشکال‌زدایی را خروجی می‌دهد.

•--debug-check

هنگام خروج برنامه، برخی اطلاعات اشکال‌زدایی را چاپ می‌کند.

•--debug-info, -T

هنگام خروج برنامه، اطلاعات اشکال‌زدایی و آمار مصرف حافظه و پردازنده (CPU) را چاپ می‌کند.

•--default-character-set=name

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

•--force

فایل mariadb-upgrade_info را نادیده می‌گیرد و اجرای mariadb-check را اجبار می‌کند، حتی اگر mariadb-upgrade پیش‌تر برای نسخهٔ فعلی MariaDB اجرا شده باشد.

•--host

اتصال به MariaDB در میزبان داده‌شده.

•--password[=password], -p[password]

گذرواژه‌ای که برای اتصال به کارساز استفاده می‌شود. اگر از فرم کوتاه گزینه (-p) استفاده می‌کنید، نمی‌توانید بین گزینه و گذرواژه فاصله بگذارید. اگر مقدار password را پس از گزینهٔ --password یا -p در خط فرمان وارد نکنید، mariadb-upgrade آن را درخواست می‌کند.

تعیین گذرواژه در خط فرمان باید ناامن تلقی شود. می‌توانید از یک فایل تنظیمات (option file) استفاده کنید تا از ارائهٔ گذرواژه در خط فرمان اجتناب شود.

•--port=port_num, -P port_num

شماره درگاه TCP/IP برای برقراری اتصال.

•--protocol={TCP|SOCKET|PIPE|MEMORY}

پروتکل اتصال برای اتصال به سرور. این گزینه زمانی کاربرد دارد که دیگر پارامترهای اتصال به‌طور معمول باعث استفاده از پروتکلی غیر از پروتکل مورد نظر شما شوند.

•--silent

نمایش اطلاعات کمتر.

•--socket=path, -S path

برای اتصال به localhost، فایل سوکت یونیکس مورد استفاده، یا در Windows، نام named pipe مورد استفاده.

•--ssl

فعال‌سازی SSL برای اتصال (به‌طور خودکار با دیگر پرچم‌ها فعال می‌شود). غیرفعال‌سازی با --skip-ssl.

•--ssl-ca=name

فایل CA در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-capath=name

دایرکتوری CA (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-cert=name

گواهی X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-cipher=name

سایفر SSL مورد استفاده (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-key=name

کلید X509 در قالب PEM (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-crl=name

فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-crlpath=name

مسیر فهرست ابطال گواهی (مستندات OpenSSL را بررسی کنید، مستلزم --ssl است).

•--ssl-verify-server-cert

اعتبارسنجی “Common Name” سرور در گواهی آن در برابر hostname استفاده‌شده هنگام اتصال. این گزینه به‌طور پیش‌فرض غیرفعال است.

•--tmpdir=path, -t path

نام مسیر دایرکتوری مورد استفاده برای ایجاد فایل‌های موقت.

•--upgrade-system-tables, -s

تنها جدول‌های سیستمی موجود در پایگاه‌داده mysql ارتقا داده می‌شوند. جدول‌ها در سایر پایگاه‌های داده بررسی یا دستکاری نمی‌شوند.

•--user=user_name, -u user_name

نام کاربری MariaDB جهت استفاده در هنگام اتصال به سرور (در صورتی که از نام کاربری فعلی استفاده نشود).

•--verbose

نمایش خروجی بیشتر در مورد فرآیند. دو بار استفاده از آن، آرگومان‌های اتصال را چاپ می‌کند؛ ۳ بار استفاده، تمام دستورهای CHECK، RENAME و ALTER TABLE استفاده‌شده در فاز بررسی را چاپ می‌کند؛ ۴ بار استفاده از آن (افزوده شده در MariaDB 10.0.14) همچنین تمام دستورهای mariadb-check استفاده‌شده را می‌نویسد؛ ۵ بار استفاده از آن، تمامی دستورهای mariadb استفاده‌شده و نتایج آن‌ها را حین اجرای اسکریپت mariadb-fix-privilege-tables چاپ خواهد کرد.

•--version, -V

نمایش اطلاعات نسخه و خروج.

•--version-check, -k

اجرای این برنامه فقط در صورتی که «نسخه سرور» آن با نسخه سروری که به آن متصل می‌شود تطابق داشته باشد. نکته: «نسخه سرور» این برنامه، همان نسخه سرور MariaDB است که با آن ساخته/توزیع شده است. به صورت پیش‌فرض فعال است؛ برای غیرفعال‌سازی از --skip-version-check استفاده کنید.

•--write-binlog

باعث فعال شدن ثبت وقایع باینری (binary logging) در زمان اجرای mariadb-upgrade می‌شود.