This command can be used to:
Deactivate a protected path. This pauses snapshots and replication according to the protection policy associated with the protected path.
Activate a protected path if it was previously deactivated. This resumes snapshots and replication according to the protection policy associated with the protected path.
Initiate a failover in an async replication scenario. This must be done from the destination peer's VMS.
Abort a graceful failover during the first phase of the failover when the protected data is read-only on both peers.
Change the name of a protected path.
Change the lease expiration time of a global access protected path.
In async replication, where the protected path is mirrored on the destination peer, activation/deactivation can be done from either peer. Failover is initiated from the destination peer.
Usage
protectedpath modify --id ID [--name NAME] [--activate] [--deactivate] [--modify-replication-state] [--abort-modify-replication-state] [--graceful] [--ungraceful] [--sync-interval SYNC_INTERVAL] [--capabilities ASYNC_REPLICATION | STARED_GLOBAL_NAMESPACE | REPLICATION_AND_GN | SYNC_REPLICATION] [--sync-disconnect-time TIME] [--lease-expiry-time TIME]
Required Parameters
| Specify the protected path by its ID. |
Options
| Changes the name of the protected path. |
| Activates a protected path if previously deactivated. |
| Deactivates a protected path. |
| Initiates an asynchronous replication failover or synchronous turnover. Must be run from the destination peer and used with either |
| Aborts a failover. Must be run from the destination peer. The abort operation is supported for graceful failovers during the read-only phase. |
| Specifies failover type as graceful. Use in addition to |
| Specifies failover type as ungraceful. Use in addition to |
| The maximum duration gap between restore points of members in the replication group, in seconds. Guarantees that a common restore point exists between group members within the specified duration. Default value: 86400 seconds (1 day) |
| The mode or purpose of the protected path:
If SYNC_REPLICATION is specified, |
| The period of time, in seconds, after which a primary and secondary cluster, configured for synchronous replication, will revert to standalone clusters (and no longer replicate data) if communication between them is lost. Default value: 45 seconds |
| For global access, the duration for which data that was already requested at the destination path can be read locally from cache without the destination peer requesting it from the source peer. When the lease expires, the cache is invalidated and the next read request for the data is requested again from the source peer. |
Example
This example suspends a protected path whose ID is 1.
vcli: admin> protectedpath modify --id 1 --deactivate
This example starts a graceful failover on protected path with ID 3.
vcli: admin> protectedpath modify --id 3 --modify-replication-state --graceful