Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | fs_newcell - Changes the kernel-resident list of a cell's database servers | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<fs newcell> S<<< B<-name> <I<cell name>> >>> -servers <I<primary servers>>+ | |
11 | S<<< [B<-linkedcell> <I<linked cell name>>] >>> [B<-help>] | |
12 | ||
13 | B<fs n> S<<< B<-n> <I<cell name>> >>> S<<< B<-s> <I<primary servers>>+ >>> | |
14 | S<<< [B<-l> <I<linked cell name>>] >>> [B<-h>] | |
15 | ||
16 | =for html | |
17 | </div> | |
18 | ||
19 | =head1 DESCRIPTION | |
20 | ||
21 | The B<fs newcell> command removes the Cache Manager's kernel-resident list | |
22 | of database server machines for the cell specified by the B<-name> | |
23 | argument and replaces it with the database server machines named by the | |
24 | B<-servers> argument. | |
25 | ||
26 | Each time the machine reboots, the Cache Manager constructs the kernel | |
27 | list of cells and database server machines by reading the local | |
28 | F</usr/vice/etc/CellServDB> file. This command does not change the | |
29 | F<CellServDB> file, so any changes made with it persist only until the | |
30 | next reboot, unless the issuer also edits the file. The output of the B<fs | |
31 | listcells> command reflects changes made with this command, because that | |
32 | command consults the kernel-resident list rather than the F<CellServDB> | |
33 | file. | |
34 | ||
35 | This command can introduce a completely new cell into the kernel-resident | |
36 | list, but cannot make a cell inaccessible (it is not possible to remove a | |
37 | cell's entry from the kernel-resident list by providing no values for the | |
38 | B<-server> argument). To make a cell inaccessible, remove its entry from | |
39 | the F<CellServDB> file and reboot the machine. | |
40 | ||
41 | The B<-linkedcell> argument specifies the name of the AFS cell to link to | |
42 | another AFS cell for the purpose of retrying volume lookups. When two | |
43 | cells are linked, a volume lookup in one cell that fails is retried in the | |
44 | linked cell. | |
45 | ||
46 | =head1 CAUTIONS | |
47 | ||
48 | Some commands, such as the B<aklog> or B<klog.krb5> commands, work correctly | |
49 | only when the information is accurate for a cell in both the F<CellServDB> file | |
50 | and the kernel-resident list. | |
51 | ||
52 | =head1 OPTIONS | |
53 | ||
54 | =over 4 | |
55 | ||
56 | =item B<-name> <I<cell name>> | |
57 | ||
58 | Specifies the fully-qualified cell name of the AFS or DCE cell. | |
59 | ||
60 | =item B<-servers> <I<primary servers>>+ | |
61 | ||
62 | Specifies the fully-qualified hostnames of all AFS database server | |
63 | machines for the cell named by the B<-name> argument. | |
64 | ||
65 | =item B<-linkedcell> <I<linked cell name>> | |
66 | ||
67 | Specifies the name of the AFS cell to link to another AFS cell for the | |
68 | purpose of retrying volume lookups. When two cells are linked, a volume | |
69 | lookup in one cell that fails is retried in the linked cell. | |
70 | ||
71 | =item B<-help> | |
72 | ||
73 | Prints the online help for this command. All other valid options are | |
74 | ignored. | |
75 | ||
76 | =back | |
77 | ||
78 | =head1 WINDOWS | |
79 | ||
80 | The B<fs newcell> command on Windows differs from the Unix version in a few ways. | |
81 | ||
82 | B<fs newcell> with no arguments discards the existing cell information. | |
83 | The Windows client will reload a cell's information the next time it | |
84 | needs the server list for a cell. | |
85 | ||
86 | Secondly, in addition to accepting the Unix options, B<fs newcell> on | |
87 | Windows accepts the following options: | |
88 | ||
89 | =over 4 | |
90 | ||
91 | =item B<-dns> | |
92 | ||
93 | Adds the new cell to the cache manager, and obtains the VLDB server | |
94 | information from DNS. | |
95 | ||
96 | =item B<-registry> | |
97 | ||
98 | Adds the new cell to the cache manager, and also saves the cell | |
99 | configuration data in the registry for use the next time the service | |
100 | restarts. | |
101 | ||
102 | =item B<-vlport> <I<cell VLDB server port>> | |
103 | ||
104 | Specifies an alternate port number at which the cell's volume location | |
105 | database servers are listening. | |
106 | ||
107 | =item B<-fsport> <I<cell fileserver port>> | |
108 | ||
109 | Specifies an alternate port number at which the cell's file servers are | |
110 | listening. | |
111 | ||
112 | =back | |
113 | ||
114 | =head1 EXAMPLES | |
115 | ||
116 | The following example changes the machine's kernel-resident list of | |
117 | database server machines for the Example Corporation cell to include the | |
118 | machines C<db1.example.com> and C<db2.example.com>: | |
119 | ||
120 | % fs newcell -name example.com -servers db1.example.com db2.example.com | |
121 | ||
122 | The following example links the AFS cell C<dce.example.com> to the AFS cell | |
123 | C<example.com>. The AFS client contacts the Volume Location (VL) servers | |
124 | C<db1.dce.example.com> and C<db2.dce.example.com> for volume location | |
125 | information. | |
126 | ||
127 | % fs newcell -name dce.example.com \ | |
128 | -servers db1.dce.example.com db2.dce.example.com \ | |
129 | -linkedcell example.com | |
130 | ||
131 | =head1 PRIVILEGE REQUIRED | |
132 | ||
133 | The issuer must be logged in as the local superuser root. | |
134 | ||
135 | =head1 SEE ALSO | |
136 | ||
137 | L<CellServDB(5)>, | |
138 | L<fs_listcells(1)> | |
139 | ||
140 | =head1 COPYRIGHT | |
141 | ||
142 | IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. | |
143 | ||
144 | This documentation is covered by the IBM Public License Version 1.0. It was | |
145 | converted from HTML to POD by software written by Chas Williams and Russ | |
146 | Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. |