


RECOVER(8)                                             RECOVER(8)


NNAAMMEE
       recover - browse and recover NetWorker files

SSYYNNOOPPSSIISS
       rreeccoovveerr  [[--ff]] [[--nn]] [[--qq]] [[--ii {{nnNNyyYYrrRR}}]] [[--dd _d_e_s_t_i_n_a_t_i_o_n]] [[--cc
       _c_l_i_e_n_t]] [[--tt _d_a_t_e]] [[ --ss _s_e_r_v_e_r]] [[ _d_i_r]]
       rreeccoovveerr [[--ff]] [[--nn]] [[--qq]] [[--ii {{nnNNyyYYrrRR}}]] [[--II _i_n_p_u_t  _f_i_l_e]]  [[--dd
       _d_e_s_t_i_n_a_t_i_o_n]] [[--cc _c_l_i_e_n_t]] [[--tt _d_a_t_e]] [[ --ss _s_e_r_v_e_r]] --aa _p_a_t_h...
       rreeccoovveerr [[--ff]] [[--nn]] [[--qq]] [[--ii {{nnNNyyYYrrRR}}]] [[--dd  _d_e_s_t_i_n_a_t_i_o_n]]  --ss
       _s_e_r_v_e_r --SS _s_s_i_d_[_/_c_l_o_n_e_i_d_] [[--SS _s_s_i_d_[_/_c_l_o_n_e_i_d_]]]...... [[ _p_a_t_h]]......

DDEESSCCRRIIPPTTIIOONN
       RReeccoovveerr browses the saved file index and recovers selected
       files  from  the NetWorker system.  The file index is cre-
       ated when files are saved with ssaavvee(8).  When in  interac-
       tive mode (the default), the user is presented with a view
       of the index similar to a UNIX filesystem,  and  may  move
       through  the  index  to select and recover files or entire
       directories.  In automatic mode  (--aa  option),  the  files
       specified  on  the  command line are recovered immediately
       and no browsing takes place.  While in  save  set  recover
       mode  (--SS option), the save set(s) specified are retrieved
       directly without browsing the NetWorker file  index.   Use
       of save set recover mode is restricted to root.

       When  using  recover  without the -S option, users who are
       root may  recover  any  file.   The  remaining  permission
       checking  rules  described in the paragraph apply to users
       who are not root.  For files that  don't  have  an  Access
       Control  List  (ACL), the normal Unix mode bits must allow
       you to read the file in order to recover it.   Files  with
       an ACL can only be recovered by their owner.

OOPPTTIIOONNSS
       --aa     This  option specifies automatic file recovery with
              no interactive browsing.   _P_a_t_h  specifies  one  or
              more files or directories to be recovered.

       --SS _s_s_i_d_[_/_c_l_o_n_e_i_d_]
              This  option  is  used  to specify save set recover
              mode and can only be used by root.  This  mode  can
              be used to implement fast batch file recovery with-
              out requiring the  NetWorker  file  index  entries.
              _S_s_i_d  specifies  the  save  set  id's  for the save
              set(s) to be recovered.  When  there  are  multiple
              clone  instances  for  a  save set, the _c_l_o_n_e_i_d can
              also be specified to select  the  particular  clone
              instance  to be recovered from.  When no _p_a_t_h argu-
              ments are specified, the entire save  set  contents
              will  be recovered.  One more or more _p_a_t_h's can be
              specified to limit which directories and files  are
              actually  recovered.   If _p_a_t_h's are supplied, then
              the beginning of each path name as it exists in the
              save  set  must  exactly  match  one  of the _p_a_t_h's



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





