" 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-PLUGINS 8
.Os "RabbitMQ Server"
.Sh "نام (NAME)"
.Nm rabbitmq-plugins
.Nd ابزار خط فرمان برای مدیریت پلاگین‌های RabbitMQ
." ------------------------------------------------------------------
.Sh "خلاصه دستور (SYNOPSIS)"
." ------------------------------------------------------------------
.Nm
.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 است.
برای مروری بر پلاگین‌های RabbitMQ و نحوه استفاده از آن‌ها به
.Lk https://www.rabbitmq.com/docs/plugins "راهنمای پلاگین‌های RabbitMQ"
مراجعه فرمایید.

.Nm
به مدیر سیستم امکان می‌دهد پلاگین‌ها را فعال، غیرفعال و بازبینی کند.
این ابزار باید توسط کاربری با دسترسی نوشتن در دایرکتوری پیکربندی RabbitMQ اجرا شود.
.Pp
پلاگین‌ها می‌توانند به پلاگین‌های دیگر وابسته باشند.
.Nm
وابستگی‌ها را شناسایی و حل کرده و تمام وابستگی‌ها را فعال یا غیرفعال می‌سازد
تا کاربر نیازی به مدیریت صریح آن‌ها نداشته باشد.
پلاگین‌های ذکرشده در خط فرمان
.Nm
به عنوان صریحاً فعال‌شده علامت‌گذاری می‌شوند؛ پلاگین‌های وابسته به عنوان
ضمنی فعال‌شده مشخص می‌گردند.
پلاگین‌های ضمنی فعال‌شده هنگامی که دیگر نیازی به آن‌ها نباشد، مجدداً به‌طور
خودکار غیرفعال می‌شوند.
.Pp
دستورات
.Cm enable ,
.Cm disable
و
.Cm set
فایل پلاگین‌ها را به‌روزرسانی کرده و سپس تلاش می‌کنند به کارگزار (broker) متصل شوند
تا اطمینان حاصل نمایند که تمام پلاگین‌های فعال در حال اجرا هستند.
به‌طور پیش‌فرض، اگر امکان اتصال و احراز هویت با گره مقصد وجود نداشته باشد
(برای نمونه اگر گره متوقف باشد)، عملیات شکست خواهد خورد.
اگر
.Nm
روی همان میزبانی استفاده شود که گره مقصد روی آن قرار دارد، می‌توان گزینه
.Fl -offline
را مشخص کرد تا
.Nm
وضعیت پلاگین‌ها را مستقیماً (بدون تماس با گره) حل و به‌روزرسانی کند.
چنین تغییراتی تنها در راه‌اندازی بعدی گره اعمال خواهند شد.
برای اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/plugins "راهنمای پلاگین‌های RabbitMQ"
مراجعه نمایید.
." ------------------------------------------------------------------
.Sh "گزینه‌ها (OPTIONS)"
." ------------------------------------------------------------------
.Bl -tag -width Ds
.It Fl n Ar node
گره پیش‌فرض
.Qq Ar rabbit@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
انتخاب حالت خروجی آرام (quiet).
در این حالت پیام‌های اطلاعاتی کاهش می‌یابند.
.It Fl s , -silent
انتخاب حالت خروجی بی‌صدا (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
رمز مشترک (Shared secret) مورد استفاده برای احراز هویت در گره مقصد.
ترجیحاً به جای تعیین این گزینه در خط فرمان، از یک فایل محلی یا متغیر محیطی
.Ev RABBITMQ_ERLANG_COOKIE
استفاده نمایید.
برای اطلاعات بیشتر به
.Lk https://www.rabbitmq.com/docs/cli "راهنمای ابزارهای CLI در RabbitMQ"
مراجعه فرمایید.
.El
." ------------------------------------------------------------------
.Sh "دستورات (COMMANDS)"
." ------------------------------------------------------------------
.Bl -tag -width Ds
." ------------------------------------
.It Cm list Oo Fl Eemv Oc Op Ar pattern
.Bl -tag -width Ds
.It Fl E
نمایش تنها پلاگین‌های صریحاً فعال‌شده.
.It Fl e
نمایش تنها پلاگین‌های صریحاً یا ضمناً فعال‌شده.
.It Fl m
نمایش تنها نام پلاگین‌ها (حالت مختصر).
.It Fl v
نمایش تمام جزئیات پلاگین‌ها (حالت باجزئیات).
.It Ar pattern
الگویی برای پالایش نام پلاگین‌ها.
.El
.Pp
فهرست کردن تمام پلاگین‌ها، نسخه‌ها، وابستگی‌ها و توضیحات آن‌ها.
هر پلاگین با دو نویسه نشانگر وضعیت درون [ ] پیشوندگذاری می‌شود.
نشانگر اول می‌تواند شامل این موارد باشد:
.Bl -tag -width <space> -compact
.It Sy <space>
نشان‌دهنده آنکه پلاگین فعال نیست
.It Sy E
نشان‌دهنده آنکه پلاگین صریحاً فعال شده است
.It Sy e
نشان‌دهنده آنکه پلاگین ضمناً فعال شده است
.It Sy \!
نشان‌دهنده آنکه پلاگین فعال است اما مفقود بوده و بنابراین قابل استفاده نیست
.El
.Pp
نشانگر دوم می‌تواند شامل این موارد باشد:
.Bl -tag -width <space> -compact
.It Sy <space>
نشان می‌دهد پلاگین در حال اجرا نیست
.It Sy *
نشان می‌دهد پلاگین در حال اجرا است
.El
.Pp
اگر الگوی اختیاری داده شود، تنها پلاگین‌هایی که نام آن‌ها با
.Ar pattern
مطابقت دارد نمایش داده می‌شوند.
.Pp
برای نمونه، این دستور تمام پلاگین‌ها را هر کدام در یک خط فهرست می‌کند:
.sp
.Dl rabbitmq-plugins list
.Pp
این دستور تمام پلاگین‌ها را فهرست می‌کند:
.sp
.Dl rabbitmq-plugins list -v
.Pp
این دستور تمام پلاگین‌هایی را که نام آن‌ها حاوی "management" است فهرست می‌نماید:
.sp
.Dl rabbitmq-plugins list -v management
.Pp
این دستور تمام پلاگین‌های فعال‌شده RabbitMQ را فهرست می‌کند:
.sp
.Dl rabbitmq-plugins list -e rabbit
." ------------------------------------
.It Cm enable Oo Fl -offline Oc Oo Fl -online Oc Ar plugin ...
.Bl -tag -width Ds
.It Fl -offline
تغییر مستقیم وضعیت پلاگین‌های فعال گره بدون برقراری تماس با گره.
.It Fl -online
تلقی عدم موفقیت در اتصال به کارگزار در حال اجرا به عنوان خطای مهلک.
.It Ar plugin
یک یا چند پلاگین برای فعال‌سازی که با فاصله جدا شده‌اند.
.El
.Pp
فعال‌سازی پلاگین‌های مشخص‌شده و تمام وابستگی‌های آن‌ها.
.Pp
برای نمونه، این دستور پلاگین‌های
.Qq shovel
و
.Qq management
و تمام وابستگی‌های آن‌ها را فعال می‌سازد:
.sp
.Dl rabbitmq\-plugins enable rabbitmq_shovel rabbitmq_management
." ------------------------------------
.It Cm disable Oo Fl -offline Oc Oo Fl -online Oc Ar plugin ...
.Bl -tag -width Ds
.It Fl -offline
تغییر مستقیم وضعیت پلاگین‌های فعال گره بدون برقراری تماس با گره.
.It Fl -online
تلقی عدم موفقیت در اتصال به کارگزار در حال اجرا به عنوان خطای مهلک.
.It Ar plugin
یک یا چند پلاگین برای غیرفعال‌سازی که با فاصله جدا شده‌اند.
.El
.Pp
غیرفعال کردن پلاگین‌های مشخص‌شده و تمام وابستگی‌های آن‌ها.
.Pp
برای نمونه، این دستور
.Qq rabbitmq_management
و تمام پلاگین‌های وابسته به آن را غیرفعال می‌کند:
.sp
.Dl rabbitmq-plugins disable rabbitmq_management
." ------------------------------------
.It Cm set Oo Fl -offline Oc Oo Fl -online Oc Op Ar plugin ...
.Bl -tag -width Ds
.It Fl -offline
تغییر مستقیم وضعیت پلاگین‌های فعال گره بدون تماس با گره.
.It Fl -online
تلقی عدم موفقیت در اتصال به کارگزار در حال اجرا به عنوان خطای مهلک.
.It Ar plugin
صفر یا چند پلاگین برای فعال‌سازی که با فاصله جدا شده‌اند.
.El
.Pp
فعال‌سازی پلاگین‌های مشخص‌شده و تمام وابستگی‌های آن‌ها.
برخلاف
.Cm enable ,
این دستور هرگونه پلاگین فعال موجود را نادیده گرفته و بازنویسی می‌کند.
دستور
.Cm set
بدون هیچ آرگومان پلاگینی، دستوری معتبر به معنای "غیرفعال‌سازی تمام پلاگین‌ها" است.
.Pp
برای نمونه، این دستور پلاگین
.Qq management
و وابستگی‌های آن را فعال کرده و مابقی را غیرفعال می‌سازد:
.sp
.Dl rabbitmq-plugins set rabbitmq_management
.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-upgrade 8 ,
.Xr rabbitmq-service 8 ,
.Xr rabbitmq-env.conf 5
." ------------------------------------------------------------------
.Sh "نویسندگان (AUTHORS)"
." ------------------------------------------------------------------
.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com