
-------------------
Version Information
-------------------------------------------------------------------------------
Product:        DiskShare   Intergraph NFS Server for Windows NT Workstation
                            and Windows NT Server
Number:		SSCB535AC-0201
Version:        02.01.01.31
Date:           21-MAR-1996
Description:	Intergraph DiskShare is a kernel-based network file 
                system (NFS) server that enables UNIX and other NFS
                clients to mount file systems located on Microsoft's
                Windows NT Workstation and Windows NT Server based
                systems.

NOTE:           Windows NT version 3.5 or higher is required.
------------------------------------------------------------------------------- 
End of Version Information                                                      
--------------------------                                                      

-----------------
Installation Help
-----------------

CAUTION:  DO NOT INSTALL A PREVIOUS VERSION OF DISKSHARE 
          AFTER INSTALLING VERSION 02.00 WITHOUT FIRST REMOVING
          VERSION 02.00.  INSTALLING A PREVIOUS VERSION OVER
          THE CURRENT VERSION CAN POSSIBLY RESULT IN INABILITY
          TO BOOT THE MACHINE.  IF THIS SITUATION OCCURS, YOU
          SHOULD TRY TO REBOOT THE SYSTEM USING THE LAST KNOWN
          GOOD CONFIGURATION AND THEN REMOVE DISKSHARE.

The DiskShare product consists of two dynamic link libraries, seven
drivers, five executables, and related documentation files.  By default,
the setup procedure installs the dynamic link libraries into 
%SystemRoot%\SYSTEM32, the drivers into %SystemRoot%\SYSTEM32\DRIVERS, 
and all other product files into the product directory. The system
root directory is the one in which Windows NT is installed, typically
C:\WINNT.

During the installation process, the setup process prompts for
a User Name, Company, and serial number.  The serial number
is on the installation diskette label.  Invalid serial numbers 
will be rejected by the setup process.

After validating user information, setup prompts for an installation 
path for all files except the run-time libraries and drivers.  The 
default is C:\WIN32APP\INGR\DISKSHAR.  If the product already exists 
in the specified directory, setup prompts to verify overwriting of 
this directory.

After installing all files, setup updates all necessary data in the 
registry and adds DiskShare Server as a common program group in the 
Program Manager.  A dialog box displays notifying the installer 
that to perform UNIX-to-NT user mapping, a UNIX style 
password file must be placed in SYSTEM32\DRIVERS\ETC\PASSWD under 
the system root directory.  Finally, because DiskShare cannot be started
until the system reboots, setup provides the option to immediately
reboot the system.

NOTE:  You should be able to re-install DiskShare even if a previous 
       version is running.  If you encounter problems during the
       installation, stop the DiskShare drivers and repeat the
       installation process.

------------------------ 
End of Installation Help 
------------------------ 


---------------                           
Getting Started                           
---------------                           

After installation, the system must be rebooted before DiskShare can
be started.  As delivered, DiskShare starts automatically each
time the system is booted, or it can be configured to be started 
manually.  To configure DiskShare startup, perform the following steps:

1. Enter the Control Panel and select the Devices applet.
2. Select NlmNsm and configure it to start manually, if desired.
3. To start pcnfsd, close the Devices applet and select the Services 
   applet.  Start pcnfsd and configure it to start automatically,
   if desired.

The DiskShare product is designed to run in a multi-threaded environment.
This allows DiskShare to process several NFS requests simultaneously,
which helps increase performance.  DiskShare is delivered with a default
setting of 16 threads.  For a heavily used server, the number of 
threads recommended is 16 per processor.  To change the number of active 
threads, perform the following steps:

1. Enter the DiskShare Server program group and select the NFS Administrator
   applet.
2. Click on the Maximum Threads box.
3. Enter the desired number of threads.
4. Click OK.
NOTE: The change will not take effect until the system is rebooted or
      DiskShare is stopped and restarted.

Other system configuration can also be done through the NFS Administrator
applet in the DiskShare Server program group.

