mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 00:41:08 +00:00
118 lines
6.8 KiB
HTML
118 lines
6.8 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
|
||
|
|
<HTML><HEAD>
|
||
|
|
<TITLE>Administration Reference</TITLE>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
|
||
|
|
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
|
||
|
|
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
|
||
|
|
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
|
||
|
|
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
|
||
|
|
</HEAD><BODY>
|
||
|
|
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
|
||
|
|
<BODY bgcolor="ffffff">
|
||
|
|
<!-- End Header Records ============================================ -->
|
||
|
|
<A NAME="Top_Of_Page"></A>
|
||
|
|
<H1>Administration Reference</H1>
|
||
|
|
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf084.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf086.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
|
||
|
|
<P>
|
||
|
|
<H2><A NAME="HDRBK_RESTOREDB" HREF="auarf002.htm#ToC_99">backup restoredb</A></H2>
|
||
|
|
<A NAME="IDX4394"></A>
|
||
|
|
<A NAME="IDX4395"></A>
|
||
|
|
<A NAME="IDX4396"></A>
|
||
|
|
<P><STRONG>Purpose</STRONG>
|
||
|
|
<P>Restores a saved copy of the Backup Database
|
||
|
|
<P><STRONG>Synopsis</STRONG>
|
||
|
|
<PRE><B>backup restoredb</B> [<B>-portoffset</B> <<VAR>TC port offset</VAR>>]
|
||
|
|
[<B>-localauth</B>] [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-help</B>]
|
||
|
|
|
||
|
|
<B>backup res</B> [<B>-p</B> <<VAR>TC port offset</VAR>>] [<B>-l</B>] [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-h</B>]
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Description</STRONG>
|
||
|
|
<P>The <B>backup restoredb</B> command restores to the Backup Server
|
||
|
|
machine's local disk a version of the Backup Database previously written
|
||
|
|
to tape by using the <B>backup savedb</B> command.
|
||
|
|
<P>(If the <B>FILE YES</B> instruction appears in the
|
||
|
|
<B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file associated with the
|
||
|
|
specified port offset, then the <B>backup restoredb</B> command restores
|
||
|
|
data from the backup data file listed for that port offset in the Tape
|
||
|
|
Coordinator's <B>/usr/afs/backup/tapeconfig</B> file, instead of from
|
||
|
|
tape. For the sake of clarity, the following text refers to tapes only,
|
||
|
|
but the Backup System handles backup data files in much the same way.)
|
||
|
|
<P>The most common reason to run this command is to replace a corrupted or
|
||
|
|
otherwise damaged Backup Database; use the <B>backup dbverify</B>
|
||
|
|
command to determine the database's status. The command can also
|
||
|
|
be used to restore records that were removed from the database when the
|
||
|
|
<B>-archive</B> argument was included on a previous <B>backup
|
||
|
|
savedb</B> command.
|
||
|
|
<P>The command completely overwrites the existing Backup Database records for
|
||
|
|
volume sets, Tape Coordinators, and the dump hierarchy with the corresponding
|
||
|
|
information from the saved version. It does not overwrite existing dump
|
||
|
|
records, but instead interleaves the records from the copy being
|
||
|
|
restored. If both the existing database (on the Backup Server
|
||
|
|
machine's disk) and the copy being restored include a record about the
|
||
|
|
same dump, the Backup System retains the one in the existing database.
|
||
|
|
<P>The Tape Coordinator's default response to this command is to access
|
||
|
|
the first tape it needs by invoking the <B>MOUNT</B> instruction in the
|
||
|
|
local <B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file, or by
|
||
|
|
prompting the backup operator to insert the tape if there is no
|
||
|
|
<B>MOUNT</B> instruction. However, if the <B>AUTOQUERY NO</B>
|
||
|
|
instruction appears in the <B>CFG_</B><VAR>device_name</VAR> file, or if the
|
||
|
|
issuer of the <B>butc</B> command included the <B>-noautoquery</B>
|
||
|
|
flag, the Tape Coordinator instead expects the tape to be in the device
|
||
|
|
already. If it is not, or is the wrong tape, the Tape Coordinator
|
||
|
|
invokes the <B>MOUNT</B> instruction or prompts the operator. It
|
||
|
|
also invokes the <B>MOUNT</B> instruction or prompts for any additional
|
||
|
|
tapes needed to complete the restore operation; the backup operator must
|
||
|
|
arrange to provide them.
|
||
|
|
<P><STRONG>Cautions</STRONG>
|
||
|
|
<P>If the database is corrupted, do not attempt to restore a saved database on
|
||
|
|
top of it. Instead, use the instructions for repairing a corrupted
|
||
|
|
database in the <I>IBM AFS Administration Guide</I> chapter about
|
||
|
|
performing backup operations.
|
||
|
|
<P><STRONG>Options</STRONG>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>-portoffset
|
||
|
|
</B><DD>Specifies the port offset number of the Tape Coordinator handling the
|
||
|
|
tapes for this operation.
|
||
|
|
<P><DT><B>-localauth
|
||
|
|
</B><DD>Constructs a server ticket using a key from the local
|
||
|
|
<B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
|
||
|
|
interpreter presents it to the Backup Server, Volume Server and VL Server
|
||
|
|
during mutual authentication. Do not combine this flag with the
|
||
|
|
<B>-cell</B> argument. For more details, see the introductory
|
||
|
|
<B>backup</B> reference page.
|
||
|
|
<P><DT><B>-cell
|
||
|
|
</B><DD>Names the cell in which to run the command. Do not combine this
|
||
|
|
argument with the <B>-localauth</B> flag. For more details, see the
|
||
|
|
introductory <B>backup</B> reference page.
|
||
|
|
<P><DT><B>-help
|
||
|
|
</B><DD>Prints the online help for this command. All other valid options
|
||
|
|
are ignored.
|
||
|
|
</DL>
|
||
|
|
<P><STRONG>Examples</STRONG>
|
||
|
|
<P>The following example shows the Backup Database being restored from the
|
||
|
|
Tape Coordinator with port offset 0:
|
||
|
|
<PRE> % <B>backup restoredb</B>
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Privilege Required</STRONG>
|
||
|
|
<P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
|
||
|
|
every machine where the Backup Server is running, or must be logged onto a
|
||
|
|
server machine as the local superuser <B>root</B> if the
|
||
|
|
<B>-localauth</B> flag is included.
|
||
|
|
<P><STRONG>Related Information</STRONG>
|
||
|
|
<P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
|
||
|
|
<P><A HREF="auarf066.htm#HDRBK_DBVERIFY">backup dbverify</A>
|
||
|
|
<P><A HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</A>
|
||
|
|
<P><A HREF="auarf126.htm#HDRBUTC">butc</A>
|
||
|
|
<P><I>IBM AFS Administration Guide</I>
|
||
|
|
<P>
|
||
|
|
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf084.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf086.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
|
||
|
|
<!-- Begin Footer Records ========================================== -->
|
||
|
|
<P><HR><B>
|
||
|
|
<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
|
||
|
|
</B>
|
||
|
|
<!-- End Footer Records ============================================ -->
|
||
|
|
<A NAME="Bot_Of_Page"></A>
|
||
|
|
</BODY></HTML>
|