Microsoft KB Archive/327473

= Services for UNIX 2.2 Performance Fix Release Notes =

Article ID: 327473

Article Last Modified on 2/9/2006

-

APPLIES TO


 * Microsoft Windows Services for Unix 2.2

-



This article was previously published under Q327473



_____________________________________________________________________

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

=
=========================================================

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.
 * New Functionality

The syntax of this command is:

NfsOnly  [/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. match recent changes to standard NFS behavior.
 * Anonymous UID/GID are both now set to -2 by default. This is to

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

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

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

=
========================================================= 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.

Keywords: kbinfo kbqfe kbreadme kbhotfixserver KB327473

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.