backport to buster
[hcoop/debian/openafs.git] / doc / man-pages / pod1 / vos_remaddrs.pod.in
CommitLineData
805e021f
CE
1=head1 NAME
2
3vos_remaddrs - removes a file server machine's entry from the VLDB
4
5=head1 SYNOPSIS
6
7=for html
8<div class="synopsis">
9
10B<vos remaddrs> S<<< B<-uuid> <I<UUID of server>> >>>
11 S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
12 [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
13 S<<< [B<-config> <I<config directory>>] >>>
14 [B<-help>]
15
16B<vos rema> S<<< B<-u> <I<UUID of server>> >>>
17 S<<< [B<-c> <I<cell name>>] >>>
18 [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>]
19 S<<< [B<-co> <I<config directory>>] >>>
20 [B<-h>]
21
22=for html
23</div>
24
25=head1 DESCRIPTION
26
27The B<vos remaddrs> command removes a server entry from the Volume Location
28Database (VLDB). There must be no VLDB entries that list the machine as a site
29for any version of a volume. If necessary, use the B<vos move> or B<vos remove>
30command to move or remove volumes. It is appropriate to remove a VLDB server
31entry when removing the corresponding file server machine from service.
32
33To display all VLDB server entries, use the B<vos listaddrs> command.
34
35=head1 OPTIONS
36
37=over 4
38
39=item B<-uuid> <I<UUID of server>>
40
41The unique ID as provided by the C<vos listaddrs -printuuid> command.
42
43=back
44
45=head1 EXAMPLES
46
47The following command removes the VLDB server entry for the file server
48with the addresses C<192.12.107.214> and C<10.47.11.17>.
49
50 $ vos remaddrs -uuid 008f157e-bad0-157c-0ffee-357c4d1faa77 -verbose
51 vos: Removing UUID with addresses:
52 UUID: 008f157e-bad0-157c-0ffee-357c4d1faa77
53 192.12.107.214
54 10.47.11.17
55
56=head1 PRIVILEGE REQUIRED
57
58Issuer must be listed in the F</usr/afs/etc/UserList> file on each database
59server machine.
60
61=head1 SEE ALSO
62
63L<CellServDB(5)>,
64L<UserList(5)>,
65L<fileserver(8)>,
66L<vos(1)>,
67L<vos_listaddrs(1)>,
68L<vos_setaddrs(1)>
69
70=head1 COPYRIGHT
71
72Copyright 2014 Sine Nomine Associates. All Rights Reserved.
73
74This documentation is covered by the BSD License as written in the
75doc/LICENSE file. This man page was written by Michael Meffie for
76OpenAFS.