Command
Options
Description
Command
Options
Description
StorNext®
[ -m minstoretime ]
Minimum time (in minutes) that
a file must reside unmodified
on disk before being
considered a candidate for
storage on media.
[ class ]
One or more policy classes to
be listed.
Storage Manager
Version 2.7
[ -l ]
Long report - processing
parameters, directory paths,
and the disk affinity list for the
policy class.
[ -c mintrunctime ]
Minimum time (in days) that a
file must reside unaccessed on
disk before being considered a
candidate for truncation.
Syntax conventions:
•
•
italics = replace with a variable
[ ] = optional component
fsmodclass
Modifies the parameters of the
policy class.
[ -a affinity ]
Lists disk affinities that the files
in the policy class will traverse
in their lifecycle.
class
The policy class.
Policy Class Management
[ -d defaultcopies ]
Total number of copies to store
(including the primary) for
each file in the policy class.
[ -i minreloctime ]
Minimum time (in days) that a
file must reside unaccessed on
disk before being considered a
candidate for relocation.
Command
Options
Description
fsaddclass
Creates and defines a new
policy class.
[ -f i | p ]
File retention policy (-f) for the
policy class. Files can be:
[ -v drivepool ]
Media Manager drive pool
used to store or retrieve data
for the policy class.
WARNING: The file system
must be mounted and active
before running this command
or it will fail.
• i - Truncated immediately
• p - Truncated at policy
application time
[ -f i | p ]
File retention policy (-f) for the
policy class. Files can be:
[ -h hardlimit ]
Maximum number of media
allowed in the policy class.
class
The policy class (maximum of
16 alphanumeric characters).
• i - Truncated immediately
• p - Truncated at policy
application time
[ -l securitycode ]
Security code for the policy
class (up to 4 characters in
length).
[ -h hardlimit ]
[ -n notifyID ]
Maximum number of media
allowed in the policy class.
[ -r c | s ]
Media classification cleanup
action. When all files are
E-mail address of the user to
notify when the policy class’s
softlimit and hardlimit are
reached.
[ -m minstoretime ]
Minimum time (in minutes) that
a file must reside unmodified
on disk before being
deleted from a medium, the
medium can revert (-r) back to:
considered a candidate for
storage on media.
• c - Policy class blank pool
• s - System blank pool
[ -t mediatype ]
Defines the media type to use
for the policy class.
[ -c mintrunctime ]
[ -i minreloctime ]
[ -n notifyID ]
Minimum time (in days) that a
file must reside unaccessed on
disk before being considered a
candidate for truncation.
fsaddrelation
Adds a directory-to-policy
class association.
[ -l securitycode ]
Security code for the policy
class (up to 4 characters in
length).
Minimum time (in days) that a
file must reside unaccessed on
disk before being considered a
candidate for relocation.
[ -o acctnum ]
Account number for the policy
class (up to 5 characters in
length).
directory
Path name of the directory to
associate with the policy class.
WARNING: The command
fails if the directory has an
affinity associated with it. Use
the cvaffinity command to
remove its affinity.
E-mail address of the user to
notify when the policy class’s
softlimit and hardlimit are
reached.
[ -x maxcopies ]
[ -d defaultcopies ]
Maximum number of copies
(including the primary) allowed
for each file in the policy class.
Total number of stored copies
(including the primary) for
each file in the policy class.
This value cannot exceed the
maxcopies setting.
-c class
Policy class to associate with
the directory.
[ -o acctnum ]
Account number for the policy
class (up to 5 characters in
length).
NOTE: After the command
completes running
successfully, if the class has
any affinities, the directory has
its affinity set to the first affinity
in the class affinity list,
[ -r c | s ]
Media classification cleanup
action. When all files are
deleted from a medium, the
medium can revert (-r) back to:
[ -k maxversions ]
Maximum number of inactive
versions to keep for a file. The
minimum is 1 and the
maximum is 25.
• c - Policy class blank pool
• s - System blank pool
Default: 10
fsclassinfo
Reports policy class
processing parameters,
directory paths, and affinity
lists.
Page 1
Page 2
Page 3
File System Recovery
Command
Options
Description
Command
Options
Description
Command
Options
Description
fsrmdiskcopy
Removes a file copy from
disk after the file is stored to
media.
snrestore
Restores elements of a
StorNext Storage Manager
file system.
fsrecover
Reports or recovers files
that were removed from
disk.
filename
Full path and name of the
file copy to remove from
disk.
[ -p ]
Specifies a temporary
storage directory for
restored files.
filename
Name of the file to report
on. The name can be a file
name, a partial path name,
or a complete path name.
fsstore
Expedites storage of data
to media, instead of
allowing data migration by
SNMS software.
[ -h ]
[ -e ]
Displays usage.
dirname
Directory containing one or
more files to recover. The
name can be a directory
name, partial path, or full
path.
Extracts files to the
temporary storage
directory.
filename
Name of file on disk to store
to media.
[ -r ]
Uses files from this
directory to restore. No
files are restored from
media.
[ -c copies ]
[ -f i | p ]
Number of file copies to
store, including the primary.
restore_directory_path
[ RM_time::
]filepathname
Full path of the file to
recover. Optionally, you
can have a timestamp of
the form
YYYY:MM:DD:hh:mm:ss::/
stornext/smfs2/rel1/sub1/
file.a.
File retention policy (-f) for
the file. Files can be:
[ -c | cl component ]
Specifies the software files
restored. You can specify:
• i - Truncated immediately
• p - Truncated at policy
application time
• -c - Restore all software
configuration
dirpathname
Full path of the directory
containing file(s) to
recover.
information.
• -cl component - Restore
the specified software
component. Use the -h
option to find a list of
available components.
[ -t mediatype ]
[ -v drivepool ]
Defines the media type to
use for storage.
-u
-d
Indicates that recovery
processing is requested.
Specifies the Media
Manager drive pool group
used to store the file.
Indicates that directory
recovery processing is
requested.
[ -d | dj ]
Specifies the database
restore values. You can
specify:
[ -z minsize ]
Specifies the minimum file
size (in bytes) to store.
[ -p ]
Specifies that the user
report display entries for
which the user has
• -d - Restore database
and journal files.
fsversion
Specifies the file’s current
version(s).
• -dj- Restore only the
journal files and apply
them to the existing
database on the
permissions. If this option
is not specified, the report
to the user displays only
user-owned entries.
name
File for which the version
number will be checked.
system.
[ -h ]
[ -a ]
Displays usage.
[ -r ]
Indicates recursive
processing is requested.
[ -m | -mj [
filesystem_name ] ]
Specifies the file system
metadata restore values.
You can specify:
Lists all available versions
of the file (current and
inactive).
[ -t starttime [ endtime ] ] Indicates a time range to
restrict the length of the
user report. The format of
the starttime and endtime
parameters is:
• -m - Restore file system
metadata information
for all file systems or
for the selected
optional file system.
• -mj- Restore file system
journal information for
all file systems or for
the selected optional
file system.
[ -v ]
Verbose listing of the file’s
current version (version
number and modification
time).
YYYY:MM:DD:hh:mm:ss
[ -c ver ]
[ -f ]
Modifies the file’s current
version to the specified
inactive version.
[ -a ]
[ -v ]
Specifies active files rather
than recoverable files when
either reporting or
recovering a directory.
Forces the version change.
Specifies the verbose
mode during a recover
sequence. The system
reports on the recovered
files.
Page 7
Page 8
Page 9
Media Management
Command
Options
Description
Command
Options
Description
Command
Options
Description
[ -d destinationmediaID ]
Copies a data file to the
destination media
identifier.
[ -t ]
Indicates that detailed
information on all media
types associated with the
specified archive will be
reported.
fschmedstate
Modifies the state of
media or a policy class to
which the media belongs.
[ -b ]
Specifies blank media for
media destination.
mediaID
The media identifier.
For blank media:
[ -v ]
Indicates that all drives,
media classes, media,
and media types
associated with the
specified archive will be
reported.
[ -f fill ]
Specifies the fill level
threshold (between 0 and
100%).
[ -c class | -b ]
• Changes the name of
the associated policy
class (-c class)
[ -t mediatype ]
[ -u runtime ]
Defines media type to
use.
[ -I ]
Indicates that command
line options are read from
stdin.
- or -
Maximum allowable time
(in hours) for the
fsmedcopy command to
finish.
• Changes the policy
class to system blank
pool (-b).
[ -h ]
Requests help for the
entered command.
[ -w fragmentation ]
Percentage (0 to 100%)
of wasted space out of
filled space on media.
[ -H hostname ]
[ -P priority ]
Hostname of the Media
Manager server.
[ -s state ]
The media state. Valid
values are:
• unsusp
• protect
• unprotect
• avail
• unavail
• unmark
Execution priority of the
entered command.
fsmedinfo
Generates a report on
the specified media.
Default value: 15
Valid values: 1 to 32
mediaID
The media identifier.
[ -l ]
Generates the long-form
report which includes a
list of files on the media.
[ -R retries ]
[ -T timeout ]
Number of retries the CLI
software attempts if a
timeout is received.
fsclean
Removes inactive file
version information.
Default: 3
fsrminfo
Removes file information
from the SNMS
database.
-m mediaID
-s filesystem
-c class
The media identifier.
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
The file system to clean.
mediaID
The media identifier.
Policy class associated
with data to clean.
[ -f ]
Forces the removal of
database information.
Default: 120
-t [ endtime ]
Endtime option. This
parameter should be less
than or equal to the
current time. The format
of the endtime parameter
is:
vsarchiveqry
Queries for information
about an archive.
[ -V number ]
RPC program number for
the software.
Specifies the archive
(archivename) or all
archives (-a) to be
queried.
Default: 300016
archivename | -a
YYYY:MM:DD:hh:mm:ss
vsdriveqry
Queries for information
on the specified drive.
Default: current time
[ -c ]
Indicates that detailed
information on all media
classes associated with
the specified archive will
be reported.
fsdrvclean
fsmedcopy
Cleans the specified
drive.
driveID | -a
Indicates a specific drive
(driveID) or all drives (-a)
will be queried.
drivealias
The drive alias.
[ -I ]
Indicates that command
line options are to be
read from stdin.
Valid values: 1 to 255
characters
[ -d ]
Indicates that all drives
associated with the
specified archive will be
reported.
Copies, reports or
defragments media.
[ -h ]
Requests help for the
entered command.
[ -m ]
Indicates that all media
associated with the
specified archive will be
reported.
mediaID
The media identifier.
[ -H hostname ]
Hostname of the Media
Manager server.
[ -r ]
Initiates copy-replace for
a medium.
Page 10
Page 11
Page 12
Command
Options
Description
Command
Options
Description
Command
Options
Description
[ -P priority ]
Execution priority of the
entered command.
[ -T timeout ]
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
mediaID
Specifies a media type
(mediaID) or all media
(-a) to be queried.
Default value: 15
Valid values: 1 to 32
[ -l ]
Indicates that command
line options are to be
read from stdin.
Default: 120
[ -R retries ]
[ -T timeout ]
Number of retries the CLI
software attempts if a
timeout is received.
[ -V number ]
RPC program number for
the software.
[ -h ]
Requests help for the
entered command.
Default: 3
Default: 300016
[ -H hostname ]
[ -P priority ]
Hostname of the Media
Manager server.
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
vsmedclassqry
Queries for the attributes
of a media class.
Execution priority of the
entered command.
mediaclass
[ -m ]
Specifies a media class
(mediaclass) or all media
classes (-a) on which to
request information.
Default: 15
Default: 120
[ -R retries ]
[ -T timeout ]
Number of retries the CLI
software attempts if a
timeout is received.
[ -V number ]
RPC program number for
the software.
Requests a list of media
identifiers for all media
associated with each
reported media class.
Default: 300016
Default: 3
vsdrivevary
Changes a drive state.
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
[ -v ]
Requests detailed
driveID
Specifies the drive(s)
which state is to be
changed.
information for all media
associated with each
reported media class.
-p drivepool
Specifies the drive pool
for which associated
drives’ states will be
changed.
[ -I ]
Indicates that command
line options are to be
read from stdin.
Default: 120
[ -V number ]
RPC program number for
the software.
[ -H hostname ]
[ -P priority ]
Hostname of the Media
Manager server.
-s state
Specifies the target state
of the specified drive.
Default: 300016
Execution priority of the
entered command.
vspoolcfg
-p drivepool
-c driveID
Configures the specified
drive pool.
[ -v ]
Verbose listing (status
information) of changed
drives.
Default: 15
Valid values: 1 to 32
Creates a drive pool with
a list of drive identifiers.
[ -I ]
Indicates that command
line options are read from
stdin.
[ -R retries ]
[ -T timeout ]
Number of retries the CLI
software attempts if a
timeout is received.
-d
Deletes the drive pool.
-i driveID
Inserts drives into an
existing drive pool.
[ -h ]
Requests help for the
entered command.
Default: 3
-r driveID
Removes drives from an
existing drive pool.
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
[ -H hostname ]
[ -P priority ]
Hostname of the Media
Manager server.
[ -l ]
Indicates that command
line options are to be
read from stdln.
Execution priority of the
entered command.
Default: 120
Default: 15
Valid values: 1 to 32
[ -h ]
Requests help for the
entered command.
[ -V number ]
RPC program number for
the software.
[ -R retries ]
Number of retries the CLI
software attempts if a
timeout is received.
[ -H hostname]
[ -P priority ]
Hostname of the Media
Manager server.
Default: 300016
vsmedqry
Queries for the attributes
of one or more specified
media.
Default: 3
Execution priority of the
entered command.
Page 13
Page 14
Page 15
Command
Options
Description
[ -R retries ]
Number of retries
attempted if the software
receives a timeout.
[ -T timeout ]
[ -V number ]
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
RPC program number for
the software.
vsreclassify
Changes the media class
associated with the
specified media.
mediaID
Specifies one or more
media to reclassify.
-c currentmediaclass
Specifies the media class
with which specified
media are to be
associated.
-n newmediaclass
Specifies the new media
class with which the
specified media are to be
associated.
[ -v ]
[ -l ]
Specifies verbose output.
Indicates that CLI options
are to be read from stdin.
[ -h ]
Requests help for the
entered command.
[ -H hostname ]
[ -P priority ]
Hostname of the Media
Manager server.
Execution priority of the
entered command.
Default: 15
[ -R retries ]
[ -T timeout ]
Number of retries that the
software attempts if a
timeout is received.
Default: 3
Time interval (in
seconds) that the
software waits for status
before returning a
timeout.
Default: 120
[ -V number ]
RPC program number for
the software.
Default: 300016
Page 16
Page 17
Page 18
Reports and Queries
Command
Options
Description
Command
Options
Description
[ -s ]
Lists all suspect media.
fsfileinfo
Reports the current location of
files, whether of disk, media or
not in the system.
[ -d ]
[ -h ]
[ -t ]
Lists all media located in a
drive.
Lists all media located in its
home slot/bin.
filename
Full path and filename of the
file.
Lists all media transitioning
between locations.
fsqueue
View subsystem resource
requests.
[ -z ]
[ -o ]
Lists all media exiting a storage
area.
[-f ]
Reports all files in the queue or
specific files if request
identifiers or filenames are
specified.
Lists all media checked out of
storage areas.
[ -m ]
Reports media movement for a
request identifier or all media in
the queue.
fsstate
Reports the state of drive
components, storage
subsystem, and SNMS
software.
filename
Path and filename of the file.
[ componentalias ]
Alias for drives and storage
subsystems.
[ -r requestID ]
Identifier of the request to be
reported.
[ -f ]
Generates a report showing the
status of SNMS software.
Valid states are:
fsmedlist
Lists media in a data or storage
area.
[ -c class ]
[ -g ]
Policy class for which the report
is to be generated.
• Active
• Not Active
• Not Available
Reports on blank media in the
general scratch pool.
fsusedspace
Reports the total amount of
stored, primary copy data in the
SNMS system (in GB).
[ -l ]
Lists media in the long report
format.
[ -k ]
Lists all media marked for
check out.
Copyright © 1996-2006 by ADIC. All rights reserved.
6-00361-14 Rev A. ADIC Technical Assistance Center: in North America,
call toll-free: 1-800-827-3822; in Europe, call toll-free: 00800-9999-3822;
for a complete list of toll-free numbers by country. Technical Support:
[ -m ]
Lists all media marked for
removal.
[ -b ]
[ -f ]
[ -j ]
Lists unformatted blank media.
Lists formatted blank media.
Lists all media marked to
contain duplicate files.
[ -p ]
[ -q ]
[ -a ]
[ -n ]
Lists all write-protected media.
Lists media with mark error.
Lists all available media.
Lists all media unavailable to
SNMS software.
[ -u ]
Lists all media marked as
unavailable but still located in
SNMS system.
Page 1
Page 2
Page 3
|