src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf068.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <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="auarf067.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="auarf069.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>
  17 <P>
  18 <H2><A NAME="HDRBK_DELETEDUMP" HREF="auarf002.htm#ToC_82">backup deletedump</A></H2>
  19 <A NAME="IDX4275"></A>
  20 <A NAME="IDX4276"></A>
  21 <A NAME="IDX4277"></A>
  22 <A NAME="IDX4278"></A>
  23 <A NAME="IDX4279"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Deletes one or more dump records from the Backup Database
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>backup deletedump</B> [<B>-dumpid</B> &lt;<VAR>dump&nbsp;id</VAR>><SUP>+</SUP>]  [<B>-from</B> &lt;<VAR>date&nbsp;time</VAR>><SUP>+</SUP>]  [<B>-to</B> &lt;<VAR>date&nbsp;time</VAR>><SUP>+</SUP>]
  28                   [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  29
  30 <B>backup dele</B> [<B>-d</B> &lt;<VAR>dump&nbsp;id</VAR>><SUP>+</SUP>]  [<B>-f</B> &lt;<VAR>date&nbsp;time</VAR>><SUP>+</SUP>]  [<B>-t</B> &lt;<VAR>date&nbsp;time</VAR>><SUP>+</SUP>]
  31             [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>backup deletedump</B> command deletes one or more dump records
  35 from the Backup Database. Either use the <B>-dumpid</B> argument to
  36 specify the dump ID number of one or more dumps, or use the <B>-from</B>
  37 and <B>-to</B> arguments to delete the records for all regular dumps
  38 created during the time period bracketed by the specified values.
  39 <P>Use this command to remove dump records that are incorrect (possibly
  40 because a dump operation was interrupted or failed), or that correspond to
  41 dumps that are expired or otherwise no longer needed.
  42 <P><STRONG>Cautions</STRONG>
  43 <P>The only way to remove the dump record for an appended dump is to remove
  44 the record for its initial dump, and doing so removes the records for all of
  45 the initial dump&#39;s associated appended dumps.
  46 <P>The only way to remove the record for a Backup Database dump (created with
  47 the <B>backup savedb</B> command) is to specify its dump ID number with
  48 the <B>-dumpid</B> argument. Using the <B>-from</B> and
  49 <B>-to</B> arguments never removes database dump records.
  50 <P>Removing records of a dump makes it impossible to restore data from the
  51 corresponding tapes or from any dump that refers to the deleted dump as its
  52 parent, directly or indirectly. That is, restore operations must begin
  53 with the full dump and continue with each incremental dump in order. If
  54 the records for a specific dump are removed, it is not possible to restore
  55 data from later incremental dumps unless the deleted records are restored by
  56 running the <B>backup scantape</B> command with the <B>-dbadd</B>
  57 flag.
  58 <P>If a dump set contains any dumps that were created outside the time range
  59 specified by the <B>-from</B> and <B>-to</B> arguments, the command
  60 does not delete any of the records associated with the dump set, even if some
  61 of them represent dumps created during the time range.
  62 <P><STRONG>Options</STRONG>
  63 <DL>
  64 <P><DT><B>-dumpid
  65 </B><DD>Specifies the dump ID of each dump record to delete. The
  66 corresponding dumps must be initial dumps; it is not possible to delete
  67 appended dump records directly, but only by deleting the record of their
  68 associated initial dump. Using this argument is the only way to delete
  69 records of Backup Database dumps (created with the <B>backup savedb</B>
  70 command).
  71 <P>Provide either this argument or the <B>-to</B> (and optionally
  72 <B>-from</B>) argument.
  73 <P><DT><B>-from
  74 </B><DD>Specifies the beginning of a range of dates; the record for any dump
  75 created during the indicated period of time is deleted.
  76 <P>Omit this argument to indicate the default of midnight (00&#58;00 hours)
  77 on 1 January 1970 (UNIX time zero), or provide a date value in the format
  78 <VAR>mm/dd/yyyy</VAR> [<VAR>hh&#58;MM</VAR>]. The month (<VAR>mm</VAR>),
  79 day (<VAR>dd</VAR>), and year (<VAR>yyyy</VAR>) are required. The hour and
  80 minutes (<VAR>hh</VAR>&#58;<VAR>MM</VAR>) are optional, but if provided must be
  81 in 24-hour format (for example, the value <B>14&#58;36</B> represents
  82 2&#58;36 p.m.). If omitted, the time defaults to
  83 midnight (00&#58;00 hours).
  84 <P>The <B>-to</B> argument must be provided along with this one.
  85 <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&#39;s syntax statement
  86 because it accepts a multiword value which does not need to be enclosed in
  87 double quotes or other delimiters, not because it accepts multiple
  88 dates. Provide only one date (and optionally, time) definition.
  89 </TD></TR></TABLE>
  90 <P><DT><B>-to
  91 </B><DD>Specifies the end of a range of dates; the record of any dump created
  92 during the range is deleted from the Backup Database.
  93 <P>Provide either the value <B>NOW</B> to indicate the current date and
  94 time, or a date value in the same format as for the <B>-from</B>
  95 argument. Valid values for the year (<VAR>yyyy</VAR>) range from
  96 <B>1970</B> to <B>2037</B>; higher values are not valid because
  97 the latest possible date in the standard UNIX representation is in February
  98 2038. The command interpreter automatically reduces any later date to
  99 the maximum value.
 100 <P>If the time portion (<VAR>hh&#58;MM</VAR>) is omitted, it defaults to 59
 101 seconds after midnight (00&#58;00&#58;59 hours). Similarly, the
 102 <B>backup</B> command interpreter automatically adds 59 seconds to any
 103 time value provided. In both cases, adding 59 seconds compensates for
 104 how the Backup Database and <B>backup dumpinfo</B> command represent dump
 105 creation times in hours and minutes only. For example, the Database
 106 records a creation timestamp of <TT>20&#58;55</TT> for any dump operation
 107 that begins between 20&#58;55&#58;00 and 20&#58;55&#58;59.
 108 Automatically adding 59 seconds to a time thus includes the records for all
 109 dumps created during that minute.
 110 <P>Provide either this argument, or the <B>-dumpid</B> argument.
 111 This argument is required if the <B>-from</B> argument is provided.
 112 <P><B>Caution&#58;</B> Specifying the value <B>NOW</B> for this
 113 argument when the <B>-from</B> argument is omitted deletes all dump
 114 records from the Backup Database (except for Backup Database dump records
 115 created with the <B>backup savedb</B> command).
 116 <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&#39;s syntax statement
 117 because it accepts a multiword value which does not need to be enclosed in
 118 double quotes or other delimiters, not because it accepts multiple
 119 dates. Provide only one date (and optionally, time) definition.
 120 </TD></TR></TABLE>
 121 <P><DT><B>-localauth
 122 </B><DD>Constructs a server ticket using a key from the local
 123 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
 124 interpreter presents it to the Backup Server, Volume Server and VL Server
 125 during mutual authentication. Do not combine this flag with the
 126 <B>-cell</B> argument. For more details, see the introductory
 127 <B>backup</B> reference page.
 128 <P><DT><B>-cell
 129 </B><DD>Names the cell in which to run the command. Do not combine this
 130 argument with the <B>-localauth</B> flag. For more details, see the
 131 introductory <B>backup</B> reference page.
 132 <P><DT><B>-help
 133 </B><DD>Prints the online help for this command. All other valid options
 134 are ignored.
 135 </DL>
 136 <P><STRONG>Output</STRONG>
 137 <P>At the conclusion of processing, the output lists the dump IDs of all dump
 138 records deleted in the following format&#58;
 139 <PRE>   The following dumps were deleted&#58;
 140         <VAR>dump ID 1</VAR>
 141         <VAR>dump ID 2</VAR>
 142         <VAR>etc.</VAR>
 143
 144 </PRE>
 145 <P><STRONG>Examples</STRONG>
 146 <P>The following command deletes the dump record with dump ID 653777462, and
 147 for any appended dumps associated with it&#58;
 148 <PRE>   % <B>backup deletedump -dumpid 653777462</B>
 149    The following dumps were deleted&#58;
 150         653777462
 151
 152 </PRE>
 153 <P>The following command deletes the Backup Database record of all dumps
 154 created between midnight on 1 January 1997 and 23&#58;59&#58;59 hours on
 155 31 December 1997&#58;
 156 <PRE>   % <B>backup deletedump -from 01/01/1997 -to 12/31/1997</B>
 157    The following dumps were deleted&#58;
 158         598324045
 159         598346873
 160            ...
 161            ...
 162         653777523
 163         653779648
 164
 165 </PRE>
 166 <P><STRONG>Privilege Required</STRONG>
 167 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 168 every machine where the Backup Server is running, or must be logged onto a
 169 server machine as the local superuser <B>root</B> if the
 170 <B>-localauth</B> flag is included.
 171 <P><STRONG>Related Information</STRONG>
 172 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 173 <P><A HREF="auarf074.htm#HDRBK_DUMPINFO">backup dumpinfo</A>
 174 <P><A HREF="auarf087.htm#HDRBK_SCANTAPE">backup scantape</A>
 175 <P>
 176 <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="auarf067.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="auarf069.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>
 177 <!-- Begin Footer Records  ========================================== -->
 178 <P><HR><B>
 179 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 180 </B>
 181 <!-- End Footer Records  ============================================ -->
 182 <A NAME="Bot_Of_Page"></A>
 183 </BODY></HTML>