


SCANNER(8)                                             SCANNER(8)


NNAAMMEE
       scanner - NetWorker media verifier and index rebuilder

SSYYNNOOPPSSIISS
       ssccaannnneerr [ --BBiimmnnppqqvv ] [ --ss _s_e_r_v_e_r ] [ --SS _s_s_i_d ] [ --cc _c_l_i_e_n_t
       ] [ --NN _n_a_m_e ] [ --ff _f_i_l_e ] [ --rr _r_e_c_o_r_d ] [ --tt _t_y_p_e ]  [  --bb
       _p_o_o_l ] _d_e_v_i_c_e [ --xx _c_o_m_m_a_n_d _a_r_g _._._.  ]

DDEESSCCRRIIPPTTIIOONN
       The  ssccaannnneerr command reads NetWorker media, such as backup
       tapes or disks, directly to confirm the contents of a vol-
       ume,  to  extract  a save set from a volume, or to rebuild
       the NetWorker online indexes.  Only the  super-user,  root
       or  Administrator  can  run this command.  The _d_e_v_i_c_e 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 ssccaannnneerr is invoked with either no options or --vv,  the
       volume  on  the  indicated  _d_e_v_i_c_e  is opened for reading,
       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 con-
       taining the client name, save set name, save time,  level,
       size, files, ssid and a flag.  The cclliieenntt nnaammee is the name
       of the system that created this save set.  The nnaammee is the
       label  given to this save set by ssaavvee(8), usually the path
       name of a file system.  The ssaavvee ttiimmee is the date and time
       the save set was created.  The lleevveell values are one-letter
       abbreviated  versions  of  ffull,  iincremental,  levels   00
       through  99,  or  blank  for manual saves.  The ssiizzee is the
       number of bytes in the save set.   The  ffiilleess  labeled  by
       column provide the number of client files contained in the
       save set.  The ssssiidd (save set identifier) is an identifier
       used  internally  to  reference  and locate this save set.
       This same identifier may be specified explicitly with  the
       --SS option to extract a particular save set.

       The  table  of contents is based on synchronization (some-
       times called "note") _c_h_u_n_k_s (see mmmm__ddaattaa(5))  interspersed
       with  the  actual  save set data.  There are four types of
       note chunks: Begin, Continue, Synchronize, and  End,  sym-
       bolized by a _f_l_a_g of B, C, S or E respectively.  The BBegin
       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  CContinue  note  is  used  to
       indicate that this save set started on a different volume.
       The SSynchronize note marks locations in the save set where
       one  may  resume  extracting data in the event of previous
       media damage (a client file boundary).  The EEnd 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 --vv option is selected.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





SCANNER(8)                                             SCANNER(8)


OOPPTTIIOONNSS
       --bb _p_o_o_l
              Specifies  which pool the volume should belong too.
              This option only applies for versions of  NetWorker
              that  do  not  store  the  pool  information on the
              media.  For these versions, you might need to spec-
              ify  the  media pool the volume should belong to if
              the user does not want the volume to be a member of
              the  _D_e_f_a_u_l_t  pool.   For  volumes  where  the pool
              information is stored on the media, the media  must
              be  relabeled (destroying all data on the media) to
              assign the media to a different pool.

       --BB     When used in absence  of  the  --SS  option,  ssccaannnneerr
              quickly  scans  the tape for the start of bootstrap
              save sets.  The program only reads the first record
              at each file mark on the media to see if a save set
              with the name "bootstrap" exists.  When the  entire
              media  has been exhausted, the save set id and file
              location of the most recent bootstrap save  set  is
              printed.   When  used  in conjunction  with the --SS,,
              option the save set id specified is flagged as that
              of a bootstrap.

       --cc _c_l_i_e_n_t
              Only processes save sets that come from a NetWorker
              client machine.  This option can be  used  multiple
              times  and  in  conjunction with the --NN ooppttiioonn,, but
              only in presence of the --ii or --xx option.

       --ff _f_i_l_e
              Starts the scan at the specific media file  number.
              This  can  save time by avoiding the scan of poten-
              tially unused information if the entire  volume  is
              not  being  scanned  and  you  happen  to know from
              already existing NetWorker media  information  (see
              mmmmiinnffoo(8)) where the area of interest on the volume
              starts.  This option does not make  sense  on  some
              kinds  of  media,  such  as  optical disks and file
              device types, for example.

       --ii     Rebuilds both the media and the online file indexes
              from  the  volumes  read.   If you specify a single
              save set with the --SS _s_s_i_d option, only entries  for
              the  specified  save  set are copied to the on-line
              file index.

       --mm     Rebuild the media indexes for the volumes read.

       --nn     Go through all the motions,  but  do  nothing  with
              regard to media or index database rebuilding.  When
              used with the --ii option, this option  provides  the
              most  complete  media checking available, while not
              modifying the databases at all.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





