partner select inbound-replicaset select promote

Selects an inbound replica set from a partner and promotes it to a volume and snapshots.

The new volume will contain the data of the most recent replica. Additional replicas will be changed into corresponding snapshots.

There are two ways to promote an inbound replica set:

Permanent promotion to a volume. Replication of the original volume ceases and the replica set is deleted from the group. This promotion is permanent; the volume cannot later be demoted to the original inbound replica set (although it can be demoted to a failback replica set).

By default when you promote permanently, the volume will have a new, unique iSCSI target name, and hosts must access the volume through the IP address of the current group. Optionally, you can specify that the new volume retain the iSCSI target name (and SCSI identification number) of the original volume. However, there must be only one volume associated with a particular target name and SCSI ID.

Temporary promotion to a recovery volume. Replication of the original volume stops, although the replication relationship is retained so you can later fail back to the primary group. The recovery volume optionally uses the same iSCSI target name as the original volume. After the recovery volume is no longer needed, you can demote the recovery volume to an inbound replica set, returning it to its original state.

If changes are made to the recovery volume and you want to fail back the changes to the primary group, you must demote the volume on the primary group to a failback replica set and replicate the changes. You can then demote the recovery volume and promote the failback replica set to return to the original replication configuration. See the Group Administration manual for detailed information about failback procedures.

Note: Promoting a replica set will fail if replication is in progress for the replica set that you are attempting to promote. You must pause inbound replication before promoting a replica set, then resume it after the promotion. See partner select inbound-pause.

Promoting a replica set does not consume additional pool space on the secondary group. The volume and its snapshot reserve will use exactly the amount of space that was allocated to the replica set in its storage pool, and the delegated space on the recovery group will be reduced by that same amount.

For example, if 200% of the volume size was allocated to the replica set for a 3 GB volume (for a total of 6 GB of allocated space), after promoting the replica set, 3 GB will be used for the new volume itself, another 3 GB (100% of the new volume size) will be reserved for the new volume’s snapshots, and the delegated space will be reduced by 6 GB.

Format for Permanent Promotion

partner select partner_name inbound-replicaset select set_name promote new_vol_name [parameter...]

Format for Temporary Promotion

partner select partner_name inbound-replicaset select set_name promote keep-demote [retain-iscsi-name]

Variables

partner_name	Group name of a partner.
set_name	Name of an inbound replica set.
new_vol_name	Name of new volume.

Parameters

description text	Description for the new volume. If the text variable contains spaces, surround it with quotation marks.
read-write\|read-only	New volume permission (the default is read-write).
offline\|online	New volume status (the default is online).
snap-warn n%	Threshold at which an alarm is generated because the amount of free space reserved for snapshots of the new volume has fallen below this value, as a percentage of the total reserved snapshot space. You must include the percent sign. The default is the group-wide setting, as described in grpparams def-snap-warn .
snap-depletion action	Action to take when the new volume’s snapshot reserve is exceeded, either delete-oldest (delete the oldest snapshots, the default) or volume-offline (set the volume and its snapshots offline). The default is the group-wide setting, as described in grpparams def-snap-depletion .
iscsi-alias alias_name	iSCSI target alias, up to 64 alphanumeric characters, for the new volume. The default is the group-wide setting, as described in grpparams def-iscsi-alias.
unrestricted	Allows unrestricted host access to the new volume. Unrestricted access is not recommended. Instead, after cloning the replica, you should create one or more access control records to restrict host access to the volume. See volume select access create .
retain-iscsi-name	Sets the new volume target iSCSI name identical to the iSCSI target name (and SCSI ID) of the original volume.

Examples

The following command permanently promotes an inbound replica set to a volume:

> partner select psg1 inbound-replicaset select v1.1 promote v1-new

Promoting is in progress. Successfully created volume 'v1-new'

The following command temporarily promotes an inbound replica set to a recovery volume:

> partner select group2 inbound-replicaset select vol3 promote keep-demote

Replica set promoted to recovery volume. You can demote the original volume and then configure replication to the primary group.