User manual QUANTUM STORNEXT 3.1.4.1 CLI REFERENCE GUIDE REV A

[. . . ] CLI Refernce Guide CLI Reference Guide CLI Reference Guide StorNext 3. 1. 4. 1® StorNext 6-01688-11 StorNext CLI Reference Guide, 6-01688-11 Rev A, May 2010, Product of 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. Quantum Corporation may revise this publication from time to time without notice. Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law. [. . . ] 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. Command Syntax fsclassinfo [ class ] [ -l ] StorNext 3. 1. 4. 1 CLI Reference Guide 33 StorNext Command Line Commands Storage Manager Commands Options / Arguments Table 16 lists options and arguments for the fsclassinfo command. Table 16 Options and Arguments: fsclassinfo Options / Arguments [ class ] Description The policy class or classes to be listed. If no class is specified, a short report for all policy classes is displayed. Display the long report format, including processing parameters, directory paths, and the disk affinity list for the policy class. [ -l ] 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 17 lists options and arguments for the fsclassrnm command. Table 17 Options and Arguments: fsclassrnm Options / Arguments oldclass Description The name of the policy class to be changed. (Maximum of 16 characters. ) StorNext 3. 1. 4. 1 CLI Reference Guide 34 StorNext Command Line Commands Storage Manager Commands Options / Arguments newclass Description The name of the new policy class. (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 -p filename fsclean -b Table 18 lists options and arguments for the fsclean command. Table 18 Options and Arguments: fsclean Options / Arguments -m mediaID -s filesystem -c class Description The media identifier(s) to clean. Separate multiple policy classes with a space. StorNext 3. 1. 4. 1 CLI Reference Guide 35 StorNext Command Line Commands Storage Manager Commands Options / Arguments [ -t endtime ] Description Endtime option. 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). -r Cleans all Tertiary Manager knowledge of files on media where rminfo processing has been done. The file filename contains a list of files that need to be retrieved so missing copies can be regenerated. Cleans all online blockletized storage disk media. [ -l ] -p filename -b fsdirclass The fsdirclass command is used to display the policy class associated with the specified directory. Command Syntax fsdirclass directory Options / Arguments Table 19 lists options and arguments for the fsdirclass command. 36 StorNext 3. 1. 4. 1 CLI Reference Guide StorNext Command Line Commands Storage Manager Commands Table 19 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 20 lists options and arguments for the fsdrvclean command. Table 20 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. 37 StorNext 3. 1. 4. 1 CLI Reference Guide StorNext Command Line Commands Storage Manager Commands Command Syntax fsfilecopy -r filename -d destinationmediaID [ -c copynum ] fsfilecopy -r filename [ -b ] [ -t mediatype ] [ -c copynum ] Options / Arguments Table 21 lists options and arguments for the fsfilecopy command. Table 21 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. filename -d destinationmediaID [ -c copynum ] [ -b ] 38 StorNext 3. 1. 4. 1 CLI Reference Guide StorNext Command Line Commands Storage Manager Commands Options / Arguments [ -t mediatype ] Description Defines the type of media to be used for replacement. Valid values: · AIT · AITW · LTO · LTOW · SDISK · DDISK · 3590 · 3592 · 9840 · 9940 · T10K · DLT4 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 filename Options / Arguments Table 22 lists options and arguments for the fsfileinfo command. StorNext 3. 1. 4. 1 CLI Reference Guide 39 StorNext Command Line Commands Storage Manager Commands Table 22 Options and Arguments: fsfileinfo Options / Arguments filename Description Path and filename of the file(s) to report on. Separate multiple file names with a space. 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 medium 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 23 lists options and arguments for the fsmedcopy command. 40 StorNext 3. 1. 4. 1 CLI Reference Guide StorNext Command Line Commands Storage Manager Commands Table 23 Options and Arguments: fsmedcopy Options / Arguments mediaID Description The media identifier(s) to copy. Copies all files (active and inactive versions) from the source media. The value of the fill parameter is the percentage of the media that has been written, including active and inactive file versions. [. . . ] Default: 300016 [ -m ] [ -v ] [ -l ] [ -h ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V number ] Examples · Requests that the Media Manager software return information on every Media Class group known to the Media Manager system. No media-specific information is requested. StorNext 3. 1. 4. 1 CLI Reference Guide 73 StorNext Command Line Commands Storage Manager Commands 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 [ -Ih ] [ -H hostname ] [ -P priority ] [ -R retries ] [ -T timeout ] [ -V number ] Options / Arguments Table 47 lists options and arguments for the vsmedqry command. Table 47 Options and Arguments: vsmedqry Options / Arguments mediaID | -a Description Specifies a media type (mediaID) or all media (-a) to be queried. Default value: 15 Valid values: 1 to 32 [ -l ] [ -h ] [ -H hostname ] [ -P priority ] 74 StorNext 3. 1. 4. 1 CLI Reference Guide StorNext Command Line Commands Storage Manager Commands Options / Arguments [ -R retries ] Description Number of retries that the software attempts if a timeout is received. [. . . ]