Initial IBM OpenAFS 1.0 tree
[openafs.git] / src / WINNT / doc / install / Documentation / en_US / html / ReleaseNotes / awrns005.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="awrns004.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="awrns006.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="HDRLTCLIENT" HREF="awrns002.htm#ToC_29">AFS Light Release Notes</A></H1>
18 <HR><H2><A NAME="Header_30" HREF="awrns002.htm#ToC_30">Introduction</A></H2>
19 <P>This section contains important information about the AFS Light
20 component of AFS for Windows, version 3.6. AFS Light provides
21 access to the AFS filespace from a PC running Windows 95 or Windows 98,
22 enabling users to manage files and directories in AFS. AFS Light
23 accesses the AFS filespace via an AFS Client machine that is configured as an
24 AFS Light Gateway.
25 <HR><H2><A NAME="HDRLIGHT_PREREQ" HREF="awrns002.htm#ToC_31">AFS Light Installation Requirements</A></H2>
26 <P>Your system must meet the following hardware, software, and
27 administrative privilege requirements to install AFS Light.
28 <P><H3><A NAME="Header_32" HREF="awrns002.htm#ToC_32">Hardware</A></H3>
29 <P>The hardware requirements for installing AFS Light 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
35 </UL>
36 <P><H3><A NAME="Header_33" HREF="awrns002.htm#ToC_33">Software</A></H3>
37 <P>The software requirements for installing AFS Light are&#58;
38 <UL>
39 <P><LI>Microsoft Windows 95 with the Windows Sockets 2 update or Microsoft
40 Windows 98
41 <P><LI>AFS Light Gateway
42 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The AFS Light Gateway must be enabled on a Windows NT machine running the AFS
43 Client, version 3.5 or version 3.6. AFS Light accesses
44 AFS through the AFS Light Gateway. See <A HREF="#HDRGATEWAY">Accessing AFS via the AFS Light Gateway</A> for more information.
45 </TD></TR></TABLE>
46 </UL>
47 <P><H3><A NAME="Header_34" HREF="awrns002.htm#ToC_34">Administrative Privilege Requirement</A></H3>
48 <P>No administrative privileges are required to install and configure AFS
49 Light.
50 <HR><H2><A NAME="Header_35" HREF="awrns002.htm#ToC_35">Product Notes</A></H2>
51 <P>This section highlights important general information about the AFS
52 Light component of AFS for Windows, version 3.6.
53 <P><H3><A NAME="HDRGATEWAY" HREF="awrns002.htm#ToC_36">Accessing AFS via the AFS Light Gateway</A></H3>
54 <P>AFS Light accesses the AFS filespace through an AFS Light
55 Gateway. In order to use AFS Light, you must have at least one machine
56 in the same domain as the AFS Light machine running the AFS Client for
57 Windows, version 3.5 or the AFS Client for Windows, version
58 3.6.
59 <UL>
60 <P><LI><B>The AFS Light cell database and the AFS Light Gateway cell database
61 must be synchronized</B>
62 <P>In order for an AFS Light user to access a cell, an entry for the cell must
63 exist in both the AFS Light cell database (<B>afsdcell.ini</B>
64 file) and the AFS Light Gateway cell database (<B>afsdcell.ini</B>
65 file).
66 <P><LI><B>AFS Light must be able to resolve the AFS Light Gateway&#39;s
67 service name</B>
68 <P>AFS Light must be able to resolve the name of the gateway machine in order
69 to communicate with the gateway machine. The name of the gateway
70 machine is the gateway&#39;s NetBIOS service name, in the form
71 <I>mach</I><B>-afs</B>, where <I>mach</I> is the host
72 computer name up to a maximum of 11 characters. Name resolution can be
73 achieved by adding the gateway&#39;s NetBIOS service name to the
74 client&#39;s LMHOSTS file or to the appropriate DNS or WINS servers.
75 If the AFS Light machine and its AFS Light Gateway machine reside on the same
76 subnet, then name resolution succeeds automatically via a NetBIOS
77 broadcast.
78 <P><LI><B>The AFS Light Gateway must be able to authenticate an AFS Light user
79 in a Windows context</B>
80 <P>Once configured as an AFS Light Gateway, your AFS Client machine must be
81 able to authenticate AFS Light users in a Windows context. This
82 authentication can be achieved via a <I>domain</I> user account or via
83 synchronized <I>machine</I> user accounts. A domain user account is
84 a user account in a Windows domain. A machine user account is a user
85 account that is valid only on a particular host machine.
86 <P>When the AFS Light Gateway is configured into a Windows domain, an AFS
87 Light user must log onto either a domain user account in the domain to which
88 the gateway belongs or a machine user account with the same username and
89 password as that of a domain user account in the gateway domain.
90 <P>If machine user accounts are employed, then these accounts must be
91 synchronized on the AFS Light Gateway and AFS Light machines. A user
92 must log onto an AFS Light machine with the same username and password as that
93 of a machine user account that is defined on the AFS Light Gateway
94 machine.
95 <P><I>The use of domain user accounts is recommended to simplify
96 administration.</I>
97 </UL>
98 <P><H3><A NAME="Header_37" HREF="awrns002.htm#ToC_37">AFS Light for Windows 95 Requires the Windows Sockets 2 Update</A></H3>
99 <P>To run AFS Light on a Windows 95 machine, you must install the Windows
100 Sockets 2 update if it is not yet installed. This update is available
101 for download from the Microsoft Web site.
102 <P><H3><A NAME="Header_38" HREF="awrns002.htm#ToC_38">AFS Command-Line Binaries</A></H3>
103 <P>When installed on a Windows 98 system, AFS Light includes
104 administration-oriented command suites such as <B>bos</B>, <B>kas</B>,
105 <B>vos</B>, and <B>pts</B>. Execute the commands within these
106 suites from the Windows Command Prompt. The command suites are
107 <I>not</I> available when AFS Light is installed on a Windows 95
108 system.
109 <P>
110 <P><H3><A NAME="Header_39" HREF="awrns002.htm#ToC_39">AFS Light Must Be Installed in a Directory Whose Path Contains Only ANSI Characters</A></H3>
111 <P>The AFS for Windows software must be installed in a directory whose
112 path contains only ANSI characters, for example the default directory
113 <B>C&#58;\Program Files</B>.
114 <P><H3><A NAME="Header_40" HREF="awrns002.htm#ToC_40">Temporary Files</A></H3>
115 <P>AFS Light for Windows occasionally creates temporary files. To
116 control where such files are created, set your environment variable (TMP or
117 TEMP) to the fully qualified path of the preferred temporary directory.
118 If you do not specify a temporary directory, then any temporary files are
119 created in the current working directory of the process that creates the
120 files.
121 <P><H3><A NAME="Header_41" HREF="awrns002.htm#ToC_41">National Language Support for AFS Light</A></H3>
122 <P>AFS provides national language support for the AFS Light graphical user
123 interface (GUI) tools and documentation, including support for bidirectional
124 scripts (Hebrew, Arabic, etc.). The language strings installed
125 are determined by your machine&#39;s system default locale, as specified in
126 the Control Panel&#39;s Regional Settings Properties dialog box. If no
127 language strings exist for the current locale, then English language strings
128 are installed by default.
129 <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
130 <I>user</I> locale (specified by a user) on the machine. However,
131 the language strings installed with AFS for Windows are always determined by
132 the system default locale.
133 </TD></TR></TABLE>
134 <P><H3><A NAME="Header_42" HREF="awrns002.htm#ToC_42">The kpwvalid Password Strength Checker Is Not Used on Windows Systems</A></H3>
135 <P>When an AFS user password is changed from a Windows system, the
136 <B>kpwvalid</B> program is <I>not</I> used to check the quality of the
137 new password. (On UNIX systems, if a <B>kpwvalid</B> program exists
138 in the same directory as the <B>kpasswd</B> program, the
139 <B>kpwvalid</B> program checks the quality of every new user
140 password.)
141 <HR><H2><A NAME="Header_43" HREF="awrns002.htm#ToC_43">Limitations and Restrictions</A></H2>
142 <P>This section briefly describes the known limitations and restrictions
143 in the AFS Light component of AFS for Windows, version 3.6.
144 <P><H3><A NAME="Header_44" HREF="awrns002.htm#ToC_44">Encryption Not Supported in Simplified Chinese Version</A></H3>
145 <P>The Simplified Chinese version of Microsoft Windows 98 does not support
146 encryption, which is needed to transmit AFS passwords from AFS Light to the
147 AFS Light Gateway. In order for AFS Light users to obtain AFS tokens
148 when using the Simplified Chinese version of Microsoft Windows 98, encryption
149 in AFS must be disabled.
150 <P>To disable encryption in AFS, add the following line to your Windows
151 <B>Autoexec.bat</B> file&#58; 
152 <PRE>set AFS_RPC_ENCRYPT=OFF
153 </PRE>
154 <P>Note that disabling encryption introduces a potential security risk because
155 AFS passwords are transmitted to the AFS Client Gateway in an unencrypted form
156 when tokens are obtained.
157 <P><H3><A NAME="Header_45" HREF="awrns002.htm#ToC_45">Symbolic Links to AFS Files and Directories</A></H3>
158 <P>Symbolic links to directories are treated as directories, and symbolic
159 links to files appear as files in Windows 98 and Windows 95 systems.
160 Neither appear as symbolic links.
161 <P>Currently, you cannot use the Windows interface (the Windows Explorer, for
162 example) to delete symbolic links or create symbolic links in the AFS
163 filespace. If you attempt to delete a directory that is a symbolic link
164 using the Windows interface, the directory&#39;s contents are deleted.
165 The directory itself is not deleted. If you attempt to delete a file
166 that is a symbolic link using the Windows interface, the link is removed,
167 rather than the target file.
168 <P>To create and delete symbolic links to AFS files and directories, use the
169 <B>symlink.exe</B> program that is provided with AFS for Windows,
170 version 3.6. Execute <B>symlink</B> commands from your
171 Windows NT Command Prompt.
172 <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="awrns004.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="awrns006.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> 
173 <!-- Begin Footer Records  ========================================== -->
174 <P><HR><B> 
175 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
176 </B> 
177 <!-- End Footer Records  ============================================ -->
178 <A NAME="Bot_Of_Page"></A>
179 </BODY></HTML>