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

Genetec Mission Control™ Release Notes 2.13.3.0

Applies to
Genetec Mission Control™ 2.13.3.0
Last updated
2020-07-15
Content type
Release notes
Language
English
Product
Genetec Mission Control™
Version
2.13

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

  1. 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.
  2. 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.
  3. 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.