|Legato Storage Manager Administrator's Guide
Release 9.0.1 for Windows NT and Windows 2000
Part Number A90174-01
You can use the
scanner program to re-create the LSM client index entries or re-create media database entries, if no entries for the volume exist in the media database. The
scanner program can read a storage volume directly, without assistance from LSM.
To find the volume that contains a specific file, use the
mminfo program if the volume is still in the media database or the
scanner program if the volume is no longer in the media database. The
scanner programs provide detailed information on the contents of the volume. This information includes:
scanner program reads a storage volume directly, without accessing information that may be available in the LSM media database. If no entries exist in the media database, you must make an educated guess as to which volume contains the specific data.
Mount the volume and run the
scanner command with any of its options. The most commonly used
scanner options are as follows:
-Nsave-set-name options, along with any other of the options previously described to further specify the save sets by client or name.
Detailed information about
scanner program syntax and examples of how
scanner options can be customized to meet the needs of a particular recovery situation are available in the
scanner entry in the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT. For details on how to access the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT, see "Legato Command Reference Guide".
The entries placed in the client index receive a status of "scanned-in" to protect them from being automatically deleted the next time the index management service checks the index for entries that have surpassed their browse policy. The entries placed in the media database also receive a status of "scanned-in" and the volume mode is listed as "read-only." These entries will need to be manually deleted.
scanner program directly reads LSM media (backup tapes) to confirm the contents of a volume or to rebuild the LSM online indexes. You can only run this command as Administrator or equivalent. You must specify a device, which is usually one of the device names used by the LSM Server. If the device is a tape drive, it must be a non-rewinding type.
scanner program is invoked without options (or with only the
-v option), the volume on the specified device is scanned and a table of contents is generated. The table of contents contains information about each save set found on the volume. By default, one line of information is produced for each save set found on the volume. The information provides the client name, save set name, save time, level, size, files, save set ID, and a flag.
The following example describes the format and options available for the
scanner [ -Bimnpqv ] [ -s server ] [ -S ssid ]
[ -c client ] [ -N name ] [ -f file ] [ -r record ]
[ -t type ] [ -b pool ] device [ -x command argument-list ]
-bpool option to specify the pool that the volume should belong to. This option only applies to volumes backed up by versions of LSM that did not store pool information on the media.
-Boption, without the
-Soption, to quickly scan the tape to the location of the start of the bootstrap save sets. When the entire tape has been scanned, the save set ID and tape file location of the most recent bootstrap save set is printed.
-cclient option to instruct
scannerto only process save sets that came from the computer specified by client. You can specify more than one client name in the same command line. The
-coption can also be used in conjunction with the
-Noption, but only if the
-xoption is also specified.
-ffile option to start the scan at a specific media file number. Refer to the
mminfoentry in the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT for information on how to determine the media file number. For details on how to access the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT, see "Legato Command Reference Guide".
-ioption to instruct
scannerto rebuild both the client index and media database from the volumes that are read. If you specify a single save set with the
-Sssid option, only the entries from the specified save set are made to the client index.
-moption to instruct
scannerto rebuild only the media database for the volumes that are read.
-noption to run
scannerwithout rebuilding the client index or media database. This option provides a way to check the media without modifying the client index or media database.
-Nname option to process only save sets that match the specified name. The value of name should be a literal string. You can specify multiple names when this option is used in conjunction with the
-cclient option, but only if the
-xoption is also specified.
-poption to print out information about each save set as it is processed.
-qoption to only display error messages or messages of significance.
-rrecord option to start the scan at a specific media record number, to avoid a scan of potentially unused information. Refer to the
mminfoentry in the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT for information on how to determine the media record number. For details on how to access the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT, see "Legato Command Reference Guide".
-sserver option to specify the controlling LSM Server.
-Sssid option to extract the save set specified by ssid. When this option is used in conjunction with the
-xoption, you can specify multiple ssid values. The save sets selected are in addition to any selected by the use of the
-Noptions. If the
-Boption is also specified, the value of ssid is assumed to be that of the bootstrap save set; only one ssid can be specified in this case.
-xcommand option, with an optional list of command arguments, to specify a command to run on each save set scanned. This option can only be specified once for each
scannercommand line, after the device specification.
Refer to the
scanner entry in the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT for examples of
scanner command usage and a list of common error messages.
If a file is not browsable (which means that the save set's browse policy has expired), but its save set is still tracked by LSM in the media database (which means that the save set's retention policy has not expired), follow these steps to recover the save set's entry back into the client index:
mminfo, find the save set ID that you believe contains the file you want. Make sure it is not the bootstrap save set ID.
If the save set that contains the file is not browsable, and the save set is not represented in the media database, both the browse and retention policies have expired. Follow these steps to rebuild the save set's entry in both the client index and the media database:
scannerprogram on the backup volume that you believe contains the file you want (make a guess based on the adhesive label on the volume).
scannerprogram to decide whether to reintroduce the contents of this volume into the client index and whether the save set you want to rebuild is on this volume. You must locate all of the volumes that contain this save set ID.
scanner command asks for a new volume until you terminate it. To rebuild the indexes completely, you must scan in all of the volumes that contain the save set ID.
If you use the
scanner program with the
-s option but without an
-m option, and you receive the following message:
the number in the bracket [xx] is the entry from the last query.
scanner command always rewinds the tape and reads the volume label to determine the block size. If the volume label is corrupted or unreadable, you will see a message asking you to enter the block size (in kilobytes).
Type in the block size; it must be an integer equal to or greater than 32. If you enter an integer that is less than 32, you receive the following message:
When you use the
scanner program to rebuild the index of a backup volume, the
scanner program marks the volume read-only. This is a safety feature that prevents the last save set on the backup volume from being overwritten. To write to the media without marking it read-only, use the
For more information on the
nsrmm command, refer to the
nsrmm entry in the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT. For details on how to access the Legato Storage Manager Command Reference Guide for Windows 2000 and Windows NT, see "Legato Command Reference Guide".