To stop DiskShare, enter the Control Panel, select the Devices applet,
and then stop RpcXdr.

----------------------                    
End of Getting Started                    
----------------------                    
                                          
-------------                             
Documentation                             
-------------                             

    One documentation file is provided:

    NFSS.HLP:           Documentation for DiskShare
			provided as a WinHelp file
                        installed by default to
                        %SystemRoot%\SYSTEM32.

    The product kit also comes with one of the following, 
    depending on the language kit purchased:

	DSA066010 DiskShare Quick Start Guide - English
	DSB066010 DiskShare Quick Start Guide - French
	DSC066010 DiskShare Quick Start Guide - German
	DSG066010 DiskShare Quick Start Guide - Japanese


--------------------                      
End of Documentation                      
--------------------                      
                                          
--------                                  
Training                                  
--------                                  
No training is currently available for this product.
---------------                           
End of Training                           
---------------                           
                                          
----------------                          
Product Sections                          
----------------                          
-----------------------                   
End of Product Sections                   
-----------------------                   
                                          
---------                                 
New Fixes                                 
---------                                 
Version 02.01.01.31

TR 289600576
User-settable registry keys were being overwritten when reloading the product.

TR 289600570
NFS Administrator and password file editor would not come up if user was
a member of a large number of groups.

Version 02.01.01.28

TR 289504173
Changed NFS Share Permissions to reset anonymous UID to -2 if user
responded with 'No' to anonymous UID -1.

Version 02.01.01.26

TR 289504025
Implemented inode version numbers to detect stale file handles for
inodes that have been reused.  This forced a change in the format of
the inode files.  Old inode files will be removed during setup of
the product.  This will force any mounted clients to unmount and
remount shared directories.

Version 02.01.01.24

TR 289503766
NFSD.SYS was causing system crash on multi-processor machines when
directory caching was enabled.

Version 02.01.01.23

TR 289502790
PCNFSD was failing to delete files after printing.

TR 289503676
NFSD.SYS was causing a system crash if the character translation
file was missing or corrupt.

Version 02.01.01.17

TR 289503041
Causing system crash when creating a filename containing a colon, when
no character translation file was being used.  Changed to simply fail
the create.

TR 289502971
Inode defragmentation was taking too long.  Changed inode algorithm
to maintain a free list rather than deframenting.  This forced a change
in the format of the inode files.  Old inode files will be removed
during setup of the product.  This will force any mounted clients to
unmount and remount shared directories.

Version 02.01.01.06

TR 289502518
Renamed files were being created with uppercase names.  Changed to
preserve the filename case of the NFS request.

Version 02.01.01.04

TR 289502470
Rename of Read-Only files would not work.  Changed requested access on
file open to allow the rename to complete.

TR 289502275
Some clients perform an NFS CREATE operation on an existing file, which
could fail on DiskShare if the requestor was not the file owner.  This
problem showed itself in some graphics applications, but was also
reproducible using the 'vi' editor.  The CREATE procedure was changed
to produce correct behavior for existing files.

Version 02.00.00.00

In previous versions, NFS Administrator would sometimes not allow the
listing of users and groups from trusted domains if a one-way trust 
existed between that trusted domain and the primary domain.  A null
session to the domain controller is now being established to allow
the users/groups to be listed.

In NFS Administrator User and Group Mappings dialogs, the Delete key
did not function on screen resolutions of 640 x 480 because the dialog
control was incorrectly named.  

In Show Mounts, using the shortcut key to access the Server Name
field would cause the Apply button to be activated using the 
local host name as the server.  The dialog controls were re-grouped
so that the shortcut keys function as expected.

Version 01.01.00.00

NFS Administrator would not allow change to the network user/group
portion of an NFS mapping entry because the UID/GID was not being 
correctly parsed from the Network Users/Groups list box. The parsing
algorithm was modified to correctly retrieve the ID.

