snapmirror update-ls-set
-
PDF of this doc site
![](/us-en/ontap-cli-9131/images/pdf-zip.png)
Collection of separate PDF docs
Creating your file...
Start an incremental load-sharing set transfer
Availability: This command is available to cluster and Vserver administrators at the admin privilege level.
Description
The snapmirror update-ls-set
command updates a set of load-sharing mirrors. The command makes destination volumes, in the group of load-sharing mirrors, up-to-date mirrors of the source volume.
The key parameter that identifies the set of load-sharing mirrors is the source volume. SnapMirror transfers are performed from the source volume to each of the up-to-date destination volumes in the set of load-sharing mirrors.
The snapmirror update-ls-set
command performs an incremental transfer to each of the destination volumes. During an incremental transfer, Data ONTAP takes a Snapshot copy on the source volume to capture the current image of the source volume, finds the most recent common Snapshot copy between the source and destination volumes, and incrementally transfers Snapshot copies that are newer than the common Snapshot copy to the destination volume.
|
You still need to use the snapmirror update-ls-set command to manually update the set of load-sharing mirrors even if the set only has one destination mirror. The snapmirror update command can only be used to bring up to date a specific destination mirror that is lagging to the set.
|
After an update using the snapmirror update-ls-set
command successfully completes, the last Snapshot copy transferred is made the new exported Snapshot copy on the destination volumes.
This command is only supported for SnapMirror relationships with the field "Relationship Capability"
showing as "Pre 8.2"
in the output of the snapmirror show command.
Parameters
- {
-S, -source-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[app-cgname]>}
- Source Path -
This parameter specifies the source endpoint of the SnapMirror relationship in one of four path formats. The normal format includes the names of the Vserver (vserver) and/or the volume (volume). To support relationships with
"Relationship Capability"
of"Pre 8.2"
, a format which also includes the name of the cluster (cluster) is provided. The"Pre 8.2"
format cannot be used when operating in a Vserver context on relationships with"Relationship Capability"
of"8.2 and above"
. For SnapMirror relationships with an AltaVault source, the source endpoint is specified in the formhostip:/share/share-name
. For SnapMirror relationships with a SolidFire source, the source endpoint is specified in the formhostip:/lun/name
. - |
[-source-cluster <Cluster name>]
- Source Cluster -
Specifies the source cluster of the SnapMirror relationship. If this parameter is specified, the
-source-vserver
and-source-volume
parameters must also be specified. This parameter is only applicable for relationships with"Relationship Capability"
of"Pre 8.2"
. This parameter cannot be specified when operating in a Vserver context on relationships with"Relationship Capability"
of"8.2 and above"
. -source-vserver <vserver name>
- Source Vserver-
Specifies the source Vserver of the SnapMirror relationship. For relationships with volumes as endpoints, if this parameter is specified, parameters
-source-volume
and for relationships with"Relationship Capability"
of"Pre 8.2"
,-source-cluster
must also be specified. This parameter is not supported for relationships with non-Data ONTAP source endpoints. -source-volume <volume name>
- Source Volume }-
Specifies the source volume of the SnapMirror relationship. If this parameter is specified, parameters
-source-vserver
and for relationships with"Relationship Capability"
of"Pre 8.2"
,-source-cluster
must also be specified. This parameter is not supported for relationships with non-Data ONTAP source endpoints. [-w, -foreground <true>]
- Foreground Process-
This specifies whether the operation runs as a foreground process. If this parameter is specified, the default setting is
true
(the operation runs in the foreground). When set totrue
, the command will not return until the process completes. This parameter is only applicable to relationships with"Relationship Capability"
of"Pre 8.2"
.
Examples
To update the group of load-sharing mirrors for the source endpoint named //vs1.example.com/vs1_root
, type the following command:
cluster1::> snapmirror update-ls-set -source-path //vs1.example.com/vs1_root