SCANNER(8) Legato NetWorker 3.0 SCANNER(8)
NAME
scanner - NetWorker media verifier and index rebuilder
SYNOPSIS
scanner [ -imvqh ] [ -s ssid ] [ -f file ] [ -r record ] [ -t type ]
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 the
``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, contain
ing 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 cre
ated this save set. The name is the label given this save set by
save(8), usualy 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 identifier) 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 3.0 SCANNER(8)
-m Rebuild the media indexes for the volumes read.
-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)).
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
Licensed material--property of copyright holder(s) 2
SCANNER(8) Legato NetWorker 3.0 SCANNER(8)
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
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.
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.
Licensed material--property of copyright holder(s) 3