.\" vim:ft=nroff:
.\" This Source Code Form is subject to the terms of the Mozilla Public
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
.\" file, You can obtain one at https://mozilla.org/MPL/2.0
.\"
.\" Copyright (c) 2007-2026 Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.  All rights reserved.
.\"
.Dd June 22, 2023
.Dt RABBITMQ-UPGRADE 8
.Os "RabbitMQ Server"
.Sh "نام (NAME)"
rabbitmq-upgrade \- ابزارهای ارتقای نصب RabbitMQ
.\" ------------------------------------------------------------------
.Sh "خلاصه دستور (SYNOPSIS)"
.\" ------------------------------------------------------------------
.Nm rabbitmq-upgrade
.Op Fl q
.Op Fl s
.Op Fl l
.Op Fl n Ar node
.Op Fl t Ar timeout
.Ar command
.Op Ar command_options
.\" ------------------------------------------------------------------
.Sh "توضیحات (DESCRIPTION)"
.\" ------------------------------------------------------------------
.Nm rabbitmq-upgrade
یک ابزار خط فرمان است که دستوراتی را برای استفاده در حین ارتقای گره‌های RabbitMQ فراهم می‌کند.
برای کسب اطلاعات بیشتر درباره ارتقای نصب RabbitMQ، به
.Lk https://www.rabbitmq.com/docs/upgrade "راهنمای ارتقای RabbitMQ"
مراجعه کنید.
.
.\" ------------------------------------------------------------------
.Sh "گزینه‌ها (OPTIONS)"
.\" ------------------------------------------------------------------
.Bl -tag -width Ds
.It Fl n Ar node
گره پیش‌فرض
.Qq Pf rabbit@ Ar target-hostname
است، که در آن
.Ar target-hostname
میزبان محلی است.
در میزبانی با نام
.Qq myserver.example.com
نام گره معمولاً
.Qq rabbit@myserver
خواهد بود (مگر اینکه
.Ev RABBITMQ_NODENAME
بازنویسی شده باشد).
خروجی
.Qq hostname -s
معمولاً پسوند صحیح برای استفاده پس از علامت
.Qq @
است.
برای جزئیات پیکربندی یک گره RabbitMQ، به
.Xr rabbitmq-server 8
مراجعه کنید.
.It Fl q , -quiet
حالت خروجی ساکت (بی‌صدا) انتخاب می‌شود.
هنگامی که حالت ساکت فعال است، پیام‌های اطلاع‌رسانی کاهش می‌یابند.
.It Fl s , -silent
حالت خروجی کاملاً خاموش انتخاب می‌شود.
هنگامی که حالت خاموش فعال است، پیام‌های اطلاع‌رسانی کاهش یافته و سرصفحه جدول‌ها نمایش داده نمی‌شوند.
.It Fl t Ar timeout , Fl -timeout Ar timeout
زمان مهلت مجاز عملیات بر حسب ثانیه.
همه دستورات از مهلت زمانی پشتیبانی نمی‌کنند.
مقدار پیش‌فرض
.Cm infinity
است.
.It Fl l , Fl -longnames
هنگامی که خوشه برای استفاده از نام‌های گره طولانی (FQDN) پیکربندی شده است، باید مشخص شود.
برای کسب اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/clustering "راهنمای خوشه‌بندی RabbitMQ"
مراجعه کنید.
.It Fl -erlang-cookie Ar cookie
راز مشترک (کوکی) مورد استفاده برای احراز هویت در گره مقصد.
ترجیحاً به جای تعیین این گزینه در خط فرمان، از یک فایل محلی یا متغیر محیطی
.Ev RABBITMQ_ERLANG_COOKIE
استفاده کنید.
برای کسب اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/cli "راهنمای ابزارهای خط فرمان RabbitMQ"
مراجعه کنید.
.El
.\" ------------------------------------------------------------------
.Sh "دستورات (COMMANDS)"
.\" ------------------------------------
.Bl -tag -width Ds
.\" ------------------------------------
.It Cm help
.Pp
راهنمای عمومی و دستورات پشتیبانی‌شده توسط
.Nm
را نمایش می‌دهد.
.\" ------------------------------------
.It Cm post_upgrade
.Pp
وظایف پس از ارتقا را اجرا می‌کند. در نسخه فعلی، تعادل مجدد صف‌های آینه‌ای و حد نصاب (quorum) را در تمام گره‌های خوشه انجام می‌دهد.
.\" ------------------------------------
.It Cm await_online_quorum_plus_one
.Pp
منتظر می‌ماند تا تمام صف‌های حد نصاب (quorum) دارای حد نصاب آنلاین فراتر از حداقل باشند.
این اطمینان حاصل می‌کند که در صورت خاموش شدن گره هدف، هیچ صفی حد نصاب خود را از دست نمی‌دهد.
.\" ------------------------------------
.It Cm drain
.Pp
گره را در حالت تعمیر و نگهداری قرار می‌دهد. چنین گره‌هایی به هیچ ترافیک کلاینتی سرویس نمی‌دهند و برای میزبانی هیچ نسخه المثنای رهبر صف در نظر گرفته نمی‌شوند.
.Pp
برای کسب اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/upgrade#maintenance-mode "راهنمای ارتقای RabbitMQ"
مراجعه کنید.
.\" ------------------------------------
.It Cm revive
.Pp
گره را از حالت تعمیر و نگهداری خارج کرده و به حالت عملیاتی عادی بازمی‌گرداند.
چنین گره‌هایی مجدداً به ترافیک کلاینت‌ها سرویس می‌دهند و برای استقرار نسخه المثنای رهبر صف در نظر گرفته می‌شوند.
.Pp
برای کسب اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/upgrade#maintenance-mode "راهنمای ارتقای RabbitMQ"
مراجعه کنید.
.El
.\" ------------------------------------------------------------------
.Sh "همچنین ببینید (SEE ALSO)"
.\" ------------------------------------------------------------------
.Xr rabbitmqctl 8 ,
.Xr rabbitmq-diagnostics 8 ,
.Xr rabbitmq-server 8 ,
.Xr rabbitmq-queues 8 ,
.Xr rabbitmq-streams 8 ,
.Xr rabbitmq-service 8 ,
.Xr rabbitmq-env.conf 5
.\" ------------------------------------------------------------------
.Sh "نویسندگان (AUTHORS)"
.\" ------------------------------------------------------------------
.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com