Replication Commands This section contains commands for managing replication. Child Topicsabort_replication_consistency_group_snapshots_createAbort a previous request to create a snapshot of a Replication Consistency Group. activate_replication_consistency_group_mappingsActivate Replication Consistency Group mappings on the peer system addressed by the command. add_replication_consistency_groupAdd a Replication Consistency Group (RCG). add_replication_pairAdd a replication pair consisting of a volume from the source system and a volume from the target system. add_replication_peer_systemThe peer system must be added to each of the systems involved in replication. There must be network connectivity between the two systems. add_sdrAdd an SDR to the specified Protection Domain. The SDR is one of the main components that must be installed on each of the peer Protection Domains for replication. It transfers data from the source volume to the target volume. add_sdr_ipAdd an IP address to the specified SDR. clear_broken_replication_consistency_group_alerts Clear broken Replication Consistency Group indications for all volumes associated with the specified Protection Domain. This is useful in situations when the SDRs run out of journal capacity. At that point, an alert is produced for every replicated volume in the affected Protection Domain. These alerts can be cleared using this command. create_replication_consistency_group_snapshotsInitiate creation of Replication Consistency Group snapshots on the target. enter_sdr_maintenance_modeEnter the SDR into maintenance mode to allow for maintenance of the SDR. Note that there must be at least two other active SDRs joined to the system for replication to continue. When maintenance mode is activated, the MDM changes the mapping and distributes the I/Os to the remaining SDRs. exit_sdr_maintenance_modeMove the SDR out of maintenance mode. failover_replication_consistency_groupFail over the specified Replication Consistency Group. During failover, the application I/Os are stopped at the source and the access mode of the source volumes is changed to inaccessible. The target volumes are brought to the newest consistent image available on the destination and their access mode is changed to read-write. Recovery from failover state can be achieved by either restoring the replication or reversing it. failover_test_start_replication_consistency_groupStart a test failover of the specified Replication Consistency Group. This allows you to demonstrate failover mode without interrupting data synchronization. failover_test_stop_replication_consistency_groupStop a failover test for the specified Replication Consistency Group. freeze_apply_replication_consistency_groupApply the latest consistent image available at the destination to the target volumes and freeze the Replication Consistency Group. While the Replication Consistency Group is frozen, replication remains active and I/Os are replicated to the target journal. The I/Os are stored in the target journal and are not applied to the target volumes. Remaining in a frozen state for a long time runs the risk of running out of space in the target journal. inactivate_replication_consistency_group_mappingsInactivate replication consistency group mappings on the peer to which the command is applied. modify_replication_consistency_group_rpoModify the recovery point objective (RPO) of the Replication Consistency Group. modify_replication_consistency_group_target_volume_access_modeModify the target volume access mode of a Replication Consistency Group. modify_replication_peer_system_ipModify an IP address of a replication peer system. modify_replication_peer_system_portModify the port of the specified replication peer system. modify_sdr_ip_roleModify the role of the specified SDR's IP address. modify_sdr_portModify the port assigned to the specified SDR. pause_pair_initial_copyPause the initial copy process of the specified replication pair. pause_replication_consistency_groupPause the Replication Consistency Group. While in pause mode, new writes are collected at the source but are not transferred to the target. print_recreate_replication_consistency_group_scriptDisplay a list of SCLI commands required to recreate the specified Replication Consistency Group. query_all_replication_consistency_groupsRetrieve information about all the Replication Consistency Groups. query_all_replication_journal_capacityRetrieve information about all replication journal volumes. The results can be filtered by Protection Domain or by Storage Pool. query_all_replication_pairsRetrieve information about all the replication pairs in the system. query_all_replication_peer_systemRetrieve information about all the replication peer systems. query_all_sdrRetrieve information about all SDRs. query_replication_consistency_groupRetrieve information about the specified Replication Consistency Group. query_replication_pairRetrieve information about the specified replication pair. query_replication_peer_systemRetrieve information about the specified replication peer system. query_replication_peer_system_destination_volume_candidatesRetrieve information about destination volume candidates in the replication peer system. This command returns available remote volumes in the specified peer system's Protection Domain with the specified capacity. query_replication_peer_system_protection_domainsRetrieve information about the available Protection Domains in the target replication peer system. query_sdrRetrieve information about the specified SDR. query_sync_now_replication_consistency_groupRetrieve the status of a synchronization process for the specified Replication Consistency Group. remove_replication_consistency_groupInitiate removal of a Replication Consistency Group. remove_replication_pairRemove the specified replication pair. remove_replication_peer_systemRemove a replication peer system. remove_sdrInitiate removal of the specified SDR. remove_sdr_ipRemove an IP address from an SDR. rename_replication_consistency_groupName or rename the specified Replication Consistency Group. rename_replication_peer_systemName or rename the replication peer system. The name should be unique. rename_sdrName or rename an SDR. resume_pair_initial_copyResume the paused initial copy process of the specified replication pair. resume_replication_consistency_groupResume a paused replication consistency group. Once the replication consistency group is resumed, the source will resume transmission of the collected write data to the target. restore_replication_consistency_groupOnce the replication consistency group is in failover or switchover mode, you can reverse or restore the replication. Restoring replication maintains the replication direction from the original source and overwrites all data at the target. reverse_replication_consistency_groupOnce the replication consistency group is in failover or switchover mode, you can reverse or restore the replication. Reversing replication changes the direction so that the original target becomes the source. All data at the original source is overwritten by the data at the target. set_pair_initial_copy_queue_positionSet the priority of the initial copy process of the specified replication pair to be the highest or lowest priority in the initial copy queue. set_replication_consistency_group_consistentSet the specified Replication Consistency Group as consistent. While in consistent mode, the journal at the target applies its content to the target volumes in a way that guarantees that a consistent image of the target volumes can be achieved. set_replication_consistency_group_inconsistentSet the specified Replication Consistency Group as inconsistent. While in inconsistent mode, the contents of the target journal are applied to the target volumes without guarantee of consistency. This means that the target volume image may not be consistent during the time that the replication consistency group is inconsistent. set_replication_journal_capacitySet the replication journal capacity ratio for the specified Storage Pool. This defines the maximum ratio of a storage pool capacity that can be used by the replication system for journaling. switchover_replication_consistency_groupSwitch over the specified replication consistency group. Switchover is a planned failover. The application I/Os are stopped at the source and the data is synchronized so that the target volume is consistent with the source volume. The access mode of the original source volumes is changed to unavailable or read-only. The access mode of the original target volumes is changed so that the hosts can read and write to the volumes. sync_now_replication_consistency_groupSynchronize the source and target to ensure that all new data that has been written to the source is also written to the target volumes. A sync key is returned that can be used to query the status of the synchronization process. unfreeze_apply_replication_consistency_groupUnfreeze the Replication Consistency Group and apply the I/Os stored in the target journal to the target volumes.