mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 00:41:08 +00:00
152 lines
9.0 KiB
HTML
152 lines
9.0 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="auarf085.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="auarf087.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_SAVEDB" HREF="auarf002.htm#ToC_100">backup savedb</A></H2>
|
|
<A NAME="IDX4397"></A>
|
|
<A NAME="IDX4398"></A>
|
|
<A NAME="IDX4399"></A>
|
|
<P><STRONG>Purpose</STRONG>
|
|
<P>Creates a saved copy of the Backup Database
|
|
<P><STRONG>Synopsis</STRONG>
|
|
<PRE><B>backup savedb</B> [<B>-portoffset</B> <<VAR>TC port offset</VAR>>] [<B>-archive</B> <<VAR>date time</VAR>><SUP>+</SUP>]
|
|
[<B>-localauth</B>] [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-help</B>]
|
|
|
|
<B>backup sa</B> [<B>-p</B> <<VAR>TC port offset</VAR>>] [<B>-a</B> <<VAR>date time</VAR>><SUP>+</SUP>]
|
|
[<B>-l</B>] [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-h</B>]
|
|
</PRE>
|
|
<P><STRONG>Description</STRONG>
|
|
<P>The <B>backup savedb</B> command creates a backup copy of the entire
|
|
Backup Database and writes it to the tape in the device controlled by the Tape
|
|
Coordinator indicated with the <B>-portoffset</B> argument. If the
|
|
database is damaged (as reported by the <B>backup dbverify</B> command),
|
|
this command repairs as much of the corruption as possible as it creates the
|
|
saved copy. The Backup Server creates a dump record for the saved
|
|
database in the Backup Database (but in the disk version of the database only,
|
|
not in the version written to tape).
|
|
<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 savedb</B> command dumps the
|
|
database copy to the backup data file listed for that port offset in the Tape
|
|
Coordinator's <B>/usr/afs/backup/tapeconfig</B> file, instead of to
|
|
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>If the <B>-archive</B> flag is provided, after writing the saved copy
|
|
of the database the Backup System truncates the copy of the database on disk
|
|
by deleting volume dump records with timestamps prior to the specified date
|
|
and time (it does not delete the dump records created by previous <B>backup
|
|
savedb</B> commands, however).
|
|
<P>If the tape to which the database copy is written has an AFS tape name, it
|
|
must be <B>Ubik_db_dump.1</B> or <TT><NULL></TT>. Any
|
|
permanent name is acceptable.
|
|
<P>The Tape Coordinator's default response to this command is to access
|
|
the first tape 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, 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 operation; the
|
|
backup operator must arrange to provide them.
|
|
<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>-archive
|
|
</B><DD>Specifies a date and time; volume dump records with earlier
|
|
timestamps are deleted from the disk copy of the Backup Database after the
|
|
Backup System dumps the database (a dump's timestamp appears in the
|
|
<TT>created</TT> field of the output from the <B>backup dumpinfo</B>
|
|
command). However, if a dump set contains any dump created after the
|
|
specified date, none of the dump records associated with the dump set are
|
|
deleted. Dump records for previous dumps of the database (created with
|
|
the <B>backup savedb</B> command) are never deleted; use the
|
|
<B>backup deletedump</B> command to remove them.
|
|
<P>Provide one of two values:
|
|
<UL>
|
|
<P><LI>The string <B>NOW</B> to indicate the current date and time, in which
|
|
case the Backup System deletes all dump records except those for dumps of the
|
|
Backup Database itself.
|
|
<P><LI>A date value in the format <VAR>mm/dd/yyyy</VAR>
|
|
[<VAR>hh:MM</VAR>]. The month (<VAR>mm</VAR>), day (<VAR>dd</VAR>), and
|
|
year (<VAR>yyyy</VAR>) are required, and valid values for the year range from
|
|
<B>1970</B> to <B>2037</B>; higher values are not valid because
|
|
the latest possible date in the standard UNIX representation is in February
|
|
2038. The Backup System automatically reduces any later date to the
|
|
maximum value.
|
|
<P>The hour and minutes (<VAR>hh</VAR>:<VAR>MM</VAR>) are optional, but if
|
|
provided must be in 24-hour format (for example, the value
|
|
<B>14:36</B> represents 2:36 p.m.). If
|
|
omitted, the time defaults to 59 seconds after midnight (00:00:59
|
|
hours). Similarly, the <B>backup</B> command interpreter
|
|
automatically adds 59 seconds to any time value provided. In both
|
|
cases, adding 59 seconds compensates for how the Backup Database and
|
|
<B>backup dumpinfo</B> command represent dump creation times in hours and
|
|
minutes only. That is, the Database records a creation timestamp of
|
|
<TT>20:55</TT> for any dump created between 20:55:00 and
|
|
20:55:59. Automatically adding 59 seconds to a time thus
|
|
includes the records for all dumps created during that minute.
|
|
</UL>
|
|
<TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">A plus sign follows this argument in the command's syntax statement
|
|
because it accepts a multiword value which does not need to be enclosed in
|
|
double quotes or other delimiters, not because it accepts multiple
|
|
dates. Provide only one date (and optionally, time) definition.
|
|
</TD></TR></TABLE>
|
|
<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 writes a copy of the Backup Database to the tape
|
|
device controlled by the Tape Coordinator with port offset 1:
|
|
<PRE> % <B>backup savedb -portoffset 1</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="auarf085.htm#HDRBK_RESTOREDB">backup restoredb</A>
|
|
<P><A HREF="auarf126.htm#HDRBUTC">butc</A>
|
|
<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="auarf085.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="auarf087.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>
|