.\" 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-SERVICE.BAT 8
.Os "RabbitMQ Server"
.Sh "نام (NAME)"
.Nm rabbitmq-service.bat
.Nd ابزاری برای مدیریت سرویس ویندوز RabbitMQ
.\" ------------------------------------------------------------------
.Sh "خلاصه دستور (SYNOPSIS)"
.\" ------------------------------------------------------------------
.Nm
.Op Ar command
.\" ------------------------------------------------------------------
.Sh "توضیحات (DESCRIPTION)"
.\" ------------------------------------------------------------------
RabbitMQ یک کارگزار پیام‌رسانی چندپروتکلی و متن‌باز است.
.Pp
اجرای
.Nm
امکان می‌دهد که کارگزار RabbitMQ به عنوان یک سرویس در محیط‌های
Windows®
اجرا شود.
سرویس کارگزار RabbitMQ را می‌توان با استفاده از کنترل پنل سرویس‌های
Windows®
راه‌اندازی و متوقف کرد.
.Pp
به‌طور پیش‌فرض، سرویس در بافت احراز هویت (authentication context) حساب سیستم محلی (local system account) اجرا می‌شود.
بنابراین ضروری است که کوکی‌های Erlang میان حساب سیستم محلی (که معمولاً در
.Pa C:\(rsWindows\(rs.erlang.cookie
قرار دارد) و حسابی که برای اجرای
.Xr rabbitmqctl 8
استفاده خواهد شد، همگام‌سازی شوند.
.\" ------------------------------------------------------------------
.Sh "دستورات (COMMANDS)"
.\" ------------------------------------------------------------------
.Bl -tag -width Ds
.It Cm help
اطلاعات نحوه استفاده را نمایش می‌دهد.
.It Cm install
سرویس را نصب می‌کند.
سرویس راه‌اندازی نخواهد شد.
فراخوانی‌های بعدی، در صورت تغییر متغیرهای محیطی مربوطه، پارامترهای سرویس را به‌روزرسانی خواهند کرد.
.It Cm remove
سرویس را حذف می‌کند.
اگر سرویس در حال اجرا باشد، قبل از حذف به‌طور خودکار متوقف خواهد شد.
در نتیجه این عمل هیچ فایلی حذف نخواهد شد و
.Xr rabbitmq-server 8
همچنان قابل استفاده باقی خواهد ماند.
.It Cm start
سرویس را راه‌اندازی می‌کند.
سرویس باید از قبل به‌درستی نصب شده باشد.
.It Cm stop
سرویس را متوقف می‌کند.
برای اینکه این دستور اثری داشته باشد، سرویس باید در حال اجرا باشد.
.It Cm disable
سرویس را غیرفعال می‌کند.
این معادل با تنظیم نوع راه‌اندازی (startup type) بر روی
.Sy Disabled
با استفاده از کنترل پنل سرویس‌ها است.
.It Cm enable
سرویس را فعال می‌کند.
این معادل با تنظیم نوع راه‌اندازی بر روی
.Sy Automatic
با استفاده از کنترل پنل سرویس‌ها است.
.El
.\" ------------------------------------------------------------------
.Sh "محیط (ENVIRONMENT)"
.\" ------------------------------------------------------------------
.Bl -tag -width Ds
.It Ev RABBITMQ_SERVICENAME
مقدار پیش‌فرض: RabbitMQ.
.It Ev RABBITMQ_BASE
نکته: فقط در ویندوز. مقدار پیش‌فرض آن دایرکتوری داده‌های برنامه کاربر جاری است. این مسیر مکان دایرکتوری‌های پایگاه‌داده و لاگ است.
.It Ev RABBITMQ_NODENAME
مقدار پیش‌فرض:
.Qq rabbit@ .
به همراه نام میزبان محاسبه‌شده.
می‌تواند برای اجرای چندین گره بر روی یک میزبان استفاده شود.
هر گره در یک کلاستر باید دارای یک
.Ev RABBITMQ_NODENAME
یکتا باشد.
برای کسب اطلاعات بیشتر،
.Lk https://www.rabbitmq.com/docs/clustering "راهنمای کلاسترینگ RabbitMQ"
را ببینید.
.It Ev RABBITMQ_NODE_IP_ADDRESS
به‌طور پیش‌فرض، RabbitMQ به تمام رابط‌های شبکه IPv6 و IPv4 در دسترس متصل (bind) می‌شود.
این متغیر گره را به یک رابط شبکه یا خانواده آدرس محدود می‌کند.
برای کسب اطلاعات بیشتر،
.Lk https://www.rabbitmq.com/docs/networking "راهنمای شبکه RabbitMQ"
را ببینید.
.It Ev RABBITMQ_NODE_PORT
پورت AMQP 0-9-1 و AMQP 1.0. مقدار پیش‌فرض: 5672.
برای کسب اطلاعات بیشتر،
.Lk https://www.rabbitmq.com/docs/networking "راهنمای شبکه RabbitMQ"
را ببینید.
.It Ev ERLANG_SERVICE_MANAGER_PATH
مقدار پیش‌فرض:
.Pa C:\(rsProgram\ Files\(rserl{version}\(rserts-{version}\(rsbin
(یا
.Pa C:\(rsProgram\ Files\ (x86)\(rserl{version}\(rserts-{version}\(rsbin
برای محیط‌های ۶۴ بیتی).
این مسیر محل نصب مدیر سرویس Erlang است.
.It Ev RABBITMQ_CONSOLE_LOG
این متغیر را بر روی
.Sy new
یا
.Sy reuse
تنظیم کنید تا خروجی کنسول سرور به فایلی با نام
.Pa SERVICENAME.debug
در دایرکتوری داده‌های برنامه کاربری که سرویس را نصب کرده است، هدایت شود.
در ویندوز Vista این مسیر برابر با
.Pa C:\(rsUsers\(rsAppData\(rsusername\(rsSERVICENAME
خواهد بود.
در نسخه‌های قبلی ویندوز این مسیر برابر با
.Pa C:\(rsDocuments and Settings\(rsusername\(rsApplication Data\(rsSERVICENAME
خواهد بود.
اگر
.Ev RABBITMQ_CONSOLE_LOG
بر روی
.Sy new
تنظیم شده باشد، هر بار با شروع سرویس یک فایل جدید ایجاد می‌شود.
اگر
.Ev RABBITMQ_CONSOLE_LOG
بر روی
.Sy reuse
تنظیم شده باشد، هر بار با شروع سرویس فایل بازنویسی می‌شود.
رفتار پیش‌فرض هنگامی که
.Ev RABBITMQ_CONSOLE_LOG
تنظیم نشده باشد یا بر روی مقداری غیر از
.Sy new
یا
.Sy reuse
تنظیم شده باشد، دور ریختن خروجی سرور است.
.El
.\" ------------------------------------------------------------------
.Sh "همچنین ببینید (SEE ALSO)"
.\" ------------------------------------------------------------------
.Xr rabbitmqctl 8 ,
.Xr rabbitmq-diagnostics 8 ,
.Xr rabbitmq-plugins 8 ,
.Xr rabbitmq-server 8 ,
.Xr rabbitmq-queues 8 ,
.Xr rabbitmq-streams 8 ,
.Xr rabbitmq-upgrade 8 ,
.Xr rabbitmq-env.conf 5
.\" ------------------------------------------------------------------
.Sh "نویسندگان (AUTHORS)"
.\" ------------------------------------------------------------------
.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com