Switchover

Prev1/1Next

A switchover is a process used when both nodes are in an operational state and synchronized with each other, but you need to perform tasks that require primary node downtime, such as hardware maintenance. When you initiate a switchover, Veeam Backup & Replication assigns the role of the primary node to the secondary node. The replication of the database configuration flows to the former primary node. After the maintenance, you can revert to the primary node or use it as a new secondary.

Switchover Limitations

Before you perform a switchover, consider the following limitations:

  • It is crucial to prevent any scenario where either the primary or secondary node becomes offline (for example, due to power loss or network connectivity issues) during the switchover process. If either node goes and remains offline for the entire duration of the switchover, the HA cluster will be unable to recover. If this happens, contact Veeam Customer Support.
  • Veeam Backup & Replication does not support an automatic switchover of an HA cluster.
  • During a switchover, Veeam Backup & Replication stops all jobs and services.
  • [Instant Recovery to Hyper-V] Make sure you finalize the Instant Recovery session to Hyper-V before you start a switchover. During a switchover, Veeam Backup & Replication stops the Instant Recovery session. After that, the VM that Veeam Backup & Replication creates on the Hyper-V datastore and its snapshot are deleted. Once you connect to a cluster, Veeam Backup & Replication will start an Instant Recovery session again.

How Switchover Works

After you initiate a switchover, Veeam Backup & Replication performs the following:

  1. For a standard HA cluster removes the cluster IP address from the primary node. For a cross-subnet HA cluster, unblocks port 443 for the new primary node external IP address and blocks port 443 for the new secondary node external IP address in the firewall.
  2. Rewrites information about which host is a primary node in the database.
  3. Sets the database on the former primary node to read-only mode.
  4. Restarts services on both HA nodes.
  5. For a standard HA cluster, assigns the cluster IP address to the new primary node.

Note

This step does not apply to a cross-subnet HA cluster, since there is no cluster IP address to reassign — the switchover for a cross-subnet cluster is handled entirely by the firewall port rule changes described in step 1.


Page updated 2026-07-17

Page content applies to build 13.1.1.18