User manual QUANTUM STORNEXT 4.1 CLI REFERENCE GUIDE REV A

[. . . ] Quantum StorNext 4. 1 CLI Reference Guide Introduction Viewing man Pages File System Commands 5 5 6 cvadmin . 32 6-01688-14 Rev A, December 2010 *6-01688-14* Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 fsdrvclean . 62 Contacting Quantum 63 2 Contents Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 Made in the USA. Quantum Corporation provides this publication "as is" without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. [. . . ] · n - Database entries are not cleaned and the file is recoverable using fsrecover. [ -c <copies> ] Number of file copies to store (including the primary copy). This is the minimum number of bytes to leave on disk when files are truncated. Separate multiple file names with a space. [ -a <class> ] [ -S <stubsize> ] <filename> fschmedstate The fschmedstate command is used modify the state of media or the policy class to which the media belongs. Command Syntax fschmedstate <mediaID> [ -c <class> ] fschmedstate <mediaID> [ -b ] fschmedstate <mediaID> [ -s <state> ] 28 Storage Manager Commands Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 Options / Arguments Table 15 lists options and arguments for the fschmedstate command. Table 15 Options and Arguments: fschmedstate Options / Arguments <mediaID> [ -c <class> ] [ -b ] [ -s <state> ] Description One or more media identifiers. · unmark - Unmark media that is marked Error or Check Out. fschstate The fschstate command is used to modify the state of all storage subsystems and drive components. Command Syntax fschstate <componentalias> -s <state> Options / Arguments Table 16 lists options and arguments for the fschstate command. Table 16 Options and Arguments: fschstate Options / Arguments <componentalias> Description Component alias name used to identify storage subsystems and drive components. During system configuration, the System Administrator specifies the values of the componentalias parameter. Storage Manager Commands 29 Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 Options / Arguments -s <state> Description Desired state of drive components or subsystems. Valid values (drive components): · MAINT · ON · OFF Valid values (subsystems): · ON · OFF fsclassinfo The fsclassinfo command is used to report policy class and, within each group, its processing parameters and directory paths. Command Syntax fsclassinfo [ -l ] [ <class> . . . ] Options / Arguments Table 17 lists options and arguments for the fsclassinfo command. Table 17 Options and Arguments: fsclassinfo Options / Arguments [ -l ] Description Display the long report format, including processing parameters, directory paths, and the disk affinity list for the policy class. If no class is specified, a short report for all policy classes is displayed. [ <class> . . . ] fsclassrnm The fsclassrnm command is used to rename an existing policy class. This causes all files and media that were in the old class to be assigned to the new class. Command Syntax fsclassrnm <oldclass> <newclass> Options / Arguments Table 18 lists options and arguments for the fsclassrnm command. 30 Storage Manager Commands Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 Table 18 Options and Arguments: fsclassrnm Options / Arguments <oldclass> <newclass> Description The name of the policy class to be changed. (Maximum of 16 characters. ) fsclean The fsclean command is used to remove inactive file versions. Command Syntax fsclean -m <mediaID> [ -t [ <endtime> ] ] fsclean -s <filesystem> [ -t [ <endtime> ] ] fsclean -c <class> [ -t [ <endtime> ] ] fsclean -t [ <endtime> ] fsclean -r [ -l ] fsclean -r [ <mediaID> ] -p <filename> Table 19 lists options and arguments for the fsclean command. Table 19 Options and Arguments: fsclean Options / Arguments -m <mediaID> -s <filesystem> -c <class> Description The media identifier(s) to clean. The value of this parameter should be less than or equal to the current time. Format is: YYYY:MM:DD:hh:mm:ss The default is the current time (all inactive versions removed for all times). [ -t <endtime> ]> -r [ <mediaID> ] Cleans all Tertiary Manager knowledge of files on media where rminfo processing has been done. If a mediaID is specified, then processing is restricted to only that media. Displays a list of all media where rminfo processing has been done. [ -l ] Storage Manager Commands 31 Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 Options / Arguments -p <filename> Description Valid only with -r option. The file filename contains a list of files that need to be retrieved so missing copies can be regenerated. fsdirclass The fsdirclass command is used to display the policy class associated with the specified directory. Command Syntax fsdirclass <directory> Options / Arguments Table 20 lists options and arguments for the fsdirclass command. Table 20 Options and Arguments: fsdirclass Options / Arguments <directory> Description The directory path for which the associated policy class is returned. (The path must be less than 256 characters. ) fsdrvclean The fsdrvclean command is used to clean the specified drive. Command Syntax fsdrvclean <drivealias> Options / Arguments Table 21 lists options and arguments for the fsdrvclean command. Table 21 Options and Arguments: fsdrvclean Options / Arguments <drivealias> Description The alias of the drive to clean. If the drive alias contains spaces, use single quotes around the string. (Use the fsstate command to list the set of drive aliases. ) 32 Storage Manager Commands Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 fsfilecopy The fsfilecopy command is used to replace the primary copy (or a specified copy) of a file on a piece of media by duplicating it on another piece of media. Command Syntax fsfilecopy -r <filename> -d <destinationmediaID> [ -c <copynum> ] fsfilecopy -r <filename> [ -b ] [ -t <mediatype> ] [ -c <copynum> ] Options / Arguments Table 22 lists options and arguments for the fsfilecopy command. Table 22 Options and Arguments: fsfilecopy Options / Arguments -r Description Copies the file(s) filename to a piece of media and deletes all corresponding file(s) on the original piece of media. (If not specified, the primary copy is replaced. ) File(s) are copied to a blank piece of media. Valid values: · AIT · AITW · LTO · LTOW · SDISK · 3590 · 3592 · 9840 · 9940 · T10K · DLT4 <filename> -d <destinationmediaID> [ -c <copynum> ] [ -b ] [ -t <mediatype> ] Storage Manager Commands 33 Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 fsfileinfo The fsfileinfo command is used to report the current location of files, whether on disk, media, or not in the system. Command Syntax fsfileinfo [ -c ] <filename> Options / Arguments Table 23 lists options and arguments for the fsfileinfo command. Table 23 Options and Arguments: fsfileinfo Options / Arguments <filename> Description Path and filename of the file(s) to report on. Displays the checksum value generated for the file when stored. [ -c ] fsmedcopy The fsmedcopy command is used to duplicate the contents of non-blank media. [. . . ] Default: 3 Time interval (in seconds) that the software waits for status before returning a timeout. Default: 300016 [ -T <timeout > ] [ -V <number> ] Examples · Requests that the Media Manager software return information on every Media Class group known to the Media Manager system. vsmedclassqry -a · Requests that the Media Manager software return detailed information for every piece of media in the medclassh1user Media Class group. vsmedclassqry medclassh1user -m vsmedqry The vsmedqry command queries for the attributes of one or more specified media. Command Syntax vsmedqry <mediaID> | -a [ -I ] [ -h ] [ -H <hostname> ] [ -P <priority> ] [ -R <retries> ] [ -T <timeout> ] [ -V <number> ] Options / Arguments Table 48 lists options and arguments for the vsmedqry command. Storage Manager Commands 59 Quantum StorNext 4. 1 CLI Reference Guide 6-01688-14 Rev A December 2010 Table 48 Options and Arguments: vsmedqry Options / Arguments <mediaID> | -a Description Specifies a media type (mediaID) or all media (-a) to be queried. [. . . ]