SCANNER(8)                                             SCANNER(8)


       --NN _n_a_m_e
              Only processes save sets specified by _n_a_m_e (a  lit-
              eral  string only).  This option can be used multi-
              ple times and in conjunction with  the  --cc  option,
              but only in presence of the --ii or --xx option.

       --pp     Prints  out  information save set notes as they are
              processed.

       --qq     Displays only errors or important messages.

       --rr _r_e_c_o_r_d
              Starts the scan at the specific media  record  num-
              ber.   This  can  save time by avoiding the scan of
              potentially unused information if the entire volume
              is  not  being  scanned and you happen to know from
              already existing NetWorker media  information  (see
              mmmmiinnffoo(8)) where the area of interest on the volume
              starts.

       --ss _s_e_r_v_e_r
              Specifies the controlling server when using ssccaannnneerr
              on  a  storage  node.   See nnssrr__ssttoorraaggee__nnooddee(5) for
              additional detail on storage nodes.

       --SS _s_s_i_d
              Extracts the specified save set(s).  When used with
              the --ii or --xx option, this option can be used multi-
              ple times and is  in  addition  to  any  save  sets
              selected  using  the --cc and --NN options.  Otherwise,
              the volume is scanned for save set _s_s_i_d_, which will
              be written to the standard output.  Most often this
              is piped to a uuaassmm(8) program  running  in  recover
              mode  to  process  the save set (potentially with a
              directory list to limit the files to  be  recovered
              and potentially using a --mm argument to map the file
              location).  When using --SS without --ii or --mm,, scanner
              prompts  for  the  volume  block size if the volume
              label is not readable.  If the  volume  information
              is  still  in  the media database, the user has the
              option  of  running  recover  by  save   set   (see
              rreeccoovveerr(8)).   When  --BB  is also specified, _s_s_i_d is
              taken to be that of a bootstrap.  Only one ssid  is
              allowed in this case.

       --tt _t_y_p_e
              Specifies  the  type of media, for example, _o_p_t_i_c_a_l
              for an optical disk, or _8_m_m  _5_G_B  for  an  8mm  5GB
              tape).   Normally  the  media type is obtained from
              the NetWorker server, if a known  device  is  being
              used (see nnssrr__ddeevviiccee(5)).

       --vv     Displays  more  verbose  messages, such as a log of
              each note chunk, and  a  message  after  every  100



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





SCANNER(8)                                             SCANNER(8)


              media  records.  When the --ii option is used, a line
              is printed   for  each  client  file  (an  enormous
              amount of output can be produced).

       --xx _c_o_m_m_a_n_d _a_r_g _._._.
              Specifies an arbitrary UNIX command to process each
              new selected save  set.   This  argument  can  only
              occur  once  at the end of the argument list (after
              _d_e_v_i_c_e_).  The save stream for each save set is con-
              nected  to a new instance of the stdin for the com-
              mand.  Most often this command is  uuaassmm(8)  running
              in  recover  mode  to process each save set (poten-
              tially using a --mm argument to map  the  file  loca-
              tion).   If  the volume information is still in the
              media database, the user has the option of  running
              recover by save set (see rreeccoovveerr(8)).

EEXXAAMMPPLLEESS
       _V_e_r_i_f_y_i_n_g _a _t_a_p_e:

              scanner /dev/nrst0

       scanner: scanning 8mm tape mars.001 on /dev/nrst0

       client name   save set   save time  level        size   files    ssid S
       space         /export    10/07/94 12:38 f   100762460   10035   16983 E
       space         /usr       10/07/94 13:14 f    27185116    3185   16984 E
       space         /nsr       10/07/94 12:40 f    77292280    8436   16980 S
       space         /          10/07/94 13:22 f     1693192     518   16985 S
       scanner: reached end of 8mm tape mars.001

       _R_e_b_u_i_l_d_i_n_g _t_h_e _o_n_-_l_i_n_e _f_i_l_e _i_n_d_e_x _f_r_o_m _a _t_a_p_e:

              scanner -i /dev/nrst8

       scanner: scanning 4mm tape monday.fulls on /dev/nrst8
       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/nrst8]?

       _E_x_t_r_a_c_t_i_n_g _a _s_a_v_e _s_e_t _f_o_r _/_u_s_r _a_n_d _r_e_l_o_c_a_t_i_n_g _t_o _/_m_n_t:

              scanner -S 637475597 /dev/nrst8 | uasm -rv -m /usr=/mnt
                                                                   or
              scanner -S 637475597 /dev/nrst8 -x uasm -rv -m /usr=/mnt

       _E_x_t_r_a_c_t_i_n_g  _a_l_l  _s_a_v_e _s_e_t_s _f_r_o_m _c_l_i_e_n_t _m_a_r_s _a_n_d _r_e_l_o_c_a_t_i_n_g
       _t_o _/_a:

              scanner -c mars /dev/nrst8 -x uasm -rv -m/=/a



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





