User manual QUANTUM STORNEXT 3.5.2.1 CLI REFERENCE GUIDE REV A

[. . . ] Quantum StorNext 3. 5. 2. 1 CLI Reference Guide Introduction Viewing man Pages File System Commands 3 3 4 cvadmin . 29 Document 6-01688-12 Rev A, June 2010 Quantum StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 fsdrvclean . 59 Contacting Quantum 61 2 Contents StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 Introduction Quantum recommends using the GUI to complete most StorNext tasks, but there might be situations where you prefer or need to use the command line interface (CLI) instead. This document describes commonly used StorNext File System (SNFS) and StorNext Storage Manager (SNSM) commands. [. . . ] · 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. Valid values (drive components): · MAINT · ON · OFF Valid values (subsystems): · ON · OFF -s <state> fsclassinfo The fsclassinfo command is used to report policy class and, within each group, its processing parameters and directory paths. Storage Manager Commands 27 StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 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. 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> ] ] 28 Storage Manager Commands StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 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. The file filename contains a list of files that need to be retrieved so missing copies can be regenerated. [ -l ] -p <filename> 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. Storage Manager Commands 29 StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 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. ) 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. 30 Storage Manager Commands StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 Options / Arguments <filename> Description The path of the file(s) to replace. (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 -d <destinationmediaID> [ -c <copynum> ] [ -b ] [ -t <mediatype> ] 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. Storage Manager Commands 31 StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 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. Media duplication for replacement is intended for: · Media maintenance - if errors occur frequently when attempting to read or write to the media. · Media defragmentation - if the media is filled with unusable space due to deleted or modified files. Command Syntax fsmedcopy <mediaID> -r [ -a ] [ -d <destinationmediaID> ] [ -u <runtime> ] fsmedcopy <mediaID> -r [ -a ] [ -b ] [ -t <mediatype> ] [ -u <runtime> ] fsmedcopy [ <mediaID> ] [ -f <fill >] [ -w <fragmentation> ] Options / Arguments Table 24 lists options and arguments for the fsmedcopy command. Table 24 Options and Arguments: fsmedcopy Options / Arguments <mediaID> -r [ -a ] [ -d <destinationmediaID> ] [ -b ] Description The media identifier(s) to copy. Copies all files (active and inactive versions) from the source media. Specifies blank media for media destination. 32 Storage Manager Commands StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 Options / Arguments [ -f <fill> ] Description Specifies the fill level threshold (between 0 and 100%). [. . . ] Default value: 15 Valid values: 1 to 32 [ -R <retries> ] Number of retries that the software attempts if a timeout is received. Default value: 3 Time interval (in seconds) that the software waits for status before returning a timeout. Default value: 300016 [ -T <timeout> ] [ -V <number> ] vspoolqry The vspoolqry command is used to display information for a specified drive pool or for all drive pools. Command Syntax vspoolqry -a | <drivepool> [-v] [ -I ] [ -h ] [ -H <hostname> ] [ -P <priority> ] [ -R <retries> ] [ -T <timeout> ] [ -V <number> ] Options / Arguments Table 50 lists options and arguments for the vspoolqry command. 58 Storage Manager Commands StorNext 3. 5. 2. 1 CLI Reference Guide Document 6-01688-12 Rev A June 2010 Table 50 Options and Arguments: vspoolqry Options / Arguments -a <drivepool> [ -v ] [ -I ] [ -h ] [ -H <hostname> ] [ -P <priority> ] Description Displays information for all drive pools. Default: 15 Valid values: 1 to 32 [ -R <retries> ] Number of retries that the software attempts if a timeout is received. [. . . ]