=head1 NAME vos_convertROtoRW - Converts a Read-Only volume into a Read/Write volume =head1 SYNOPSIS =for html
B S<<< [B<-server>] > >>> S<<< [B<-partition>] > >>> S<<< [B<-id>] > >>> [B<-force>] S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-encrypt>] [B<-help>] =for html
=head1 DESCRIPTION B converts a Read-Only volume into a Read/Write volume when the original Read/Write volume is no longer available. It's normal use is to recover the Read/Write volume from a replica after a failed disk, failed server, or accidental deletion. =head1 CAUTIONS The command name is case-sensitive. It must be issued with the capital "RO" and "RW". =head1 OPTIONS =over 4 =item B<-server> > Identifies the file server machine that houses the Read-Only volume which will be converted. Provide the machine's IP address or its host name (either fully qualified or using an unambiguous abbreviation). For details, see L. =item B<-partition> > Identifies the partition on the file server machine that houses the Read-Only volume which will be converted. Provide the full partition name (for, example, B) or one of the abbreviated forms described in L. =item B<-id> > Specifies either the complete name or volume ID number of a Read/Write volume. =item B<-force> Don't ask for confirmation. =item B<-cell> > Names the cell in which to run the command. Do not combine this argument with the B<-localauth> flag. For more details, see L. =item B<-noauth> Assigns the unprivileged identity C to the issuer. Do not combine this flag with the B<-localauth> flag. For more details, see L. =item B<-localauth> Constructs a server ticket using a key from the local F file. The B command interpreter presents it to the Volume Server and Volume Location Server during mutual authentication. Do not combine this flag with the B<-cell> argument or B<-noauth> flag. For more details, see L. =item B<-verbose> Produces on the standard output stream a detailed trace of the command's execution. If this argument is omitted, only warnings and error messages appear. =item B<-encrypt> Encrypts the command so that the operation's results are not transmitted across the network in clear text. =item B<-help> Prints the online help for this command. All other valid options are ignored. =back =head1 EXAMPLES The following example converts the read-only volume test3.readonly in partition vicepb on server1 to a read-write volume: % vos convertROtoRW server1 b test3.readonly =head1 PRIVILEGE REQUIRED The issuer must be listed in the F file on the machines specified with the B<-toserver> and B<-fromserver> arguments and on each database server machine. If the B<-localauth> flag is included, the issuer must instead be logged on to a server machine as the local superuser C. =head1 SEE ALSO L =head1 COPYRIGHT Copyright 2007 Jason Edgecombe This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.