Dell Solutions Enabler 10.0.0 TimeFinder SnapVX CLI User Guide

Description

The symsnapvx establish command creates and activates a SnapVX snapshot.

Syntax

symsnapvx establish [-secure <-delta <delta_time> | -absolute <date_time>> |
		 	                -ttl <-delta <delta_time> | -absolute <date_time>>]
                    [-both_sides]
                    [-preaction <ScriptFile>] [-postaction <ScriptFile>]

Options

-name <SnapshotName>

Snapshot name - case sensitive, maximum length of 32 alphanumeric character, dash (-) and underscore (_) are legal characters.

-ttl

Sets the time to live (TTL) for a snapshot either as a number of days plus hours or hours from the current host time, or to an absolute date and time in the future. When the TTL expires a snapshot is identified as expired. Only snapshots without links or restore sessions can be terminated. If the snapshot has links or restore sessions, it is terminated when the last link is unlinked or the restore session is terminated. TTL is set using the following options:

NOTE:Refer to the examples in Set SnapVX snapshot time to live (TTL) for TTL formatting rules.

-secure

Creates a secure snapshot with a secure expiration time for a snapshot either as a number of days plus hours, or hours from the current host time, or an absolute date and time in the future. Use extreme caution with this option. When the secure expiration time expires a snapshot is identified as expired. Only snapshots without links or restore sessions can be terminated. If the snapshot has links, it is terminated when the last link is unlinked. Secure expiration time is set using the following options:

NOTE:Refer to the examples in Set SnapVX snapshot time to live (TTL) for formatting rules for setting expiration time.

• -delta Days[:hours] — Sets secure expiration time to 1 – 400 days plus 0 –23 hours from current host time. Day format is days:hh (for hours, only whole numbers are valid and 0 value is optional).
• -absolute Date[:hour] — Sets secure expiration time to an absolute date in the future, up to a date 400 days from current host date, plus 0 –23 hours. Date format is MM/DD/YYYY:HH (for hours, only whole numbers are valid and 0 value is optional).

-both_sides

Valid with DG, SG, or CG. Performs SnapVX operation on both local and remote snapshots. The following rules apply when using this option:

• A mixture of R1 and R2 devices is not allowed.
• All the RDF devices in the SG must be in same RDF group.
• RDF pairs must be must be in Synchronous RDF mode and in Synchronous state, or in Active RDF mode and in ActiveActive or ActiveBias state.

-preaction <ScriptFile>

Executes the specified script before a snapshot is established.

-postaction <ScriptFile>

Executes the specified script after a snapshot is established, using the following options:

• -delta Days — Executes the specified script after 1 to 400 days.
• -absolute Date — Executes the specified script after a date that is up to 400 days in the future.

Examples

To establish a snapshot named 600am for the source devices specified in Storage Group1, enter:

symsnapvx -sid 001 -sg StorageGroup1 -name 600am establish

To establish a snapshot named 600am for source device 55, enter:

symsnapvx -sid 001 -dev 55 -name 600am establish

To establish a snapshot named 600am and automatically terminate it in 2 days 23 hours, enter:

symsnapvx -sid 001 -sg StorageGroup1 -name 600am establish -ttl -delta 2:23

To establish a secure snapshot named 600am and automatically terminate it at noon on June 1 2017, enter:

symsnapvx -sid 001 -sg StorageGroup1 -name 600am establish -secure -absolute 06/01/2017:12

Each time a new snapshot with the same name is created (on the same source device), the new snapshot becomes generation 0, and all of the previous generation numbers are incremented. SnapVX supports up to 256 manual snapshots per source device. A device can have total of 1024 snapshots including manual and automated policy snapshots, and legacy TimeFinder snapshots.