Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | vos_changeloc - Change a volume's entry in the VLDB | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<vos changeloc> S<<< [B<-server>] <I<new server name>> >>> | |
11 | S<<< [B<-partition>] <I<new partition location>> >>> | |
12 | S<<< [B<-id>] <I<volume name or ID>> >>> | |
13 | S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] | |
14 | [B<-verbose>] [B<-encrypt>] [B<-noresolve>] | |
15 | S<<< [B<-config> <I<config directory>>] >>> | |
16 | [B<-help>] | |
17 | ||
18 | B<vos changel> S<<< [B<-s>] <I<new server name>> >>> | |
19 | S<<< [B<-p>] <I<new partition location>> >>> | |
20 | S<<< [B<-i>] <I<volume name or ID>> >>> | |
21 | S<<< [B<-c> <I<cell name>>] >>> | |
22 | [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] | |
23 | S<<< [B<-co> <I<config directory>>] >>> | |
24 | [B<-h>] | |
25 | ||
26 | =for html | |
27 | </div> | |
28 | ||
29 | =head1 DESCRIPTION | |
30 | ||
31 | The B<vos changeloc> command changes the location of a volume in the | |
32 | Volume Location Database (VLDB) without needing to contact the original | |
33 | file server on which the volume was hosted. This is useful when a file | |
34 | server has gone down permanently and the data that was stored on that | |
35 | server has been moved to a new file server with a different name and IP | |
36 | address (perhaps by mounting the same /vicepX partitions on a different | |
37 | host). After moving the data and running B<vos changeloc>, run B<vos | |
38 | syncvldb> and then B<vos syncserv> against the new server to ensure full | |
39 | synchronization of the VLDB with the file server. | |
40 | ||
41 | In essence, B<vos changeloc> performs the same operations on the VLDB as | |
42 | B<vos move>, but it does NOT move the data from one server's file system | |
43 | to another. | |
44 | ||
45 | =head1 CAUTIONS | |
46 | ||
47 | Using B<vos changeloc> changes the VLDB without modifying the file server | |
48 | data, so it inherently causes the VLDB to be out of sync with the data on | |
49 | the servers. It should only be used when recovering from server failure. | |
50 | If the servers are on-line, B<vos move> should be used instead. It is | |
51 | highly recommended that B<vos syncvldb> and B<vos syncserv> be run after | |
52 | using the B<vos changeloc> command to ensure properly synchronization of | |
53 | the VLDB with the file servers. | |
54 | ||
55 | =head1 OPTIONS | |
56 | ||
57 | B<vos changeloc> takes the following options: | |
58 | ||
59 | =over 4 | |
60 | ||
61 | =item B<-server> <I<new server name>> | |
62 | ||
63 | Specifies the new server where the VLDB should believe the volume resides. | |
64 | Provide the machine's IP address or its host name (either fully qualified | |
65 | or using an unambiguous abbreviation). For details, see L<vos(1)>. | |
66 | ||
67 | =item B<-partition> <I<partition name>> | |
68 | ||
69 | Specifies the partition where the VLDB should believe the volume resides. | |
70 | Provide the B<-server> argument along with this one. Provide the | |
71 | partition's complete name with preceding slash (for example, C</vicepa>) | |
72 | or use one of the three acceptable abbreviated forms. For details, see | |
73 | L<vos(1)>. | |
74 | ||
75 | =item B<-id> <I<volume name or ID>> | |
76 | ||
77 | Specifies the name or volume ID number on which to operate. | |
78 | ||
79 | =include fragments/vos-common.pod | |
80 | ||
81 | =back | |
82 | ||
83 | =head1 OUTPUT | |
84 | ||
85 | B<vos changeloc> shows a brief message upon completion: | |
86 | ||
87 | Changed location to server2 /vicepa for volume user.jdoe | |
88 | ||
89 | =head1 EXAMPLES | |
90 | ||
91 | The following command changes the location of the C<user.jdoe> volume to | |
92 | be F</vicepa> on the file server machine C<server2> while being verbose: | |
93 | ||
94 | % vos changeloc server2 a user.jdoe -verbose | |
95 | done | |
96 | Changed location to server2 /vicepa for volume user.jdoe | |
97 | ||
98 | The following command changes the location of the C<user.jdoe> volume to | |
99 | be F</vicepa> on C<server1> without being verbose: | |
100 | ||
101 | % vos changeloc server1 a user.jdoe | |
102 | Changed location to server1 /vicepa for volume user.jdoe | |
103 | ||
104 | =head1 PRIVILEGE REQUIRED | |
105 | ||
106 | The issuer must be listed in the F</usr/afs/etc/UserList> file on each | |
107 | database server machine. If the B<-localauth> flag is included, the issuer | |
108 | must instead be logged on to a server machine as the local superuser | |
109 | C<root>. | |
110 | ||
111 | =head1 SEE ALSO | |
112 | ||
113 | L<vos(1)>, | |
114 | L<vos_move(1)>, | |
115 | L<vos_syncserv(1)>, | |
116 | L<vos_syncvldb(1)> | |
117 | ||
118 | =head1 COPYRIGHT | |
119 | ||
120 | Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com> | |
121 | ||
122 | This documentation is covered by the BSD License as written in the | |
123 | doc/LICENSE file. This man page was written by Jason Edgecombe for | |
124 | OpenAFS. |