Print Email PDF

QQ CLI: Replication

IN THIS ARTICLE 

Lists the qq commands available for Replication in Qumulo Core and their corresponding API action

REQUIREMENTS

  • Cluster running Qumulo Core 2.6.6 and above
    • Cluster is in quorum and qfsd process is running on the selected node
    • The list below reflects the qq commands currently available for Replication that was released in version 2.6.6 of Qumulo Core. Certain commands may require upgrading to a later release to utilize a specific API action related to this feature.
  • Command line (CLI) tools installed via API & Tools in the Web UI
  • Admin privileges on the Qumulo cluster

COMMANDS FOR REPLICATION

COMMAND ACTION
qq replication_
abort_object_replication
Abort any ongoing replication job for the specified object replication relationship
qq replication_
abort_replication
Abort ongoing replication work for the specified source replication relationship 
qq replication_
add_blackout_window
Add a blackout window to the specified source of the replication relationship 
qq replication_authorize
Authorize the specified replication relationship to establish the cluster as the target of the replication 
qq replication_
create_object_relationship
Create an object replication relationship that initiates a one-time copy of file data to S3
qq replication_
create_source_relationship
Create a new replication relationship 
qq replication_
delete_blackout_windows
Delete blackout windows of the specified source replication relationship 
qq replication_
delete_object_relationship
Delete the specified object replication relationship, which must not be running a job
qq replication_
delete_source_relationship
Delete the specified source replication relationship 
qq replication_
delete_target_relationship
Delete the specified target replication relationship 
qq replication_
get_object_relationship
Get the configuration of the specified object replication relationship
qq replication_
get_source_relationship
Get information about the specified source replication relationship 
qq replication_
get_object_relationship_status
Get current status of the specified object replication relationship
qq replication_
get_source_relationship_status
Get current status of the specified source replication relationship 
qq replication_
get_target_relationship_status
Get current status of the specified target replication relationship 
qq replication_
link_snapshot_policy

Link a snapshot policy to the specified source replication relationship to replicate snapshots taken by the policy. The replication mode will be set to REPLICATION_SNAPSHOT
_
POLICY_WITH_CONTINUOUS
when linking the first policy, otherwise the existing mode will be preserved. The mode can be modified with the replication_set_snapshot
_policy
_replication_
mode command or by removing all linked snapshot policies.

qq replication_
list_queued_snapshots
List information for all snapshots awaiting replication by the specified source replication relationship.
qq replication_
list_object_relationships
List all the existing object replication relationships
qq replication_
list_source_relationships
List existing source replication relationships 
qq replication_
list_object_relationship_statuses
List the statuses for all existing object replication relationships
qq replication_
list_source_relationship_statuses
List statuses for all existing source replication relationships 
qq replication_
list_target_relationship_statuses
List statuses for all existing target replication relationships 
qq replication_
make_target_writable
Revert target directory to the latest recovery point to ensure that it is in a point-in-time consistent state. Then disconnect the specified target replication relationship, breaking the relationship
with the source and making the target directory writable. The revert action may take some time to complete. If the relationship is later reconnected, any changes made to the target directory since the relationship was disconnected will be reverted upon reconnecting.
qq replication_
modify_source_relationship
Modify an existing source replication relationship 
qq replication_
reconnect_target_relationship
Make the target directory read-only and revert any changes made to the target directory since the latest recovery point. Then reconnect the specified target replication relationship with its source directory. The revert action may take some time to complete before replication is resumed.
qq replication_
release_queued_snapshot
Release a snapshot queued for replication from the queue of the specified source replication relationship.
qq replication_replicate
Replicate from the source to the target of the specified relationship 
qq replication_
reverse_target_relationship
Reverse source and target for the specified replication relationship. This operation is initiated on the target cluster. The previous target directory will be made the new source, and the previous source directory will be made the new target. After reversal completes, blackout windows will be reset and the relationship will remain disconnected, where replication will not resume. To resume replication after reversal, configure blackout windows from the new source cluster and reconnect the relationship from the new target cluster.
qq replication_
set_snapshot_policy_replication_mode
Set the replication mode of the specified source replication relationship. This command is only for a relationship that has linked snapshot policies.
qq replication_
unlink_snapshot_policy
Unlink a linked snapshot policy from the specified source replication relationship. The replication mode will be set to REPLICATION_
CONTINUOUS when unlinking the last policy, otherwise the existing mode will be preserved.

NOTE: Once you've accessed a node via ssh, you can see the full list of qq commands by running:

qq -h

RESOLUTION

You should now be able to successfully use qq commands to complete specific API actions for Replication in Qumulo Core

ADDITIONAL RESOURCES

QQ CLI: Install Command-Line Tools

QQ CLI: Get Started

QQ CLI: Comprehensive list of Commands

Replication: Continuous Replication with 2.11.2 and above

Video: Continuous Replication

 

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

Was this article helpful?
1 out of 1 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.