The password file editor, unixusrs.exe, would crash if an attempt was
made to scroll beyond the top or bottom of the Password File Entries
list box. This condition was corrected.

Version 01.00.00.06

Show Mounts and RPC Information would allow more server/host defaults 
than the maximum specified in the source code.  If the program exceeded
the number specified, unintelligible characters would be printed
in the list box. The programs were modified to respect the maximum
defaults.

The password file editor, unixusrs.exe, would crash when trying to save
the password file if the file existed and was read-only.  The program was 
modified to give the user an error, which will allow the file permissions 
to be reset before attempting to save the file.

Show Mounts and RPC Information could not resolve the local host address if
the system used the password file only and the host name was in lower case,
because the system returns the host name in all upper case letters.
Programs were modified to look for both upper and lower case spellings
of host names.

----------------                          
End of New Fixes                          
----------------                          
                                          
------------        
New Features        
------------    
Version 02.01.01.25

This version contains a new DWORD registry value, uStationCompatibility,
under the key
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NlmNsm\Parameters.
The MicroStation PC product uses file locking conventions that are
incompatible with other NFS locking applications.  This registry value
can be used to specify which type of locking semantics DiskShare should
use.  Note that problems may be encountered if a single DiskShare server
is providing data access for both MicroStation PC and NFS locking
applications (notably Microsoft Mail).  To turn off MicroStation-compatible
locking, set this value to zero.  The server must be rebooted for changes
to this value to take effect.
The default value is one (MicroStation-compatible).

Version 02.01.01.11

This version contains new controls and algorithms governing the
setting and retrieving of NTFS file permissions.  Most of the changes
were introduced to facilitate the sharing of data between NFS and
non-NFS clients, and to provide better reporting of group permissions.
See the file dsperms.wri delivered with the product for a complete
description of the enhancements.

Version 02.00.00.00

This version can only be installed on Windows NT version 3.5 and higher.

The name of the Program Group created during DiskShare setup was 
changed from "NFS Server" to "DiskShare Server".  The old program 
group is removed during installation.

Domain user and group support is available with this release.  This
allows the NFS administrator to map domain users and/or groups via the
NFS Administrator Mapping dialogs.  To map users or groups from a
domain, the administrator must be logged on to an account that has
Domain Administrator privileges.  Note that well-known users and groups,
i.e. Guest, should only be mapped from the local machine, not from a
domain.  The mapping and reverse mapping characteristics of domain users
and groups is exactly the same as for local groups and users mapped in
previous versions.

New program items have been added to the NFS Server program group
to allow easier use of the password file editing utility, DiskShare
on-line help, and the readme.txt and answers.wri files.

Version 01.01.00.00

Symbolic linking of files is now supported, and is enabled by default.  
Complete information is available in the symlinks.wri file.  

The password file editing utility, unixusrs.exe, has been modified to
allow easier addition of users to the file.  In addition, a default
password of 'password' is automatically assigned to each new user if
the administrator does not enter a password.

Support for filename character translations is now available.  This
functionality is provided for clients that allow characters in filenames
which are invalid on the server.  Filename character translation allows
the filename to be created on the server under a different name, but
appear to all NFS clients as the filename expected.  Note that use of
this mechanism can have serious side effects.  Read the associated
on-line help topics thoroughly before implementing any character 
translations.

File permission reporting in this version is more intuitive for
UNIX users. See the on-line help for a detailed description.

Full support for disabling anonymous (or unmapped) user access is
provided with this release.  By setting the AnonUID to -1 in the
DiskShare Permissions dialog in File Manager, NFS requests with UID
-2 will no longer be allowed.  Also, any request with a UID that
is not mapped through the NFS Administrator will be rejected.  Per
the NFS specification, any request whose UID is 0 must also have
root permission exported, or the request will be processed as though
its UID were -2.  In particular, if root access is not granted,
and anonymous UIDs are not allowed, the request will be rejected.

