Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | vos_setaddrs - Set new addresses for a file server's entry in the VLDB | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<vos setaddrs> S<<< B<-uuid> <I<UUID of server>> >>> | |
11 | S<<< B<-host> <I<IP address>>+ >>> | |
12 | S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] | |
13 | [B<-verbose>] [B<-encrypt>] [B<-noresolve>] | |
14 | S<<< [B<-config> <I<config directory>>] >>> | |
15 | [B<-help>] | |
16 | ||
17 | B<vos seta> S<<< B<-u> <I<UUID of server>> >>> | |
18 | S<<< B<-ho> <I<IP address>>+ >>> | |
19 | S<<< [B<-c> <I<cell name>>] >>> | |
20 | [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] | |
21 | S<<< [B<-co> <I<config directory>>] >>> | |
22 | [B<-h>] | |
23 | ||
24 | =for html | |
25 | </div> | |
26 | ||
27 | =head1 DESCRIPTION | |
28 | ||
29 | The B<vos setaddrs> command sets the IP addresses for a server entry in | |
30 | the Volume Location Database (VLDB). Specify one or several IP addresses. | |
31 | All existing addresses in the VLDB server entry are replaced with the new | |
32 | addresses given on the command line. | |
33 | ||
34 | To find the UUID for a server entry, use the C<vos listaddrs -printuuid> | |
35 | command to display all VLDB server entries with their UUIDs. | |
36 | ||
37 | =head1 CAUTIONS | |
38 | ||
39 | Normally, the best way to change the registered addresses for a server | |
40 | entry is to restart the File Server process after changing the network | |
41 | configuration for that server and possibly the F<NetInfo> and | |
42 | F<NetRestrict> files for that server. See L<NetInfo(5)> and | |
43 | L<NetRestrict(5)> for more information about configuring the File Server | |
44 | to register the correct set of addresses. This command can be used to | |
45 | change the registered addresses without restarting the File Server, but | |
46 | the next time the File Server is restarted, it will register all of its | |
47 | known addresses again. You should therefore always ensure that the File | |
48 | Server configuration is correct for whenever it is next restarted before | |
49 | using this command. | |
50 | ||
51 | Setting the wrong addresses will make the volumes on that file server | |
52 | unreachable from AFS clients. | |
53 | ||
54 | This command was introduced in OpenAFS 1.5.74, but can be used with any | |
55 | version of the Volume Location Server. | |
56 | ||
57 | =head1 OPTIONS | |
58 | ||
59 | =over 4 | |
60 | ||
61 | =item B<-uuid> <I<UUID of server>> | |
62 | ||
63 | The unique ID as provided by the C<vos listaddrs -printuuid> command. | |
64 | ||
65 | =item B<-host> <I<IP address>>+ | |
66 | ||
67 | The new list of IP addresses for the File Server. | |
68 | ||
69 | =include fragments/vos-common.pod | |
70 | ||
71 | =back | |
72 | ||
73 | =head1 EXAMPLES | |
74 | ||
75 | The following command sets addresses C<192.12.107.214> and C<10.47.11.17> | |
76 | for the UUID 008f157e-bad0-157c-0ffee-357c4d1faa77 | |
77 | ||
78 | % vos setaddrs -uuid 008f157e-bad0-157c-0ffee-357c4d1faa77 \ | |
79 | -host 192.12.107.214 -host 10.47.11.17 -verbose | |
80 | vos: Changed UUID with addresses: | |
81 | UUID: 008f157e-bad0-157c-0ffee-357c4d1faa77 | |
82 | 192.12.107.214 | |
83 | 10.47.11.17 | |
84 | ||
85 | =head1 PRIVILEGE REQUIRED | |
86 | ||
87 | Issuer must be listed in the F</usr/afs/etc/UserList> file on each | |
88 | database server machine. | |
89 | ||
90 | =head1 SEE ALSO | |
91 | ||
92 | L<CellServDB(5)>, | |
93 | L<NetInfo(5)>, | |
94 | L<NetRestrict(5)>, | |
95 | L<UserList(5)>, | |
96 | L<sysid(5)>, | |
97 | L<fileserver(8)>, | |
98 | L<vos(1)>, | |
99 | L<vos_listaddrs(1)>, | |
100 | L<vos_remaddrs(1)> | |
101 | ||
102 | =head1 COPYRIGHT | |
103 | ||
104 | KTH 2010. All Rights Reserved. | |
105 | ||
106 | This documentation is covered by the IBM Public License Version 1.0. |