VSN Association Directives

The VSN associations section of the archiver.cmd file assigns volumes to archive sets. This section starts with a vsns directive and ends with an endvsns directive.

VSN associations can also be configured with the SAM-QFS Manager software. See the SAM-QFS Manager online help for more information.

Collections of volumes are assigned to archive sets by directives of the following form:

archive-set-name.copy-num media-type vsn-expr ... [-pool  /
vsn-pool-name ...]

An association requires at least three fields: archive-set-name and copy-num, media-type, and at least one volume. The archive-set-name and copy-num values are connected by a period (.).

Argument	Definition
archive-set-name	A site-defined name for the archive set.
copy-num	A digit followed by one or more arguments that specify archive characteristics for that copy. Archive copy directives begin with a digit. This digit (`1`, `2`, `3`, or `4`) is the copy number.
media-type	The media type. For a list of valid media types, see mcf(4) in Sun QFS and Sun Storage Archive Manager Reference Manual.
vsn-expr	A regular expression. See the `regexp`(5) man page.
`-pool` vsn-pool-name	A named collection of VSNs.

Note - If your SAM-QFS environment is configured to recycle by archive set, do not assign a VSN to more than one archive set.

Example 12-17 VSN Specifications on Multiple Lines

The following example shows two lines of VSN specifications.

vsns
set.1 lt VSN001 VSN002 VSN003 VSN004 VSN005
set.1 lt VSN006 VSN007 VSN008 VSN009 VSN010
endvsns

Example 12-18 VSN Specifications With a Continued Line

The following example shows a VSN specification that uses a backslash character "\" to continue a line onto a subsequent line.

vsns
set.1 lt VSN001 VSN002 VSN003 VSN004 VSN005 \
VSN006 VSN007 VSN008 VSN009 VSN010
endvsns

Example 12-19 VSN Specifications With Shorthand Notation

The following example specifies VSNs using a regular expression in a shorthand notation.

vsns
set.1 lt VSN0[1-9] VSN10
endvsns

When the archiver needs volumes for the archive set, it examines each volume of the selected media type in all automated libraries and manually mounted drives to determine whether the volume satisfies any VSN expression. It selects the first volume that matches an expression that contains enough space for the archive copy operation. For example:

The following directive specifies that files belonging to archive set ex_set for copy 1 be copied to media type mo using any of the 20 volumes with the names optic20 through optic39.
```
ex_set.1 mo optic[2-3][0-9]
```
The following directive specifies that files belonging to archive set ex_set for copy 2 be copied to media type lt using any volume beginning with TAPE:
```
ex_set.2 lt ^TAPE
```
Note - Make sure you assign volumes to the archive set used for the file system's metadata when setting up the archiver.cmd file. Each file system has an archive set with the same name as the file system. For more information about preserving metadata, see samfsdump(1M) in Sun QFS and Sun Storage Archive Manager Reference Manual.

Skip Navigation Links
Exit Print View
	Sun Storage Archive Manager 5.3 Configuration and Administration Guide Sun QFS and Sun Storage Archive Manager 5.3 Information Library