Note that you cannot set the anonymous UID to any arbitrary value.
-1 and -2 are the only valid values.  To specify a particular local
user as the anonymous user, enter the UID -2 into the password file
(using unixusrs.exe) and map it to the desired local user in the NFS
Administrator Mapping dialog.

Also note that the unknown UID and GID returned to the client
for unmapped users or groups can be changed by adding the entry
'nouser' or 'nogroup' into the passwd or group file respectively.
The ID given for that entry will be returned to the client.  You
must enter the NFS Administrator User and Group Mapping dialogs
and select OK after the changes have been made to the files.  No
other changes need be made in the mapping dialogs.

Reverse-mapping support has been added for reporting file ownership and
permissions.  This is a change from previous versions which reported the
UID and GID of the current client user as the owner and determined 
permissions for that owner and group.

This feature is supported by changes in the User and Group Mapping dialogs. 
In each dialog, a 'Default' button has been added.  This button is used to
select a UNIX user (UID) or group (GID) to return as the file owner when
more than one UID or GID is mapped to a single NT user or group.  The 
default mapping is denoted in the NFS Mapped Users list box by a (*) to 
the right of the appropriate mapping entry.  To change the default mapping,
highlight the desired default mapped entry, then select the Default button. 

When a previous version of DiskShare is upgraded to 01.00.01.00, default
mappings will be arbitrarily selected from the existing mapped users 
and groups.

In the following example, both UIDs 72 and 73 are mapped to NT user jim,
and UID 72 is the reverse-mapping default:
    
    bob(72):jim         (*)
    john(73):jim

DiskShare will report bob (72) as the owner of files that are owned locally
by user jim.  Note that files created by user john (73) will be reported
as owned by bob (72).  For this reason, it is recommended that each UNIX
user be mapped to a different NT user account.  Files owned by a local
user or group to which no UID or GID is mapped will be reported to be 
owned by UID or GID 65534.

Version 01.00.00.06

DiskShare version 01.00.00.06 can be installed even if a previous
version of the product is currently running.

An About box was added to the system menu of each of the four
NFS Server utilities.  The About box displays the version 
numbers of each of the DiskShare drivers as well as product 
registration information.

Version 01.00.00.05

DiskShare version 01.00.00.05 features support for mapping of UNIX
groups (GID) to local NT groups.  Windows NT allows file access
rights to be given to many users and/or groups independently.  A
tool included in the NFS Administrator utility allows UNIX groups (GIDs)
to be mapped to local NT groups.  For a detailed description of
group mapping and its impact on file permissions, refer to the
DiskShare QuickStart Guide.

This version incorporates caching of directory information.
Caching improves response time of the DiskShare server when
listing the contents of large directories from a client machine.

Choosing a default network interface card (NIC) with a local
TCP/IP address is no longer required during installation.  Multiple 
IP addresses are now supported.

The default maximum number of NFS threads that can execute
concurrently has been increased from 4 to 16 to better utilize
DiskShare's capabilities.  The number of threads can be modified
using the NFS Administrator utility.

The default time for automatic refreshing of the user mapping 
cache has been changed from once every 5 minutes to once every
24 hours.  Automatic cache refreshing can be disabled, or the
default time changed, using the NFS Administrator utility.

The UNIXUSRS.EXE utility has been expanded to allow editing of
a user's UID and GID in the password file as well as changing 
of the user's password.  This utility can also be used to add
users to or delete users from the password file.

All four NFS Server utilities: NFS Administrator, NFS Statistics,
RPC Information, and Show Mounts, have been modified to allow
a more natural and usable Z-ordering of the application dialogs.

Help topics invoked from any of the NFS Administrator dialogs
will remain until the NFS Administrator main dialog is dismissed
or the Help window is dismissed.

------------------- 
End of New Features 
------------------- 
                    
-------------       
Open Problems       
-------------       

Running Windows NT with the RACAL ethernet driver es3210.sys dated 
9/29/93 11:10:20 p.m. could possibly lock up the system under a 
heavy load.

--------------------
End of Open Problems
--------------------
