recover man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

RECOVER(8)							    RECOVER(8)

       recover - browse and recover NetWorker files

       recover	[-f] [-n] [-q] [-u] [-i {nNyYrR}] [-d destination] [-c client]
       [-x index-namespace] [-t date] [-s server] [-p pass-phrase] [ dir]
       recover [-f] [-n] [-u] [-q] [-i {nNyYrR}] [-I input file] [-d  destina‐
       tion]  [-c client] [-x index-namespace] [-t date] [-s server] [-p pass-
       phrase] -a path...
       recover [-f] [-n] [-u] [-q] [-i {nNyYrR}] [-d destination] -s server -S
       ssid[/cloneid] [-S ssid[/cloneid]]... [ path]...
       recover	[-f]  [-q] -i {NYR} -R recover-target [-c client] [-d destina‐
       tion] [-x index-namespace] [-t date] [-s	 server]  [-p  pass-phrase]  [
       recover	[-f]  [-n]  [-q] [-i {nNyYrR}] [-t date] [-s server] [-p pass-
       phrase] [-N system save set]

       recover browses the saved file index and recovers selected  files  from
       the  NetWorker  system.	 The file index is created in the backup index
       namespace when files are saved with save(8).  If files are  saved  into
       an  index-storing  archive  pool using nsrarchive(8), the file index is
       created in the archive index namespace.	When in interactive 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 (-a option), the files
       specified on the command line are recovered immediately without	brows‐
       ing.  While in save set recover mode (-S option), the save set(s) spec‐
       ified 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 or by root.

       If path argument is used with the save  (8)  command  and  one  of  the
       directories in the path is a symbolic link, then the target path of the
       symbolic link must be specified with -a option to  recover  the	files.
       Recovering  the	files by specifying the symbolic link in the path with
       -a option will result in "<path> not in index" message.	Alternatively,
       -S option may be specified to recover these files.

       -a     Specifies	 automatic file recovery with no interactive browsing.
	      Path specifies one or more files or directories to be recovered.
	      Symbolic	links  are  not	 followed, though the link file itself
	      will be recovered.  Mount points are also	 not  followed	unless
	      the most recent save(8) was performed with the '-x' option.

       -S ssid[/cloneid]
	      Specifies	 save  set  recover mode and can only be used by root.
	      This mode can be used to	implement  fast	 batch	file  recovery
	      without  requiring  the  NetWorker file index entries.  The save
	      set id may be for either a backup save set or  an	 archive  save
	      set.  ssid 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 cloneid can also be specified to select the particular
	      clone instance to be recovered from.  When no path arguments are
	      specified,  the entire save set contents will be recovered.  One
	      or more path's can be specified to limit which  directories  and
	      files  are actually recovered.  If path's are supplied, then the
	      beginning of each path name as it exists in the  save  set  must
	      exactly  match  one  of  the path's before it will be recovered.
	      Shell like file name matching using meta	characters  like  `*',
	      `?',  and `[...]'	 is not done.  You can use a path that ends in
	      with a slash (`/') to force a directory only match (e.g., use  a
	      path  of	/etc/fs/  instead  of  /etc/fs	to  prevent files like
	      /etc/fsck from being recovered as well).

       -d destination
	      Specifies the destination directory to relocate recovered files.
	      Using  this  option  is equivalent to using the relocate command
	      when in interactive mode (see usage).  Relative paths are inter‐
	      preted relative to the current working directory.

       -s server
	      Selects which NetWorker server to use.

       -c client
	      Client  is  the  name of the machine that saved the files.  When
	      browsing a directory that was saved by another client, the path‐
	      names  will  reflect  the file tree of the client that saved the
	      files.  By default save and recover determine  the  client  name
	      from  the	 filesystem  table.  This option might be necessary if
	      the -L option was used on the save command.  This option	cannot
	      be used in conjunction with the -S ssid option (save set recover

       -x index-namespace
	      Browse/recover files in the specified file index	namespace.  By
	      default the backup namespace is used. The other recognized index
	      namespace is: archive.  This field is case sensitive.

       -p pass-phrase
	      Specifies an additional pass phrase to use  when	attempting  to
	      recover  files backed up using the aes directive. By default the
	      current datazone encryption key is tried as well as the key gen‐
	      erated  from  the	 default pass phrase. Using this option causes
	      recover to generate an encryption key from the pass  phrase  and
	      try it if the default and datazone pass phrase keys do not work.
	      This option can be specifie multiple times.

       -t date
	      Display/recover files as of  the	specified  date	 (in  nsr_get‐
	      date(3)  format).	  Using this option is equivalent to using the
	      changetime command with the given date when in interactive  mode
	      (see usage).  This option cannot be used in conjunction with the
	      -S ssid option (save set recover mode).

       -q     Turns off the verbose output.  The recover command normally runs
	      with verbose output.

       -f     Forces  recovered files to overwrite any existing files whenever
	      a name conflict occurs.  This is the same as specifying -iY.

       -n     Does not write or create any files or directories when  recover‐

       -i {nNyYrR}
	      Specifies	 the  initial  default	overwrite response to use when
	      recovering existing files.  Only one letter  may	be  specified.
	      This  option  is	the same as the uasm -i option when running in
	      recover mode.  See the uasm(8) man page for a detailed  explana‐
	      tion of this option.  For directed recovers (see the -R option),
	      only 'N', 'Y', and 'R' are valid values.

       -I input file
	      Takes the paths to recover from the command line, and 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.

       -R recover-target
	      Specifies the name of the remote machine to direct the recovery.
	      This is used in conjunction with the -c option to specify brows‐
	      ing of another client's index.  When  the	 -R  option  is	 used,
	      either  the  -f or the -i option must also be specified in order
	      to instruct the recover target what to do when it is  recovering
	      existing	files.	Note that the values 'N', 'Y', and 'R' are the
	      only valid ones to use with the -i option for directed recovers.
	      Note  also  that	the  -a	 option	 is  not supported with the -R

       -N system save set
	      Used to recover the following system save sets: SYSTEM DB,  SYS‐
	      TEM FILES, or SYSTEM STATE. (Windows Only)

       -u     Stops  when  an error occurs during recovery.  Normally, recover
	      treats errors as warnings and tries to continue to  recover  the
	      rest of the files requested.  However, when this option is used,
	      recover will stop recovering on the first error  it  encounters.
	      This option is not valid for directed recovers.

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

       The following commands manipulate the view of the filesystem and	 build
       the  list of files to recover.  In all of the commands that take a name
       argument pattern matching characters can be used. The pattern  matching
       characters  and	regular expression format are the same as for the UNIX
       shell sh(1).

       ls [ options ] [ name ...  ]
	      List information about the given files and directories.  When no
	      name  arguments  are given, ls lists the contents of the current
	      directory.  When a name is given and name is  a  directory,  its
	      contents	are displayed.	If name 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, ls(1).	 An  additional	 recover  specific  -S
	      option  can  be used to select the save time instead of the last
	      modified time for sorting (with the -t option)  and/or  printing
	      (with the -l 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.

       lf [ name ...  ]
	      is the same as ls -F.  Directories are marked  with  a  trailing
	      `/', symbolic links with a trailing `@', sockets with a trailing
	      `=', FIFO special files with  a  trailing	 `|',  and  executable
	      files with a trailing `*'.

       ll [ name ...  ]
	      is  the  same  as	 ls -lgsF.  Generates a long format listing of
	      files and directories.  This command can be  used	 to  find  the
	      value of a symbolic link.

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

       pwd    Print the full pathname of the current working directory.

       add [ name ...  ]
	      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.   Symbolic
	      links  are  not  followed,  though  the link file itself will be
	      recovered.  Mount points are also not followed unless  the  most
	      recent save(8) was performed with the '-x' option.

       debug [ level ]
	      Turn on or turn off debugging. Level must be a number.  If level
	      is 0, debugging is off. As the  debug  level  goes  higher,  the
	      recover command prints out more messages.	 By default, debugging
	      is off.

       delete [ name ...  ]
	      Delete the current directory, or the  named  file(s)  or	direc‐
	      tory(s)  from  the  recover  list.  If a directory 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.

       dir [ w ] [ filename...	]
	      This  command  is similar to the "ll" command with the following
	      differences. The dir command uses the  display  format  used  by
	      "dir"  command in DOS command prompt. Also this command does not
	      add a + to the files selected for recovery.  With w option,  the
	      names of the files or directories only are displayed.

       list [ -l ] | [ -c ]
	      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 -c argument prints just the  total  count  of	 files	to  be
	      recovered.   The -l argument prints the files in the same format
	      as the ll command with the -dS options.

	      Prints a list of the volumes needed to recover the  current  set
	      of  files	 on  the  recover  list.  If all volumes are near-line
	      (near-line volumes are available volumes that are not  mounted),
	      this  command  will  note that all volumes needed are near-line.
	      If all volumes are on-line (on-line volumes are those  that  are
	      available	 and  mounted) or if some volumes are on-line and some
	      are near-line, this command will note that all volumes  are  on-
	      line.   Both near-line and on-line volumes do not require manual

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

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

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

	      Cancel  the  force  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 automati‐
	      cally 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 fur‐
	      ther  prompting.	 Hence,	 selecting `Y' will cause all existing
	      conflicting files to be overwritten, `N'	will  cause  all  con‐
	      flicting recovered files to be discarded, and `R' will automati‐
	      cally rename all conflicting recovered  files  (except  when  an
	      external	ASM  has  a conflicting file name that already ends in
	      the rename suffix).

       relocate [ directory ]
	      Change the target recover location to directory.	 If  directory
	      is  not  specified then the user will be prompted for a destina‐
	      tion directory.  Relative paths are interpreted relative to  the
	      current  working	directory  within  the	recover	 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	 /usr/include/sys/errno.h  and
	      /usr/include/stdio.h  are	 being	recovered,  and the relocation
	      directory is set to /tmp, then the first common parent of	 these
	      two  files  is  include,	so  the	 recovered files will be named
	      /tmp/sys/errno.h, and /tmp/stdio.h.

	      Print destination location for recovered file.

       exit   Immediately exit from recover.

       help   Display a summary of the available commands.

       ?      Same as help.

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

       changetime [ time ]
	      Display the filesystem as it existed at a different time.	 If no
	      time is specified the `current' time is displayed, and a	prompt
	      is  issued  for a `new' time.  The new time is given in nsr_get‐
	      date(3) format.  This format is very flexible. It accepts	 abso‐
	      lute  dates, such as March 17, 1997, and relative dates, such as
	      last Tuesday.  Absolute dates  can  be  given  in	 two  formats:
	      MM/DD[/YY],  and	Month DD[, YYYY].  Times can also be specified
	      as either absolute or relative, with absolute times in the  for‐
	      mat: HH[[:MM][:SS]] [am|pm] [time zone].	For example, 12:30 am,
	      14:21, and 10 pm PST.  The current 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 the end of the day is assumed
	      for  unspecified	times  on  an absolute date (e.g. July 2 means
	      July 2 at 11:59:59 PM).  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 save was run and how  far  back
	      the NetWorker file index information goes.

       versions [ name ]
	      All  instances  of  the current directory, if name is not speci‐
	      fied, 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 ll 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 changetime command, any one of the
	      entries may be added to the recover list.	 As with ls,  lf,  and
	      ll,  files that have been added to the recover list are preceded
	      by a `+'.

       ls(1), nsr_getdate(3), nsr_service(5), nsr(8),  nsrd(8),	 nsrindexd(8),
       nwrecover(8), save(8)

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

       Message from server: other clones exist for failed save set
	      The request failed on a save set that had multiple clones.   The
	      server  automatically  picks  a different clone on each attempt.
	      Recover automatically re-submits	its  recover  request  to  the
	      server, if any files remain to be recovered.

       Path name is within machine:export-point
	      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 machine is
	      not a NetWorker client, then the -c option may be necessary.

       Browsing machine's on-line file index
	      An informative message that explicitly  states  which  NetWorker
	      client's	index  is  being browsed for interactive recovers that
	      resolve to another machine.

       Using server as server for client
	      An informative message that lets you know which NetWorker server
	      was selected for client's index.

       Cannot open recover session with server
	      This  message  indicates	that some problem was encountered con‐
	      necting to the NetWorker server on the named machine.

       error, name is not on client list
	      This message indicates that the client invoking the recover com‐
	      mand is not in the server's client list.	See nsr_service(5) for

       path: Permission denied
	      The file name cannot be recovered because you are not root,  and
	      you don't have read permission for the file.

       path: Permission denied (has acl)
	      The  file name 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 7.3.2			  Aug 23, 06			    RECOVER(8)

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net