SCANNER(8)                                             SCANNER(8)


SSEEEE AALLSSOO
       mmmm__ddaattaa(5), mmmmiinnffoo(8),  nnssrrmmmmddbbaassmm(8),  nnssrr(8),  nnssrriinnddeexx--
       aassmm(8),   nnssrrmmmmdd(8),  nnssrr__ddeevviiccee(5),  nnssrr__ssttoorraaggee__nnooddee(5),
       uuaassmm(8).

DDIIAAGGNNOOSSTTIICCSS
       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 dam-
              aged).  In the case of an xdr conversion  error,  a
              non-zero "chunk" number means that the block may be
              partially salvageable.  Unexpected file numbers are
              normal  when ssccaannnneerr reaches the logical end of the
              media that has been recycled.

       ccoonnttiinnuuaattiioonn ooff ddaattaa iinn nnssrrssccaann.._N_N_N_N_N.._M_M_M_M_M_M
              After an XDR decode error (an error denoted by  one
              or  more  of the messages described above), ssccaannnneerr
              attempts to re-synchronize and send the rest of the
              stream.  However, because programs like uuaassmm(8) are
              unable to handle decoding streams with parts  miss-
              ing  in  the middle, scanner sends the remainder of
              the stream to a file.  You can decode  this  stream
              manually.   For  example,  if your original command
              was:
                   scanner -S ssid | uasm -r
              and a synchronization error occurs, you can  decode
              the rest of the stream with the following command:
                   uasm -r < nsrscan._N_N_N_N_N._M_M_M_M_M_M
              where  the  file  name you enter corresponds to the
              name printed in the diagnostic message.

       uunneexxppeecctteedd vvoolluummee iidd,, wwaanntteedd _v_o_l_i_d_1 ggoott _v_o_l_i_d_2
              This message normally appears when running in  ver-
              bose mode on a tape or disk that has been recycled.
              It  does  not  indicate  an  error  condition,  but
              details  the conditions normally treated as the end
              of the volume.

       ssssiidd %%dd:: ffiinniisshheedd,, bbuutt iinnccoommpplleettee
              SSccaannnneerr has detected the end of a save stream,  but
              the  stream  was  aborted, and is of dubious value.
              If online indexes are being rebuilt, the end of the
              aborted stream may precipitate the next message.

       ((ssssiidd %%dd)):: eerrrroorr ddeeccooddiinngg ssaavvee ssttrreeaamm
              As indexes are being rebuilt, ssccaannnneerr 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  damaged  tape.
              Once  this  condition  is  detected, the process of
              rebuilding the  indexes  for  the  particular  save



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





SCANNER(8)                                             SCANNER(8)


              stream  begins.  This may precipitate the next mes-
              sage.

       wwrriittee ffaaiilleedd,, BBrrookkeenn ppiippee
              Printed by ssccaannnneerr when a process rebuilding a save
              stream's  indexes exits before consuming the entire
              stream.

       mmuusstt bbee rruunn bbyy ssuuppeerr--uusseerr
              A normal (non-root) user tried to invoke this  com-
              mand.

       ccaannnnoott ccoonnvveerrtt  _a_r_g"" ttoo aa ffiillee nnuummbbeerr""
              The  --ff  and  --rr options require a numeric argument
              for the starting  file  or  record  number  of  the
              media.

       aallrreeaaddyy eexxiissttss iinn tthhee mmeeddiiaa iinnddeexx
              The  --ii  or  --mm option was specified and the volume
              was already listed in  the  media  database.   This
              message is purely informational, and means that the
              volume is not being added  to  the  media  database
              because it is already listed there.

       fn %d rn 0 read error I/O error
       fn %d rn 0 read error I/O error
       done with _t_a_p_e___t_y_p_e ttaappee vvoolliidd _v_o_l_u_m_e___n_a_m_e
              These messages, when occurring together on AIX, are
              a consequence of scanner hitting consecutive  file-
              marks at end of the media.  They do not indicate an
              error condition, and can be ignored.

LLIIMMIITTAATTIIOONNSS
       Although ssccaannnneerr was  originally  intended  to  be  stand-
       alone,  it  now  requires  the  NetWorker  services  (e.g.
       nnssrrdd(8) and nnssrrmmmmddbbdd(8)) to be running in order  to  query
       and,  if  requested, update the online RAP, media and file
       indexes.

       When scanning a  relabeled  optical  volume  (i.e.  a  re-
       writable  optical  volume that had been written once, then
       re-labeled and used again), ssccaannnneerr may read off  the  end
       of the new data, and attempt to read the old data from the
       previous version of the volume, terminating with an "unex-
       pected  volume id" error.  This error occurs after all the
       good data has been read, and can be ignored.











NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6


