Upgrading a RabbitMQ failover cluster to version 3.8.3 - Genetec Mission Control™ 2.13.3.0

If RabbitMQ is deployed in a failover configuration with a master node and a secondary node, you must use an adapted procedure to upgrade RabbitMQ to version 3.8.3. This version of RabbitMQ was introduced in Genetec Mission Control™ 2.13.3.0.

Before you begin

Copy the Genetec Mission Control™ 2.13.3.0 installation package to both RabbitMQ servers.

Tip: It is recommended to use a 3 cluster node failover procedure. For details, see Configuring failover for RabbitMQ in the Genetec Mission Control™ Deployment Guide.

What you should know

RabbitMQ version 3.8.3 installs important security updates, an easier configuration file format and additional features.

This procedure refers to a master node and a secondary node. Because these servers are interchangeable, the secondary node is always the first node to be brought down.

Procedure

On the secondary node, do the following:
1. Stop the RabbitMQ service.
2. Back up the .erlang.cookie file to a temporary storage location.
  File path for the .erlang.cookie is as follows:
  - C:\Windows\.erlang.cookie, if upgrading from RabbitMQ 3.7.10.
  - C:\Windows\ServiceProfiles\LocalService\.erlang.cookie, if upgrading from RabbitMQ 3.8.0.
  IMPORTANT: A new .erlang.cookie file is generated during the upgrade process and must be replaced with the backup.
On the master node, do the following:
1. Stop the RabbitMQ service.
2. Back up the .erlang.cookie file to a temporary storage location.
  File path for the .erlang.cookie is as follows:
  - C:\Windows\.erlang.cookie, if upgrading from RabbitMQ 3.7.10.
  - C:\Windows\ServiceProfiles\LocalService\.erlang.cookie, if upgrading from RabbitMQ 3.8.0.
3. Use the advanced setup in the Genetec Mission Control™ 2.13.3.0 installation wizard to only upgrade RabbitMQ.
4. Restore your backup of the .erlang.cookie file to the following locations:
  - %HOMEDRIVE%%HOMEPATH%
    Usually C:\Users\<username>
  - %USERPROFILE%
    Usually C:\Windows\ServiceProfiles\LocalService\ for a service
5. Restart the RabbitMQ service.
On the secondary node, do the following:
1. Restore your backup of the .erlang.cookie file to the following locations:
  - %HOMEDRIVE%%HOMEPATH%
    Usually C:\Users\<username>
  - %USERPROFILE%
    Usually C:\Windows\ServiceProfiles\LocalService\ for a service
2. Use the advanced setup in the Genetec Mission Control™ 2.13.3.0 installation wizard to only upgrade RabbitMQ.
3. Restart the RabbitMQ service.

Results

Your RabbitMQ failover cluster has been upgraded.