[openafs.git] / doc / html / QuickStartWindows / awqbg003.htm
3 <TITLE>Quick Beginnings</TITLE>
4 <!-- Begin Header Records  ========================================== -->
5 <!-- /tmp/idwt3639/awqbg000.scr converted by idb2h R4.2 (359) ID      -->
6 <!-- Workbench Version (AIX) on 6 Dec 1999 at 11:23:35                -->
7 <META HTTP-EQUIV="updated" CONTENT="Mon, 06 Dec 1999 11:23:34">
8 <META HTTP-EQUIV="review" CONTENT="Wed, 06 Dec 2000 11:23:34">
9 <META HTTP-EQUIV="expires" CONTENT="Thu, 06 Dec 2001 11:23:34">
10 </HEAD><BODY>
11 <!-- (C) IBM Corporation 2000. All Rights Reserved    --> 
12 <BODY bgcolor="ffffff"> 
13 <!-- End Header Records  ============================================ -->
14 <A NAME="Top_Of_Page"></A>
15 <H1>Quick Beginnings</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="awqbg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="awqbg002.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="awqbg004.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="awqbg004.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
17 <HR><H1><A NAME="Header_1" HREF="awqbg002.htm#ToC_1">IBM AFS for Windows Quick Beginnings</A></H1>
18 <HR><H2><A NAME="Header_2" HREF="awqbg002.htm#ToC_2">Introduction</A></H2>
19 <A NAME="IDX178"></A>
20 <A NAME="IDX179"></A>
21 <P>AFS<SUP>(R)</SUP> is an enterprise file system that provides consistent
22 file access by way of a shared filespace. By joining the local file
23 systems of several File Server machines, AFS presents a single filespace
24 independent of machine boundaries. Files are stored on different
25 machines in the computer network but are accessible from all machines across
26 the enterprise.
27 <P>IBM AFS for Windows<SUP>(R)</SUP>, version 3.6 extends the full
28 capabilities of AFS to Microsoft<SUP>(R)</SUP> Windows operating
29 systems.
30 <HR><H2><A NAME="Header_3" HREF="awqbg002.htm#ToC_3">Document Overview</A></H2>
31 <P>
32 <A NAME="IDX180"></A>
33 This document summarizes installation prerequisites, provides detailed
34 instructions on how to install, configure, and uninstall AFS for Windows, and
35 outlines the changes made to your system during the installation and
36 uninstallation processes. This document also describes the
37 documentation provided with AFS for Windows.
38 <P><H3><A NAME="Header_4" HREF="awqbg002.htm#ToC_4">Audience</A></H3>
39 <P>
40 <A NAME="IDX181"></A>
41 This document provides information for system administrators and users
42 responsible for the installation and configuration of the products included in
43 AFS for Windows. This document assumes that system administrators are
44 familiar with system administration in general and that users are familiar
45 with the basic terms and concepts of the Microsoft Windows operating
46 systems.
47 <P><H3><A NAME="Header_5" HREF="awqbg002.htm#ToC_5">Organization</A></H3>
48 <P>This document has the following organization&#58;
49 <UL>
50 <P><LI><A HREF="#HDRINSTALLATION">Installing AFS for Windows</A> outlines installable combinations of AFS components,
51 describes the procedure for installing the products that are included in AFS
52 for Windows, and lists the changes that the installation process makes to your
53 system.
54 <P><LI><A HREF="#HDRDOCUMENT">AFS for Windows Documentation</A> presents the various types of documentation that are
55 provided with AFS for Windows and discusses procedures for accessing this
56 documentation.
57 <P><LI><A HREF="#HDRCONFIGURE">Configuring AFS for Windows</A> describes the procedures for configuring the products that
58 are included in AFS for Windows.
59 <P><LI><A HREF="#HDRUNINSTALL">Uninstalling AFS for Windows</A> outlines uninstallation prerequisites, describes the
60 procedure for uninstalling the products that are included in AFS for Windows,
61 and lists the changes that the uninstallation process makes to your
62 system.
63 </UL>
64 <HR><H2><A NAME="HDRINSTALLATION" HREF="awqbg002.htm#ToC_6">Installing AFS for Windows</A></H2>
65 <P>This section outlines installable combinations of AFS components,
66 describes the procedure for installing AFS for Windows, and lists the changes
67 that the installation process makes to your system.
68 <P><H3><A NAME="Header_7" HREF="awqbg002.htm#ToC_7">AFS for Windows Components</A></H3>
69 <P>
70 <A NAME="IDX182"></A>
71 AFS for Windows, version 3.6 includes the following components&#58;
72 <UL>
73 <P><LI>
74 <A NAME="IDX183"></A>
75 <A NAME="IDX184"></A>
76 <A NAME="IDX185"></A>
77 <B>AFS Server</B>
78 <P>The AFS Server runs AFS server processes and includes the AFS Server
79 Configuration Wizard to facilitate setup.
80 <P><LI>
81 <A NAME="IDX186"></A>
82 <A NAME="IDX187"></A>
83 <A NAME="IDX188"></A>
84 <B>AFS Control Center</B>
85 <P>The AFS Control Center includes two powerful graphical user interface (GUI)
86 tools to assist AFS system administrators in AFS cell administration&#58;
87 the AFS Server Manager and the AFS Account Manager.
88 <P><LI>
89 <A NAME="IDX189"></A>
90 <A NAME="IDX190"></A>
91 <A NAME="IDX191"></A>
92 <B>AFS Client</B>
93 <P>The AFS Client provides direct access to the AFS filespace, enabling users
94 to manage files and directories in AFS. The AFS Client includes the AFS
95 Light Gateway.
96 <P><LI>
97 <A NAME="IDX192"></A>
98 <A NAME="IDX193"></A>
99 <A NAME="IDX194"></A>
100 <B>AFS Light</B>
101 <P>AFS Light provides access to the AFS filespace via an AFS Light Gateway
102 machine, enabling users to manage files and directories in AFS.
103 <P><LI>
104 <A NAME="IDX195"></A>
105 <B>AFS Supplemental Documentation</B>
106 <P>AFS Supplemental Documentation provides additional AFS system
107 administration information and includes the following documents&#58;
108 <I>IBM AFS Administration Guide</I> and <I>IBM AFS Administration
109 Reference</I>.
110 </UL>
111 <P><H3><A NAME="HDROPTIONS" HREF="awqbg002.htm#ToC_8">Installation Options</A></H3>
112 <P>
113 <A NAME="IDX196"></A>
114 <A NAME="IDX197"></A>
115 <A NAME="IDX198"></A>
116 You can install the components of AFS for Windows in various combinations,
117 based on your Windows operating system. Refer to the <I>IBM AFS for
118 Windows Release Notes</I> for details on the specific software requirements
119 for each AFS for Windows component. Note that if you are installing the
120 AFS Server, you must also install the AFS Client, unless the AFS Client,
121 version 3.6 is already installed on the machine. Follow the
122 installation procedure described in <A HREF="#HDRHOWTOINSTALL">To Install AFS for Windows</A> regardless of the components you are installing.
124 <A NAME="IDX199"></A>
125 <A NAME="IDX200"></A>
126 <A NAME="IDX201"></A>
127 <A NAME="IDX202"></A>
128 <A NAME="IDX203"></A>
129 You have the option of altering the AFS for Windows setup program to disable
130 all but the client component. Such a client-only setup program renders
131 users unable to install any components other than the AFS Client. To
132 perform a client-only installation, create the file <B></B>
133 in the same directory as the other installation files; the setup program
134 then only allows the AFS Client to be installed. Note that the contents
135 of the <B></B> file are irrelevent. Follow the
136 installation procedure described in <A HREF="#HDRHOWTOINSTALL">To Install AFS for Windows</A> regardless of the type of installation you are
137 performing.
138 </TD></TR></TABLE>
139 <P><H3><A NAME="Header_9" HREF="awqbg002.htm#ToC_9">Upgrading From an Earlier Version</A></H3>
140 <P>
141 <A NAME="IDX204"></A>
142 <A NAME="IDX205"></A>
143 <A NAME="IDX206"></A>
144 On a Windows NT machine, it is <I>not</I> necessary to uninstall the
145 components of AFS for Windows for the purpose of upgrading the software;
146 you can install this release of AFS for Windows on your system
147 <I>without</I> removing or unconfiguring your existing software. To
148 upgrade AFS for Windows, follow the installation procedure described in <A HREF="#HDRHOWTOINSTALL">To Install AFS for Windows</A>. During the installation process, the
149 previous-version AFS component is upgraded and the AFS configuration
150 information is preserved.
151 <P>On a Windows 95 or Windows 98 machine, you must uninstall the
152 previously-installed AFS Light component, as described in <A HREF="#HDRTOUNINSTALL">To Uninstall AFS for Windows</A>, before upgrading AFS Light.
153 <P>Note that the AFS for Windows installation tool does <I>not</I> allow a
154 user to install AFS components that have different version numbers. If
155 you have more than one AFS for Windows component installed on your machine,
156 you cannot update one component without updating all of the other components
157 as well.
158 <P><H3><A NAME="HDRHOWTOINSTALL" HREF="awqbg002.htm#ToC_10">To Install AFS for Windows</A></H3>
159 <A NAME="IDX207"></A>
160 <A NAME="IDX208"></A>
161 <A NAME="IDX209"></A>
162 <A NAME="IDX210"></A>
163 <A NAME="IDX211"></A>
164 <A NAME="IDX212"></A>
165 <A NAME="IDX213"></A>
166 <P>Before installing AFS for Windows, refer to your <I>IBM AFS for Windows
167 Release Notes</I> for a detailed description of the installation
168 prerequisites. If you are running any other Windows applications, it is
169 recommended that you exit from them before installing AFS for Windows. 
170 <OL TYPE=1>
171 <P><LI>Insert the AFS for Windows installation disk into your CD-ROM
172 drive.
173 <P><LI>Run the AFS for Windows <B>setup</B> program by using one of the
174 following methods&#58;
175 <UL>
176 <P><LI>From the <B>Start</B> menu, select <B>Run</B>. Type
177 <TT><I>drive</I><B>&#58;\setup</B></TT> where <I>drive</I> is
178 the drive letter of your CD-ROM drive. Click <B>OK</B>.
179 <P><LI>In the <B>Windows Explorer</B>, select your CD-ROM drive, and
180 double-click the <B>setup.exe</B> program.
181 </UL>
182 <P><LI>The Welcome dialog box appears. Select the <B>Next</B> button
183 to continue with the installation process.
184 <P><LI>The Select Components dialog box appears. 
185 <UL>
186 <P><LI>In the <B>Components</B> box, select the AFS for Windows components
187 that you want to install or upgrade. See <A HREF="#HDROPTIONS">Installation Options</A> for information on the various combinations of components
188 that can be installed on a Windows machine. Note that if you are
189 installing the AFS Server, you must also select to install (or upgrade) the
190 AFS Client, unless the AFS Client, version 3.6 is already installed on
191 your system.
192 <P><LI>The <B>Destination Folder</B> box indicates the default drive and
193 directory in which the selected components will be installed. The
194 default drive is the drive where Windows is installed. The default
195 directory on that drive is <B>\Program Files\Ibm\Afs</B>. To select
196 another drive, directory, or both, select the <B>Browse</B> button.
197 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If you are upgrading from a previous-version of AFS for Windows or
198 reinstalling AFS for Windows, the installation directory that you choose must
199 be the same as the installation directory that was used by the
200 previously-installed version.
201 </TD></TR></TABLE>
202 </UL>
203 <P>Select the <B>Next</B> button to continue with the installation
204 process.
205 <P><LI>The application files for the selected AFS for Windows components are
206 installed on your system. When the installation process finishes, the
207 Setup Complete dialog box appears, indicating that you must restart your
208 system before you can use the installed AFS products. Select <B>Yes,
209 I want to restart my computer now</B>, and then select the <B>Finish</B>
210 button. Your system is shut down and then restarted.
211 <P>Installation of AFS for Windows is complete.
212 </OL>
213 <P><H3><A NAME="Header_11" HREF="awqbg002.htm#ToC_11">Changes Made to Your System</A></H3>
214 <P>
215 <A NAME="IDX214"></A>
216 This section describes the changes that are made to your system by installing
217 each AFS for Windows component. The information in this section is
218 based upon the default installation settings.
219 <P><H4><A NAME="HDRCLIENTCHANGE">Changes made to your system by installing the AFS Client</A></H4>
220 <P>Installing the AFS Client for Windows NT makes the following changes to
221 your system&#58;
222 <UL>
223 <P><LI>Creates a <B>Start</B> menu program group named <B>IBM AFS</B>
224 with the following program applications&#58;
225 <DL>
226 <DD><P>The <B>Documentation</B> program entry allows access to the AFS online
227 documentation set that is provided with AFS for Windows.
228 <DD><P>The <B>Client</B> program subgroup enables users to access the AFS
229 Client property box and the AFS Client Online Help.
230 </DL>
231 <P><LI>Adds the AFS Menu to the Windows NT Explorer&#39;s context menu.
232 <P><LI>Creates a documentation directory and places the <I>IBM AFS for Windows
233 Quick Beginnings</I> and the <I>IBM AFS for Windows Release Notes</I>
234 online documents in the directory, which is located at <B>\Program
235 Files\Ibm\Afs\Documentation</B>.
236 <P><LI>Adds <B>AFS Credentials</B> to the <B>Startup</B> program
237 group. The <B>AFS Client</B> icon is displayed in the taskbar at
238 startup.
239 <P><LI>Creates the installation directories in which the setup program installs
240 AFS binaries, icons, and help files. The default directories are
241 <B>\Program Files\Ibm\Afs\Client\Program</B> and <B>\Program
242 Files\Ibm\Afs\Common</B>.
243 <P><LI>Registers the AFS Client as a service.
244 <P><LI>Installs the AFS Client Configuration utility and adds the <B>AFS Client
245 Configuration</B> icon to the Control Panel by placing the
246 <B>afs_cpa.cpl</B> file in the
247 <B>\</B><I>WindowsDefault</I><B>\system32</B> directory, where
248 <I>WindowsDefault</I> is your Windows directory.
249 <P><LI>Places the <B>afsdcell.ini</B> file in your Windows directory
250 and in the <B>\Program Files\Ibm\Afs\Common</B> directory. If you
251 have upgraded from a previous-version AFS Client, the AFS Client cell database
252 (<B>afsdcell.ini</B>) in the Windows directory is not
253 replaced.
254 <P><LI>Modifies the Windows NT Registry by adding entries relevant to the AFS
255 Client.
256 </UL>
257 <P><H4><A NAME="Header_13">Changes made to your system by installing AFS Light</A></H4>
258 <P>Installing AFS Light for Windows 95 and Windows 98 makes the following
259 changes to your system&#58;
260 <UL>
261 <P><LI>Creates a program group named <B>IBM AFS</B> with the following
262 program applications&#58;
263 <DL>
264 <DD><P>The <B>Documentation</B> program entry allows access to the AFS online
265 documentation set that is provided with AFS for Windows.
266 <DD><P>The <B>Light</B> program subgroup enables users to access the AFS
267 Light property box and the AFS Light Online Help.
268 </DL>
269 <P><LI>Adds the AFS Menu to the Windows Explorer&#39;s context menu.
270 <P><LI>Creates a documentation directory and places the <I>IBM AFS for Windows
271 Quick Beginnings</I> and the <I>IBM AFS for Windows Release Notes</I>
272 online documents in the directory, which is located at <B>\Program
273 Files\Ibm\Afs\Documentation</B>.
274 <P><LI>Creates the installation directories in which the setup program installs
275 AFS binaries, icons, and help files. The default directories are
276 <B>\Program Files\Ibm\Afs\Client\Program</B> and <B>\Program
277 Files\Ibm\Afs\Common</B>.
278 <P><LI>Installs the AFS Light Configuration utility and adds the <B>AFS Light
279 Configuration</B> icon to the Control Panel by placing the
280 <B>afs_cpa.cpl</B> file in the
281 <B>\</B><I>WindowsDefault</I><B>\system</B> directory, where
282 <I>WindowsDefault</I> is your Windows directory.
283 <P><LI>Places the <B>afsdcell.ini</B> file in your Windows directory
284 and in the <B>\Program Files\Ibm\Afs\Common</B> directory.
285 <P><LI>Modifies the Windows Registry by adding entries relevant to AFS
286 Light.
287 </UL>
288 <P><H4><A NAME="Header_14">Changes made to your system by installing the AFS Server</A></H4>
289 <P>Installing the AFS Server for Windows NT makes the following changes to
290 your system&#58;
291 <UL>
292 <P><LI>Creates a <B>Start</B> menu program group named <B>IBM AFS</B>
293 with the following program applications&#58;
294 <DL>
295 <DD><P>The <B>Documentation</B> program entry allows access to the AFS online
296 documentation set that is provided with AFS for Windows.
297 <DD><P>The <B>Server</B> program subgroup enables users to access the AFS
298 Server Quick-Start Wizard.
299 </DL>
300 <P><LI>Creates a documentation directory and places the <I>IBM AFS for Windows
301 Quick Beginnings</I> and the <I>IBM AFS for Windows Release Notes</I>
302 online documents in the directory, which is located at <B>\Program
303 Files\Ibm\Afs\Documentation</B>.
304 <P><LI>Creates the installation directories in which the setup program installs
305 AFS binaries, icons, and help files. The default directories are
306 <B>\Program Files\Ibm\Afs\Server\usr\afs\bin</B> and <B>\Program
307 Files\Ibm\Afs\Common</B>.
308 <P><LI>Registers the AFS Server as a service.
309 <P><LI>Installs the AFS Server Configuration application and adds the <B>AFS
310 Server Configuration</B> icon to the Control Panel by placing the
311 <B>afsserver.cpl</B> file in the
312 <B>\</B><I>WindowsDefault</I><B>\system32</B> directory, where
313 <I>WindowsDefault</I> is your Windows directory.
314 <P><LI>Modifies the Windows NT Registry by adding entries relevant to the AFS
315 Server.
316 </UL>
317 <P><H4><A NAME="Header_15">Changes made to your system by installing the AFS Control Center</A></H4>
318 <P>Installing the AFS Control Center for Windows NT makes the following
319 changes to your system&#58;
320 <UL>
321 <P><LI>Creates a <B>Start</B> menu program group named <B>IBM AFS</B>
322 with the following program applications&#58;
323 <DL>
324 <DD><P>The <B>Documentation</B> program entry allows access to the AFS online
325 documentation set that is provided with AFS for Windows.
326 <DD><P>The <B>Control Center</B> program subgroup enables users to access the
327 Account Manager and the Server Manager.
328 </DL>
329 <P><LI>Creates a documentation directory and places the <I>IBM AFS for Windows
330 Quick Beginnings</I> and the <I>IBM AFS for Windows Release Notes</I>
331 online documents in the directory, which is located at <B>\Program
332 Files\Ibm\Afs\Documentation</B>.
333 <P><LI>Creates the installation directories in which the setup program installs
334 AFS binaries, icons, and help files. The default directories are
335 <B>\Program Files\Ibm\Afs\Control Center</B> and <B>\Program
336 Files\Ibm\Afs\Common</B>.
337 <P><LI>Installs the AFS Control Center Properties utility and adds the <B>AFS
338 Control Center</B> icon to the Control Panel by placing the
339 <B>afs_cpa.cpl</B> file in the
340 <B>\</B><I>WindowsDefault</I><B>\system32</B> directory, where
341 <I>WindowsDefault</I> is your Windows directory. This icon is added
342 to the Control Panel if only the AFS Control Center is installed on your
343 system.
344 <P><LI>Places the <B>afsdcell.ini</B> file in your Windows directory
345 and in the <B>\Program Files\Ibm\Afs\Common</B> directory.
346 <P><LI>Modifies the Windows NT Registry by adding entries relevant to the AFS
347 Control Center.
348 </UL>
349 <P><H4><A NAME="Header_16">Changes made to your system by installing the AFS Supplemental Documentation</A></H4>
350 <P>Installing the AFS Supplemental Documentation makes the following
351 changes to your system&#58;
352 <UL>
353 <P><LI>Creates a <B>Start</B> menu program group named <B>IBM AFS</B>
354 with a program entry named <B>Documentation</B>.
355 <P><LI>The following system administration documents are installed on the
356 machine&#58; <I>IBM AFS Administration Guide</I> and <I>IBM AFS
357 Administration Reference</I>. These documents are added to the online
358 documentation directory, which is located at <B>\Program
359 Files\Ibm\Afs\Documentation</B>. The <I>IBM AFS for Windows Quick
360 Beginnings</I> and the <I>IBM AFS for Windows Release Notes</I> online
361 documents are also installed in the documentation directory.
362 <P><LI>Modifies the Windows NT Registry by adding entries relevant to the AFS
363 Supplemental Documentation.
364 </UL>
365 <HR><H2><A NAME="HDRDOCUMENT" HREF="awqbg002.htm#ToC_17">AFS for Windows Documentation</A></H2>
366 <P>This section describes the documentation that is provided with AFS for
367 Windows and details the procedures for accessing this documentation.
368 <P><H3><A NAME="Header_18" HREF="awqbg002.htm#ToC_18">The Online Documentation Directory</A></H3>
369 <A NAME="IDX215"></A>
370 <A NAME="IDX216"></A>
371 <P>Regardless of the components you install on your system, a documentation
372 directory is created. The default location is <B>\Program
373 Files\Ibm\Afs\Documentation</B>. This directory includes the <I>IBM
374 AFS for Windows Quick Beginnings</I> and <I>IBM AFS for Windows Release
375 Notes</I>. These same documents are available from the Documentation
376 index accessed from the <B>Documentation</B> entry in the <B>Start</B>
377 menu.
378 <P>If you install the AFS Supplemental Documentation, then the documentation
379 directory also includes the following documents&#58; <I>IBM AFS
380 Administration Guide</I> and <I>IBM AFS Administration
381 Reference</I>. These same documents are available from the
382 Documentation index accessed from the <B>Documentation</B> entry in the
383 <B>Start</B> menu.
384 <P><H4><A NAME="Header_19">To access the online documentation directory&#58;</A></H4>
385 <OL TYPE=1>
386 <P><LI>From the <B>Start</B> menu, choose <B>Programs</B>, then choose
387 <B>IBM AFS</B>, then choose <B>Documentation</B>.
388 <P><LI>Select the document that you want to view.
389 </OL>
390 <P><H3><A NAME="Header_20" HREF="awqbg002.htm#ToC_20">The CD-ROM Documentation Directory</A></H3>
391 <A NAME="IDX217"></A>
392 <A NAME="IDX218"></A>
393 <P>The AFS for Windows CD-ROM contains a documentation directory. This
394 directory includes the following documentation&#58; <I>IBM AFS for Windows
395 Quick Beginnings</I>, <I>IBM AFS for Windows Release Notes</I>, <I>IBM
396 AFS Administration Guide</I>, and <I>IBM AFS Administration
397 Reference</I>. The documentation is provided in HTML and PDF
398 formats.
399 <P><H4><A NAME="Header_21">To access the CD-ROM documentation directory&#58;</A></H4>
400 <OL TYPE=1>
401 <P><LI>Insert the AFS for Windows CD-ROM into your machine&#39;s CD-ROM
402 drive.
403 <P><LI>Follow one of the paths listed below. Note that <I>CD</I> is
404 the drive letter of your CD-ROM drive.
405 <UL>
406 <P><LI>For HTML documentation, follow the path
407 <I>CD</I><B>&#58;\Documentation\Html</B>.
408 <P><LI>For PDF documentation, follow the path
409 <I>CD</I><B>&#58;\Documentation\Pdf</B>.
410 </UL>
411 </OL>
412 <P><H3><A NAME="Header_22" HREF="awqbg002.htm#ToC_22">Online Help</A></H3>
413 <A NAME="IDX219"></A>
414 <A NAME="IDX220"></A>
415 <P>Online help is installed along with each AFS for Windows component.
416 The online help documentation describes the features available from each
417 component. Use the <B>Help</B> menus and <B>Help</B> buttons
418 located on most dialog boxes to access the online help. You can get
419 help on topics by browsing the contents page, using the index to locate
420 topics, and using <B>Find</B>, the online help search engine.
421 <HR><H2><A NAME="HDRCONFIGURE" HREF="awqbg002.htm#ToC_23">Configuring AFS for Windows</A></H2>
422 <P>
423 <A NAME="IDX221"></A>
424 <A NAME="IDX222"></A>
425 This section details the configuration procedure for each of the components of
426 AFS for Windows. You must configure the components on your system
427 before you can use AFS.
428 <P><H3><A NAME="HDRCLIENT_CONFIG" HREF="awqbg002.htm#ToC_24">To Configure the AFS Client</A></H3>
429 <A NAME="IDX223"></A>
430 <A NAME="IDX224"></A>
431 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If you intend to configure the AFS Server on your Windows NT system, you do
432 not need to configure the AFS Client. The AFS Client is configured
433 automatically when the AFS Server is configured. In addition, if you
434 upgraded to this version of AFS for Windows from a previous-version AFS
435 Client, configuration information is preserved. You do not need to
436 reconfigure the AFS Client.
437 </TD></TR></TABLE>
438 <OL TYPE=1>
439 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
440 <B>Control Panel</B>.
441 <P><LI>Double-click the <B>AFS Client Configuration</B> icon. The AFS
442 Client Configuration utility opens, displaying the <B>General</B>
443 tab.
444 <P><LI>In the <B>Cell Name</B> box, enter the name of the AFS cell in which
445 the machine is to be a client.
446 <P><LI>Select the <B>AFS Cells</B> tab. If the cell in which the
447 machine is to be a client is not listed in the list of AFS cells, choose the
448 <B>Add</B> button. The New Cell dialog box opens. Enter the
449 cell name in the <B>AFS Cell</B> box and a short description in the
450 <B>Description</B> box.
451 <P>Choose the <B>Add</B> button. The Add Server dialog box
452 opens. In the <B>Server Name</B> box, enter the name of a Volume
453 Location Server in the selected cell. Choose <B>OK</B> to close the
454 Add Server dialog box. Repeat this process, adding information for all
455 Volume Location Servers in the cell. (If you do not know the names of
456 the Volume Location Servers in the AFS cell, consult your AFS system
457 administrator.) After all server information has been entered, choose
458 <B>OK</B> to close the New Cell dialog box.
459 <P><LI>Select the <B>General</B> tab and choose the <B>Start Service</B>
460 button to start the AFS Client service.
461 <P><LI>Select the <B>Drive Letters</B> tab. To map a drive letter on
462 the Windows NT machine to the AFS filespace, choose the <B>Add</B>
463 button. The Map Drive Letter dialog box opens.
464 <P><LI>In the <B>Drive Letter</B> box, select the drive to be mapped to the
465 AFS filespace or accept the default. In the <B>AFS</B>
466 <B>Path</B> box, indicate the AFS location to which you want to map the
467 selected drive, for example,<B> /afs</B>. If desired, enter a
468 description of the AFS drive mapping in the <B>Description</B> box.
469 Choose <B>OK</B> to connect the drive to the specified place in the AFS
470 filespace.
471 <P><LI>Choose <B>OK</B> to close the AFS Client Configuration utility.
472 <P>The AFS Client is now configured in the selected AFS cell and the AFS
473 filespace can be accessed via the selected drive mapping in the Windows NT
474 Explorer.
475 </OL>
476 <P><H3><A NAME="HDRGATEWAY" HREF="awqbg002.htm#ToC_25">To Configure the AFS Client as an AFS Light Gateway</A></H3>
477 <A NAME="IDX225"></A>
478 <A NAME="IDX226"></A>
479 <A NAME="IDX227"></A>
480 <P>You can configure the AFS Client on your Windows NT machine to serve as an
481 AFS Light Gateway. Your AFS Client, configured as an AFS Light Gateway,
482 makes it possible for AFS Light users to access the AFS filespace.
483 <OL TYPE=1>
484 <P><LI>Configure the AFS Client as detailed in <A HREF="#HDRCLIENT_CONFIG">To Configure the AFS Client</A>.
485 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
486 <B>Control Panel</B>.
487 <P><LI>Double-click the <B>AFS Client Configuration</B> icon. The AFS
488 Client Configuration utility opens, displaying the <B>General</B>
489 tab.
490 <P><LI>Select the <B>Provide an AFS Light Gateway</B> option.
491 <P><LI>Choose <B>OK</B>. 
492 <UL>
493 <P><LI>If the AFS Client service is running, a message box appears, informing you
494 that the service must be restarted. Choose <B>Yes</B> to restart
495 the AFS Client service and enable the AFS Light Gateway.
496 <P><LI>If the AFS Client service is stopped, a message box appears, informing you
497 that you must start the AFS Client service. Choose <B>Yes</B> to
498 start the AFS Client service and enable the AFS Light Gateway.
499 </UL>
500 <P><LI>
501 <A NAME="IDX228"></A>
502 Add cell entries to your AFS Light Gateway&#39;s cell database. Note
503 that in order for an AFS Light user to access a cell, an entry for the cell
504 must exist in both the AFS Light cell database and the AFS Light Gateway cell
505 database. Incorrect or missing information about a cell in the gateway
506 machine&#39;s cell database renders light client machines unable to access
507 files. 
508 <P><B>To add an entry to the cell database&#58;</B>
509 <P>Access the <B>AFS Cells</B> tab from the AFS Light Configuration
510 utility and choose the <B>Add</B> button. The New Cell dialog box
511 opens. Enter the cell name in the <B>AFS Cell</B> box and a short
512 description in the <B>Description</B> box.
513 <P>Choose the <B>Add</B> button. The Add Server dialog box
514 opens. In the <B>Server Name</B> box, enter the name of a Volume
515 Location Server in the selected cell. Choose <B>OK</B> to close the
516 Add Server dialog box. Repeat this process, adding information for all
517 Volume Location Servers in the cell. (If you do not know the names of
518 the Volume Location Servers in the AFS cell, consult your AFS system
519 administrator.) After all server information has been entered, choose
520 <B>OK</B> to close the New Cell dialog box.
521 </OL>
522 <P>
523 <A NAME="IDX229"></A>
524 <A NAME="IDX230"></A>
525 <A NAME="IDX231"></A>
526 The Windows NT machine is now configured as an AFS Light Gateway. Once
527 configured as an AFS Light Gateway, your AFS Client machine must be able to
528 authenticate AFS Light users in a Windows context. This authentication
529 can be achieved via a <I>domain</I> user account or via synchronized
530 <I>machine</I> user accounts. A domain user account is a user
531 account in a Windows domain. A machine user account is a user account
532 that is valid only on a particular host machine.
533 <P>When the AFS Light Gateway is configured into a Windows domain, the AFS
534 Light user must log onto either a domain user account in the domain to which
535 the gateway belongs or a machine user account with the same username and
536 password as that of a domain user account in the gateway domain.
537 <P>If machine user accounts are employed, then these accounts must be
538 synchronized on the AFS Light Gateway and AFS Light machines. A user
539 must log onto an AFS Light machine with the same username and password as that
540 of a machine user account that is defined on the AFS Light Gateway
541 machine.
542 <P><H3><A NAME="Header_26" HREF="awqbg002.htm#ToC_26">To Configure AFS Light</A></H3>
543 <A NAME="IDX232"></A>
544 <A NAME="IDX233"></A>
545 <P>AFS Light accesses the AFS filespace via an AFS Light Gateway.
546 Before configuring AFS Light, you must have a Windows NT machine running the
547 AFS Client and configured as an AFS Light Gateway. See <A HREF="#HDRGATEWAY">To Configure the AFS Client as an AFS Light Gateway</A> for more information.
548 <OL TYPE=1>
549 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
550 <B>Control Panel</B>.
551 <P><LI>Double-click the <B>AFS Light Configuration</B> icon. The AFS
552 Light Configuration utility opens, displaying the <B>General</B>
553 tab.
554 <A NAME="IDX234"></A>
555 <A NAME="IDX235"></A>
556 <P><LI>In the <B>Gateway</B> box, enter the name of a Windows NT machine that
557 is configured as an AFS Light Gateway and click <B>Connect Now</B>.
558 The name of the gateway machine is the gateway&#39;s NetBIOS service name, in
559 the form <I>mach</I><B>-afs</B>, where <I>mach</I> is the
560 host computer name up to a maximum of 11 characters. AFS Light must be
561 able to resolve this service name in order to communicate with the gateway
562 machine. Name resolution can be achieved by adding the gateway&#39;s
563 NetBIOS service name to the client&#39;s LMHOSTS file or to the appropriate
564 DNS or WINS servers. If the AFS Light machine and its AFS Light Gateway
565 machine reside on the same subnet, then no additional configuration is
566 required. 
567 <P>AFS Light automatically becomes a member of the same cell as its AFS Light
568 Gateway. The name of the cell is displayed in the <B>Cell Name</B>
569 box.
570 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If the AFS Light Gateway machine is in the same domain as the AFS Light
571 machine and the hostname of the gateway machine in this domain is
572 <B>xyz-pc</B>, you can specify the computer name in the <B>Gateway</B>
573 box as either <B>xyz-pc</B> or
574 <B></B>.
575 </TD></TR></TABLE>
576 <P><LI>Select the <B>AFS Cells</B> tab. If the cell to which the
577 machine belongs is not listed in the list of AFS cells, choose the
578 <B>Add</B> button. The New Cell dialog box opens. Enter the
579 cell name in the <B>AFS Cell</B> box and a short description in the
580 <B>Description</B> box. 
581 <P>Choose the <B>Add</B> button. The Add Server dialog box
582 opens. In the <B>Server Name</B> box, enter the name of a Volume
583 Location Server in the selected cell. Choose <B>OK</B> to close the
584 Add Server dialog box. Repeat this process, adding information for all
585 Volume Location Servers in the cell. (If you do not know the names of
586 the Volume Location Servers in the AFS cell, consult your AFS system
587 administrator.) After all server information has been entered, choose
588 <B>OK</B> to close the New Cell dialog box.
589 <P>Note that an identical entry must exist in the AFS Light Gateway&#39;s
590 cell database (<B>afsdcell.ini</B> file) in order for the AFS Light
591 user to authenticate to the cell. See <A HREF="#HDRGATEWAY">To Configure the AFS Client as an AFS Light Gateway</A> for more information on synchronizing the gateway
592 machine&#39;s cell database with your light client&#39;s cell
593 database.
594 <P><LI>Select the <B>Drive Letters</B> tab. To map a drive letter on
595 the Windows machine to the AFS filespace, choose the <B>Add</B>
596 button. The Map Drive Letter dialog box opens.
597 <P><LI>In the <B>Drive Letter</B> box, select the drive to be mapped to the
598 AFS filespace or accept the default. In the <B>AFS</B>
599 <B>Path</B> box, indicate the AFS location to which you want to map the
600 selected drive, for example,<B> /afs</B>. If desired, enter a
601 description of the AFS drive mapping in the <B>Description</B> box.
602 Choose <B>OK</B> to connect the drive to the specified place in the AFS
603 filespace.
604 <P><LI>Choose <B>OK</B> to close the AFS Light Configuration utility.
605 <P>AFS Light is now configured in the specified AFS cell and the AFS filespace
606 can be accessed via the drive mapping in the Windows Explorer.
607 </OL>
608 <P><H3><A NAME="Header_27" HREF="awqbg002.htm#ToC_27">To Configure the AFS Server</A></H3>
609 <A NAME="IDX236"></A>
610 <A NAME="IDX237"></A>
611 <P>The configuration process starts the services needed to run the AFS Server
612 and sets up AFS partitions on your Windows NT machine. Using the AFS
613 Configuration Wizard, you can quickly configure the AFS Server as either the
614 first server in a new AFS cell or as a server in an existing AFS cell.
615 Note that if you have upgraded to this version of the AFS Server,
616 previous-version configuration information is preserved; you do not need
617 to reconfigure the server.
618 <P><B>
619 <A NAME="IDX238"></A>
620 To configure the AFS Server as the first AFS Server in a cell&#58;</B>
621 <OL TYPE=1>
622 <P><LI>From the <B>Start</B> menu, choose <B>Programs</B>, then choose
623 <B>IBM AFS</B>, then choose <B>Server</B>, and then choose
624 <B>Configuration Wizard</B>. The AFS Server Quick-Start
625 Wizard opens.
626 <P><LI>Choose the <B>Next</B> button. The Cell and Server Information
627 dialog box appears.
628 <P><LI>Choose the <B>This will be the first server in a new AFS cell</B>
629 option.
630 <P><LI>In the <B>Cell Name</B> box, enter a name for the new AFS cell.
631 <P>The following constraints apply to the form of an internet domain name that
632 can be used as the name of an AFS cell&#58;
633 <UL>
634 <P><LI>The cell name must be unique in order to distinguish your AFS cell from
635 all others in the AFS global namespace.
636 <P><LI>The cell name can contain as many as 64 characters; however, shorter
637 names are recommended.
638 <P><LI>The cell name must include only lowercase characters, numbers,
639 underscores, dashes, and periods to ensure portability between different
640 operating system types.
641 <P><LI>The cell name can include any numbers or letters, which are conventionally
642 separated by periods.
643 <P><LI>The cell name must end in a suffix that indicates the type of institution
644 to which it belongs. Some of the standard suffixes are
645 <B>.com</B>, for business and other commercial organizations,
646 <B>.edu</B>, for educational institutions such as universities,
647 <B>.gov</B>, for government institutions, and
648 <B>.mil</B>, for military institutions.
649 </UL>
650 <P><LI>In the <B>Password</B> box, enter the character string to serve as the
651 password for the AFS Server principal account in the cell
652 (<B>afs</B>). All AFS Servers obtain AFS tokens as this principal,
653 and the Authentication Server&#39;s Ticket Granting Service (TGS) module uses
654 this password to encrypt the server tickets that AFS Clients present to
655 servers during mutual authentication.
656 <P><LI>In the <B>Verify password</B> box, retype the initial AFS password for
657 the AFS Server principal account for this cell to confirm the password
658 selection.
659 <P><LI>Choose the <B>Next</B> button. The Administrative Information
660 dialog box appears.
661 <P><LI>In the <B>Name</B> box, enter a username to serve as a generic AFS
662 administrative account for this cell (generally, <B>admin</B>.)
663 <P>
664 <A NAME="IDX239"></A>
665 Use of a generic administrative account means that you do not need to grant
666 privileges to each system administrator. Instead, each administrator
667 knows the name and password of this generic administrative account and uses
668 this identity to authenticate to AFS when performing tasks that require
669 administrative privileges.
670 <P><LI>In the <B>Password</B> box, enter a character string to serve as the
671 password for the AFS administrative account.
672 <P><LI>In the <B>Verify password</B> box, retype the password for the AFS
673 administrative account to confirm the password selection.
674 <P><LI>Specify the AFS User ID (UID) to assign to the AFS administrative
675 account&#58;
676 <UL>
677 <P><LI>(Recommended) To automatically assign the next available UID to the AFS
678 administrative account, choose the <B>Use the next available AFS UID</B>
679 option.
680 <P><LI>To assign a specific UID to the AFS administrative account, choose the
681 <B>Use this AFS ID</B> option and enter the desired UID in the entry
682 box.
683 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">It is not generally recommended that you assign a specific UID to a new AFS
684 account, unless you need to make the AFS UID match an existing UNIX
685 UID.
686 </TD></TR></TABLE>
687 </UL>
688 <P><LI>Choose the <B>Next</B> button. The File Service dialog box
689 appears.
690 <P>
691 <A NAME="IDX240"></A>
692 AFS File Servers deliver requested files and data from the server to AFS
693 Clients. File Servers store files and data, handle requests for
694 copying, moving, creating, and deleting files and directories, and keep track
695 of status information about each file and directory on the server.
696 <P>Because you are configuring the first AFS Server in a new cell, the File
697 Service must be configured on the server, and will be configured
698 automatically.
699 <P><LI>Choose the <B>Next</B> button. The Database Service dialog box
700 appears.
701 <P>
702 <A NAME="IDX241"></A>
703 Every AFS cell must contain at least one Database Server. Each Database
704 Server runs the Database processes that maintain the AFS databases&#58; the
705 Authentication Database, the Protection Database, the Volume Location
706 Database, and optionally the Backup Database.
707 <P>Because you are configuring the first AFS Server in a new cell, the
708 Database Service must be configured on the server, and will be configured
709 automatically.
710 <P><LI>Choose the <B>Next</B> button. The Backup Server dialog box
711 appears.
712 <P>
713 <A NAME="IDX242"></A>
714 A Backup Server maintains the Backup Database where information related to the
715 Backup system is stored. The Backup Server enables the AFS system
716 administrator to back up data in the AFS filespace from volumes to
717 tape. The data can then be restored from tape in the event that it is
718 lost from the file system (for example, if a system or disk failure causes
719 data to be lost).
720 <P><LI>Choose the <B>Yes, configure as a Backup Server</B> option if you want
721 to configure this AFS Server as a Backup Server. If you do not want to
722 configure this AFS Server as a Backup Server, choose the <B>No, do not
723 configure as a Backup Server</B> option.
724 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If the Backup Server is configured on any Database Server in the cell, it
725 must be configured on <I>all</I> Database Servers in the cell.
726 </TD></TR></TABLE>
727 <P><LI>Choose the <B>Next</B> button. The AFS Partition dialog box
728 appears.
729 <P>
730 <A NAME="IDX243"></A>
731 Every AFS File Server must have at least one partition designated exclusively
732 to storing AFS volumes, and all AFS volumes must reside on partitions that
733 have been designated as AFS partitions. On a Windows NT machine, only
734 NTFS volumes can be designated as AFS partitions. In addition, AFS
735 partitions can be created only on NTFS volumes that are empty (or contain only
736 the Windows NT Recycle Bin).
737 <P>Because you are configuring the first AFS Server in a new cell, you must
738 designate an AFS partition on the server.
739 <P><LI>In the list of NTFS volumes, choose the volume you want to designate as an
740 AFS partition. In the <B>AFS Partition Name</B> box, enter the last
741 part of the partition name.
742 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">There can exist up to 256 AFS partitions on an AFS Server. By
743 convention, each partition is named <B>/vicep</B><I>x</I>, where
744 <I>x</I> is one or two lowercase letters of the English alphabet.
745 AFS partitions can be named <B>/vicepa</B>, <B>/vicepb</B>, and so on
746 up to <B>/vicepz</B>. Additional partitions can be named
747 <B>/vicepaa</B> through <B>vicepaz</B> and so on up to
748 <B>/vicepiv</B>.
749 </TD></TR></TABLE>
750 <P>It is strongly recommended that you use the NTFS volume drive letter as the
751 last letter of the partition name.
752 <P><LI>Choose the <B>Next</B> button. The Root AFS Volumes dialog box
753 appears.
754 <P>
755 <A NAME="IDX244"></A>
756 <A NAME="IDX245"></A>
757 <A NAME="IDX246"></A>
758 The root AFS volumes are two volumes that every AFS cell must include in its
759 file system. They are named&#58;
760 <UL>
761 <P><LI><B>root.afs</B>, for the volume corresponding to the top
762 (<B>/afs</B>) level of the AFS filespace
763 <P><LI><B>root.cell</B>, for the volume mounted just below
764 <B>/afs</B> at the cell&#39;s name (for example,
765 <B>/afs/</B> in the
766 <B></B> cell)
767 </UL>
768 <P>Because you are configuring the first AFS Server in a new cell, the
769 cell&#39;s root volumes must be created on the server, and will be created
770 automatically during the configuration of the server.
771 <P><LI>Choose the <B>Next</B> button. The Replication dialog box
772 appears.
773 <P>
774 <A NAME="IDX247"></A>
775 If you want to be able to take advantage of the replication capabilities of
776 AFS, the AFS root volumes must be replicated. The replication process
777 creates one or more read-only copies of an AFS volume, and distributes these
778 copies to one or more other sites (AFS partitions and servers).
779 Replication increases system efficiency and improves data availability by
780 making the contents of an AFS volume accessible on one or more AFS File Server
781 machines.
782 <P>Because you are configuring the first AFS Server in a new cell, the
783 cell&#39;s root volumes must be replicated on the server, and will be
784 replicated automatically during the configuration of the server.
785 <P><LI>Choose the <B>Next</B> button. The System Control Service
786 dialog box appears.
787 <P>
788 <A NAME="IDX248"></A>
789 In cells running the domestic version of AFS for Windows, the System Control
790 Server distributes new versions of AFS Server configuration information to all
791 AFS servers. It is generally recommended that you designate the first
792 server in an AFS cell as the System Control Server. (Cells running the
793 international version of AFS for Windows do not use the System Control Server
794 to distribute system configuration files.)
795 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The role of System Control Server can later be assigned to a different server
796 machine if desired. However, depending on the number of AFS servers in
797 the cell, the process of assigning the role to another machine can be very
798 time-consuming.
799 </TD></TR></TABLE>
800 <P><LI>To configure this AFS Server as the System Control Server for the AFS
801 cell, choose the <B>Configure as the System Control Server</B>
802 option. If you do not want to configure this AFS Server as the System
803 Control Server for the AFS cell, choose the <B>Do not configure as the
804 System Control Server</B> option.
805 <P><LI>Choose the <B>Next</B> button. The Configure the System dialog
806 box appears.
807 <P>A list of the steps that will be taken to configure this AFS Server is
808 displayed, enabling you to review the steps before starting the actual
809 configuration process.
810 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">To return to a previous step to review or modify your selections, choose the
811 <B>Back</B> button.
812 </TD></TR></TABLE>
813 <P><LI>To begin configuration of the AFS Server on this machine, choose the
814 <B>Configure</B> button. The AFS Server is configured according to
815 your specifications. The progress bar at the bottom of the dialog box
816 indicates the steps in progress. A message box appears indicating that
817 configuration is complete.
818 </OL>
819 <P>
820 <A NAME="IDX249"></A>
821 <B>To configure the AFS Server into an existing AFS cell&#58;</B>
822 <OL TYPE=1>
823 <P><LI>From the <B>Start</B> menu, choose <B>Programs</B>, then choose
824 <B>IBM AFS</B>, then choose <B>Server</B>, and then choose
825 <B>Configuration Wizard</B>. The AFS Server Quick-Start
826 Wizard opens.
827 <P><LI>Choose the <B>Next</B> button. The Cell and Server Information
828 dialog box appears.
829 <P><LI>Choose the <B>Make this host a server in an existing AFS cell</B>
830 option.
831 <P><LI>In the <B>Cell Name</B> box, enter the name of the AFS cell to which
832 you want to add the new AFS Server.
833 <P><LI>Choose the <B>Next</B> button. The Administrative Information
834 dialog box appears.
835 <P><LI>In the <B>Name</B> box, enter the username of the AFS administrative
836 account, for example <B>admin</B>, or the username of an AFS user account
837 with administrative privileges.
838 <P><LI>In the <B>Password</B> box, enter the password for the AFS
839 administrative account or the AFS user account with administrative privileges
840 entered in the <B>Name</B> box.
841 <P><LI>In the <B>AFS Server</B> box, enter the hostname of a running AFS
842 Server in this AFS cell. AFS configuration information will be
843 retrieved from the server for use in configuring this new AFS Server.
844 <P><LI>Choose the <B>Next</B> button. The File Service dialog box
845 appears.
846 <P>
847 <A NAME="IDX250"></A>
848 AFS File Servers deliver requested files and data from the server to AFS
849 Clients. File Servers store files and data, handle requests for
850 copying, moving, creating, and deleting files and directories, and keep track
851 of status information about each file and directory on the server.
852 <P>To configure this AFS Server as a File Server, choose the <B>Yes,
853 configure as a File Server</B> option. If you do not want to
854 configure this AFS Server as a File Server, choose the <B>No, do not
855 configure as a File Server</B> option.
856 <P><LI>Choose the <B>Next</B> button. The Database Service dialog box
857 appears.
858 <P>
859 <A NAME="IDX251"></A>
860 Every AFS cell must contain at least one Database Server. Each Database
861 Server runs the Database processes that maintain the AFS databases&#58; the
862 Authentication Database, the Protection Database, the Volume Location
863 Database, and optionally the Backup Database.
864 <P>To configure this AFS Server as a Database Server, choose the <B>Yes,
865 configure as a Database Server</B> option. If there is a System
866 Control Server in the AFS cell to which you are adding the server, enter its
867 hostname in the System Control Server box. AFS configuration
868 information (for example, the list of AFS Database Servers maintained in the
869 <B>CellServDB</B> file on each AFS Server machine) will be updated by this
870 server. If you do not want to configure this AFS Server as a Database
871 Server, choose the <B>No, do not configure as a Database Server</B>
872 option.
873 <P><LI>Choose the <B>Next</B> button. The Backup Server dialog box
874 appears.
875 <P>
876 <A NAME="IDX252"></A>
877 A Backup Server maintains the Backup Database where information related to the
878 Backup system is stored. The Backup Server enables the AFS system
879 administrator to back up data in the AFS filespace from volumes to
880 tape. The data can then be restored from tape in the event that it is
881 lost from the file system (for example, if a system or disk failure causes
882 data to be lost).
883 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The Backup Server can only be configured on a machine that is configured as a
884 Database Server. Also, if the Backup Server is configured on any
885 Database Server in the cell, it must be configured on <I>all</I> Database
886 Servers in the cell.
887 </TD></TR></TABLE>
888 <P><LI>Choose the <B>Yes, configure as a Backup Server</B> option if you want
889 to configure this AFS Server as a Backup Server. If you do not want to
890 configure this AFS Server as a Backup Server, choose the <B>No, do not
891 configure as a Backup Server</B> option.
892 <P><LI>Choose the <B>Next</B> button. The AFS Partition dialog box
893 appears.
894 <P>If you are configuring this AFS Server as a File Server, you must specify
895 an NTFS volume to designate as an AFS partition. Every AFS File Server
896 must have at least one partition designated exclusively to storing AFS
897 volumes, and all AFS volumes must reside on partitions that have been
898 designated as AFS partitions. On a Windows NT machine, only NTFS
899 volumes can be designated as AFS partitions. In addition, AFS
900 partitions can be created only on NTFS volumes that are empty (or contain only
901 the Windows NT Recycle Bin).
902 <P>To designate a volume as an AFS partition, choose the <B>Yes, create a
903 partition</B> option. In the list of NTFS volumes, choose the volume
904 that you want to designate as an AFS partition. In the <B>AFS
905 Partition Name</B> box, enter the last part of the partition name.
906 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">There can exist up to 256 AFS partitions on an AFS Server. By
907 convention, each partition is named <B>/vicep</B><I>x</I>, where
908 <I>x</I> is one or two lowercase letters of the English alphabet.
909 AFS partitions can be named <B>/vicepa</B>, <B>/vicepb</B>, and so on
910 up to <B>/vicepz</B>. Additional partitions can be named
911 <B>/vicepaa</B> through <B>vicepaz</B> and so on up to
912 <B>/vicepiv</B>.
913 </TD></TR></TABLE>
914 <P>It is strongly recommended that you use the NTFS volume drive letter as the
915 last letter of the partition name.
916 <P>If you do not want to designate a volume as an AFS partition, choose the
917 <B>No, do not create a partition</B> option.
918 <P><LI>Choose the <B>Next</B> button. The Root AFS Volumes dialog box
919 appears.
920 <P>The root AFS volumes are two volumes that every AFS cell must include in
921 its file system. They are named&#58;
922 <UL>
923 <P><LI><B>root.afs</B>, for the volume corresponding to the top
924 (<B>/afs</B>) level of the AFS filespace
925 <P><LI><B>root.cell</B>, for the volume mounted just below
926 <B>/afs</B> at the cell&#39;s name (for example,
927 <B>/afs/</B> in the
928 <B></B> cell)
929 </UL>
930 <A NAME="IDX253"></A>
931 Because you are adding this AFS Server to an existing AFS cell, the root AFS
932 volumes already exist in the cell, and the AFS Configuration Wizard indicates
933 that you do not need to create the root volumes. 
934 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If for some reason the root AFS volumes do not yet exist in this AFS cell,
935 you can choose the <B>Yes, create the root volumes</B> option to create
936 the root volumes on this AFS Server.
937 </TD></TR></TABLE>
938 <P><LI>Choose the <B>Next</B> button. The Replication dialog box
939 appears.
940 <P>If you want to be able to take advantage of the replication capabilities of
941 AFS, the AFS root volumes must be replicated. The replication process
942 creates one or more read-only copies of an AFS volume, and distributes these
943 copies to one or more other sites (AFS partitions and servers).
944 Replication increases system efficiency and improves data availability by
945 making the contents of an AFS volume accessible on one or more AFS File Server
946 machines.
947 <P>Because you are adding this AFS Server to an existing AFS cell, the root
948 AFS volumes are probably already replicated, and the AFS Server Configuration
949 Wizard indicates that you do not need to replicate the root AFS
950 volumes.
951 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If for some reason the root AFS volumes are not yet replicated in this AFS
952 cell, you can choose the <B>Yes, replicate the root volumes</B> option to
953 replicate the AFS cell&#39;s root volumes on this AFS Server.
954 </TD></TR></TABLE>
955 <P><LI>Choose the <B>Next</B> button. The System Control Service
956 dialog box appears.
957 <P>In cells running the domestic version of AFS for Windows, the System
958 Control Server distributes new versions of AFS Server configuration
959 information to all AFS servers and the System Control Client machines obtain
960 common AFS configuration files from the System Control machine. (Cells
961 running the international version of AFS for Windows do not use the System
962 Control Server to distribute system configuration files or the System Control
963 Client to obtain these files.)
964 <P><LI>To configure this AFS Server as the System Control Server for the AFS
965 cell, choose the <B>Configure as the System Control Server</B>
966 option. To configure this AFS Server as a System Control Client, choose
967 the <B>Configure as a System Control Client</B> option and enter the
968 hostname of the System Control Server in this AFS cell. The AFS Server
969 will obtain new versions of AFS Server configuration information from the
970 server specified. If you do not want to configure this AFS Server as
971 the System Control Server for the AFS cell or as a System Control Client,
972 choose the <B>Do not configure as the System Control Client or Server</B>
973 option.
974 <P><LI>Choose the <B>Next</B> button. The Configure the System dialog
975 box appears.
976 <P>A list of the steps that will be taken to configure this AFS Server is
977 displayed, enabling you to review the steps before starting the actual
978 configuration process.
979 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">To return to a previous step to review or modify your selections, choose the
980 <B>Back</B> button.
981 </TD></TR></TABLE>
982 <P><LI>To begin configuration of the AFS Server on this machine, choose the
983 <B>Configure</B> button. If you are configuring the AFS Server into
984 an AFS cell in which there are Database Servers running a version of AFS older
985 than version 3.5, a dialog box appears prompting you to enter the AFS
986 principal password. 
987 <P>The AFS Server is configured according to your specifications. The
988 progress bar at the bottom of the dialog box indicates the steps in
989 progress. A message box appears indicating that configuration is
990 complete.
991 </OL>
992 <P><H3><A NAME="Header_28" HREF="awqbg002.htm#ToC_28">To Configure the AFS Control Center</A></H3>
993 <A NAME="IDX254"></A>
994 <A NAME="IDX255"></A>
995 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">If you have installed the AFS Control Center in combination with the AFS
996 Server, or the AFS Client, or both, then you do not need to configure the AFS
997 Control Center. The AFS Control Center is automatically configured when
998 the AFS Server or AFS Client is configured. If you have installed the
999 AFS Control Center only, then the Control Center must be configured on your
1000 system before it can be used.
1001 </TD></TR></TABLE>
1002 <OL TYPE=1>
1003 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
1004 <B>Control Panel</B>.
1005 <P><LI>Double-click the <B>AFS Control Center</B> icon. The AFS
1006 Control Center Properties dialog box appears.
1007 <P><LI>In the <B>Default Cell</B> box, enter the full name of the AFS cell to
1008 be administered by default.
1009 <P><LI>If the cell to be administered by the AFS Control Center is not listed in
1010 the list of AFS cells, choose the <B>Add</B> button. The New Cell
1011 dialog box opens. Enter the cell name in the <B>AFS Cell</B> box
1012 and a short description in the <B>Description</B> box.
1013 <P>Choose the <B>Add</B> button. The Add Server dialog box
1014 opens. In the <B>Server Name</B> box, enter the name of a Volume
1015 Location Server in the selected cell. Choose <B>OK</B> to close the
1016 Add Server dialog box. Repeat this process, adding information for all
1017 Volume Location Servers in the cell. After all server information has
1018 been entered, choose <B>OK</B> to close the New Cell dialog box.
1019 <P><LI>Choose <B>OK</B> to close the AFS Control Center Properties dialog
1020 box.
1021 </OL>
1022 <P>The AFS Control Center is now configured.
1023 <A NAME="IDX256"></A>
1024 <HR><H2><A NAME="HDRUNINSTALL" HREF="awqbg002.htm#ToC_29">Uninstalling AFS for Windows</A></H2>
1025 <P>This section outlines uninstallation prerequisites, provides
1026 instructions for uninstalling AFS for Windows, and lists the changes that the
1027 uninstallation process makes to your system.
1028 <A NAME="IDX257"></A>
1029 <A NAME="IDX258"></A>
1030 <P><H3><A NAME="Header_30" HREF="awqbg002.htm#ToC_30">Reinstalling and Upgrading</A></H3>
1031 <P>On a Windows NT machine, it is <I>not</I> necessary to uninstall
1032 the components of AFS for Windows for the purpose of reinstalling or upgrading
1033 the software. To reinstall or upgrade AFS for Windows, follow the
1034 installation procedure described in <A HREF="#HDRHOWTOINSTALL">To Install AFS for Windows</A>. During the installation process, the
1035 previously-installed AFS components are replaced. AFS configuration
1036 information is preserved.
1037 <P>On a Windows 95 or Windows 98 machine, you must uninstall the
1038 previously-installed AFS Light component, as described in <A HREF="#HDRTOUNINSTALL">To Uninstall AFS for Windows</A>, before reinstalling or upgrading AFS Light.
1039 <A NAME="IDX259"></A>
1040 <A NAME="IDX260"></A>
1041 <A NAME="IDX261"></A>
1042 <P><H3><A NAME="Header_31" HREF="awqbg002.htm#ToC_31">Uninstallation Prerequisites</A></H3>
1043 <P>Uninstalling AFS results in the deletion of all AFS application
1044 files. These files cannot be deleted if other applications are using
1045 them. For this reason, you must close all AFS dialog boxes before
1046 uninstalling AFS for Windows.
1047 <P>If you are uninstalling the AFS Server for the purpose of decommissioning
1048 the machine, the following prerequisites are necessary to avoid loss of
1049 data&#58;
1050 <OL TYPE=1>
1051 <P><LI>If the AFS Server is functioning as a File Server, move all read/write
1052 volumes to another AFS File Server, and remove all read-only volumes.
1053 <P><LI>Unconfigure the AFS Server. Open the AFS Server Configuration
1054 utility and choose the <B>Server</B> tab. Clear all check boxes and
1055 choose <B>OK</B>.
1056 </OL>
1057 <A NAME="IDX262"></A>
1058 <A NAME="IDX263"></A>
1059 <A NAME="IDX264"></A>
1060 <A NAME="IDX265"></A>
1061 <A NAME="IDX266"></A>
1062 <A NAME="IDX267"></A>
1063 <A NAME="IDX268"></A>
1064 <P><H3><A NAME="HDRTOUNINSTALL" HREF="awqbg002.htm#ToC_32">To Uninstall AFS for Windows</A></H3>
1065 <OL TYPE=1>
1066 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
1067 <B>Control Panel</B>.
1068 <P><LI>Double-click the <B>Add/Remove Programs</B> icon. The
1069 Add/Remove Programs Properties dialog box appears, displaying the
1070 <B>Install/Uninstall</B> tab.
1071 <P><LI>Close the Control Panel.
1072 <P><LI>Select the AFS component to be uninstalled, and select the
1073 <B>Add/Remove</B> button. The Confirm File Deletion dialog box
1074 appears, verifying that you want to remove the selected AFS for Windows
1075 component. Click <B>Yes</B> to continue with the uninstallation
1076 procedure.
1077 <P><LI>An AFS message box appears asking if you want to preserve configuration
1078 information. Select <B>Yes</B> to preserve configuration
1079 information or <B>No</B> to delete all configuration information.
1080 (No configuration information is associated with the AFS Supplemental
1081 Documentation component. If you are removing this component from your
1082 system, the AFS message box does not appear.)
1083 <P><LI>The Remove Programs from your Computer dialog box opens, displaying the
1084 components being removed from your system.
1085 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">A message box can possibly appear asking if you want to remove shared AFS
1086 files that are no longer needed by other components. Click <B>Yes To
1087 All</B> to completely remove the selected AFS component.
1088 </TD></TR></TABLE>
1089 </OL>
1090 <P>The selected AFS for Windows component is now uninstalled. If you
1091 installed a combination of AFS for Windows components, you must repeat Steps
1092 4-6 to remove each component separately.
1093 <P><H3><A NAME="Header_33" HREF="awqbg002.htm#ToC_33">Changes Made to Your System</A></H3>
1094 <A NAME="IDX269"></A>
1095 <P><H4><A NAME="Header_34">Changes made to your system by uninstalling the AFS Client</A></H4>
1096 <P>Uninstalling the AFS Client makes the following changes to your
1097 system&#58;
1098 <UL>
1099 <P><LI>Removes all AFS Client files from the <B>\Program
1100 Files\Ibm\Afs\Client\Program</B> directory, removes the <B>Client</B>
1101 directory, and, if no other AFS components remain installed, removes the
1102 <B>Ibm</B> directory.
1103 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The directories are <I>not</I> removed if they contain any files other
1104 than those installed by the AFS for Windows <B>setup</B> program.
1105 </TD></TR></TABLE>
1106 <P><LI>Removes the <B>IBM AFS</B> program group from the <B>Start</B>
1107 menu if no other AFS components remain installed.
1108 <P><LI>Removes the <B>AFS Client Configuration</B> icon from the Control
1109 Panel.
1110 <P><LI>Removes the AFS Menu from the Windows NT Explorer&#39;s context
1111 menu.
1112 <P><LI>Deletes the <B>IBM AFS Client</B> service.
1113 <P><LI>Removes AFS Client related registry entries from your system. Note
1114 that if you chose to preserve configuration information, some information
1115 remains in the registry after the uninstallation process.
1116 </UL>
1117 <P><H4><A NAME="Header_35">Changes made to your system by uninstalling AFS Light</A></H4>
1118 <P>Uninstalling AFS Light makes the following changes to your
1119 system&#58;
1120 <UL>
1121 <P><LI>Removes all AFS files from the <B>\Program
1122 Files\Ibm\Afs\Client\Program</B> directory and removes the <B>Ibm</B>
1123 directory.
1124 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The directories are <I>not</I> removed if they contain any files other
1125 than those installed by the AFS for Windows <B>setup</B> program.
1126 </TD></TR></TABLE>
1127 <P><LI>Removes the <B>IBM AFS</B> program group from the <B>Start</B>
1128 menu.
1129 <P><LI>Removes the <B>AFS Light Configuration</B> icon from the Control
1130 Panel.
1131 <P><LI>Removes the AFS Menu from the Windows Explorer&#39;s context menu.
1132 <P><LI>Removes AFS Light related registry entries from your system. Note
1133 that if you chose to preserve configuration information, some information
1134 remains in the registry after the uninstallation process.
1135 </UL>
1136 <P><H4><A NAME="Header_36">Changes made to your system by uninstalling the AFS Server</A></H4>
1137 <P>Uninstalling the AFS Server makes the following changes to your
1138 system&#58;
1139 <UL>
1140 <P><LI>Removes all AFS Server files from the <B>\Program
1141 Files\Ibm\Afs\Server</B> directory, removes the <B>Server</B> directory,
1142 and, if no other AFS components remain installed, removes the <B>Ibm</B>
1143 directory.
1144 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">These directories are <I>not</I> removed if they contain any files other
1145 than those installed by the AFS for Windows <B>setup</B> program.
1146 Also, if you chose to preserve configuration information, some files in the
1147 <B>\Program Files\Ibm\Afs\Server</B> directory are <I>not</I>
1148 removed.
1149 </TD></TR></TABLE>
1150 <P><LI>Removes the <B>IBM AFS</B> program group from the <B>Start</B>
1151 menu if no other AFS components remain installed.
1152 <P><LI>Removes the <B>AFS Server Configuration</B> icon from the Control
1153 Panel.
1154 <P><LI>Deletes the <B>IBM AFS Server</B> service.
1155 <P><LI>Removes AFS Server related registry entries from your system. Note
1156 that if you chose to preserve configuration information, some information
1157 remains in the registry after the uninstallation process.
1158 </UL>
1159 <P><H4><A NAME="Header_37">Changes made to your system by uninstalling the AFS Control Center</A></H4>
1160 <P>Uninstalling the AFS Control Center makes the following changes to your
1161 system&#58;
1162 <UL>
1163 <P><LI>Removes all AFS Control Center files from the <B>\Program
1164 Files\Ibm\Afs\Control Center</B> directory, removes the <B>Control
1165 Center</B> directory, and, if no other AFS components remain installed,
1166 removes the <B>Ibm</B> directory.
1167 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">These directories are <I>not</I> removed if they contain any files other
1168 than those installed by the AFS for Windows <B>setup</B> program.
1169 </TD></TR></TABLE>
1170 <P><LI>Removes the <B>IBM AFS</B> program group from the <B>Start</B>
1171 menu if no other AFS components remain installed.
1172 <P><LI>Removes the <B>AFS Control Center</B> icon from the Control
1173 Panel. Note that this icon appears in the Control Panel only if no
1174 other AFS for Windows components are installed on your system.
1175 <P><LI>Removes AFS Control Center related registry entries from your
1176 system. Note that if you chose to preserve configuration information,
1177 some information remains in the registry after the uninstallation
1178 process.
1179 </UL>
1180 <P><H4><A NAME="Header_38">Changes made to your system by uninstalling the AFS supplemental documentation</A></H4>
1181 <P>Uninstalling the AFS supplemental documentation makes the following
1182 changes to your system&#58;
1183 <UL>
1184 <P><LI>Removes the <B>SysAdminGd</B> directory and the <B>CmdRef</B>
1185 directory from the <B>\Program Files\Ibm\Afs\Documentation\Html</B>
1186 directory, and, if no other AFS components remain installed, removes the
1187 <B>Ibm</B> directory.
1188 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">These directories are <I>not</I> removed if they contain any files other
1189 than those installed by the AFS for Windows <B>setup</B> program.
1190 </TD></TR></TABLE>
1191 <P><LI>Removes the <B>IBM AFS</B> program group from the <B>Start</B>
1192 menu if no other AFS components remain installed.
1193 <P><LI>Removes AFS supplemental documentation related registry entries from your
1194 system.
1195 </UL>
1196 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="awqbg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="awqbg002.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="awqbg004.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="awqbg004.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
1197 <!-- Begin Footer Records  ========================================== -->
1198 <P><HR><B> 
1199 <br>&#169; <A HREF="">IBM Corporation 2000.</A>  All Rights Reserved 
1200 </B> 
1201 <!-- End Footer Records  ============================================ -->
1202 <A NAME="Bot_Of_Page"></A>
1203 </BODY></HTML>