doc/man-pages/pod1/vos_convertROtoRW.pod.in

   1 =head1 NAME
   2
   3 vos_convertROtoRW - Converts a Read-Only volume into a Read/Write volume
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<vos convertROtoRW> S<<< [B<-server>] <I<machine name>> >>>
  11    S<<< [B<-partition>] <I<partition name>> >>>
  12    S<<< [B<-id>] <I<volume name or ID>> >>> [B<-force>]
  13    S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
  14    [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
  15    S<<< [B<-config> <I<config directory>>] >>>
  16    [B<-help>]
  17
  18 B<vos con> S<<< [B<-s>] <I<machine name>> >>>
  19    S<<< [B<-p>] <I<partition name>> >>>
  20    S<<< [B<-i>] <I<volume name or ID>> >>> [B<-f>]
  21    S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-l>]
  22    [B<-v>] [B<-e>] [B<-nor>]
  23    S<<< [B<-co> <I<config directory>>] >>>
  24    [B<-h>]
  25
  26 =for html
  27 </div>
  28
  29 =head1 DESCRIPTION
  30
  31 B<vos convertROtoRW> converts a Read-Only volume into a Read/Write volume
  32 when the original Read/Write volume is no longer available.  It's normal use
  33 is to recover the Read/Write volume from a replica after a failed disk,
  34 failed server, or accidental deletion.
  35
  36 =head1 CAUTIONS
  37
  38 The command name is case-sensitive.  It must be issued with the capital "RO"
  39 and "RW".
  40
  41 After running vos convertROtoRW, the old file server will still contain
  42 the old Read/Write copy of the volume, even if the VLDB no longer
  43 references it. You can view the old volume with B<vos listvol>, and you
  44 should remove the old copy (for example, with B<vos zap>) so that the
  45 original file server will match the VLDB.
  46
  47 =head1 OPTIONS
  48
  49 =over 4
  50
  51 =item B<-server> <I<server name>>
  52
  53 Identifies the file server machine that houses the Read-Only volume which
  54 will be converted.  Provide the machine's IP address or its host name
  55 (either fully qualified or using an unambiguous abbreviation).  For details,
  56 see L<vos(1)>.
  57
  58 =item B<-partition> <I<partition name>>
  59
  60 Identifies the partition on the file server machine that houses the
  61 Read-Only volume which will be converted.  Provide the full partition name
  62 (for, example, B</vicepa>) or one of the abbreviated forms described in
  63 L<vos(1)>.
  64
  65 =item B<-id> <I<volume ID>>
  66
  67 Specifies either the complete name or volume ID number of a Read/Write
  68 volume.
  69
  70 =item B<-force>
  71
  72 Don't ask for confirmation.
  73
  74 =include fragments/vos-common.pod
  75
  76 =back
  77
  78 =head1 EXAMPLES
  79
  80 The following example converts the read-only volume test3.readonly in
  81 partition vicepb on server1 to a read-write volume:
  82
  83    % vos convertROtoRW server1 b test3.readonly
  84
  85 =head1 PRIVILEGE REQUIRED
  86
  87 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
  88 machine specified with the B<-server> argument and
  89 on each database server machine.  If the B<-localauth> flag is included,
  90 the issuer must instead be logged on to a server machine as the local
  91 superuser C<root>.
  92
  93 =head1 SEE ALSO
  94
  95 L<vos(1)>
  96
  97 =head1 COPYRIGHT
  98
  99 Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
 100
 101 This documentation is covered by the BSD License as written in the
 102 doc/LICENSE file. This man page was written by Jason Edgecombe for
 103 OpenAFS.