FreeBSD Manual Pages
RABBITMQ-PLUGINS(8) System Manager's Manual RABBITMQ-PLUGINS(8) NAME rabbitmq-plugins -- command line tool for managing RabbitMQ plugins SYNOPSIS rabbitmq-plugins [-q] [-s] [-l] [-n node] [-t timeout] command [command_options] DESCRIPTION rabbitmq-plugins is a command line tool for managing RabbitMQ plugins. See the RabbitMQ Plugins guide: https://www.rabbitmq.com/docs/plugins for an overview of RabbitMQ plugins and how they are used. rabbitmq-plugins allows the operator to enable, disable and inspect plugins. It must be run by a user with write permissions to the Rab- bitMQ configuration directory. Plugins can depend on other plugins. rabbitmq-plugins resolves the de- pendencies and enables or disables all dependencies so that the user doesn't have to manage them explicitly. Plugins listed on the rabbitmq-plugins command line are marked as explicitly enabled; depen- dent plugins are marked as implicitly enabled. Implicitly enabled plu- gins are automatically disabled again when they are no longer required. The enable, disable, and set commands will update the plugins file and then attempt to connect to the broker and ensure it is running all en- abled plugins. By default if it is not possible to connect to and au- thenticate with the target node (for example if it is stopped), the op- eration will fail. If rabbitmq-plugins is used on the same host as the target node, --offline can be specified to make rabbitmq-plugins re- solve and update plugin state directly (without contacting the node). Such changes will only have an effect on next node start. To learn more, see the RabbitMQ Plugins guide: https://www.rabbitmq.com/docs/plugins OPTIONS -n node Default node is "rabbit@target-hostname", where target-hostname is the local host. On a host named "myserver.example.com", the node name will usually be "rabbit@myserver" (unless RABBITMQ_NODENAME has been overridden). The output of "hostname -s" is usually the correct suffix to use after the "@" sign. See rabbitmq-server(8) for details of configuring a RabbitMQ node. -q, --quiet Quiet output mode is selected. Informational messages are re- duced when quiet mode is in effect. -s, --silent Silent output mode is selected. Informational messages are re- duced and table headers are suppressed when silent mode is in effect. -t timeout, --timeout timeout Operation timeout in seconds. Not all commands support time- outs. Default is infinity. -l, --longnames Must be specified when the cluster is configured to use long (FQDN) node names. To learn more, see the RabbitMQ Clustering guide: https://www.rabbitmq.com/docs/clustering --erlang-cookie cookie Shared secret to use to authenticate to the target node. Pre- fer using a local file or the RABBITMQ_ERLANG_COOKIE environ- ment variable instead of specifying this option on the command line. To learn more, see the RabbitMQ CLI Tools guide: https://www.rabbitmq.com/docs/cli COMMANDS list [-Eemv] [pattern] -E Show only explicitly enabled plugins. -e Show only explicitly or implicitly enabled plugins. -m Show only plugin names (minimal). -v Show all plugin details (verbose). pattern Pattern to filter the plugin names by. Lists all plugins, their versions, dependencies and descrip- tions. Each plugin is prefixed with two status indicator char- acters inside [ ]. The first indicator can be: <space> to indicate that the plugin is not enabled E to indicate that it is explicitly enabled e to indicate that it is implicitly enabled to indicate that it is enabled but missing and thus not operational The second indicator can be: <space> to show that the plugin is not running * to show that it is If the optional pattern is given, only plugins whose name matches pattern are shown. For example, this command lists all plugins, on one line each rabbitmq-plugins list This command lists all plugins: rabbitmq-plugins list -v This command lists all plugins whose name contains "manage- ment". rabbitmq-plugins list -v management This command lists all implicitly or explicitly enabled Rab- bitMQ plugins. rabbitmq-plugins list -e rabbit enable [--offline] [--online] plugin ... --offline Modify node's enabled plugin state directly without contacting the node. --online Treat a failure to connect to the running broker as fa- tal. plugin One or more plugins to enable. Enables the specified plugins and all their dependencies. For example, this command enables the "shovel" and "management" plugins and all their dependencies: rabbitmq-plugins enable rabbitmq_shovel rabbitmq_management disable [--offline] [--online] plugin ... --offline Modify node's enabled plugin state directly without contacting the node. --online Treat a failure to connect to the running broker as fa- tal. plugin One or more plugins to disable. Disables the specified plugins and all their dependencies. For example, this command disables "rabbitmq_management" and all plugins that depend on it: rabbitmq-plugins disable rabbitmq_management set [--offline] [--online] [plugin ...] --offline Modify node's enabled plugin state directly without contacting the node. --online Treat a failure to connect to the running broker as fa- tal. plugin Zero or more plugins to disable. Enables the specified plugins and all their dependencies. Un- like enable, this command ignores and overwrites any existing enabled plugins. set with no plugin arguments is a legal com- mand meaning "disable all plugins". For example, this command enables the "management" plugin and its dependencies and disables everything else: rabbitmq-plugins set rabbitmq_management SEE ALSO rabbitmqctl(8), rabbitmq-diagnostics(8), rabbitmq-server(8), rabbitmq-queues(8), rabbitmq-streams(8), rabbitmq-upgrade(8), rabbitmq-service(8), rabbitmq-env.conf(5), rabbitmq-echopid(8) AUTHOR The RabbitMQ Team <contact-tanzu-data.pdl@broadcom.com> RabbitMQ Server June 22, 2023 RABBITMQ-PLUGINS(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rabbitmq-plugins&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>