RECOVER(8)                                             RECOVER(8)


              before it will be recovered.  Shell like file  name
              matching  using  meta characters like `**', `??', and
              `[[...]]'  is not done.  You can use a _p_a_t_h that ends
              in  with  a  slash  (`//') to force a directory only
              match (e.g., use a  _p_a_t_h  of  //eettcc//ffss//  instead  of
              //eettcc//ffss  to prevent files like //eettcc//ffsscckk from being
              recovered as well).

       --dd _d_e_s_t_i_n_a_t_i_o_n
              Specifies the  destination  directory  to  relocate
              recovered  files  to.  Using this option is equiva-
              lent to using the rreellooccaattee command when in interac-
              tive  mode  (discussed  below).  Relative paths are
              interpreted relative to the current working  direc-
              tory.

       --ss _s_e_r_v_e_r
              Selects which NetWorker server to use.  This option
              is required for save set recover mode (--SS).  Other-
              wise  the default is the server of the first direc-
              tory being recovered,  if  it  is  a  network  file
              server  and  NetWorker server.  Otherwise, the cur-
              rent machine if it is  running  a  server,  or  the
              machine  with  the  logical name ``nsrhost'' in the
              host table (see hhoossttss(5)).

       --cc _c_l_i_e_n_t
              _C_l_i_e_n_t is the name of the machine  that  saved  the
              files.   Note  that  when browsing a directory that
              was saved by another  client,  the  pathnames  will
              reflect  the file tree of the client that saved the
              files.  By default ssaavvee and rreeccoovveerr  determine  the
              client  name  from  the  filesystem table, but this
              option might be necessary if the --LL option was used
              on the ssaavvee command.  This option cannot be used in
              conjunction with  the  --SS  _s_s_i_d  option  (save  set
              recover mode).

       --tt _d_a_t_e
              Display/recover  files as of the specified _d_a_t_e (in
              nnssrr__ggeettddaattee(3)  format).   Using  this  option   is
              equivalent to using the cchhaannggeettiimmee command with the
              given _d_a_t_e  when  in  interactive  mode  (discussed
              below).   This option cannot be used in conjunction
              with the --SS _s_s_i_d option (save set recover mode).

       --qq     The rreeccoovveerr command normally runs with verbose out-
              put. This flag turns off the verbose output.

       --ff     Force  recovered  files  to  overwrite any existing
              files whenever a name conflict occurs.  This is the
              same as specifying --iiYY.

       --nn     When   recovering,   do  not  actually  create  any



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





RECOVER(8)                                             RECOVER(8)


              directories or files.

       --ii {{nnNNyyYYrrRR}}
              Specifies the initial default overwrite response to
              use  when  recovering  files  and  the file already
              exists.  Only one letter may  be  specified.   This
              option  is the same as the uuaassmm --ii option when run-
              ning in recover mode.  See the uuaassmm(8) man page for
              a detailed explanation of this option.

       --II _i_n_p_u_t _f_i_l_e
              In addition to taking the paths to recover from the
              command line, read paths to recover from the  named
              file.   The  paths must be listed one per line.  If
              no paths are specified on the  command  line,  then
              only  those  paths  specified  in  the file will be
              recovered.  To  be  used  in  conjunction  with  -a
              option.

UUSSAAGGEE
       When  using  recover  in the interactive mode, an image of
       the filesystem at a particular time is  presented.   Using
       commands similar to the shell, one can change the view and
       traverse the filesystem.  Files may be selected for recov-
       ering, and the actual recover command issued.

       The following commands manipulate the view of the filesys-
       tem and build the list of files to recover.  In all of the
       commands  that take a _n_a_m_e argument pattern matching char-
       acters can be used. The pattern  matching  characters  and
       regular  expression  format  are  the same as for the UNIX
       shell sshh(1).

       llss [ _o_p_t_i_o_n_s ] [ _n_a_m_e _._._.  ]
              List information about the given files and directo-
              ries.   When  no _n_a_m_e arguments are given, llss lists
              the contents of the current directory.  When a _n_a_m_e
              is  given and _n_a_m_e is a directory, its contents are
              displayed.  If _n_a_m_e is a file, then just that  file
              is displayed.  The current directory is represented
              by a `..'  (period).  The options  to  this  command
              correspond to those of the UNIX command, llss(1).  An
              additional recover specific --SS option can  be  used
              to  select  the save time instead of the last modi-
              fied time for sorting (with the --tt  option)  and/or
              printing  (with  the  --ll  option).  Files that have
              been added to the recover list are  preceded  by  a
              `++'.   Files  that  have an ACL have a trailing '+'
              (e.g.  -rw-r--r--+) after the mode bits when  view-
              ing file details.

       llff [ _n_a_m_e _._._.  ]
              is  the same as llss --FF.  Directories are marked with
              a trailing `//', symbolic links with a trailing `@@',



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





