Update NEWS file with user visible changes in 1.2.6.
[openafs.git] / NEWS
1 OpenAFS News -- history of user-visible changes.  July 22, 2002.
2
3 * Changes incorporated in OpenAFS 1.3
4
5 ** When fakestat is enabled on MacOSX, the Finder can be used to browse
6    a fully-populated /afs directory.  However, this precludes reliable
7    use of entire volumes as MacOS bundles (i.e. containing a Contents
8    directory in the root of the volume).
9
10 ** Mountpoint directory information can be faked by the cache manager,
11    making operations such as stat'ing all cells under /afs much faster.
12    This is enabled by passing -fakestat to afsd, but might not be stable
13    on all platforms.
14
15 * Changes incorporated in OpenAFS 1.2.6
16
17 ** Mountpoint directory information can be faked by the cache manager,
18    making operations such as stat'ing all cells under /afs much faster.
19    This is enabled by passing -fakestat to afsd.
20
21 ** Solaris 9 FCS and Solaris 7 and 8 x86 are now supported.
22
23 * Changes incorporated in OpenAFS 1.2.5
24
25 ** A remote denial of service attack in the AIX and IRIX clients has
26    been fixed.  Users of those platforms are strongly encouraged to
27    upgrade.
28
29 ** Fixed race conditions in fileserver that could result in crash.
30
31 * Changes incorporated in OpenAFS 1.2.4
32
33 ** Server logfiles now more consistant about format in which hosts are
34    referred to.
35
36 ** vfsck on Solaris will now allow force runs (using -y flag) even if old 
37    inodes exist.
38
39 * Changes incorporated in OpenAFS 1.2.3
40
41 ** Cell aliases for dynroot can be specified in the CellAlias file in
42    /usr/vice/etc or /usr/local/etc/openafs, in format "realname alias",
43    one per line.  They can also be managed at runtime with "fs newalias"
44    and "fs listaliases".
45
46 * Changes incorporated in OpenAFS 1.2.2
47
48 ** Solaris 9 and Linux PA-RISC are now supported
49
50 ** fileserver will not erroneously delay legitimate errors for 3 seconds
51    after 10 errors are returned (e.g. stat() on a directory you can't read)
52
53 ** Rx MTU calculation now works for Irix, Solaris and Linux
54
55 ** If afsd is started with the -dynroot flag, /afs will be locally
56    generated from the CellServDB.  AFSDB cells will be mounted
57    automatically upon access.
58
59 ** The namei fileserver allows vice "partitions" to be directories instead
60    of partitions and will attach and display accordingly. Creating the file
61    "AlwaysAttach" in the /vicepX directory is used as the trigger to attach it.
62
63 ** TSM support for butc no longer requires editing a Makefile, simply
64    specify the --enable-tivoli-tsm configure option.
65
66 ** Linux builds no longer require source changes every time the kernel
67    inode structure changes; the OpenAFS sources will now configure
68    itself to the actual inode structure as defined in the kernel
69    sources.
70
71 * Changes incorporated in OpenAFS 1.2.1
72
73 ** vfsck on Digital UNIX and Solaris will now refuse to fsck mounted
74    mounted partitions.
75
76 * Changes incorporated in OpenAFS 1.2.0
77
78 ** AFS now supports --prefix and the other directory options of
79    configure.  By default AFS builds assuming it will be installed in
80    /usr/local.  In order to get traditional AFS directory paths (/usr/afs
81    and /usr/vice/etc) use the --enable-transarc-paths option to
82    configure.  More details on the new directory layout are found in README.
83
84 * Changes incorporated in OpenAFS 1.1.1a
85  
86 ** Windows 95/98/ME/NT/2000 - Consistent versioning
87    Installation, AFS Control Center, Client dialog boxes and properties 
88    pages for executables display a consistent OpenAFS version number. 
89    Installation detects previous installation and prompts the user for upgrade 
90    options.
91
92 ** Windows 95/98/ME/NT/2000 - Installation features
93    During installation the user can select the source of the CellservDB file,
94    AFS home cell, and drive mappings.  During installation a drive path 
95    mapping can include a variable that will be substituted with the current 
96    UserName that is logged in.
97
98 ** Windows 2000/NT - Integrated logon
99    The Integrated Logon feature works now.
100
101 ** Windows 95/98/ME - Logon script features
102    The Windows 95/98/ME client now offers a command-line option for starting up 
103    the AFS client without authenication. It is now possilbe to start the AFS 
104    client first and obtain tokens, and map drives all through Windows scripts.
105    This helps using Windows 95/98/ME client in Kerberos 5 environment.
106
107 ** Windows 2000/NT - LANA numbers
108    AFS client now scans the LANA numbers to establish the correct NETBIOS
109    connection.  NetBEUI is no longer needed.  The user no longer needs to find
110    the correct LANA number.
111
112 ** Windows 2000/NT - OpenAFS naming consistancy
113    Further progress has been made to remove references to "Transarc AFS"
114    and replace with "OpenAFS".
115
116
117   
118 * Changes since OpenAFS 1.0 
119
120 ** AFS now builds with configure. The README for building has been
121    updated and includes full details.
122
123 ** A client system can now have multiple sysname values for @sys.
124    They will be searched in order when looking up files in AFS.  The
125    -newsysname argument to fs sysname can be repeated to set multiple
126    sysnames.
127
128 ** A new system group is created for new cells (system:ptsviewers
129    with id -203).  If this group exists, members of this group can
130    examine and read the entire protection database.  They can examine
131    all users and groups and can get the membership of any group.
132
133 ** A new program, pt_util has been added to the distribution.  This
134    program allows users to print the contents of the protection
135    database or to edit the protection database without running a
136    ptserver.  It can be used to set up a new cell without ever running
137    in noauth mode.  Run pt_util -h for help.
138
139 ** The fs setcrypt and fs getcrypt commands have been added.  These
140    commands allow the system administrator to require that the client
141    encrypt all authenticated traffic between the client workstation
142    and AFS.  The encryption used is weak, but is likely better than
143    sending unencrypted traffic in most environments.  Some functions,
144    such as looking for a volume may not be encrypted, but data
145    transfer certainly is.  By default data is not encrypted.  At this
146    time no significant experimentation with server performance has
147    been conducted.
148
149 ** By default AFS is compiled with AFS_AFSDB_ENV, enabling the -afsdb 
150    option to be given to afsd on startup.  If this option is used, then new
151    cells will be looked up using AFSDB records stored in DNS if they
152    are not found in CellServDB.  This means that users can create
153    cross-cell mountpoints in directories they control to access cells
154    not in root.afs, and that cells in root.afs need not be in the
155    client's CellServDB.
156
157 ** AFS database servers can be marked as read-only clones.  Surround
158    the hostname in square brackets on the bos addhost command and the
159    database server will never be elected sync site.  This is useful
160    for cells distributed over a wide region.
161
162 ** The AFS servers now support the -syslog flag.  This flag causes
163    them to log to syslog rather than to files.  This flag is not
164    supported on NT.  For all servers besides the salvager, the flag can
165    also be specified as -syslog=facility, where facility is an integer
166    facility code from syslog.h.  A -syslogfacility option is provided for
167    the salvager to accomplish the same goal.
168
169 ** If the --enable-fast-restart flag is given when configuring AFS,
170    then the salvager supports the -dontsalvage flag which causes it to 
171    exit without salvaging any volumes.  If this is configured into the 
172    third command of a fs process, then the fileserver will start without 
173    salvaging.  It will fail to attach volumes that need salvaging and they
174    can be salvaged manually.  This provides significantly better server 
175    startup performance at the cost of administrative complexity.
176
177 ** If the --enable-bitmap-later flag is given when configuring AFS,
178    then the fileserver creates bitmaps for free vnodes on demand, allowing 
179    faster starts.
180
181 ** If bosserver finds a BosConfig.new file at startup, it reads this
182    file and renames it to BosConfig.  This allows bosserver to be
183    reconfigured at next restart.
184
185 ** The bosserver can be placed in a restricted mode in
186    which AFS superusers are only granted limited access to the server
187    host. The following functionality is disabled when restricted mode is in
188    use:
189
190     bos exec
191     bos getlog (except for files with no '/'s in their name)*
192     bos create *
193     bos delete
194     bos install
195     bos uninstall
196
197    specific exceptions are made for functionality that "bos salvage"
198    uses:
199
200     a cron bnode who's name is "salvage-tmp", time is now, and command
201     begins with "/usr/afs/bin/salvager" may be created. This bnode 
202     deletes itself when complete, so no special "delete" support is needed. 
203     This functionality may be removed in the future if a "Salvage" RPC is 
204     implimented.
205
206     The file with the exact path /usr/afs/logs/SalvageLog may be fetched,
207     since that is how bos salvage [...] -showlog is implimented.
208
209     Restricted mode is enabled using a new bos command (bos setrestricted)
210     or bossever command line switch (bosserver -restricted). Restricted
211     mode can be disabled by a) sending the bosserver process a SIGFPE (which
212     will then allow restricted operations until the next restart or
213     setrestricted command) or b) editing /usr/afs/local/BosConfig 
214     (or BosConfig.new), and restarting the bosserver.
215
216 ** The bos UserList of trusted administrators can now contain
217    cross-realm Kerberos principals.
218
219 ** udebug now takes --server not --servers.
220
221 ** Several error messages have been improved to include volume
222    numbers.
223
224 ** Several new ports have been included for UNIX platforms: Darwin
225    (ppc_darwin_12 and ppc_darwin_13), Linux 2.4 (i386_linux24), Linux on
226    the Powerpc (ppc_linux22 and ppc_linux24), Linux on the Sparc
227    (sparc_linux22, sparc64_linux22 and sparc64_linux24) .
228
229 ** Incomplete FreeBSD and Alpha Linux ports are included.  The
230    FreeBSD port has a working server and the Alpha Linux port has a
231    partially working client.
232
233 ** A native client for Windows 95/98/ME has been added to the distribution.
234    With this program, a gateway machine is no longer required for Windows 9x
235    to access AFS files.  One drive letter will be created on your machine by
236    default - Z:.  The Z: drive will be the root of the AFS tree, allowing you
237    to browse all sites that have AFS servers available.  Additional drive
238    letters can be defined for other AFS directories.  A Windows Explorer
239    shell extension is included that allows you to right click on items
240    within an AFS tree to bring up an "AFS" menu item and perform various
241    operations on a file or directory.  The most useful item is "Access
242    Control Lists", which allows you to view and edit the permissions of a
243    particular directory.  Command line tools are also available in the
244    install directory.  These commands include klog, unlog, tokens, kpasswd,
245    symlink, fs and pts.  The installable includes a readme file that contains
246    more information on how to use the client program and known issues.
247
248 ** support for large caches in afsd.  Cachefiles are stored in
249    subdirectories.  The default is 2048 files per subdirectory, which
250    should work fine in most situations.  You can use the new afsd
251    option -files_per_subdir to change this number.  Note that the first
252    time you run afsd with this patch, your cachefiles will get moved
253    into subdirectories.  If you subsequently run an older version of
254    afsd, you will lose all your cached files.