NAME

vos_convertROtoRW - Converts a Read-Only volume into a Read/Write volume

SYNOPSIS

vos convertROtoRW [-server] <machine name> [-partition] <partition name> [-id] <volume name or ID> [-force] [-cell <cell name>] [-noauth] [-auth] [-localauth] [-encrypt [<yes|no>]] [-verbose] [-noresolve] [-config <configuration file>] [-help]

DESCRIPTION

vos convertROtoRW creates a read/write volume from a read-only replica volume and updates the volume location entry information. The new volume location information will no longer reference the original read/write site for any volume type.

Converting a read-only replica on another File Server to a read/write volume can often be performed faster than restoring the read/write from a dump file or from tape backup. It is intended to be used when the original read/write volume has been permanently lost due to a failed disk, failed server, or accidental deletion.

CAUTIONS

vos convertROtoRW assumes that the File Server and partition containing the original read/write volume is inaccessible or the volume itself is lost.

vos convertROtoRW will make no effort to remove the original read/write volume from the File Server and partition it is housed on.

After running vos convertROtoRW, if the File Server and partition containing the original read/write volume is restored to operation or the original read/write volume is otherwise recovered, the cell administrator should remove it with vos_zap(1). The original read/write volume will not be accessble to Cache Managers because it will not be registered with the Location Service and it will cause problems if future attempts are made to vos_move(1) or vos_addsite(1) the new read/write volume to the original File Server and partition.

OPTIONS

-server <server name>

Identifies the File Server that houses the read-only volume that will be converted. Provide a fully qualified host name, an IP address or UUID as reported by vos_listfs(1).

-partition <partition name>

Identifies the partition on the File Server named by the -server argument where the read-only volume is to be converted. Provide the partition's complete name with preceding slash (for example, /vicepa) or use one of the three acceptable abbreviated forms. For details, see vos(1).

-id <volume name or ID>

Specifies either the name of a volume including the .readonly extension or ID of the readonly volume to be converted.

-force

vos convertROtoRW is a destructive operation that can result in the loss of user data and leave the state of the File Server housing the read/write volume out of sync with the Location Service. Provide the -force switch on the command line to avoid a confirmation prompt.

-cell <cell name>

Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see vos(1).

-noauth

Assigns the unprivileged identity anonymous to the issuer. Do not combine this flag with the -localauth flag. For more details, see vos(1).

-localauth

Obtains an authentication token using the server encryption key with the highest key version number in the local /etc/yfs/server/KeyFileExt file. The resulting token never expires and has Super User privileges. Do not combine this flag with the -cell argument or -noauth flag. For more details, see vos(1).

-auth

Use the calling user's tokens from the kernel or as obtained using the active Kerberos ticket granting ticket to communicate with the Volume Server and Location Service. This is the default if neither -localauth nor -noauth is given.

Since this option is the default, it is usually not useful for running single command line operations. However, it can be useful when running commands via vos_interactive(1) or vos_source(1), since otherwise it would be impossible to switch from, for example, -localauth back to using regular tokens during a bulk operation.

-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.

-encrypt [<yes|no>]

Enables or disables encrytion for the command so that the operation's results are not transmitted across the network in clear text.

-noresolve

Shows all servers as IP addresses instead of the reverse DNS lookup hostname. -noresolve useful when troubleshooting no such volume and volume moved errors.

-config <configuration file>

Set the location of the configuration file to be used. The default file is /etc/yfs/yfs-client.conf.

-help

Prints the online help for this command. All other valid options are ignored.

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

PRIVILEGE REQUIRED

The issuer must be listed in the /etc/yfs/server/UserListExt file on the File Server specified by the -server argument and on each Location Server. If the -localauth flag is included, the issuer must instead be logged on to a server with an account capable of reading the /etc/yfs/server/KeyFileExt file.

SEE ALSO

vos(1), vos_addsite(1), vos_listfs(1), vos_move(1), vos_zap(1)

COPYRIGHT

Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>

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.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.