Legato Storage Manager Administrator's Guide Release 3 (8.1.7) for Windows 2000 and Windows NT Part Number A85274-01 |
|
You can use the scanner
program to recreate the LSM client index entries or recreate 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 mminfo
and scanner
programs provide detailed information on the contents of the volume. This information includes:
The 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 execute the scanner
command with any of its options. The most commonly used scanner
options are as follows:
scanner -m
device.
scanner -i
device.
scanner -S
save-set-id -i
device.
scanner -S
save-set-id -m
device.
scanner
with -c
client-name
and -N
save-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 LSM Command Reference Guide. For details on how to access the LSM Command Reference Guide, 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.
The 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.
If the 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 written to standard output 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
program:
scanner [ -Bimnpqv ] [ -s server ] [ -S ssid ]
[ -c client ] [ -N name ] [ -f file ] [ -r record ]
[ -t type ] [ -b pool ] device [ -x command argument-list ]
-b
pool
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.
-B
option, without the -S
option, 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 to standard output.
-c
client
option to instruct scanner
to 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 -c
option can also be used in conjunction with the -N
option, but only if the -i
or -x
option is also specified.
-f
file
option to start the scan at a specific media file number. Refer to the mminfo
entry in the LSM Command Reference Guide for information on how to determine the media file number. For details on how to access the LSM Command Reference Guide, see "Legato Command Reference Guide".
-i
option to instruct scanner
to rebuild both the client index and media database from the volumes that are read. If you specify a single save set with the -S
ssid
option, only the entries from the specified save set are made to the client index.
-m
option to instruct scanner
to rebuild only the media database for the volumes that are read.
-n
option to run scanner
without rebuilding the client index or media database. This option provides a way to check the media without modifying the client index or media database.
-N
name
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 -c
client
option, but only if the -i
or -x
option is also specified.
-p
option to print out information about each save set as it is processed.
-q
option to only display error messages or messages of significance.
-r
record
option to start the scan at a specific media record number, to avoid a scan of potentially unused information. Refer to the mminfo
entry in the LSM Command Reference Guide for information on how to determine the media record number. For details on how to access the LSM Command Reference Guide, see "Legato Command Reference Guide".
-s
server
option to specify the controlling LSM Server.
-S
ssid
option to extract the save set specified by ssid. When this option is used in conjunction with the -i
or -x
option, you can specify multiple ssid values. The save sets selected are in addition to any selected by the use of the -c
and -N
options. If the -B
option 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.
-x
command
option, with an optional list of command arguments, to specify a command to execute on each save set scanned. This option can only be specified once per scanner
command line, after the device specification.
Refer to the scanner
entry in the LSM Command Reference Guide 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
program:
mminfo -a -v volume-name
mminfo
output, find the save set ID that you believe contains the file you want. Make sure it is not the bootstrap save set ID.
scanner
program:
scanner -i -S save-set-id device-name
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:
scanner
program on the backup volume that you believe contains the file you want (make a guess based on the adhesive label on the volume).
scanner device-name
scanner
program 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 below:
scanner -i device-name
The 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 -i
or -m
option, and you receive the following message:
please enter record size for this volume ('q' to quit) [xx]
the number in the bracket [xx] is the entry from the last query.
The 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:
illegal record size (must be an integer >=32)
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 nsrmm -o c
ommand:
# nsrmm -o notreadonly volume-name
For more information on the nsrmm
command, refer to the nsrmm
entry in the LSM Command Reference Guide. For details on how to access the LSM Command Reference Guide, see "Legato Command Reference Guide".
|
![]() Copyright © 1996-2000, Oracle Corporation. All Rights Reserved. |
|