afs-blacklist-initialize-volume-ptr-always-20080628
[openafs.git] / src / WINNT / doc / install / Documentation / en_US / html / ReleaseNotes / awrns004.htm
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
2 <HTML><HEAD>
3 <TITLE>Release Notes</TITLE>
4 <!-- Begin Header Records  ========================================== -->
5 <!-- /tmp/idwt4485/awrns000.scr converted by idb2h R4.2 (359) ID      -->
6 <!-- Workbench Version (AIX) on 15 Feb 2000 at 10:10:20               -->
7 <META HTTP-EQUIV="updated" CONTENT="Tue, 15 Feb 2000 10:10:19">
8 <META HTTP-EQUIV="review" CONTENT="Thu, 15 Feb 2001 10:10:19">
9 <META HTTP-EQUIV="expires" CONTENT="Fri, 15 Feb 2002 10:10:19">
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>Release Notes</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="awrns002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="awrns003.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="awrns005.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="#INDEX_START"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
17 <HR><H1><A NAME="HDRCLIENT" HREF="awrns002.htm#ToC_6">AFS Client Release Notes</A></H1>
18 <HR><H2><A NAME="Header_7" HREF="awrns002.htm#ToC_7">Introduction</A></H2>
19 <P>This section contains important information about the AFS Client
20 component of AFS for Windows, version 3.6. The AFS Client
21 provides direct access to the AFS filespace from a PC running Windows NT,
22 enabling users to manage files and directories in AFS. The AFS Client
23 includes the AFS Light Gateway, which enables AFS Light users to access the
24 AFS filespace.
25 <HR><H2><A NAME="HDRPREREQ" HREF="awrns002.htm#ToC_8">AFS Client Installation Requirements</A></H2>
26 <P>Your system must meet the following hardware, software, and
27 administrative privilege requirements to install the AFS Client.
28 <P><H3><A NAME="Header_9" HREF="awrns002.htm#ToC_9">Hardware</A></H3>
29 <P>The hardware requirements for installing the AFS Client are&#58;
30 <UL>
31 <P><LI>A PC using an 80486/66 MHz (or faster) microprocessor or a Pentium-based
32 microprocessor
33 <P><LI>At least 16 MB of RAM
34 <P><LI>A hard disk with at least 4 MB of available disk space, plus enough
35 additional disk space on the drive where the cache is located to accommodate
36 the desired cache size. (By default, the cache is located on the drive
37 where Windows is installed and the cache size is 20 MB.)
38 </UL>
39 <P><H3><A NAME="Header_10" HREF="awrns002.htm#ToC_10">Software</A></H3>
40 <P>The software requirements for installing the AFS Client are&#58;
41 <UL>
42 <P><LI>Microsoft Windows NT 4.0 with Service Pack 4 or Service Pack 5
43 </UL>
44 <P><H3><A NAME="Header_11" HREF="awrns002.htm#ToC_11">Administrative Privilege Requirement</A></H3>
45 <P>You must be a member of the local <B>Administrators</B> group on
46 your Windows system in order to install, configure, and start the AFS
47 Client.
48 <HR><H2><A NAME="Header_12" HREF="awrns002.htm#ToC_12">Product Notes</A></H2>
49 <P>This section highlights important general information about the AFS
50 Client component of AFS for Windows, version 3.6. It includes
51 descriptions of new features and enhancements made available in this release
52 of the AFS Client.
53 <P><H3><A NAME="Header_13" HREF="awrns002.htm#ToC_13">Additional Configuration Options Available Via the Client Interface</A></H3>
54 <P>The AFS Client Configuration utility&#39;s <B>Advanced</B> tab now
55 includes options for configuring logon parameters, diagnostic parameters, and
56 other miscellaneous configuration parameters. From the
57 <B>Advanced</B> tab, you can also configure global drive mappings.
58 Many of these configuration options were formerly available to AFS Client
59 users as registry settings.
60 <P>The <B>Advanced</B> tab is accessed from the Windows Control
61 Panel. To display the <B>Advanced</B> tab&#58;
62 <OL TYPE=1>
63 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
64 <B>Control Panel</B>.
65 <P><LI>Double-click the <B>AFS Client Configuration</B> icon to display the
66 AFS Client Configuration utility.
67 <P><LI>Choose the <B>Advanced</B> tab.
68 </OL>
69 <P><H3><A NAME="HDRCACHE" HREF="awrns002.htm#ToC_14">AFS Client Cache Location Is Now Configurable</A></H3>
70 <P>The AFS Client Cache is stored in a file named <B>AFSCache</B>,
71 rather than in the system paging file. By default, the cache is stored
72 on the drive where Windows is installed. The size of the AFS Client
73 Cache is limited by available free disk space. The cache size must be
74 at least 1 MB. The default cache size is 20480 KB (20MB).
75 <P>The location of the AFS Client Cache can now be changed. Changing
76 the cache location is useful when there is not sufficient available free disk
77 space on the drive where Windows is installed. To change the cache
78 location, enter a valid, fully qualified filename in the <B>Cache Path</B>
79 field on the AFS Client Configuration&#39;s <B>Advanced</B> tab.
80 <P><H3><A NAME="Header_15" HREF="awrns002.htm#ToC_15">Mapping Global Drives to the AFS Filespace</A></H3>
81 <P>The AFS Client&#39;s graphical user interface can now be used to map
82 global drives to places in the AFS filespace. Global drives are mapped
83 to the AFS filespace when the IBM AFS Client service starts; users are
84 not required to be logged on. To map global drives to AFS&#58;
85 <OL TYPE=1>
86 <P><LI>From the <B>Start</B> menu, choose <B>Settings</B>, then choose
87 <B>Control Panel</B>.
88 <P><LI>Double-click the <B>AFS Client Configuration</B> icon to display the
89 AFS Client Configuration utility. Select the <B>Advanced</B>
90 tab.
91 <P><LI>Click <B>Add</B>. The Map Global Drive dialog box
92 appears. In the <B>Drive Letter</B> box, choose a network drive or
93 accept the default. In the <B>AFS Path</B> box, type a path to the
94 AFS filespace. If desired, enter a short name to be associated with the
95 specified drive letter and AFS path in the <B>Description</B> box.
96 Note that a drive letter description can have no more than 12 characters and
97 cannot contain spaces or tabs.
98 <P><LI>Click <B>OK</B> to establish the connection. The drive letter
99 and AFS path appear on the Global Drives dialog box. The drive letter
100 now appears in your Windows NT Explorer.
101 </OL>
102 <P><H3><A NAME="Header_16" HREF="awrns002.htm#ToC_16">AFS Client Computer Name Must Correspond to the Name Service Host Name</A></H3>
103 <P>The computer name of an AFS Client machine (as displayed in the
104 <B>Computer Name</B> field on the <B>Identification</B> tab of the
105 Network dialog box) must correspond to the host name assigned to the computer
106 by the name service (normally the Domain Name Service, or DNS) used to map
107 names to Internet Protocol (IP) addresses. For example, if the machine
108 on which the AFS Client is installed has the computer name
109 <B>afsclient1</B> and is in the <B>yourcompany.com</B> domain,
110 the corresponding DNS entry for the machine must be
111 <B>afsclient1.yourcompany.com</B>.
112 <P><H3><A NAME="Header_17" HREF="awrns002.htm#ToC_17">AFS Command-Line Binaries</A></H3>
113 <P>The AFS Client includes administration-oriented command suites such as
114 <B>bos</B>, <B>kas</B>, <B>vos</B>, and <B>pts</B>.
115 Execute the commands within these suites from the Windows Command
116 Prompt.
117 <P><H3><A NAME="Header_18" HREF="awrns002.htm#ToC_18">The AFS Client Must Be Installed in a Directory Whose Path Contains Only ANSI Characters</A></H3>
118 <P>The AFS for Windows software must be installed in a directory whose
119 path contains only ANSI characters, for example the default directory
120 <B>C&#58;\Program Files</B>.
121 <P><H3><A NAME="Header_19" HREF="awrns002.htm#ToC_19">Disabling All but the Client Component of the AFS for Windows Setup Program</A></H3>
122 <P>You have the option of altering the AFS for Windows setup program to
123 disable all but the client component. Such a client-only setup program
124 renders users unable to install any components other than the AFS
125 Client. To perform a client-only installation, create the file
126 <B>setup.co</B> in the same directory as the other installation
127 files; the setup program then allows only the AFS Client to be
128 installed. Note that the contents of the <B>setup.co</B>
129 file are irrelevant. Follow the installation procedure described in
130 <I>IBM AFS for Windows Quick Beginnings</I> regardless of the type of
131 installation you are performing.
132 <P><H3><A NAME="Header_20" HREF="awrns002.htm#ToC_20">Temporary Files</A></H3>
133 <P>The AFS Client for Windows occasionally creates temporary files.
134 To control where such files are created, set your environment variable (TMP or
135 TEMP) to the fully qualified path of the preferred temporary directory.
136 If you do not specify a temporary directory, then any temporary files are
137 created in the current working directory of the process that creates the
138 files.
139 <P><H3><A NAME="Header_21" HREF="awrns002.htm#ToC_21">National Language Support for the AFS Client</A></H3>
140 <P>AFS provides national language support for the AFS Client graphical
141 user interface (GUI) tools and documentation, including support for
142 bidirectional scripts (Hebrew, Arabic, etc.). The language
143 strings installed are determined by your machine&#39;s system default locale,
144 as specified in the Control Panel&#39;s Regional Settings Properties dialog
145 box. If no language strings exist for the current locale, then English
146 language strings are installed by default.
147 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The <I>system default</I> locale for a machine can be different than the
148 <I>user</I> locale (specified by a user) on the machine. However,
149 the language strings installed with AFS for Windows are always determined by
150 the system default locale.
151 </TD></TR></TABLE>
152 <P><H3><A NAME="Header_22" HREF="awrns002.htm#ToC_22">The kpwvalid Password Strength Checker Is Not Used on Windows Systems</A></H3>
153 <P>When an AFS user password is changed from a Windows system, the
154 <B>kpwvalid</B> program is <I>not</I> used to check the quality of the
155 new password. (On UNIX systems, if a <B>kpwvalid</B> program exists
156 in the same directory as the <B>kpasswd</B> program, the
157 <B>kpwvalid</B> program checks the quality of every new user
158 password.)
159 <P><H3><A NAME="Header_23" HREF="awrns002.htm#ToC_23">Configurable LAN Adapter Number</A></H3>
160 <P>The LAN Adapter (LANA) number used by the AFS Client service must match
161 the LANA number setting on your Windows system. By default, the AFS
162 Client service is configured to use LANA number <B>0</B> (zero).
163 <P>You can now use the AFS Client&#39;s graphical user interface tools to
164 modify the value of the LANA number used by the AFS Client service. To
165 change the LANA number, enter a new value in the <B>Lan Adapter Number</B>
166 field on the AFS Client Configuration&#39;s <B>Advanced</B> tab.
167 You must restart the AFS Client service after modifying this parameter.
168 <P>Alternatively, if you do not want to change the default LANA number used by
169 the AFS Client service to match the NetBIOS Configuration of your Windows NT
170 machine, you can instead modify your system&#39;s LANA number setting to
171 match the AFS default setting (<B>0</B>). Access the
172 <B>Services</B> tab on the Control Panel&#39;s Network
173 application. Choose <B>NetBIOS Interface</B>, and select the
174 <B>Properties</B> button. Enter <B>0</B> (zero) in the
175 <B>Lana Number</B> field. You must restart your machine after
176 making changes to this Windows setting.
177 <P><H3><A NAME="Header_24" HREF="awrns002.htm#ToC_24">WinLogon Graphical Identification and Authentication (GINA) Modules and AFS Authentication</A></H3>
178 <P>The AFS Client includes the header files and libraries required to
179 build a WinLogon Graphical Identification and Authentication (GINA) module
180 that obtains AFS tokens. These header files and libraries are installed
181 in the <B> &lt;</B><I>AFS for Windows Installation
182 Directory</I><B>>\afs\client\program</B> directory. In addition,
183 a sample program with compiling and linking instructions is provided in
184 <B>&lt;</B><I>AFS for Windows Installation
185 Directory</I><B>>\afs\client\program\sample\token.c</B>.
186 <P><H3><A NAME="Header_25" HREF="awrns002.htm#ToC_25">Cell Database Is Maintained During Upgrade</A></H3>
187 <P>When the AFS Client software is upgraded, the AFS Client cell database
188 file (<B>afsdcell.ini</B>) located in the <B>Windows</B>
189 directory is not replaced, in order to preserve local cell configuration
190 information. However, a copy of the cell database as distributed by the
191 vendor is installed in the AFS Client program directory.
192 <P>
193 <HR><H2><A NAME="Header_26" HREF="awrns002.htm#ToC_26">Limitations and Restrictions</A></H2>
194 <P>This section briefly describes the known limitations and restrictions
195 in the AFS Client component of AFS for Windows, version 3.6.
196 <P><H3><A NAME="Header_27" HREF="awrns002.htm#ToC_27">Symbolic Links to AFS Files and Directories</A></H3>
197 <P>Symbolic links to directories are treated as directories, and symbolic
198 links to files appear as files in Windows NT systems. Neither appear as
199 links.
200 <P>Currently, you cannot use the Windows interface (the Windows NT Explorer,
201 for example) to delete symbolic links or create symbolic links in the AFS
202 filespace. If you attempt to delete a directory that is a symbolic link
203 using the Windows interface, the directory&#39;s contents are deleted.
204 The directory itself is not deleted. If you attempt to delete a file
205 that is a symbolic link using the Windows interface, the link is removed,
206 rather than the target file.
207 <P>To create and delete symbolic links to AFS files and directories, use the
208 <B>symlink.exe</B> program that is provided with AFS for Windows,
209 version 3.6. Execute <B>symlink</B> commands from your
210 Windows NT Command Prompt.
211 <P><H3><A NAME="Header_28" HREF="awrns002.htm#ToC_28">AFS Client Can Fail to Load When Network Drives Are in the Application Path</A></H3>
212 <P>When loading an application (such as the AFS Client), Windows NT
213 searches for the application&#39;s dynamic-link libraries (DLLs). One
214 of the places that Windows searches for an application&#39;s DLLs is in each
215 directory specified in the Path environment variable. In the Path
216 environment variable, if a network path is defined before the path that
217 contains a DLL, the application can possible fail to load.
218 <P>Most services (such as the AFS Client) do not have security access to
219 network drives specified in the Path environment variable. When a
220 network drive is encountered in the path and the application does not have the
221 permission to access the network, Windows fails to distinguish between an
222 Access Denied error caused by a process which cannot access a file and a
223 process which cannot access the network drive that contains the file.
224 Because this distinction cannot be made, the operating system assumes that the
225 file exists but cannot be accessed by the process. This error causes
226 the system to discontinue the search for the DLLs and assume that a DLL cannot
227 be accessed. Since Windows believes that a DLL is inaccessible, it
228 fails to load the application.
229 <P>In order to avoid this problem, ensure that the directory to an
230 application&#39;s DLLs comes before any network drives in the path.
231 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="awrns002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="awrns003.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="awrns005.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="#INDEX_START"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
232 <!-- Begin Footer Records  ========================================== -->
233 <P><HR><B> 
234 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
235 </B> 
236 <!-- End Footer Records  ============================================ -->
237 <A NAME="Bot_Of_Page"></A>
238 </BODY></HTML>