1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry id="vos_backup1">
4 <refentrytitle>vos backup</refentrytitle>
5 <manvolnum>1</manvolnum>
8 <refname>vos backup</refname>
9 <refpurpose>Creates a backup volume for a single read/write volume</refpurpose>
12 <title>Synopsis</title>
13 <para><emphasis role="bold">vos backup</emphasis> <emphasis role="bold">-id</emphasis> <<emphasis>volume name or ID</emphasis>> [<emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>]
14 [<emphasis role="bold">-noauth</emphasis>] [<emphasis role="bold">-localauth</emphasis>] [<emphasis role="bold">-verbose</emphasis>] [<emphasis role="bold">-help</emphasis>]</para>
16 <para><emphasis role="bold">vos backup</emphasis> <emphasis role="bold">-i</emphasis> <<emphasis>volume name or ID</emphasis>> [<emphasis role="bold">-c</emphasis><<emphasis>cell name</emphasis>>]
17 [<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-l</emphasis>] [<emphasis role="bold">-v</emphasis>] [<emphasis role="bold">-h</emphasis>]</para>
21 <title>Description</title>
22 <para>The <emphasis role="bold">vos backup</emphasis> command clones the indicated read/write volume to create
23 a backup version, placing it at the same site as the read/write
24 version. The backup volume's name is the same as the read/write source's
25 with the addition of the <computeroutput>.backup</computeroutput> extension. Its volume ID number is the
26 one allocated for it in the Volume Location Database (VLDB) when the
27 read/write source was created with the <emphasis role="bold">vos create</emphasis> command. If a backup
28 version already exists, the new clone replaces it.</para>
30 <para>To create a backup version of multiple volumes, use the <emphasis role="bold">vos backupsys</emphasis>
35 <title>Options</title>
38 <term><emphasis role="bold">-id</emphasis> <<emphasis>volume name or ID</emphasis>></term>
40 <para>Specifies either the complete name or volume ID number of the read/write
46 <term><emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>></term>
48 <para>Names the cell in which to run the command. Do not combine this argument
49 with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="vos1">vos(1)</link>.</para>
54 <term><emphasis role="bold">-noauth</emphasis></term>
56 <para>Assigns the unprivileged identity anonymous to the issuer. Do not combine
57 this flag with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="vos1">vos(1)</link>.</para>
62 <term><emphasis role="bold">-localauth</emphasis></term>
64 <para>Constructs a server ticket using a key from the local
65 <replaceable>/usr/afs/etc/KeyFile</replaceable> file. The <emphasis role="bold">vos</emphasis> command interpreter presents it
66 to the Volume Server and Volume Location Server during mutual
67 authentication. Do not combine this flag with the <emphasis role="bold">-cell</emphasis> argument or
68 <emphasis role="bold">-noauth</emphasis> flag. For more details, see <link linkend="vos1">vos(1)</link>.</para>
73 <term><emphasis role="bold">-verbose</emphasis></term>
75 <para>Produces on the standard output stream a detailed trace of the command's
76 execution. If this argument is omitted, only warnings and error messages
82 <term><emphasis role="bold">-help</emphasis></term>
84 <para>Prints the online help for this command. All other valid options are
93 <para>The following message confirms that the command succeeded:</para>
96 Created backup volume for I&lt;volume name&gt;
101 <title>Examples</title>
102 <para>The following example creates a backup version of the volume
103 <computeroutput>user.smith</computeroutput>.</para>
106 % vos backup user.smith
107 Created backup volume for user.smith
112 <title>Privilege Required</title>
113 <para>The issuer must be listed in the <replaceable>/usr/afs/etc/UserList</replaceable> file on the
114 machine specified with the <emphasis role="bold">-server</emphasis> argument and on each database server
115 machine. If the <emphasis role="bold">-localauth</emphasis> flag is included, the issuer must instead be
116 logged on to a server machine as the local superuser <computeroutput>root</computeroutput>.</para>
120 <title>See Also</title>
121 <para><link linkend="vos1">vos(1)</link>,
122 <link linkend="vos_backupsys1">vos_backupsys(1)</link></para>
126 <title>Copyright</title>
127 <para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
129 <para>This documentation is covered by the IBM Public License Version 1.0. It was
130 converted from HTML to POD by software written by Chas Williams and Russ
131 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>