Changing a mirroring schedule for local peers
Use the mirror_change_schedule command to change the replication schedule for peers on the local system.
mirror_change_schedule < vol=VolName | cg=cgName > [ target=TargetName ] schedule=Schedule
Parameters
| Name | Type | Description | Mandatory | Default |
|---|---|---|---|---|
| vol | Object name | Volume name on the local system. | N | N/A |
| cg | Object name | CG name on the local system. | N | N/A |
| target | Object name | Target name of the mirror, mandatory if there are two mirrors defined on the volume. | N | [none] |
| schedule | Object name | A reference to a mirroring schedule. | Y | N/A |
This command changes the replication schedule for a peer on the local system. The new scheduling will become effective only if the peer is set as master.
- The coupling must be ASYNC_INTERVAL.
- The schedule’s interval has to be shorter than the corresponding mirror's RPO.
- The specified target does not exist
- The specified target is non-mirrored
- The specified target is a volume that belongs to a mirrored consistency group
- The specified target synchronization type is not ASYNC_INTERVAL
- The system displays the following warning: ″Are you sure to change schedule″
- An event is generated
- New sync jobs will be generated according to updated schedule. A running sync job is unaffected.
Access control
| User Category | Permission |
|---|---|
| Storage administrator | Allowed |
| Application administrator | Disallowed |
| Security administrator | Disallowed |
| Read-only users | Disallowed |
| Operations administrator | Disallowed |
| Host side accelerator client | Disallowed |
Return codes
- VOLUME_BAD_NAME
Volume name does not exist.
- CONS_GROUP_BAD_NAME
Consistency group name does not exist.
- VOLUME_NO_MIRROR
Local volume does not have remote mirroring definitions.
- CONS_GROUP_NO_MIRROR
Local consistency group does not have remote mirroring definitions.
- SCHEDULE_DOES_NOT_EXIST
Specified schedule does not exist.
- SYNC_MIRROR_DOES_NOT_USE_SCHEDULE
Definition of synchronous mirror does not require a schedule object to be specified.
- VOLUME_BELONGS_TO_MIRRORED_CONS_GROUP
Volume mirror is part of consistency group mirror.
- INTERVAL_SHOULD_BE_SHORTER_THAN_RPO
Schedule interval must be shorter than the RPO.
The newly defined schedule has to be shorter than the RPO.
- TARGET_BAD_NAME
Target name does not exist.
- VOLUME_HAS_MULTIPLE_MIRRORS
volume has multiple mirrors, operation not allowed or target must be specified.
- VOLUME_TARGET_MISMATCH
Volume and target do not match.
- CONS_GROUP_BAD_TARGET
Target name does not match the consistency group.
- MIRROR_IS_STANDBY
Mirror is marked as standby.