SnapMirror commands and configuration files

About SnapMirror commands

This section lists the Data ONTAP commands and configuration files associated with the SnapMirror features that are described in this chapter.

Commands to set up SnapMirror

You can use the following commands and configuration files to set up SnapMirror replication.

Command or File

Function

license add

Enables the SnapMirror license on the source and destination filers. See Entering license codes.

options snapmirror.access

or

/etc/snapmirror allow file

Specifies the host names of filers that are allowed to copy data directly from the source filer.

See Specifying destination filers on the source filer.

/etc/snapmirror.conf file

Specifies the destination volumes and qtrees to be replicated to and the schedule on which the destinations are updated. See Defining source and destination through snapmirror.conf.

snapmirror on

or

options snapmirror.enable

Enables SnapMirror on the source and destination filers. See Enabling SnapMirror.

vol create

and

vol restrict

In combination, create the restricted read-only volumes that are required as destinations for SnapMirror volume replications.

See Initializing a SnapMirror destination.

snapmirror initialize

Begins the initial complete (baseline) SnapMirror snapshot replication from a source volume or qtree to a destination volume or qtree.

See Initializing a SnapMirror destination for more information.

Command or File	Function
`license add`	Enables the SnapMirror license on the source and destination filers. See Entering license codes.
`options snapmirror.access` or /etc/snapmirror allow file	Specifies the host names of filers that are allowed to copy data directly from the source filer. See Specifying destination filers on the source filer.
/etc/snapmirror.conf file	Specifies the destination volumes and qtrees to be replicated to and the schedule on which the destinations are updated. See Defining source and destination through snapmirror.conf.
`snapmirror on` or `options snapmirror.enable`	Enables SnapMirror on the source and destination filers. See Enabling SnapMirror.
`vol create` and `vol restrict`	In combination, create the restricted read-only volumes that are required as destinations for SnapMirror volume replications. See Initializing a SnapMirror destination.
`snapmirror initialize`	Begins the initial complete (baseline) SnapMirror snapshot replication from a source volume or qtree to a destination volume or qtree. See Initializing a SnapMirror destination for more information.

SnapMirror management commands

You can use the following commands to perform SnapMirror management tasks:

Command or file	Function
`snapmirror update`	Performs a manual (unscheduled) update of the destination. See Updating a destination manually.
`snapmirror status`	Displays the status of SnapMirror data transfers. See Checking SnapMirror data transfer status.
/etc/log/snapmirror	Displays the SnapMirror data transfer history. See Checking SnapMirror data transfer logs.
`snapmirror abort`	Stops a transfer that is in progress. See Aborting a SnapMirror transfer.
/etc/snapmirror.conf	Enables you to specify or modify scheduled updates for one or more volumes or qtrees. See Turning off or changing scheduled updates for volumes or qtrees.

SnapMirror shutdown commands

You can use the following commands to temporarily or permanently shut down SnapMirror processes on a filer, volume or qtree:

Command	Function
`snapmirror off` or `options snapmirror.enable off`	Turns off SnapMirror functionality for a specified filer. See Turning off SnapMirror updates for the filer.
`snapmirror break`	Converts the destination to a writable volume or qtree, breaking the SnapMirror relationship between the source and destination. See Converting a destination to a writable volume or qtree.
`snapmirror release`	Releases for deletion SnapMirror snapshots on former source volumes or qtrees. See Releasing partners from a SnapMirror relationship.

Command

Function

snapmirror off

options snapmirror.enable off

Turns off SnapMirror functionality for a specified filer. See Turning off SnapMirror updates for the filer.

snapmirror break

Converts the destination to a writable volume or qtree, breaking the SnapMirror relationship between the source and destination. See Converting a destination to a writable volume or qtree.

snapmirror release

Releases for deletion SnapMirror snapshots on former source volumes or qtrees. See Releasing partners from a SnapMirror relationship.

SnapMirror advanced function commands

You can use the following commands to perform advanced functions with SnapMirror:

Command or File	Function
`snapmirror quiesce`	Stabilizes the contents of a destination just prior to a snapshot by allowing ongoing data transfers to finish and temporarily preventing new transfers from beginning. This action ensures a manual snapshot of a stable database. See Stabilizing (quiescing) destinations before taking a snapshot.
`snapmirror resume`	Resumes normal data transfer to a destination after it has been quiesced. See Resuming transfers after quiescing a destination.
`snapmirror resync`	Returns a former destination volume or qtree to the SnapMirror relationship after the `snapmirror break` command and resynchronizes its contents with the source without repeating the initial transfer. See Resynchronizing SnapMirror.
/etc/snapmirror.conf file `snapmirror initialize` `snapmirror destinations`.	These commands set up a cascading series of SnapMirror destinations. They make a uniform set of data available on a read-only basis to users from various locations throughout a network and they update that data uniformly at regular intervals. See Copying from one destination to another in a series (cascading).
`snapmirror store` and `snapmirror use`	These commands copy a volume to local tape and continue the backup on subsequent tapes if necessary. See SnapMirroring a volume to local tape.
`snapmirror retrieve` and `snapmirror use`	These commands initialize or restore a volume from local tape. See Initializing a SnapMirror destination via local tape.