RECOVER(8)                                             RECOVER(8)


              sockets  with  a  trailing  `==', FIFO special files
              with a trailing `||', and executable  files  with  a
              trailing `**'.

       llll [ _n_a_m_e _._._.  ]
              is  the  same as llss --llggssFF.  Generates a long format
              listing of files and directories.  This command can
              be used to find the value of a symbolic link.

       ccdd [ _d_i_r_e_c_t_o_r_y ]
              Change  the current working directory to _d_i_r_e_c_t_o_r_y.
              The default directory is the directory rreeccoovveerr  was
              executed  in.   If  _d_i_r_e_c_t_o_r_y  is a simple symbolic
              link, ccdd will follow the symbolic  link.   However,
              if  _d_i_r_e_c_t_o_r_y  is  a path containing symbolic links
              anywhere but at the end of the path, the ccdd command
              will fail; you should ccdd a component of the path at
              a time instead.

       ppwwdd    Print the full  pathname  of  the  current  working
              directory.

       aadddd [ _n_a_m_e _._._.  ]
              Add  the current directory, or the named file(s) or
              directory(s) to the recover list.  If  a  directory
              is  specified,  it  and all of its descendent files
              are added to the recover list.

       ddeelleettee [ _n_a_m_e _._._.  ]
              Delete the current directory, or the named  file(s)
              or directory(s) from the recover list.  If a direc-
              tory is  specified,  that  directory  and  all  its
              descendents  are  deleted  from the list.  The most
              expedient way to recover a majority of files from a
              directory  is  to  add the directory to the recover
              list, and then delete the unwanted files.

       lliisstt [ --ll ] | [ --cc ]
              Display the files on the  recover  list.   With  no
              arguments  the  recover list is displayed as a list
              of full path names, one per line,  followed  but  a
              total  count  of the files to be recovered.  The --cc
              argument prints just the total count of files to be
              recovered.  The --ll argument prints the files in the
              same format as the llll command with the --ddSS options.

       vvoolluummeess
              Prints  a  list  of the volumes need to recover the
              current set of files on the recover list.

       rreeccoovveerr
              Recover all of the files on the recover  list  from
              the  NetWorker server.  Upon completion the recover
              list is empty.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





RECOVER(8)                                             RECOVER(8)


       vveerrbboossee
              Toggle the status of the ``verbose'' option.   When
              verbose  mode  is  on  rreeccoovveerr displays information
              about each file as it is recovered.   When  verbose
              mode  is off rreeccoovveerr only prints information when a
              problem occurs.  The default is verbose mode on.

       ffoorrccee  If name conflicts  exist,  overwrite  any  existing
              files with recovered files.

       nnooffoorrccee
              Cancel the ffoorrccee option.  When in `noforce' mode, a
              prompt is issued each time a naming conflict arises
              between  a  file  being  recovered  and an existing
              file.  At each prompt, six choices  are  presented:
              `y',  `Y', `n', `N', `r' and `R'.  To overwrite the
              existing file, select `y'.  To rename the  file  to
              an automatically generated alternative name, select
              `r'.  Selecting `n' causes the recovered file to be
              discarded.   The  capital  letters  invoke the same
              action for all subsequent conflicts without further
              prompting.   Hence,  selecting  `Y'  will cause all
              existing conflicting files to be  overwritten,  `N'
              will  cause  all  conflicting recovered files to be
              discarded, and `R' will  automatically  rename  all
              conflicting  recovered files (except when an exter-
              nal ASM has a conflicting file  name  that  already
              ends in the rename suffix).

       rreellooccaattee [ _d_i_r_e_c_t_o_r_y ]
              Change the target recover location to _d_i_r_e_c_t_o_r_y, if
              _d_i_r_e_c_t_o_r_y is not specified then the  user  will  be
              prompted  for  a  destination  directory.  Relative
              paths are interpreted relative to the current work-
              ing  directory  within  the  rreeccoovveerr  program.  The
              recovered files will be placed into this directory,
              which  will  be  created  if necessary.  When files
              from multiple directories are being recovered, they
              will  be  placed  below  this directory with a path
              relative to the first  common  parent  of  all  the
              files   to   be   recovered.    For   example,   if
              _/_u_s_r_/_i_n_c_l_u_d_e_/_s_y_s_/_e_r_r_n_o_._h  and  _/_u_s_r_/_i_n_c_l_u_d_e_/_s_t_d_i_o_._h
              are  being  recovered, and the relocation directory
              is set to _/_t_m_p, then the  first  common  parent  of
              these  two files is _i_n_c_l_u_d_e, so the recovered files
              will be named _/_t_m_p_/_s_y_s_/_e_r_r_n_o_._h, and _/_t_m_p_/_s_t_d_i_o_._h.

       ddeessttiinnaattiioonn
              Print destination location for recovered file.

       eexxiitt   Immediately exit from rreeccoovveerr.

       hheellpp   Display a summary of the available commands.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5





RECOVER(8)                                             RECOVER(8)


       ??      Same as hheellpp..

       qquuiitt   Immediately  exit  from  rreeccoovveerr.   Files  on   the
              recover list are not recovered.

       cchhaannggeettiimmee [ _t_i_m_e ]
              Display the filesystem as it existed at a different
              time.  If no _t_i_m_e is specified the  `current'  time
              is  displayed,  and  a prompt is issued for a `new'
              time.  The new time is given in nnssrr__ggeettddaattee(3) for-
              mat.   This  format  is  very  flexible. It accepts
              absolute dates, such as _M_a_r_c_h _1_7_, _1_9_9_7,  and  rela-
              tive  dates,  such as _l_a_s_t _T_u_e_s_d_a_y.  Absolute dates
              can be given in two formats: _M_M_/_D_D_[_/_Y_Y_], and  _M_o_n_t_h
              _D_D_[_,  _Y_Y_Y_Y_].  Times can also be specified as either
              absolute or relative, with absolute  times  in  the
              format:  _H_H_[_[_:_M_M_]_[_:_S_S_]_]  _[_a_m_|_p_m_]  _[_t_i_m_e _z_o_n_e_].  For
              example, 12:30 am, 14:21, and 10 pm PST.  The  cur-
              rent time is used to calculate unspecified parts of
              a relative date (e.g. 2 days ago means 2  days  ago
              at  the  current time), and midnight is assumed for
              unspecified times on an absolute date (e.g. July  2
              means July 2 at midnight).  By default, the present
              is used as the current time.  The resolution of the
              filesystem  image  at a time in the past depends on
              how often ssaavvee was run and how far  back  the  Net-
              Worker file index information goes.

       vveerrssiioonnss [ _n_a_m_e ]
              All  instances of the current directory, if _n_a_m_e is
              not specified, or  the  named  file  or  directory,
              found  in the NetWorker file index are listed.  For
              each instance, three lines of data  are  displayed.
              The  first  line  is similar to the llll output.  The
              second line lists the instance's  save  time.   The
              third  line  specifies  which tape(s) this instance
              may be recovered from.  With appropriate use of the
              cchhaannggeettiimmee  command,  any one of the entries may be
              added to the recover list.  As with llss, llff, and llll,
              files  that have been added to the recover list are
              preceded by a `++'.

