CLI Guide

You can run this command on either the primary or secondary system.
Minimum role manage
Syntax
set replication-set
[name new-name]
[queue-policy discard|queue-latest]
[snapshot-basename basename]
[snapshot-count #]
[snapshot-history disabled|off|secondary|both]
[snapshot-retention-priority never-delete|high|medium|low]
current-replication-set-ID
Parameters
[name new-name]
Optional. Specifies a new name for the replication set. Input rules:
• The value is case sensitive.
• The value can have a maximum of 32 bytes.
• The value can include spaces and printable UTF-8 characters except: " , . < \
• A value that includes a space must be enclosed in double quotes. If you change this parameter while a
replication is running, the replication set will be immediately renamed but the current replication will not be
affected.
[queue-policy discard|queue-latest]
Optional. Specifies the action to take when a replication is running and a new replication is requested.
• discard: Discard the new replication request.
• queue-latest: Take a snapshot of the primary volume and queue the new replication request. If the
queue contained an older replication request, discard that older request. A maximum of one replication
can be queued. This is the default.
If you change this parameter while a replication is running, the change will affect subsequent replications but
not the current replication.
NOTE: If the queue policy is queue-latest and a replication is running and another is queued,
you cannot change the queue policy to discard. You must manually remove the queued
replication before you can change the policy.
[snapshot-basename basename]
Optional if snapshot-history is set to disabled or off. Required if snapshot-history is set to
secondary or both. Specifies a prefix to help you identify replication snapshots. Input rules:
• The value is case sensitive.
• The value can have 1-26 bytes.
• The value can include spaces and printable UTF-8 characters except: " , . < \
• A value that includes a space must be enclosed in double quotes.
If you change this parameter while a replication is running, for the current replication it will affect the name of
the snapshot on the secondary system. For that replication only, the names of the snapshots on the primary
and secondary systems will differ.
[snapshot-count #]
Optional if snapshot-history is set to disabled or off. Required if snapshot-history is set to
secondary or both.
Specifies the number of snapshots taken of the replication volume to retain, from 1 to 16. When a new
snapshot exceeds this limit, the oldest snapshot in the snapshot history is deleted.
The snapshot-count setting can be changed at any time. Its value must be greater than the number of
existing snapshots in the replication set, regardless of whether snapshot-history is enabled.
142
Alphabetical list of commands