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