6.2.8.11 snapshotfile
Create snapshots.
Purpose
The snapshotfile
command creates a snapshot of a file or group of
files.
Syntax
snapshotfile source1 target1 [ sourceN targetN ]... [ --exclude exclude-spec ]...
Command Options
The options for the snapshotfile
command are:
-
source1-N: Specifies the name of the file or files that are the snapshot source.
-
target1-N: Specifies the name of the file or files that are the snapshot destination.
-
--exclude
: Specifies the name of the file or files that are excluded from the snapshot operation.
Usage Notes
Note the following information when using this command:
-
You can use a wildcard (
*
) in the source to specify multiple source files, in which case the corresponding target must also contain a matching wildcard. -
All files in a snapshot operation must be in the same vault, otherwise and error is returned.
-
Multiple source and target pairs are permitted. In this case, the source file specifications are considered in order, and only the first match is used.
-
Files specified using the
--exclude
option are excluded from the snapshot operation. Such exclusions apply across all of the source and target pairs. -
If you specify a null (empty) string as a target value, no snapshots are created for the corresponding source. Specifying a null target is an alternative method of excluding files from the snapshot operation.
The source and null target is considered in order along with all other source and target pairs, and only the first match is used.
-
All snapshots created in the same operation are point-in-time consistent.
Examples
Example 6-105 Snapshot a File
This example shows creating a snapshot. The source file
@MYDATA/file-1
is and the snapshot is
@MYDATA/snap-file-1
.
@> snapshotfile @MYDATA/file-1 @MYDATA/snap-file-1
Example 6-106 Snapshot a Group of Files
This example shows creating snapshots for a group of files using a
wildcard. Assuming the existence of files named @MYDATA/file1
,
@MYDATA/file2
, and so on, the example creates a snapshot of
@MYDATA/file1
named @MYDATA/snap-dir/file1
,
@MYDATA/file2
named @MYDATA/snap-dir/file2
,
and so on.
@> snapshotfile @MYDATA/file* @MYDATA/snap-dir/file*
Example 6-107 Snapshot Multiple File Groups
This example shows creating snapshots for multiple groups of files using
wildcards. The source file groups are @MYDATA/a*
and
@MYDATA/b*
, with the resulting snapshots located under
@MYDATA/snap/
.
@> snapshotfile @MYDATA/a* @MYDATA/snap/a* @MYDATA/b* @MYDATA/snap/b*
Example 6-108 Ordering Significance
These examples show the significance of the order in which the source and target pairs are specified.
In the first command, the snapshots for files matching
@MYDATA/a*
are created in @MYDATA/snap/a
, and
the snapshots for the other files are created in
@MYDATA/snap/other
.
@> snapshotfile @MYDATA/a* @MYDATA/snap/a/a* @MYDATA/* @MYDATA/snap/other/*
In the following command, all of the snapshots are created in
@MYDATA/snap/other
because all of the files match
@MYDATA/*
. In this case, the second source and target pair is never
used.
@> snapshotfile @MYDATA/* @MYDATA/snap/other/* @MYDATA/a* @MYDATA/snap/a/a*
Example 6-109 Snapshot a Group of Files with Exclusions
The following examples show how to snapshot files in
@MYDATA
, except for those matching with
@MYDATA/a*
or @MYDATA/b*
.
@> snapshotfile @MYDATA/* @MYDATA/snap/* --exclude @MYDATA/a* --exclude @MYDATA/b*
@> snapshotfile @MYDATA/a* "" @MYDATA/b* "" @MYDATA/* @MYDATA/snap/*
Example 6-110 Invalid Commands
The following examples show invalid commands. The first and second commands are invalid because multiple vaults are referenced. The final command is invalid because the snapshot destination does not contain a wildcard to match the source specification.
@> snapshotfile @MYDATA/a* @MYDATABACKUP/a*
@> snapshotfile @MYDATA/a* @MYDATA/snap/a* @VAULT2/a* @VAULT2/snap/a*
@> snapshotfile @MYDATA/withwc* @MYDATA/snap/withoutwc
Parent topic: File Management