CCAAVVEEAATTSS
       The times being used for interactive  and  non-interactive
       recovers  are  not consistent with networker. For example,
       if you want to recover a file that was backed up at  23:50
       on  5/22,  you  could  use interactive recover and issue a
       changetime 5/22 command and it would use 5/22 at  23:59:59
       as  the  time. This would pick up a version of a file that
       was backed up at 23:00. If  you  use  the  non-interactive
       recover and use the -t with, for example, recover -t 5/22,
       this will in effect set the time to 00:00:00.   This  will
       then  not  find the version of the file that was backed up
       after 00:00:00 and will recover the previous version.



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        6





RECOVER(8)                                             RECOVER(8)


       The workaround is to include the time with the "recover -t
       5/22 00:00:00" command.

SSEEEE AALLSSOO
       llss(1),  nnssrr__ggeettddaattee(3),  hhoossttss(5), nnssrr__sseerrvviiccee(5), nnssrr(8),
       nnssrrdd(8), nnssrriinnddeexxdd(8), nnwwrreeccoovveerr(8), ssaavvee(8)

DDIIAAGGNNOOSSTTIICCSS
       RReeccoovveerr complains about bad option characters by  printing
       a ``usage'' message describing the available options.


       MMeessssaaggee  ffrroomm  sseerrvveerr::  ootthheerr cclloonneess eexxiisstt ffoorr ffaaiilleedd ssaavvee
              sseett
              Recover will automatically  re-submit  its  recover
              request  to  the  server, if any files remain to be
              recovered, because the request failed on a save set
              that had multiple clones.  The server automatically
              picks a different clone on each attempt.

       PPaatthh _n_a_m_e iiss wwiitthhiinn _m_a_c_h_i_n_e::_e_x_p_o_r_t_-_p_o_i_n_t
              An informative message that lets you know that  the
              given  path  name  is  mounted  from a network file
              server and that the recovery will use the index for
              the  named  file  server.   If the _m_a_c_h_i_n_e is not a
              NetWorker client, then the --cc option may be  neces-
              sary.

       BBrroowwssiinngg _m_a_c_h_i_n_e''ss oonn--lliinnee ffiillee iinnddeexx
              An informative message that explicitly states which
              NetWorker  client's  index  is  being  browsed  for
              interactive   recovers  which  resolve  to  another
              machine.

       UUssiinngg _s_e_r_v_e_r aass sseerrvveerr ffoorr _c_l_i_e_n_t
              An informative message that  lets  you  know  which
              NetWorker server was selected for client's index.

       CCaannnnoott ooppeenn rreeccoovveerr sseessssiioonn wwiitthh _s_e_r_v_e_r
              This   message  indicates  that  some  problem  was
              encountered connecting to the NetWorker  server  on
              the named machine.

       eerrrroorr,, _n_a_m_e iiss nnoott oonn cclliieenntt lliisstt
              This message indicates that the client invoking the
              rreeccoovveerr command is not in the server's client list.
              See nnssrr__sseerrvviiccee(5) for details.

       _p_a_t_h:: PPeerrmmiissssiioonn ddeenniieedd
              The  file  _n_a_m_e cannot be recovered because you are
              not root, and you don't have  read  permission  for
              the file.

       _p_a_t_h:: PPeerrmmiissssiioonn ddeenniieedd ((hhaass aaccll))



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        7





RECOVER(8)                                             RECOVER(8)


              The  file  _n_a_m_e cannot be recovered because you are
              not root, the  file  has  an  ACL  (Access  Control
              List), and you are not the owner of the file.






















































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        8


