Services for UNIX 2.2 Performance Fix Release Notes (327473)

_____________________________________________________________________

 Microsoft(R) Windows (R) Services for UNIX Version 2.2
 Patch Q327473 - The Replacement Patch for Q320175
 
 Performance Fix Q320175 for SFU 2.2 contained a beta expiry check, 
 which leaves the product unusable after August 1st 2002.
 
 Release Notes
 August 2002

_____________________________________________________________________

Please read the following important information before you install
and use the Microsoft Windows Services fo UNIX Version 2.2 Patch 
Q327473.

HOW TO VIEW AND PRINT THIS DOCUMENT
======================================================================

To view these release notes in Windows Notepad, maximize the Notepad 
window. On the Edit or Format menu (depending on which version of 
Notepad you are using), click Word Wrap. 

To print the release notes, open the file in Notepad or another word-
processing program, and then, on the File menu, click Print.

======================================================================
FOR MORE TECHNICAL INFORMATION
======================================================================
For more information about Windows Services for UNIX, please refer 
to the white papers and technical walkthroughs on 
http://www.microsoft.com/windowsserversystem/sfu/default.mspx 

======================================================================
CONTENTS
======================================================================

1. PREREQUISITES FOR INSTALLING THIS PATCH
2. PROBLEM FIXED BY THIS PATCH
3. HOW THIS PATCH FIXES THE PROBLEM
4. STEPS TO INSTALL
5. KNOWN ISSUES
6. SUPPORT
7. NFS SHARES ARE READ-ONLY BY DEFAULT

======================================================================
1. PREREQUISITES FOR INSTALLING THIS PATCH
======================================================================

To install and use this patch, you must be running Windows Services 
for UNIX version 2.2.

======================================================================
2. PROBLEM FIXED BY THIS PATCH
======================================================================

NFS performance as measured by the SPEC SFS97 benchmark is slow.

======================================================================
3. HOW THIS PATCH FIXES THE PROBLEM
======================================================================

* New Functionality
  This fix includes new functionality to provide faster performance.
  A new executable file, nfsonly.exe, allows a share to be modified to
  do more aggressive caching to improve performance.  You can set this
  on a share-by-share basis. You must not use this function on any 
  share that can be accessed by any means other than via NFS, as data 
  corruption can occur. However, as much as a 15% improvement in 
  performance has been observed when using an NFS only share.

  The syntax of this command is:

  NfsOnly <resourcename|sharename> [/enable|disable]

  Resourcename|sharename is the name of the cluster resource or the 
  name of the NFS share

  The /enable option turns on NfsOnly for specified resource or share.

  The /disable option turns off NfsOnly for specified resource or 
  share.

  If a share is created as a cluster resource and a share of the same 
  name is created on the node of a cluster where nfsonly.exe was run, 
  only the cluster resource will be changed to an NFS only share.
 
* Anonymous UID/GID are both now set to -2 by default. This is to 
  match recent changes to standard NFS behavior.

* Server for NFS provides administrators the ability to configure whether 
  Inherited Access Control Entries (ACEs) should apply to newly created 
  files/directories over NFS. 

  This is controlled by the value of the following registry entry: 

  HKLM\Software\Microsoft\Server for NFS\CurrentVersion\
     Mapping\KeepInheritance

  This registry value is 0 by default, which means Inherited ACEs will 
  not be present on newly created files/directories on the NFS share.   
  For example, if administrators want the ability to read/write every 
  file/directory created in the hierarchy, they should set this value to 1
  and set Inheritable read/write ACE at the root of the hierarchy. 

  Note: 
  
  * Setting this value to 1 could have some effects on how the permissions 
    would look like from the UNIX side because of the additional inherited 
    ACEs.

  * This feature is somewhat similar to the functionality provided by the 
    AugmentDACL registry setting in SFU 2.x; however, these two features 
    are not exactly the same. The AugmentDACL key is deprecated in this 
    release.


======================================================================
4. STEPS TO INSTALL
======================================================================

To install this patch on a stand-alone server

    1 Run the file Q327473_SFU_2_X86.exe from its current location, 
      or save the file to disk and then run it.
    2 Restart the computer after the installation completes

To install this Patch on a cluster
    1 Migrate all NFS resources to one node of the cluster.
    2 Run the file Q327473_SFU_2_X86.exe on the node from which the 
      resources were removed.
    3 Restart the cluster node after the installation completes.
    4 Migrate all NFS resources to the node of the cluster that was
      just upgraded.
    5 Run the file Q327473_SFU_2_X86.exe on the node that has not 
      yet been upgraded.
    6 Restart the cluster node after the installation completes.

    While doing an upgrade of a cluster configuration:
    * Do not change permissions of the shares until both nodes of the 
      cluster have been upgraded.
    * Do not create any new shares until both nodes of the cluster 
      have been upgraded.

======================================================================
5. KNOWN ISSUES
======================================================================
* There are issues with regard to creating shares with the Server
  Appliance Kit 2.01 with Add-on Pack. Patch Q321096 addresses this issue.

======================================================================
6. SUPPORT
======================================================================

The patch contains debug symbols. To extract the symbols, copy
Q327473_SFU_2_X86.exe to a folder on the computer. At a command prompt,
change the current directory to the folder containing Q327473_SFU_2_X86.exe 
and type the following command:

  Q327473_SFU_2_X86.exe /x

You will be prompted for a location where you want the symbol files
to be placed. After you provide the path to the folder, the debug 
symbols will be extracted and saved in the folder.

======================================================================
7. NFS SHARES ARE READ-ONLY BY DEFAULT
======================================================================

For security reasons, by default an NFS share will be initially 
created as a read-only share. This is a change from the previous 
releases of SFU. You must explicitly choose the read/write option 
while creating an NFS share either using the nfsshare.exe command-line
utility or using the NFS Sharing tab of the Windows Explorer 
properties page for a folder.