3.1.2 Matrix Server Upgrade Guide

Single Upgrade Procedures

This chapter describes how to upgrade Matrix Server in a single rolling

upgrade. For upgrades from Matrix Server 2.7.2 and 3.0.1, all servers

must be running a 32-bit operating system.

The procedures do not require any matrix downtime. Each server is

removed from the matrix, upgraded, and then returned to the matrix.

Rolling Upgrade Considerations

You should be aware of the following when upgrading to the Matrix

Server 3.1.2 release:

• Servers can be upgraded one-at-a-time during the rolling upgrade.

The server with the numerically highest primary IP address must be

upgraded first. Then continue to upgrade the servers in descending

order of IP address, with the server with the lowest primary IP

address being upgraded last. (This is a change in order from previous

Matrix Server upgrades.)

If a server is accidentally upgraded out of order, when a higher-

number server joins the matrix, the servers still running the old

version of Matrix Server will think they need to leave the matrix and

will no longer send configuration and status updates. To correct this

problem, stop Matrix Server on the node that was upgraded out of

order. Continue upgrading the other nodes before starting Matrix

Server on that node.