Skip to main content

snapmirror release

Contributors
Suggest changes
PDFs

Remove source information for a SnapMirror relationship

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

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 volumes. It does not destroy any volumes or Vservers. This command must be used from the source Vserver or cluster.

For relationships with a policy of type strict-sync-mirror , it additionally resumes primary volume access if the IO was restricted because the relationship was OutOfSync.

For relationship having Application Consistency Groups, snapmirror release command used on the source of a Application Consistency Group relationship, removes the relationship information from the source side and deletes Snapshot copies which were created on the source volumes.

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.

This command is not supported for SnapMirror relationships with non-Data ONTAP endpoints.

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

Parameters

{ [-S, -source-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[app-cgname]>}] - Source Path

Specifies the source endpoint of the SnapMirror relationship in one of three formats. The normal format includes the names of the Vserver (vserver), and/or 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. For relationships between Application Consistency Groups, the source endpoint is specified in the form [vserver:]/cg/cg-name .

| [-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, 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>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[app-cgname]>} - Destination Path

Specifies the destination endpoint of the SnapMirror relationship in one of three formats. The normal format includes the names of the Vserver (vserver), and/or 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. For relationships between Application Consistency Groups the destination endpoint is specified in the form [vserver:]/cg/cg-name

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

Specifies the destination Vserver of the SnapMirror relationship. For relationships with volumes as endpoints, 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. This parameter is not supported for Vserver SnapMirror relationships.

[-f, -force <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

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

cluster1::> snapmirror release
       -destination-path dvs1.example.com:

To release the Application Consistency Group SnapMirror relationship with the destination Application Consistency Group cg_dst in Vserver vs2.example.com and the source Application Consistency Group cg_src in Vserver vs1.example.com , type the following command from the source cluster:

source::> snapmirror release
        vs2.example.com:/cg/cg_dst

To release just the source information but not remove the Snapshot copies that might be needed for a subsequent resync for the Asynchronous SnapMirror Application Consistency Group relationship with the destination Application Consistency Group cg_dst in Vserver vs2.example.com , type the following command:

vs2.example.com::> snapmirror release
       -destination-path vs2.example.com:/cg/cg_dst
       -relationship-info-only true

To release the SnapMirror active sync relationship with the destination Consistency Group cg_dst in Vserver vs2.example.com and the source Consistency Group cg_src in Vserver vs1.example.com , type the following command from the source cluster:

source::> snapmirror release
        vs2.example.com:/cg/cg_dst