---
name: "rabbitmq-upgrade"
section: "8"
platform: "linux"
package: "rabbitmq"
version: "4.3.6-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rabbitmq-upgrade"
---

# rabbitmq-upgrade(8)

RabbitMQ installation upgrade tools

## NAME

**rabbitmq-upgrade** – RabbitMQ 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:* **https://www.rabbitmq.com/docs/upgrade** 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)](/rabbitmq-server/8.md) 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:* **https://www.rabbitmq.com/docs/clustering**

- **--erlang-cookie** *cookie*

  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:* **https://www.rabbitmq.com/docs/cli**

## COMMANDS

- **help**

  Displays general help and commands supported by **rabbitmq-upgrade**.

- **post\_upgrade**

  Runs post-upgrade tasks. In the current version, it performs the rebalance of mirrored and quorum queues across all nodes in the cluster.

- **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:* **https://www.rabbitmq.com/docs/upgrade#maintenance-mode**

- **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:* **https://www.rabbitmq.com/docs/upgrade#maintenance-mode**

## SEE ALSO

[rabbitmqctl(8)](/rabbitmqctl/8.md), [rabbitmq-diagnostics(8)](/rabbitmq-diagnostics/8.md), [rabbitmq-server(8)](/rabbitmq-server/8.md), [rabbitmq-queues(8)](/rabbitmq-queues/8.md), [rabbitmq-streams(8)](/rabbitmq-streams/8.md), [rabbitmq-service(8)](/rabbitmq-service/8.md), [rabbitmq-env.conf(5)](/rabbitmq-env.conf/5.md)

## AUTHOR

The RabbitMQ Team ⟨*contact-tanzu-data.pdl@broadcom.com*⟩