+++ /dev/null
-<!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>
git://git.openafs.org / openafs.git / blobdiff