3 vos_backup - Creates a backup volume for a single read/write volume
10 B<vos backup> S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-cell> <I<cell name>>] >>>
11 [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
13 B<vos backup> S<<< B<-i> <I<volume name or ID>> >>> [B<-c><I<cell name>>]
14 [B<-n>] [B<-l>] [B<-v>] [B<-h>]
21 The B<vos backup> command clones the indicated read/write volume to create
22 a backup version, placing it at the same site as the read/write
23 version. The backup volume's name is the same as the read/write source's
24 with the addition of the C<.backup> extension. Its volume ID number is the
25 one allocated for it in the Volume Location Database (VLDB) when the
26 read/write source was created with the B<vos create> command. If a backup
27 version already exists, the new clone replaces it.
29 To create a backup version of multiple volumes, use the B<vos backupsys>
36 =item B<-id> <I<volume name or ID>>
38 Specifies either the complete name or volume ID number of the read/write
41 =item B<-cell> <I<cell name>>
43 Names the cell in which to run the command. Do not combine this argument
44 with the B<-localauth> flag. For more details, see L<vos(1)>.
48 Assigns the unprivileged identity anonymous to the issuer. Do not combine
49 this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
53 Constructs a server ticket using a key from the local
54 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
55 to the Volume Server and Volume Location Server during mutual
56 authentication. Do not combine this flag with the B<-cell> argument or
57 B<-noauth> flag. For more details, see L<vos(1)>.
61 Produces on the standard output stream a detailed trace of the command's
62 execution. If this argument is omitted, only warnings and error messages
67 Prints the online help for this command. All other valid options are
74 The following message confirms that the command succeeded:
76 Created backup volume for I<volume name>
80 The following example creates a backup version of the volume
83 % vos backup user.smith
84 Created backup volume for user.smith
86 =head1 PRIVILEGE REQUIRED
88 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
89 machine specified with the B<-server> argument and on each database server
90 machine. If the B<-localauth> flag is included, the issuer must instead be
91 logged on to a server machine as the local superuser C<root>.
100 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
102 This documentation is covered by the IBM Public License Version 1.0. It was
103 converted from HTML to POD by software written by Chas Williams and Russ
104 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.