2 .\" Author: Alan M. McIvor <alan@kauri.auck.irl.cri.nz>
3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
5 .\" Manual: System Administration Commands
6 .\" Source: Amanda 2.6.1
9 .TH "AMRECOVER" "8" "01/22/2009" "Amanda 2\&.6\&.1" "System Administration Commands"
10 .\" -----------------------------------------------------------------
11 .\" * (re)Define some macros
12 .\" -----------------------------------------------------------------
13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14 .\" toupper - uppercase a string (locale-aware)
15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22 .\" SH-xref - format a cross-reference to an SH section
23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33 .\" SH - level-one heading that works better for non-TTY output
34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36 .\" put an extra blank line of space above the head in non-TTY output
43 .nr an-prevailing-indent \\n[IN]
47 .HTML-TAG ".NH \\n[an-level]"
49 .nr an-no-space-flag 1
51 \." make the size of the head bigger
56 .\" if n (TTY output), use uppercase
61 .\" if not n (not TTY), use normal case (not uppercase)
65 .\" if not n (not TTY), put a border/line under subheading
70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71 .\" SS - level-two heading that works better for non-TTY output
72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
77 .nr an-prevailing-indent \\n[IN]
82 .nr an-no-space-flag 1
85 \." make the size of the head bigger
91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92 .\" BB/BE - put background/screen (filled box) around block of text
93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
106 .if "\\$2"adjust-for-leading-newline" \{\
114 .nr BW \\n(.lu-\\n(.i
117 .ie "\\$2"adjust-for-leading-newline" \{\
118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133 .\" BM/EM - put colored marker in margin next to block of text
134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
159 .\" -----------------------------------------------------------------
160 .\" * set default formatting
161 .\" -----------------------------------------------------------------
162 .\" disable hyphenation
164 .\" disable justification (adjust text to left margin only)
166 .\" -----------------------------------------------------------------
167 .\" * MAIN CONTENT STARTS HERE *
168 .\" -----------------------------------------------------------------
170 amrecover \- \fIAmanda\fR index database browser
173 .HP \w'\fBamrecover\fR\ 'u
174 \fBamrecover\fR [\-C\ \fIconfig\fR] [\-s\ \fIindex\-server\fR] [\-t\ \fItape\-server\fR] [\-d\ \fItape\-device\fR] [\-o\ \fIconfigoption\fR]...
179 browses the database of
181 index files to determine which tapes contain files to recover\&. Furthermore, it is able to recover files\&.
183 In order to restore files in place, you must invoke
185 from the root of the backed up filesystem, or use
187 to move into that directory, otherwise a directory tree that resembles the backed up filesystem will be created in the current directory\&. See the examples below for details\&.
189 Amrecover will read the
190 \fBamanda\-client\&.conf\fR
192 \fIconfig\fR\fB/amanda\-client\&.conf\fR
193 file\&. If no configuration name is supplied on the command line, Amrecover will try the compiled\-in default configuration ,usually
198 man page for more details about
207 .nr an-no-space-flag 1
215 The Default values are those set at compile\-time\&. Use
217 to recover client\-encrypted or client\-custom\-compressed tapes\&.
228 \fB\-s index\-server\fR
230 Host that runs the index daemon\&.
233 \fB\-t tape\-server\fR
235 Host that runs the tape server daemon\&.
238 \fB\-d tape\-device\fR
240 Tape device to use on the tape server host\&.
243 \fB\-o\fR \fIclientconfigoption\fR
245 See the "\fBCONFIGURATION OVERRIDE\fR" section in
251 connects to the index server and then presents a command line prompt\&. Usage is similar to an ftp client\&. The GNU readline library is used to provide command line history and editing if it was built in to
254 The purpose of browsing the database is to build up a
256 of files to be extracted from the backup system\&. The following commands are available:
258 \fBsethost hostname\fR
260 Specifies which host to look at backup files for (default: the local host)\&.
263 \fBsetdate YYYY\-MM\-DD\-HH\-MM[\-SS] | YYYY\-MM\-DD\fR
265 Set the restore time (default: now)\&. File listing commands only return information on backup images for this day, for the day before with the next lower dump level, and so on, until the most recent level 0 backup on or before the specified date is encountered\&.
278 .BB lightgray adjust-for-leading-newline
281 1996\-07\-01 was a level 0 backup
282 1996\-07\-02 through 1996\-07\-05 were level 1 backups
283 1996\-07\-06 through 1997\-07\-08 were level 2 backups
284 .EB lightgray adjust-for-leading-newline
296 \fBsetdate 1997\-07\-08\-00\fR
297 would yield files from the following days:
308 .BB lightgray adjust-for-leading-newline
311 1997\-07\-08 (the latest level 2 backup)
312 1997\-07\-05 (the latest level 1 backup)
313 1997\-07\-01 (the latest level 0 backup)
314 .EB lightgray adjust-for-leading-newline
325 Only the most recent version of a file will be presented\&.
327 The following abbreviated date specifications are accepted:
331 dates in the current year
336 dates in the current month of the current year
340 \fBsetdisk\fR \fIdiskname\fR [\fImountpoint\fR]
342 Specifies which disk to consider (default: the disk holding the working directory where
344 is started)\&. It can only be set after the host is set with
347 is the device name specified in the
350 \fBdisklist\fR(5)\&. The disk must be local to the host\&. If
352 is not specified, all pathnames will be relative to the (unknown) mount point instead of full pathnames\&.
355 \fBlisthost\fR [\fIdiskdevice\fR]
361 \fBlistdisk\fR [\fIdiskdevice\fR]
367 \fBsetdevice\fR [[\-h \fItape\-server\fR] \fItapedev\fR]
369 Specifies the host to use as the tape server, and which of its tape devices to use\&. If the server is omitted, the server name reverts to the configure\-time default\&. If the tape device is omitted, the default is used\&.
371 If you want amrecover to use your changer, the
373 must be equal to the amrecover_changer setting on the server\&.
375 Since device names contain colons, you must always specify the hostname\&.
377 settape 192\&.168\&.0\&.10:file:/file1
379 You can change the tape device when amrecover ask you to load the tape:
383 Tape device: server2:/dev/nst2
385 Using tape /dev/nst2 from server server2\&.
389 \fBsetmode\fR \fImode\fR
391 Set the extraction mode for Samba shares\&. If
394 \fBsmb\fR, shares are sent to the Samba server to be restored back onto the PC\&. If
397 \fBtar\fR, they are extracted on the local machine the same way tar volumes are extracted\&.
402 Displays the extracting mode for Samba shares\&.
407 Show the backup history of the current host and disk\&. Dates, levels, tapes and file position on tape of each backup are displayed\&.
412 Display the name of the current backup working directory\&.
417 Change the backup working directory to
419 If the mount point was specified with
420 \fBsetdisk\fR, this can be a full pathname or it can be relative to the current backup working directory\&. If the mount point was not specified, paths are relative to the mount point if they start with "/", otherwise they are relative to the current backup working directory\&. The
422 can be a shell style wildcards\&.
429 command but allow regular expression\&.
436 working directory\&. Files will be restored under this directory, relative to the backed up filesystem\&.
449 List the contents of the current backup working directory\&. See the description of the
451 command for how the view of the directory is built up\&. The backup date is shown for each file\&.
454 \fBadd\fR \fIitem1 item2 \&.\&.\&.\fR
456 Add the specified files or directories to the restore list\&. Each item may have shell style wildcards\&.
459 \fBaddx\fR \fIitem1 item2 \&.\&.\&.\fR
461 Add the specified files or directories to the restore list\&. Each item may be a regular expression\&.
464 \fBdelete\fR \fIitem1 item2 \&.\&.\&.\fR
466 Delete the specified files or directories from the restore list\&. Each item may have shell style wildcards\&.
469 \fBdeletex\fR \fIitem1 item2 \&.\&.\&.\fR
471 Delete the specified files or directories from the restore list\&. Each item may be a regular expression\&.
474 \fBlist\fR \fIfile\fR
476 Display the contents of the restore list\&. If a file name is specified, the restore list is written to that file\&. This can be used to manually extract the files from the
484 Clear the restore list\&.
489 Close the connection to the index server and exit\&.
494 Close the connection to the index server and exit\&.
499 Start the extract sequence (see the examples below)\&. Make sure the local working directory is the root of the backed up filesystem, or another directory that will behave like that\&. Use
501 to display the local working directory, and
508 Display a brief list of these commands\&.
512 The following shows the recovery of an old
518 syslog\&.7: No such file or directory
520 AMRECOVER Version 2\&.4\&.2\&. Contacting server on oops \&.\&.\&.
521 220 oops \fIAmanda\fR index server (2\&.4\&.2) ready\&.
522 Setting restore date to today (1997\-12\-09)
523 200 Working date set to 1997\-12\-09\&.
524 200 Config set to MyConfig\&.
525 200 Dump host set to this\-host\&.some\&.org\&.
526 $CWD \'/var/log\' is on disk \'/var\' mounted at \'/var\'\&.
527 200 Disk set to /var\&.
529 WARNING: not on root of selected filesystem, check man\-page!
531 1997\-12\-09 daemon\&.log
534 1997\-12\-08 sysidconfig\&.log
535 1997\-12\-08 syslog\&.0
536 1997\-12\-08 syslog\&.1
537 1997\-12\-08 syslog\&.2
538 1997\-12\-08 syslog\&.3
539 1997\-12\-08 syslog\&.4
540 1997\-12\-08 syslog\&.5
541 1997\-12\-08 syslog\&.6
542 1997\-12\-08 syslog\&.7
543 amrecover> add syslog\&.7
544 Added /log/syslog\&.7
547 amrecover> lcd \&.\&.
551 Extracting files using tape drive /dev/nst0 on host 192\&.168\&.0\&.10
553 The following tapes are needed: DMP014
555 Restoring files into directory /var
560 set owner/mode for \'\&.\'? [yn] n
565 \-rw\-r\-\-r\-\- 1 root other 12678 Oct 14 16:36 syslog\&.7
568 If you do not want to overwrite existing files, create a subdirectory to run
570 from and then move the restored files afterward\&.
573 # (umask 077 ; mkdir \&.restore)
576 AMRECOVER Version 2\&.4\&.2\&. Contacting server on oops \&.\&.\&.
582 amrecover> add syslog\&.7
583 Added /log/syslog\&.7
588 Extracting files using tape drive /dev/nst0 on host 192\&.168\&.0\&.10
592 # mv \-i log/syslog\&.7 \&.\&./log/syslog\&.7\-restored
599 by hand instead of letting
603 command after browsing to display the needed tapes\&.
607 AMRECOVER Version 2\&.4\&.2\&. Contacting server on oops \&.\&.\&.
611 amrecover> add syslog syslog\&.6 syslog\&.7
613 Added /log/syslog\&.6
614 Added /log/syslog\&.7
616 TAPE DMP014 LEVEL 0 DATE 1997\-12\-08
619 TAPE DMP015 LEVEL 1 DATE 1997\-12\-09
626 command shows each tape that has a backup of the current disk along with the date of the backup, the level, the tape label and the file position on the tape\&. All active tapes are listed, not just back to the most recent full dump\&.
628 Tape file position zero is a label\&. The first backup image is in file position one\&.
632 AMRECOVER Version 2\&.4\&.2\&. Contacting server on oops \&.\&.\&.
635 200\- Dump history for config "MyConfig" host "this\-host\&.some\&.org" disk "/var"
636 201\- 1997\-12\-09 1 DMP015 9
637 201\- 1997\-12\-08 1 DMP014 11
638 201\- 1997\-12\-07 0 DMP013 22
639 201\- 1997\-12\-06 1 DMP012 16
640 201\- 1997\-12\-05 1 DMP011 9
641 201\- 1997\-12\-04 0 DMP010 11
642 201\- 1997\-12\-03 1 DMP009 7
643 201\- 1997\-12\-02 1 DMP008 7
644 201\- 1997\-12\-01 1 DMP007 9
645 201\- 1997\-11\-30 1 DMP006 6
656 commands will use $PAGER to display the file lists\&. Defaults to
658 if PAGER is not set\&.
661 If set, $AMANDA_SERVER will be used as index\-server\&. The value will take precedence over the compiled default, but will be overridden by the \-s switch\&.
663 \fBAMANDA_TAPE_SERVER\fR
664 If set, $AMANDA_TAPE_SERVER will be used as tape\-server\&. The value will take precedence over the compiled default, but will be overridden by the \-t switch\&.
668 \fBamanda-client.conf\fR(5),
670 \fBamfetchdump\fR(8),
672 : http://wiki.zmanda.com
675 \fBAlan M\&. McIvor\fR <\&alan@kauri\&.auck\&.irl\&.cri\&.nz\&>
677 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>