[openafs.git] / src / WINNT / install / Win9x / ReadMe.rtf
1 {\rtf1\ansi\deff0\deftab720{\fonttbl{\f0\fswiss MS Sans Serif;}{\f1\froman\fcharset2 Symbol;}{\f2\froman Times New Roman;}{\f3\froman Times New Roman;}}\r
2 {\colortbl\red0\green0\blue0;\red0\green0\blue255;}\r
3 \deflang1033\pard\qc\plain\f2\fs28\b AFS Client for Windows 95/98 (\plain\f2\fs20\b Version - 04/20/01 12:18 PM\plain\f2\fs28\b )\r
4 \par \pard\plain\f2\fs28 \r
5 \par \plain\f2\fs20 Welcome to the Open AFS Client for Windows 95/98.\r
6 \par \r
7 \par This client will allow you to access files on sites stored all over the Internet as though the files were residing on your local machine.  You can store your own files on the Internet to share with others, and can limit access to your files to specific users or groups of users.  You can browse through the different AFS sites (known as \plain\f2\fs20\i cells\plain\f2\fs20 ) from a single file tree and use standard Windows programs such as Explorer to copy and manipulate files.  You can open files stored on the Internet directly from Windows applications.\r
8 \par \r
9 \par One drive letter will be created on your machine by default - Z:.  The Z: drive will be the root of the AFS tree, allowing you to browse all sites that have AFS servers available.\r
10 \par \r
11 \par This is a native Windows 9x client; a gateway machine is not required.\r
12 \par \r
13 \par \plain\f2\fs24\b System Requirements\r
14 \par \r
15 \par \plain\f2\fs20 IBM compatible PC running Windows 95 (see below) or 98\r
16 \par 16 MB RAM\r
17 \par 20 MB free disk space\r
18 \par Client for Microsoft Networks must be installed\r
19 \par TCP/IP protocol stack must be installed\r
20 \par \r
21 \par \plain\f2\fs24\b Getting Started\r
22 \par \plain\f2\fs20 \r
23 \par To use the client, you will need to perform the following tasks after installation and reboot:\r
24 \par \r
25 \par 1) Boot up your machine and log in to Windows.  (Note: if you bypass the login by hitting "Cancel" at the login screen, Windows networking will not work and you will not be able to mount your drives.)\r
26 \par 2) Connect to the Internet or your company's intranet.  (Note: If you are using the client in a firewalled intranet environment with private AFS cells, you will probably need a CellServDB file specific to your \r
27 \par company's environment.  Ask your system administrator.)\r
28 \par 3) Check your system time, timezone, and date settings and make sure they are synchronized with the AFS server. \r
29 \par 4) Start the AFS Client by double-clicking on the icon on the desktop or Start Menu.\r
30 \par 5) A box will appear asking for your userid and password.  Type them in and press "Connect".  This will\r
31 \par authenticate you to the AFS cell you specified at installation.  (Note: You cannot use the GUI interface to authenticate to other cells at present.  This will be added later.  You can still authenticate to other cells using the "klog" command; see "Command Line Tools" below.)  Use the "Save Password" checkbox to enable the AFS Client to save your password in the registry for use next time you run the AFS Client.  (The password will be saved encrypted in the registry if you are running Windows 98 or have installed Internet Explorer version 4.0 or later.  Otherwise, it will be saved in clear text.  We recommend you do not use the save password feature if encryption is not available on your system.)\r
32 \par 6) Now a Windows Explorer will start to allow you to browse your new Z: drive.  Z: will be the root of the AFS tree.\r
33 \par 7) By checking "Advanced Options",  you can add and change your drive letter assignments.  There is one  share assigned by default, "all".  (Note: the "all" share cannot be removed.)  New shares must be assigned a unique share name and an AFS path.  You can mount and unmount your AFS drives by checking or unchecking the box next to each drive letter.  You can also set whether a drive will be automatically mounted at startup by highlighting the drive and clicking "Change".\r
34 \par 8) You can kill or minimize the AFS client dialog window.  Double click the icon in the system tray to restore it.\r
35 \par 9) When you are ready to shut down the AFS client, bring up the AFS client dialog and click the "Disconnect" button.  This will terminate the AFS daemon.  Then click "Exit" to quit.\r
36 \par \r
37 \par Complete documentation for the AFS client is available at:  \r
38 \par\r
39 \par  \r
40 \par \plain\f2\fs24\b Explorer Shell Extension\r
41 \par \r
42 \par \plain\f2\fs20 You can right click on items within an AFS tree to bring up an "AFS" menu item.  Under this menu are various operations you can execute on a file or directory.  The most useful item is "Access Control Lists" which allows you to view and edit the permissions of a particular directory. \r
43 \par \r
44 \par \r
45 \par \plain\f2\fs24\b Command Line Tools\r
46 \par \r
47 \par \plain\f2\fs20 The following command line tools are available in the install directory.  See the full documentation at the above URL for complete information on these commands:\r
48 \par \r
49 \par klog.exe:         \tab Authenticate a user to a cell, e.g. "klog" \tab \r
50 \par unlog.exe:       \tab Unauthenticate to a cell\tab \r
51 \par tokens.exe\tab List which tokens  you have (cells you have authenticated to) and their expiration times\tab \r
52 \par kpasswd.exe\tab Change your password for the specified cell\tab \r
53 \par symlink.exe:    \tab Create a symbolic link , e.g. "symlink make dest src" makes a link called "dest" pointing to file  "src"\tab \r
54 \par fs.exe:              \tab This command is used for a number of file server functions.  Type "fs help" for a list, and then "fs help function" to get detailed help for that function.  See the documentation for more info.\tab \r
55 \par fs help\tab list functions\tab \r
56 \par fs listacl <directory>\tab show directory access control list\tab \r
57 \par fs setacl <diretory> <acl>\tab set directory access control list\tab \r
58 \par fs listquota <directory>\tab show directory disk quota\tab \r
59 \par fs flushvolume <directory>\tab flush cached data from volume\tab \r
60 \par pts.exe\tab This command is used for user administration functions.  See the documentation for more info.   (Note: this command currently does not work in Windows 95.)\tab \r
61 \par \r
62 \par \plain\f2\fs24\b Known Issues\r
63 \par \r
64 \par \pard\li720\fi-360\plain\f2\fs20 1) The Microsoft Visual Studio linker "link.exe" fails when writing to a file stored in AFS.  It freezes the system for a minute or so and then times out.  This problem may exist in other programs as well.\r
65 \par 2) Occasionally the U: and Z: drive letters are not mapped automatically when the client is started.  If this happens, you can map them manually by entering the commands:\r
66 \par \pard\li1440\fi-360\tx1440\plain\f2\fs20 0net use u: \\\\mymachine-afs\\home\r
67 \par 1net use z: \\\\mymachine-afs\\all\r
68 \par 2where "mymachine" is the Windows networking name of your machine.\r
69 \par \pard\li720\fi-360\plain\f2\fs20 3) The Windows file system does not understand symbolic links, so links to directories just look like normal directories.  This can lead to problems when trying to recursively copy a directory, since following cyclical links can lead to infinite regress.\r
70 \par 4) The Office 2000 install program seems to take a very long time to install Office 2000 to AFS.\r
71 \par 5) You must log in to Windows for Windows networking to work correctly.  If you bypass the login, AFS will time out trying to start the AFS client console, with the error "Connect can't continue: Network error adding Z:all."\r
72 \par 6) Under certain configurations the AFS Client Console will report a cache error.   This will prevent the AFS Client from initializing.  \r
73 \par 7) Infrequently Windows will incorrectly notify the AFS Control Panel that there are open files.  If this prevents AFS from disconnecting, it will require you to reboot.\r
74 \par \pard\plain\f2\fs20 \r
75 \par \r
76 \par \plain\f2\fs24\b Legalities\r
77 \par \r
78 \par \pard\li720\ri810\plain\f2\fs24\i Copyright 2000, International Business Machines Corporation and others. All Rights Reserved. This software has been released under the terms of the IBM Public License.  For details, see the LICENSE file in the top-level source directory or online at  \plain\f2\fs24\cf1\i\ul\plain\f2\fs24\b \r
79 \par \pard\plain\f2\fs24\b \r
80 \par \plain\f2\fs20 This program was compiled using the DJGPP compiler and includes object code copyrighted by DJ Delorie.  The compiler and libraries are available at\r
81 \par \r
82 \par This program includes software developed by the University of California, Berkeley, and its contributors.\r
83 \par \r
84 \par This program has been distributed with, and uses the services of, the sock.vxd and mmap.vxd drivers written for the Coda project at and licensed under the GNU General Public License.  Source code for these drivers is available at the above web site.\r
85 \par \r
86 \par \r
87 \par }\r
88 \0