src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf064.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="auarf063.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="auarf065.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_ADDVOLSET" HREF="auarf002.htm#ToC_78">backup addvolset</A></H2>
  19 <A NAME="IDX4255"></A>
  20 <A NAME="IDX4256"></A>
  21 <A NAME="IDX4257"></A>
  22 <A NAME="IDX4258"></A>
  23 <A NAME="IDX4259"></A>
  24 <A NAME="IDX4260"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Creates a new (empty) volume set
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>backup addvolset -name</B> &lt;<VAR>volume&nbsp;set&nbsp;name</VAR>> [<B>-temporary</B>]
  29                  [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  30
  31 <B>backup addvols -n</B> &lt;<VAR>volume&nbsp;set&nbsp;name</VAR>> [<B>-t</B>]  [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell name</VAR>>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>backup addvolset</B> command creates a new volume set, by
  35 default adding it to the Backup Database. It is best that the volume
  36 set&#39;s name indicate the volume set&#39;s contents; for example,
  37 define the volume entries in the <B>user</B> volume set to match all user
  38 volumes. The volume set name must be unique within the Backup Database
  39 of the local cell.
  40 <P>After issuing this command, issue the <B>backup addvolentry</B> command
  41 to define the volume entries in the volume set.
  42 <P>Sometimes it is convenient to create volume sets without recording them
  43 permanently in the Backup Database, for example when using the <B>backup
  44 volsetrestore</B> command to restore a group of volumes that were not
  45 necessarily backed up together. To create a <I>temporary</I> volume
  46 set, include the <B>-temporary</B> flag. A temporary volume set
  47 exists only during the lifetime of the current interactive session, so the
  48 flag is effective only when used during an interactive session (opened by
  49 issuing the <B>backup interactive</B> command). If it is included
  50 when the command is issued at the regular command shell prompt, the command
  51 appears to succeed, but the volume set is not created. As noted, a
  52 temporary volume set ceases to exist when the current interactive session
  53 ends, or use the <B>backup delvolset</B> command to delete it before
  54 that.
  55 <P>One advantage of temporary volume sets is that the <B>backup
  56 addvolset</B> command, and any <B>backup addvolentry</B> commands
  57 subsequently used to add volume entries to it, complete more quickly than for
  58 regular volume sets, because no records are created in the Backup
  59 Database.
  60 <P><STRONG>Options</STRONG>
  61 <DL>
  62 <P><DT><B>-name
  63 </B><DD>Names the new volume set. The name can include up to 31 of any
  64 character other than the period. Avoid other metacharacters as
  65 well.
  66 <P><DT><B>-temporary
  67 </B><DD>Creates a volume set that exists only within the context of the current
  68 interactive session. It is not added to the Backup Database.
  69 <P><DT><B>-localauth
  70 </B><DD>Constructs a server ticket using a key from the local
  71 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
  72 interpreter presents it to the Backup Server, Volume Server and VL Server
  73 during mutual authentication. Do not combine this flag with the
  74 <B>-cell</B> argument. For more details, see the introductory
  75 <B>backup</B> reference page.
  76 <P><DT><B>-cell
  77 </B><DD>Names the cell in which to run the command. Do not combine this
  78 argument with the <B>-localauth</B> flag. For more details, see the
  79 introductory <B>backup</B> reference page.
  80 <P><DT><B>-help
  81 </B><DD>Prints the online help for this command. All other valid options
  82 are ignored.
  83 </DL>
  84 <P><STRONG>Examples</STRONG>
  85 <P>The following command creates a volume set called <B>sys</B>&#58;
  86 <PRE>   % <B>backup addvolset sys</B>
  87
  88 </PRE>
  89 <P><STRONG>Privilege Required</STRONG>
  90 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
  91 every machine where the Backup Server is running, or must be logged onto a
  92 server machine as the local superuser <B>root</B> if the
  93 <B>-localauth</B> flag is included.
  94 <P><STRONG>Related Information</STRONG>
  95 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
  96 <P><A HREF="auarf063.htm#HDRBK_ADDVOLENTRY">backup addvolentry</A>
  97 <P><A HREF="auarf070.htm#HDRBK_DELVOLENTRY">backup delvolentry</A>
  98 <P><A HREF="auarf071.htm#HDRBK_DELVOLSET">backup delvolset</A>
  99 <P><A HREF="auarf082.htm#HDRBK_LISTVOLSETS">backup listvolsets</A>
 100 <P><A HREF="auarf092.htm#HDRBK_VOLSETRESTORE">backup volsetrestore</A>
 101 <P>
 102 <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="auarf063.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="auarf065.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>
 103 <!-- Begin Footer Records  ========================================== -->
 104 <P><HR><B>
 105 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 106 </B>
 107 <!-- End Footer Records  ============================================ -->
 108 <A NAME="Bot_Of_Page"></A>
 109 </BODY></HTML>