Skip to main content
Version: Next

rabbitmq-upgrade.8

NAME

rabbitmq-upgradeRabbitMQ installation upgrade tools

SYNOPSIS

rabbitmq-upgrade[-q] [-s] [-l] [-n node] [-t timeout] command [command_options]

DESCRIPTION

rabbitmq-upgrade is a command line tool that provides commands used during the upgrade of RabbitMQ nodes. See the RabbitMQ upgrade guide to learn more about RabbitMQ installation upgrades.

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 reduced when quiet mode is in effect.

-s, --silent

Silent output mode is selected. Informational messages are reduced and table headers are suppressed when silent mode is in effect.

-t timeout, --timeout timeout

Operation timeout in seconds. Not all commands support timeouts. 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

Shared secret to use to authenticate to the target node. Prefer using a local file or the RABBITMQ_ERLANG_COOKIE environment variable instead of specifying this option on the command line. To learn more, see the RabbitMQ CLI Tools guide

COMMANDS

help

Displays general help and commands supported by rabbitmq-upgrade.

post_upgrade

Runs post-upgrade tasks. This is a command that can be expected to evolve over time.

await_online_quorum_plus_one

Waits for all quorum queues to have an above minimum online quorum. This makes sure that no queues would lose their quorum if the target node is shut down.

drain

Puts the node in maintenance mode. Such nodes will not serve any client traffic or considered for hosting any queue leader replicas.

To learn more, see the RabbitMQ Upgrade guide

revive

Puts the node out of maintenance and into regular operating mode. Such nodes will again serve client traffic and considered for queue leader replica placement.

To learn more, see the RabbitMQ Upgrade guide

SEE ALSO

rabbitmqctl(8), rabbitmq-diagnostics(8), rabbitmq-server(8), rabbitmq-queues(8), rabbitmq-streams(8), rabbitmq-service(8), rabbitmq-env.conf(5), rabbitmq-echopid(8)

AUTHOR

The RabbitMQ Team <rabbitmq-core@groups.vmware.com>