CLI Guide

Specifies the number of snapshots that are 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.

snapshot-history disabled|off|secondary|both

Optional. Specifies whether to maintain a replication snapshot history for the replication set, as previously

described.

• disabled or off: A snapshot history is not kept. If this parameter is disabled after a replication set has

been established, any existing snapshots will be kept, but not updated. This option is the default.

• secondary: A snapshot history set is kept on the secondary system for the secondary volume, using

snapshot-count and snapshot-basename settings.

• both: A snapshot history is kept for the primary volume on the primary system and for the secondary

volume on the secondary system. Both snapshot histories use the same snapshot-count and

snapshot-basename settings

snapshot-retention-priority never-delete|high|medium|low

Optional. For virtual storage, this specifies the retention priority for history snapshots, which is used when

automatic deletion of snapshots is enabled by using the "set snapshot-space" command. In a snapshot tree,

only leaf snapshots can be deleted automatically. Deletion of snapshots based on retention priority is

unrelated to deleting the oldest snapshots to maintain a snapshot count.

• never-delete: Snapshots are never automatically deleted to make space. The oldest snapshot in the

snapshot history is deleted once the snapshot-count has been exceeded. This is the default.

• high: Snapshots can be deleted after all eligible medium-priority snapshots have been deleted.

• medium: Snapshots can be deleted after all eligible low-priority snapshots have been deleted.

• low: Snapshots can be deleted.

name

Specifies a 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.

Examples

Create replication set RS1 for primary volume Vol1 on the peer connection Peer1.

# create replication-set peer-connection Peer1 primary-volume Vol1 RS1

Create replication set RS1 for volume group VG1.* on the peer connection Peer1.

# create replication-set peer-connection Peer1 primary-volume VG1.* RS1

Create replication set repset2 for volume vol2 on peer-connection Lab; specify that the system cannot

automatically delete history snapshots in this set; and enable snapshot history for both the primary volume

and the secondary volume, allowing up to 5 replication snapshots with the basename repsnapvol2 to be

retained for each volume.

# create replication-set peer-connection Lab primary-volume vol2 secondary-

pool A snapshot-retention-priority never-delete snapshot-history both

snapshot-basename repsnapVol2 snapshot-count 5 repset2