Data ONTAP 8.3 Reference - snapmirror release

Description

The snapmirror release command removes the relationship information from the source Vserver. The command also removes any Snapshot copy owner tags and any Snapshot copies which were created for the specified relationship from the source volume. It does not destroy any volumes. This command must be used from the source Vserver or cluster.

You can use the snapmirror list-destinations command to display source Vservers' relationship information. This information is populated during the first SnapMirror transfer, not when the snapmirror create command is issued.

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

The snapmirror release operation fails if a SnapMirror transfer for the SnapMirror relationship is in a data phase of the transfer.

Parameters

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

Specifies the source endpoint of the SnapMirror relationship in one of two formats. The normal format includes the names of the Vserver (vserver), and volume (volume). A format which also includes the name of the cluster (cluster) is also provided for consistency with other snapmirror commands. The form of the pathname which includes the cluster name cannot be used when operating in a Vserver context.

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

Specifies the source Vserver of the SnapMirror relationship. If this parameter is specified, parameter -source-volume must also be specified.

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

Specifies the source volume of the SnapMirror relationship. If this parameter is specified, parameter -source-vserver must also be specified.

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

Specifies the destination endpoint of the SnapMirror relationship in one of two formats. The normal format includes the names of the Vserver (vserver), and volume (volume). A format which also includes the name of the cluster (cluster) is also provided for consistency with other snapmirror commands. The form of the pathname which includes the cluster name cannot be used when operating in a Vserver context.

| -destination-vserver <vserver name> - Destination Vserver

Specifies the destination Vserver of the SnapMirror relationship. If this parameter is specified, parameter -destination-volume must also be specified.

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

Specifies the destination volume of the SnapMirror relationship. If this parameter is specified, parameter -destination-vserver must also be specified.

[-relationship-info-only [true]] - Remove relationship info only (skip cleanup of snapshots)

If this parameter is specified, the cleanup of Snapshot copies is bypassed and only the source relationship information is removed. It is recommended to specify this parameter only when the source volume is not accessible.

[-relationship-id <UUID>] - Relationship ID

This optional parameter specifies the relationship identifier of the relationship. It must be specified when information for more than one relationship with the same source and destination paths is present.

[-force | -f [true]] - Force

If this parameter is specified, the command proceeds without prompting for confirmation.

Examples

To release the source information for the SnapMirror relationship with the destination endpoint vs2.example.com:dept_eng_dp_mirror4, type the following command:

vs1.example.com::> snapmirror release
        -destination-path vs2.example.com:dept_eng_dp_mirror4

To release the source information for the SnapMirror relationship with the destination endpoint vs2.example.com:dept_eng_dp_mirror4, and relationship-id 5f91a075-6a72-11e1-b562-123478563412, type the following command:

vs1.example.com::> snapmirror release
       -destination-path vs2.example.com:dept_eng_dp_mirror4
       -relationship-id 5f91a075-6a72-11e1-b562-123478563412

snapmirror release

Description

Parameters

Examples

See Also