Description

The snapmirror initialize command initializes the destination volume of a SnapMirror relationship. The command behaves differently between data protection (DP), extended data protection (XDP) and load-sharing (LS) relationships.

For data protection (DP) and extended data protection (XDP) relationships, the snapmirror initialize command initializes the destination volume.

For load-sharing (LS) relationships, the snapmirror initialize command initializes a new load-sharing mirror in an existing set of load-sharing mirrors. If the command finishes before the start of a scheduled or manual transfer of the set of load-sharing mirrors, the load-sharing mirror is up to date with the set of load-sharing mirrors; otherwise, the load-sharing mirror will be brought up to date at the next scheduled or manual transfer of the set of load-sharing mirrors.

The initial transfer to an empty destination volume is called a baseline transfer. During a baseline transfer for a data protection (DP) or extended data protection (XDP) relationship, the snapmirror initialize command takes a Snapshot copy on the source volume to capture the current image of the source volume. For data protection relationships, the snapmirror initialize command transfers all of the Snapshot copies up to and including the Snapshot copy created by it from the source volume to the destination volume. For extended data protection (XDP) relationships, the snapmirror initialize command behavior depends on the snapmirror policy associated with the relationship. If the policy type is async-mirror then depending on the rules in the policy it can transfer either all the Snapshot copies up to and including the Snapshot copy created by it or only the Snapshot copy created by it from the source volume to the destination volume. For extended data protection (XDP) relationships with policy type vault or mirror-vault the snapmirror initialize transfers only the Snapshot copy created by it.

After the snapmirror initialize command successfully completes, the last Snapshot copy transferred is made the exported Snapshot copy on the destination volume.

When an Infinite Volume SnapMirror relationship is initialized, the command will create any needed constituent volumes for the destination Infinite Volume. The Infinite Volume relationship will appear in the snapmirror show command output on the source cluster after it is initialized.

You can use the snapmirror initialize command to initialize a specific load-sharing mirror that is new to the set of load-sharing mirrors. An initialize of the new load-sharing mirror should bring it up to date with the other up-to-date destination volumes in the set of load-sharing mirrors.

If a SnapMirror relationship does not already exist, that is, the relationship was not created using the snapmirror create command, the snapmirror initialize command will implicitly create the SnapMirror relationship, with the same behaviors as described for the snapmirror create command before initializing the relationship. This implicit create feature is not supported for Infinite Volumes.

This command is supported for SnapMirror relationships with the field "Relationship Capability" showing as either "8.2 and above" or "Pre 8.2" in the output of the snapmirror show command.

For relationships with "Relationship Capability" of "8.2 and above", you can track the progress of the operation using the snapmirror show command.

For relationships with "Relationship Capability" of "Pre 8.2", a job will be spawned to operate on the SnapMirror relationship, and the job id will be shown in the command output. The progress of the job can be tracked using the job show and job history show commands.

The snapmirror initialize command must be used from the destination Vserver or cluster.

Parameters

{  [-source-path | -S {<[vserver:]volume>|<[[cluster:]//vserver/]volume>}] - Source Path

|  [-source-cluster <Cluster name>] - Source Cluster

   [-source-vserver <vserver name>] - Source Vserver

   [-source-volume <volume name>]  } - Source Volume

{  -destination-path {<[vserver:]volume>|<[[cluster:]//vserver/]volume>} - Destination Path

|  [-destination-cluster <Cluster name>] - Destination Cluster

   -destination-vserver <vserver name> - Destination Vserver

   -destination-volume <volume name>  } - Destination Volume

[-source-snapshot | -s <text>] - Source Snapshot

[-type <snapmirrorType>] - Snapmirror Relationship Type

[-policy <sm_policy>] - SnapMirror Policy

[-throttle | -k <throttleType>] - Throttle (KB/sec)

[-transfer-priority {low|normal}] - Transfer Priority

[-foreground | -w [true]] - Foreground Process

Examples

To start the initial transfer for the SnapMirror relationship with the destination endpoint vs2.example.com:dept_eng_dp_mirror2 after the relationship has been created with the snapmirror create command, type the following command:

vs2.example.com::> snapmirror initialize -destination-path
       vs2.example.com:dept_eng_dp_mirror2

For relationships with "Relationship Capability" of "Pre 8.2", to start the initial transfer for the SnapMirror relationship with the destination endpoint cluster2://vs2.example.com/dept_eng_dp_mirror2 after the relationship has been created with the snapmirror create command, type the following command:

cluster2::> snapmirror initialize -destination-path
         cluster2://vs2.example.com/dept_eng_dp_mirror2

To create a data protection mirror relationship between the source endpoint vs1.example.com:dept_mkt, and the destination endpoint vs2.example.com:dep_mkt_dp_mirror, and start the initial transfer, type the following command:

vs2.example.com::> snapmirror initialize -destination-path
         vs.example.com2:dept_mkt_dp_mirror
         -source-path vs1.example.com:dept_mkt

To create a data protection mirror relationship between the source endpoint cluster1://vs1.example.com/dept_mkt, and the destination endpoint cluster2://vs2.example.com/dep_mkt_dp_mirror, and start the initial transfer when the source cluster is running Data ONTAP 8.1 software, type the following command:

cluster2::> snapmirror initialize -destination-path
         cluster2://vs2.example.com/dept_mkt_dp_mirror
         -source-path cluster1://vs1.example.com/dept_mkt

See Also