doc/html/AdminReference/auarf080.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18: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="auarf079.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="auarf081.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_LISTDUMPS" HREF="auarf002.htm#ToC_94">backup listdumps</A></H2>
  19 <P><STRONG>Purpose</STRONG>
  20 <A NAME="IDX4357"></A>
  21 <A NAME="IDX4358"></A>
  22 <A NAME="IDX4359"></A>
  23 <A NAME="IDX4360"></A>
  24 <A NAME="IDX4361"></A>
  25 <A NAME="IDX4362"></A>
  26 <A NAME="IDX4363"></A>
  27 <A NAME="IDX4364"></A>
  28 <P>Displays the dump hierarchy from the Backup Database
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>backup listdumps</B>  [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  31
  32 <B>backup listd</B>  [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  33 </PRE>
  34 <P><STRONG>Description</STRONG>
  35 <P>The <B>backup listdumps</B> command displays the dump hierarchy from
  36 the Backup Database.
  37 <P><STRONG>Options</STRONG>
  38 <DL>
  39 <P><DT><B>-localauth
  40 </B><DD>Constructs a server ticket using a key from the local
  41 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
  42 interpreter presents it to the Backup Server, Volume Server and VL Server
  43 during mutual authentication. Do not combine this flag with the
  44 <B>-cell</B> argument. For more details, see the introductory
  45 <B>backup</B> reference page.
  46 <P><DT><B>-cell
  47 </B><DD>Names the cell in which to run the command. Do not combine this
  48 argument with the <B>-localauth</B> flag. For more details, see the
  49 introductory <B>backup</B> reference page.
  50 <P><DT><B>-help
  51 </B><DD>Prints the online help for this command. All other valid options
  52 are ignored.
  53 </DL>
  54 <P><STRONG>Output</STRONG>
  55 <P>The output displays the complete dump hierarchy and indicates the
  56 relationship between full and incremental dump levels. Full dump levels
  57 appear at the left margin. The hierarchy can include more than one full
  58 dump level; each one defines a subhierarchy of dump levels that can be
  59 used for dumping different volume sets.
  60 <P>Incremental dump levels appear below and indented to the right of their
  61 parent dump levels, which can be either full or incremental. Since
  62 multiple incremental dump levels can share the same parent, an incremental
  63 dump level is not always directly below its parent; the amount of
  64 indentation indicates the parent/child relationship.
  65 <P>If a dump level has an associated expiration date, it appears along with
  66 the level name. Absolute expiration dates appear in the format
  67 <PRE>   <VAR>dump_level</VAR> expires at <VAR>day month date time year</VAR>
  68
  69 </PRE>
  70 <P>and relative expiration dates in the format
  71 <PRE>   <VAR>dump_level</VAR> expires in {<VAR>years</VAR>y | <VAR>months</VAR>m | <VAR>days</VAR>d}
  72
  73 </PRE>
  74 <P>to indicate the number of years, months, days, or combination of the three
  75 after creation a dump expires when created at this level.
  76 <P><STRONG>Examples</STRONG>
  77 <P>The following example depicts six dump hierarchies. The expiration
  78 date for all incremental dump levels is 13 days so that the corresponding
  79 tapes can be recycled two weeks after their creation. The expiration
  80 dates for all full dump levels is 27 days so that the corresponding tapes can
  81 be recycled four weeks after their creation.
  82 <PRE>   % <B>backup listdumps</B>
  83    /week1  expires in  27d
  84          /tuesday  expires in  13d
  85                  /thursday  expires in  13d
  86          /sunday  expires in  13d
  87                 /tuesday expires in  13d
  88                         /thursday expires in  13d
  89    /week3  expires in  27d
  90          /tuesday  expires in  13d
  91                  /thursday  expires in  13d
  92          /sunday  expires in  13d
  93                 /tuesday  expires in  13d
  94                         /thursday  expires in  13d
  95    /sunday1  expires in  27d
  96            /monday1  expires in  13d
  97            /tuesday1  expires in  13d
  98            /wednesday1  expires in  13d
  99            /thursday1  expires in  13d
 100            /friday1  expires in  13d
 101    /sunday2  expires in  27d
 102            /monday2  expires in  13d
 103            /tuesday2  expires in  13d
 104            /wednesday2  expires in  13d
 105            /thursday2  expires in  13d
 106            /friday2  expires in  13d
 107    /sunday3  expires in  27d
 108            /monday1  expires in  13d
 109            /tuesday1  expires in  13d
 110            /wednesday1  expires in  13d
 111            /thursday1  expires in  13d
 112            /friday1  expires in  13d
 113    /sunday4  expires in  27d
 114            /monday2  expires in  13d
 115            /tuesday2  expires in  13d
 116            /wednesday2  expires in  13d
 117            /thursday2  expires in  13d
 118            /friday2  expires in  13d
 119
 120 </PRE>
 121 <P><STRONG>Privilege Required</STRONG>
 122 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 123 every machine where the Backup Server is running, or must be logged onto a
 124 server machine as the local superuser <B>root</B> if the
 125 <B>-localauth</B> flag is included.
 126 <P><STRONG>Related Information</STRONG>
 127 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 128 <P><A HREF="auarf061.htm#HDRBK_ADDDUMP">backup adddump</A>
 129 <P><A HREF="auarf067.htm#HDRBK_DELDUMP">backup deldump</A>
 130 <P>
 131 <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="auarf079.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="auarf081.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>
 132 <!-- Begin Footer Records  ========================================== -->
 133 <P><HR><B>
 134 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 135 </B>
 136 <!-- End Footer Records  ============================================ -->
 137 <A NAME="Bot_Of_Page"></A>
 138 </BODY></HTML>