نام (NAME)

rabbitmq-service.bat — ابزاری برای مدیریت سرویس ویندوز RabbitMQ

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

rabbitmq-service.bat [command]

توضیحات (DESCRIPTION)

RabbitMQ یک کارگزار پیام‌رسانی چندپروتکلی و متن‌باز است.

اجرای rabbitmq-service.bat امکان می‌دهد که کارگزار RabbitMQ به عنوان یک سرویس در محیط‌های Windows® اجرا شود. سرویس کارگزار RabbitMQ را می‌توان با استفاده از کنترل پنل سرویس‌های Windows® راه‌اندازی و متوقف کرد.

به‌طور پیش‌فرض، سرویس در بافت احراز هویت (authentication context) حساب سیستم محلی (local system account) اجرا می‌شود. بنابراین ضروری است که کوکی‌های Erlang میان حساب سیستم محلی (که معمولاً در C:\Windows\.erlang.cookie قرار دارد) و حسابی که برای اجرای rabbitmqctl(8) استفاده خواهد شد، همگام‌سازی شوند.

دستورات (COMMANDS)

help: اطلاعات نحوه استفاده را نمایش می‌دهد.
install: سرویس را نصب می‌کند. سرویس راه‌اندازی نخواهد شد. فراخوانی‌های بعدی، در صورت تغییر متغیرهای محیطی مربوطه، پارامترهای سرویس را به‌روزرسانی خواهند کرد.
remove: سرویس را حذف می‌کند. اگر سرویس در حال اجرا باشد، قبل از حذف به‌طور خودکار متوقف خواهد شد. در نتیجه این عمل هیچ فایلی حذف نخواهد شد و rabbitmq-server(8) همچنان قابل استفاده باقی خواهد ماند.
start: سرویس را راه‌اندازی می‌کند. سرویس باید از قبل به‌درستی نصب شده باشد.
stop: سرویس را متوقف می‌کند. برای اینکه این دستور اثری داشته باشد، سرویس باید در حال اجرا باشد.
disable: سرویس را غیرفعال می‌کند. این معادل با تنظیم نوع راه‌اندازی (startup type) بر روی Disabled با استفاده از کنترل پنل سرویس‌ها است.
enable: سرویس را فعال می‌کند. این معادل با تنظیم نوع راه‌اندازی بر روی Automatic با استفاده از کنترل پنل سرویس‌ها است.

محیط (ENVIRONMENT)

RABBITMQ_SERVICENAME: مقدار پیش‌فرض: RabbitMQ.
RABBITMQ_BASE: نکته: فقط در ویندوز. مقدار پیش‌فرض آن دایرکتوری داده‌های برنامه کاربر جاری است. این مسیر مکان دایرکتوری‌های پایگاه‌داده و لاگ است.
RABBITMQ_NODENAME: مقدار پیش‌فرض: "rabbit@". به همراه نام میزبان محاسبه‌شده. می‌تواند برای اجرای چندین گره بر روی یک میزبان استفاده شود. هر گره در یک کلاستر باید دارای یک RABBITMQ_NODENAME یکتا باشد. برای کسب اطلاعات بیشتر، راهنمای کلاسترینگ RabbitMQ را ببینید.
RABBITMQ_NODE_IP_ADDRESS: به‌طور پیش‌فرض، RabbitMQ به تمام رابط‌های شبکه IPv6 و IPv4 در دسترس متصل (bind) می‌شود. این متغیر گره را به یک رابط شبکه یا خانواده آدرس محدود می‌کند. برای کسب اطلاعات بیشتر، راهنمای شبکه RabbitMQ را ببینید.
RABBITMQ_NODE_PORT: پورت AMQP 0-9-1 و AMQP 1.0. مقدار پیش‌فرض: 5672. برای کسب اطلاعات بیشتر، راهنمای شبکه RabbitMQ را ببینید.
ERLANG_SERVICE_MANAGER_PATH: مقدار پیش‌فرض: C:\Program Files\erl{version}\erts-{version}\bin (یا C:\Program Files (x86)\erl{version}\erts-{version}\bin برای محیط‌های ۶۴ بیتی). این مسیر محل نصب مدیر سرویس Erlang است.
RABBITMQ_CONSOLE_LOG: این متغیر را بر روی new یا reuse تنظیم کنید تا خروجی کنسول سرور به فایلی با نام SERVICENAME.debug در دایرکتوری داده‌های برنامه کاربری که سرویس را نصب کرده است، هدایت شود. در ویندوز Vista این مسیر برابر با C:\Users\AppData\username\SERVICENAME خواهد بود. در نسخه‌های قبلی ویندوز این مسیر برابر با C:\Documents and Settings\username\Application Data\SERVICENAME خواهد بود. اگر RABBITMQ_CONSOLE_LOG بر روی new تنظیم شده باشد، هر بار با شروع سرویس یک فایل جدید ایجاد می‌شود. اگر RABBITMQ_CONSOLE_LOG بر روی reuse تنظیم شده باشد، هر بار با شروع سرویس فایل بازنویسی می‌شود. رفتار پیش‌فرض هنگامی که RABBITMQ_CONSOLE_LOG تنظیم نشده باشد یا بر روی مقداری غیر از new یا reuse تنظیم شده باشد، دور ریختن خروجی سرور است.

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

rabbitmqctl(8), rabbitmq-diagnostics(8), rabbitmq-plugins(8), rabbitmq-server(8), rabbitmq-queues(8), rabbitmq-streams(8), rabbitmq-upgrade(8), rabbitmq-env.conf(5)

نویسندگان (AUTHORS)

The RabbitMQ Team <contact-tanzu-data.pdl@broadcom.com>