Print Email PDF

Replication: Version Requirements and Upgrade Recommendations

IN THIS ARTICLE

This article outlines the version requirements and upgrade recommendations for clusters that run Qumulo Core.

DETAILS

Replication creates a copy of the data in a directory on your cluster and transfers it to a directory on a second target cluster. This process generates a consistent point-in-time copy of the source directory on the target cluster.

Because two clusters are required for this feature, there are specific version requirements and upgrade considerations depending on what version of Qumulo Core you run on either cluster. 

Replication for Qumulo Core 5.0.1 (and Higher)

Important: From version 5.0.1, Qumulo Core blocks replication between unsupported versions. For example, version 5.0.1 can't replicate with releases before 4.3.0 or after 5.2.0.

Qumulo Core 5.0.0 (and higher) supports replication between the current cluster version and up to two previous or future quarterly releases.

  • This example shows quarterly releases with your current cluster version at 5.1.0.
    4.3.0 (q) ← 5.0.0 (q) ← 5.1.0 (q) → 5.2.0 (q) → 5.3.0 (q)
  • This example shows non-quarterly releases with your current cluster version at 5.1.1.
    5.0.0 (q) ← 5.1.0 (q) ← 5.1.1 → 5.2.0 (q) → 5.3.0 (q)

Replication for Qumulo Core 2.11.0 to 5.0.0

From Qumulo Core 2.11.0 to 5.0.0, clusters that use different software versions can use replication between at least 2 consecutive quarterly releases.

The following table illustrates replication between Qumulo Core versions 4.1.0 to 5.0.0. Cells marked with an x are compatible.

  4.1.0 4.1.1 4.1.2 4.1.3 4.1.4 4.1.5 4.2.0 4.2.1 4.2.2
4.2.3 4.2.4 4.2.5 4.2.6 4.3.0 4.3.1 4.3.2 4.3.3 4.3.4 5.0.0
4.1.0 x x x x x x x                        
4.1.1 x x x x x x x                        
4.1.2 x x x x x x x                        
4.1.3 x x x x x x x                        
4.1.4 x x x x x x x                        
4.1.5 x x x x x x x                        
4.2.0 x x x x x x x x x x x x x x x x x x x
4.2.1             x x x x x x x x x x x x x
4.2.2             x x x x x x x x x x x x x
4.2.3             x x x x x x x x x x x x x
4.2.4             x x x x x x x x x x x x x
4.2.5             x x x x x x x x x x x x x
4.2.6             x x x x x x x x x x x x x
4.3.0             x x x x x x x x x x x x x
4.3.1             x x x x x x x x x x x x x
4.3.2             x x x x x x x x x x x x x
4.3.3             x x x x x x x x x x x x x
4.3.4             x x x x x x x x x x x x x
5.0.0             x x x x x x x x x x x x x

Replication for Qumulo Core 2.10.x (and Lower)

To use replication with earlier versions of Qumulo Core, the source and target cluster must be running the same version of Qumulo Core 2.7.3 (or higher).

Important: If the clusters run different versions of Qumulo Core, replication fails.

Upgrade Recommendations

If you create a replication relationship with a target directory path that specifies the file system root directory (Qumulo Core 2.12.0 and higher supports this), you must follow specific recommendations for upgrading your cluster.

Note: Regardless of version, upgrading Qumulo Core while a replication job runs interrupts the job in progress. When both clusters return to a state in which replication is possible, the job resumes.

Because the target directory of an existing replication relationship is read-only to all client access, upgrading a cluster whose file system root directory is the target of a replication relationship has the following requirements.

If the Source Cluster is Available

To avoid having to resynchronize your clusters after the relationship is reconnected, we recommend the following steps.

  1. Copy the upgrade image to a directory on the source cluster (you can't copy it to the read-only target cluster).
  2. Wait for the upgrade image to replicate to the target cluster.
  3. Continue with the normal upgrade process.

If the Source Cluster is Unavailable or Another Issue Exists

The following process interrupts the replication process. On clusters that run Qumulo Core 2.12.5 (and lower), it also requires additional time to resynchronize the clusters by running a full-tree scan after you reconnect the relationship.

  1. To temporarily make the target relationship writable for the duration of the upgrade, use the Make Target Writable action in the Web UI.
  2. Wait for the upgrade to complete.
  3. Re-establish the relationship by using the Reconnect Relationship action. Note that this will interrupt replication for the duration of the process.

ADDITIONAL RESOURCES

Replication: Continuous Replication with 2.11.2 and above

Replication: Continuous Replication with 2.11.1 and below

Replication: Blackout Windows

QQ CLI: Replication

 

Like what you see? Share this article with your network!

Was this article helpful?
3 out of 3 found this helpful

Comments

0 comments

Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.