SCANNER(8) Legato NetWorker 4.0 SCANNER(8)
NAME
scanner - NetWorker media verifier and index rebuilder
SYNOPSIS
scanner [ -imnvqh ] [ -s ssid ] [ -f file ] [ -r record ] [ -t type ]
[ -b pool ] device
DESCRIPTION
The scanner command directly reads NetWorker media, such as backup
tapes or disks, to confirm the contents of a volume, to extract a
save set from a volume, or to rebuild the NetWorker on-line indexes.
Only the super-user (root) may run this command. The device must
always be specified, and is usually one of the device names used by
the NetWorker server; for tape drives, it must be the name of a ``no-
rewind on close'' device.
When scanner is invoked with no options or just -v, the volume on the
indicated device is opened for reading, scanned, and a table of con
tents is generated. The table of contents contains information about
each save set found on the volume. By default, for each save set
found, one line of information is written to standard output, con
taining the client name, save set name, save time, level, size,
files, ssid and a flag. The client name is the name of the system
that created this save set. The name is the label given to this save
set by save(8), usually the path name of a file system. The save
time is the date and time the save set was created. The level values
are one-letter abbreviated versions of full, incremental, levels 0
through 9, or blank for ad-hoc saves. The size is the number of
bytes in the save set. The column labeled files gives the number of
client files contained in the save set. The ssid (save set identi
fier) is an identifier used internally to reference and locate this
save set. This same identifier may be specified explicitly with the
-s option to extract a particular save set.
The table of contents is based on synchronization (sometimes called
``note'') chunks (see mmdata(5)) interspersed with the actual save
set data. There are four types of note chunks: Begin, Continue, Syn
chronize, and End, symbolized by a flag of B, C, S or E respectively.
The Begin note is used to mark the start of a save set. At the time
a beginning chunk is written, the save set size and number of files
are not known. The Continue note is used to indicate that this save
set started on a different volume. The Synchronize note marks loca
tions in the save set where one may resume extracting data in the
event of previous media damage (a client file boundary). The End
note marks the end of the save set, and causes the table of contents
line to be printed. The other notes are displayed only when the -v
option is selected.
OPTIONS
-i Rebuild both the media and the on-line file indexes from the
volumes which are read. If you specify a single save set with
the -s ssid option, only entries for the specified save set
will be made to the on-line file index.
Licensed material--property of copyright holder(s) 1
SCANNER(8) Legato NetWorker 4.0 SCANNER(8)
-m Rebuild the media indexes for the volumes read.
-n Go through all the motions, but do nothing with regard to
media or index database rebuilding. When used with the -i
option, this provides the most complete media checking avail
able, while not modifying the databases at all.
-v Display more verbose messages, such as a log of each note
chunk, and a message after each hundred media records. When
the -i option is used, this prints out a line for each client
file, which can produce an enormous amount of output.
-q Display only errors or very interesting messages.
-h Try harder to read the media. Some media errors can be misin
terpreted as the end of tape. This option requires the user
to intercede whenever scanner is not making progress, by
pressing the interrupt key, and selecting the ``next volume''
option when prompted.
-s ssid
Extract the specified save set. The volume will be scanned
for save set ssid which will be written to the standard out
put. One of the NetWorker Application Specific Module (ASM)
programs may then be used in recover mode to process the save
set. Most often this will be the uasm(8) program.
-f file
Start the scan at the specific media file number. This can
save time and disk space by avoiding the scan of potentially
unused information. Since file numbers are stored in the
index itself, and scanner is needed to rebuild the index, this
option is normally not usable. This option does not make
sense on some kinds of media, such as optical disks, for exam
ple.
-r record
Start the scan at the specific media record number. This can
save time and disk space by avoiding the scan of potentially
unused information. Since record numbers are stored in the
index itself, and scanner is needed to rebuild the index, this
option is normally not usable.
-t type
Specify the type of media (for example, optical for an optical
disk, or 8mm for an 8mm tape). Normally the type is obtained
from the NetWorker server, if one of the known devices is used
(see nsrdevice(5)).
-b pool
Specify which pool the volume should belong too. If this
option is omitted, the volume is designated as being part of
the Default pool.
Licensed material--property of copyright holder(s) 2
SCANNER(8) Legato NetWorker 4.0 SCANNER(8)
EXAMPLES
Verifying a tape:
scanner /dev/rmt/0
scanner: scanning 8mm tape mars.001 on /dev/rmt/0
client name save set save time level size files ssid S
earth /usr/etc 04/20/92 11:16 4209992 146 20880783 S
mars / 02/14/93 21:12 5 4326980 599 637475596 E
venus / 02/14/93 21:06 f 4478460 621 637475595 E
mars /usr 02/14/93 21:13 i 166918900 9065 637475597 E
mars /home/mars 02/14/93 21:14 i 109661320 8025 637475598 E
scanner: reached end of 8mm tape mars.001
Rebuilding the on-line file index from a tape:
scanner -i /dev/rmt/8
scanner: scanning 4mm tape monday.fulls on /dev/rmt/8
scanner: ssid 17458697: scan complete
scanner: ssid 17458694: scan complete
scanner: ssid 17458698: scan complete
scanner: ssid 17458693: NOT complete
scanner: reached end of 4mm tape monday.fulls
scanner: when next tape is ready, enter device name [/dev/rmt/8]?
Extracting a save set for /usr and relocating to /mnt:
scanner -s 63674857 /dev/rmt/0 | uasm -rv -m /usr=/mnt
SEE ALSO
mmdata(5), nsrmmdbasm(8), nsr(8), nsrindexasm(8), nsrmmd(8),
nsrdevice(5), uasm(8).
DIAGNOSTICS
xdr conversion error, fn %d, rn %d, chunk %d out of %d
unexpected file number, wanted %d got %d
unexpected record number, wanted %d got %d
All three preceding messages are indicative of media errors -
tape blocks are either lost or damaged. In the case of an xdr
conversion error, a non-zero ``chunk'' number means that the
block may be partially salvageable. The case of an unexpected
file number is normal when scanner reaches the logical end of
a tape which has been recycled.
unexpected volume id, wanted volid1 got volid2
This message will normally appear when running in verbose mode
on a tape or disk that has been recycled. It does not indi
cate an error condition, but just details the conditions nor
mally treated as the end of the volume.
Licensed material--property of copyright holder(s) 3
SCANNER(8) Legato NetWorker 4.0 SCANNER(8)
ssid %d: finished, but incomplete
Scanner has detected the end of a save stream, but the stream
was aborted. Therefore, it is of dubious value. If on-line
indexes are being rebuilt, the end of the aborted stream may
precipitate the next message.
(ssid %d): error decoding save stream
As indexes are being rebuilt, scanner detected that the bytes
in the save stream are invalid. This is usually caused by
processing an aborted save stream. Other causes may include a
damage tape. Once this condition is detected, the process
rebuilding the indexes for the particular save stream exists;
this may precipitate the next message.
write failed, Broken pipe
Printed by scanner when a process rebuilding a save stream's
indexes exits before consuming the entire stream.
must be run by super-user
A normal (non-root) user tried to invoke this command.
cannot convert `arg' to a file number
The -f and -r options take a numeric argument for the starting
file or record number of the media.
already exists in the media index
The -i or -m option was specified and the volume was already
listed in the media database. This message is purely informa
tional, and means that the volume is not being added to the
media database because it is already listed there.
(type %s) (media %s) (volume name %s) is in pool pool1, not pool2
The volume, which was found in the media database, is associ
ated with the pool pool1, instead of the pool specified on the
command line (pool2). If you loaded the wrong volume, re-run
scanner after loading the correct volume. If you entered the
wrong pool name, then just run scanner without the -b option.
Licensed material--property of copyright holder(s) 4