mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 07:20:11 +00:00
6ef9f39335
The NAME heading for man pages can't contain a space in the program side or the man pages won't index with some man implementations.
128 lines
4.1 KiB
Plaintext
128 lines
4.1 KiB
Plaintext
=head1 NAME
|
|
|
|
vos_remsite - Removes a read-only site definition from a VLDB entry
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
=for html
|
|
<div class="synopsis">
|
|
|
|
B<vos remsite> S<<< B<-server> <I<machine name>> >>>
|
|
S<<< B<-partition> <I<partition name>> >>> S<<< B<-id> <I<volume name or ID>> >>>
|
|
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-verbose>]
|
|
[B<-help>]
|
|
|
|
B<vos rems> S<<< B<-s> <I<machine name>> >>> S<<< B<-p> <I<partition name>> >>>
|
|
S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>]
|
|
[B<-v>] [B<-h>]
|
|
|
|
=for html
|
|
</div>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<vos remsite> command removes the read-only replication site
|
|
specified by the B<-machine> and B<-partition> arguments from the Volume
|
|
Location Database (VLDB) entry for the indicated volume, which is
|
|
read/write.
|
|
|
|
This command is useful for removing read-only sites that were mistakenly
|
|
created with the B<vos addsite> command, before the B<vos release> command
|
|
actually releases them. If a read-only copy already exists at the site, it
|
|
is not affected. However, if this read-only site was the last site housing
|
|
any version of the volume, then the entire VLDB entry is removed, even if
|
|
a copy of the read-only version still actually exists at the site. The VL
|
|
Server does not correct the discrepancy until the B<vos syncserv> and
|
|
B<vos syncvldb> commands are run.
|
|
|
|
=head1 CAUTIONS
|
|
|
|
Do not use this command as the standard way to remove a read-only volume,
|
|
because it can create a discrepancy between the VLDB and the volumes on
|
|
file server machines. Use the B<vos remove> command instead.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item B<-server> <I<server name>>
|
|
|
|
Specifies the file server machine portion of the site definition to
|
|
remove. Provide the machine's IP address or its host name (either fully
|
|
qualified or using an unambiguous abbreviation). For details, see
|
|
L<vos(1)>.
|
|
|
|
=item B<-partition> <I<partition name>>
|
|
|
|
Specifies the partition name portion of the site definition to
|
|
remove. Provide the partition's complete name with preceding slash (for
|
|
example, C</vicepa>) or use one of the three acceptable abbreviated
|
|
forms. For details, see L<vos(1)>.
|
|
|
|
=item B<-id> <I<volume name or id>>
|
|
|
|
Specifies either the complete name or volume ID number of the read/write
|
|
volume to remove.
|
|
|
|
=item B<-cell> <I<cell name>>
|
|
|
|
Names the cell in which to run the command. Do not combine this argument
|
|
with the B<-localauth> flag. For more details, see L<vos(1)>.
|
|
|
|
=item B<-noauth>
|
|
|
|
Assigns the unprivileged identity C<anonymous> to the issuer. Do not
|
|
combine this flag with the B<-localauth> flag. For more details, see
|
|
L<vos(1)>.
|
|
|
|
=item B<-localauth>
|
|
|
|
Constructs a server ticket using a key from the local
|
|
F</usr/afs/etc/KeyFile> file. The B<vos> 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<vos(1)>.
|
|
|
|
=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<-help>
|
|
|
|
Prints the online help for this command. All other valid options are
|
|
ignored.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following command removes the mistakenly defined read-only site
|
|
F</viceph> on the file server machine C<fs5.abc.com> from the VLDB entry
|
|
for the volume C<root.cell>.
|
|
|
|
% vos remsite -server fs5.abc.com -partition h -id root.cell
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
The issuer must be listed in the F</usr/afs/etc/UserList> file on the
|
|
machine specified with the B<-server> argument 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<root>.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<vos(1)>,
|
|
L<vos_delentry(1)>,
|
|
L<vos_remove(1)>,
|
|
L<vos_zap(1)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|