
			README
                     NFSware V1.1

NFSware ON INTEL AND ALPHA PLATFORMS

The NFSware Server software has been ported to the Alpha 
platform and is available for installation on Intel 
or Alpha based platforms. The Installation procedures on
both platforms are identical.

Current performance of the NFSware Server on the Alpha 
platform matches that of the server running on a 486/66
class machine. Future optimization of the code will 
increase the performance to the Alpha platform level.


BEFORE INSTALLING AND STARTING NFSWARE 

Before installing NFSware, make sure that you have:

o  Read the "Getting Started Guide" for NFSware. If you 
   obtained NFSware from the Internet, review the GSG.TXT 
   file.

o  Administrator privileges on the machine on which you are 
   installing NFSware. (See your NFSware "Getting Started 
   Guide" and Windows NT documentation for information.)


SYSTEM REQUIREMENTS

Make sure that the Windows NT system on which you want to 
install and run NFSware has Windows NT 3.5 or later software. 
Note that Windows NT 3.5 is the default for Intel and Alpha
based systems. If you are running Windows NT 3.1, contact 
Process Software Corporation.


SERIAL NUMBER

Information sent with the NFSware software includes the 
serial number. Entering the serial number is optional.

If you do not enter a serial number, you have 30 days to 
evaluate NFSware after which you must purchase a license if
you want to continue using NFSware.  


CREATING DATABASES

Make sure you create your User, Group, and Export databases 
before you start NFSware. The Setup program prompts you to
create these databases.


USER AND GROUP MAPPING

NOTE: Process Software Corporation is reserving the "Guest 
User Account" and "Guest Group Account" fields in the 
Server Configuration pulldown window for future use.

If an NFS client user UID and GID have no mapping in the 
NFSware User and Group databases, then NFSware maps the:

o  UID to Windows NT Anonymous Logon user 

o  GID to Windows NT NULL group.

Anonymous Logon user and NULL group are equivalent to the 
nobody account on most Unix platforms.


GROUP DATABASE SYNTAX

When using the NFSware V 1.0 and later software, a Windows 
NT group name can be either a single word or a group of words. 
For example, POWERUSER and POWER USER are both valid group 
names. (Note that these are not the same group).


USING THE UNIX /etc/passwd AND /etc/group FILES

If you have UNIX based clients, using the READ UIDs and 
READ GIDs feature from the User and Group database dialog 
boxes lets you automatically map UIDs and GIDS from the 
/etc/passwd and /etc/group file to the equivalent Windows 
NT Account Name.

Before you use this feature, copy the UNIX /etc/passwd and
/etc/group file from the NIS Master Server to the server
machine.


SHARING THE USER AND GROUP DATABASES

NFSware lets multiple servers share single User and Group 
databases located in a common directory. To implement this
feature: 

o  Select the Shared UID/GID Directory Configure text box 
   from the Server Configuration dialog box.

o  Enter the absolute pathname to the common directory 
   holding the UID database file (UID_DB.DAT) and the GID 
   database file (GID_DB.DAT).

   Use the format \\Server\Shareneme\NFSware. 

   For example: \\MyServer\C$\NFSware\


THE EXPORT DATABASE

To export a directory or file:

o  Make sure that the Administrator has "Full Control" 
   access to the directory that you want to export. 

o  If necessary, use the security menu selections in the 
   File Manager to set access to "Full Control". 

   NOTE: See your Windows NT documentation for information 
         about using the security menu selections in the 
         File Manager.

o  Set the case conversion flag as appropriate for each 
   export database entry in the Export Database Dialog box.


DRAG AND DROP ENABLED

The Export Database dialog box supports drag and drop of a
single file or directory from the file manager. Simply drag
the selected file or directory to anywhere in the Export 
Database dialog box and drop the file or directory.


EXPORT FILENAME CASE SELECTION 
NFSware now lets you set "convert filename case" flags in 
the Export Database as follows: 

o  Convert to Uppercase

o  Convert to Lowercase

o  No Conversions

When you build the export database, the new export flag 
selections let you select the case structure of filenames 
that the NFSware server sends to the client host. 

For example, the client ABLE expects filenames to be all 
lowercase. The filenames in an NT directory you want to 
export are all uppercase. Select the "Convert to Lowercase"
flag when you create this export database entry for client
ABLE to mount.
 
If you select "No conversions", NFSware sends the filenames
to the client just as they appear in the exported directory.

Selecting "Convert to Uppercase" causes NFSware to send the
filenames to the client in all uppercase.

   NOTE: No Conversions is the default. Context sensitive 
         help is not currently available for these new flag
         buttons.


CURRENT "EXPORT AS" RESTRICTION 

You cannot have an "Exported As" identification point to 
two different Export Paths even though they point to 
different hosts. For example, you can not have:

Export As:  /test          and  Export As:   /test
Export Path:\\test\C$\GIF       Export Path: \\test\C$\TEMP
Host Name:  ANY_HOST            Host Name:   note.jazz.com

Note that this restriction may be removed in the future.


MOUNTING EXPORT ENTRIES THAT POINT TO A FLOPPY DRIVE OR 
CD-ROM

Windows NT V3.1 creates a default share with the name 
drive name$ for every drive connected to the system. This 
includes floppy drives, hard drives, and CD-ROM drives. 

Windows NT V3.5 creates a default share for hard drives 
only. Windows NT V3.5 does not create default shares for 
floppy drives or for CD-ROM drives. The following table 
shows the system created shares on a 486 machine running 
Windows NT V3.1 and then Windows NT V3.5. 

486 machine         |System created      |System created
configured          |shares on machine   |shares on machine
with...             |running V3.1        |running V3.5
--------------------|--------------------|-----------------
1 floppy drive (A:) |A$ pointing to A:\  |None created
                    |                    |
2 hard drives  (C:) |C$ pointing to C:\  |C$ pointing to C:\
               (D:) |D$ pointing to D:\  |D$ pointing to D:\
                    |                    |
1 CD-ROM drive (E:) |E$ pointing to E:\  |None created

This means that NFSware on a system running Windows NT V3.5
can easily offer and mount export entries that point to 
hard drives. In addition, System Administrators can easily
add export entries pointing to A or E drives through the 
NFSware user interface. However, users will not be able to
mount the export entries pointing to A:\ or E:\ from a 
remote machine.

To avoid this problem, using the File Manager, the system 
administrator can add a share called A$ pointing to A:\ or
E$ pointing to E:\.

To add a share, do the following:

1. Open the File Manager.

2. Select drive A:\ (make sure that there is a diskette in
   drive A).

3. Select Disk from the main menu bar

4. Select Share As...

5. Enter the share name as A$

6. Click on OK

Follow the same procedure and create a share called E$ 
pointing to E:\ for the CD-ROM drive.

If the system has other floppy or DC-ROM drives, make sure
to create a default share for each additional drive.


STARTING NFSware

The NFSware setup program sets NFSware to start automatically 
when you reboot the system. 

Note: Stopping and restarting NFSware or reloading databases
      also resets all statistics fields to zero.


STARTING NFSware AUTHENTICATION SERVICE

The first time that NFSware receives an authentication 
request from a PCNFS client, it starts the NFSware 
Authentication service. The NFSware Authentication service
continues running until NFSware shuts down.

After NFSware starts again, a subsequent request from a 
PCNFS client restarts the NFSware Authentication service.


RELOADING DATABASES

New, modified, or deleted entries in the User, Group, and 
Export databases do not take effect until you reload the 
server databases. To reload the server databases, do one 
of the following:

1. Click on the Reload button on the NFSware button bar.

2. Select Reload Databases from the Server pulldown menu.

3. Stop and then restart NFSware.

Scroll the list box horizontally to view your entire 
database entry. Scroll vertically to view the entire 
database.


PCNFSD

NFSware supports the PCNFSD Protocol Version 1 and Version
2. NFSware uses PCNFSD to authenticate PC users and to 
provide print services.

If you plan to use PCNFSD for remote printing, make sure to
set up the printer(s) and create a spool directory. NFSware
exports the spool directory specified in the Server 
Configuration dialog box for use by PCNFS clients. 

See your Windows NT documentation for information. See 
also the online help provided with NFSware.


PCNFSD AUTHENTICATION PROCESS IMPROVED

NFSware now fully supports the PCNFSD authentication 
process. Previously under some circumstances, the 
authentication process would stop NFSD.


DISABLING PCNFSD PASSWORD AUTHENTICATION

NFSware lets you disable PCNFS authentication. To do so, 
click on the Disable PCNFSD Password Authentication check 
box from the Server Configuration dialog box.

Deselect this check box to enable PCNFSD authentication.

NFSware defaults to PCNFSD authentication enabled. 


FILE SYSTEM SUPPORT

In this release of NFSware, the NFSware Server follows the
NTFS file name conventions when it deals with the NTFS 
volume. The NFSware server preserves the case of the 
filename. However, it does not distinguish files whose 
names are different in case only.


NFS VERSION 2 AND VERSION 3 PROTOCOL SPECIFICATIONS

NFSware implements NFS Version 2 and NFS Version 3 Protocol
procedures. The following list shows the Version 3 procedures. 
The procedure number follows the procedure name.

NULL (0)      READ (6)      REMOVE (12)     FSSTAT (18)
GETATTR (1)   WRITE (7)     RMDIR (13)      FSINFO (19)
SETATTR (2)   CREATE (8)    RENAME (14)     PATHCONF (20)
LOOKUP (3)    MKDIR (9)     LINK (15)*      COMMIT (21)
ACCESS (4)    SYMLINK (10)  READDIR (16)
READLINK (5)  MKNOD (11)**  READDIRPLUS (17)  

*  NFSware does not support hard links. The client system 
   displays an I/O error message when the client attempts 
   to execute a link, ln (1), command. NFSware does support
   soft links.

** NFSware does not support MKNOD.


SYMBOLIC LINK PERFORMANCE PROBLEM

A problem with correctly creating and reading symbolic links
has been corrected. Previously, after creating a symbolic 
link, you would get an I/O error message when you tried to
do a readlink. 


CREATING SYMBOLIC LINKS

When you create a symbolic link file the new file on the 
server is a hidden file. 


REMOVING NFSware

The NFSware product comes with an UNINSTALL utility. This 
utility removes NFSware from the system. The utility removes
the NFSware keys from the registry database, stops the 
NFSware service, and deletes the files in the directory 
where the product was installed. 

To use the utility:

1. Go to a directory where you did not install NFSware.

2. Copy UNINSTAL.EXE from the directory where you installed
   NFSware.

3. At the MS-DOS prompt type:  uninstal

   For example: C:\FOO> uninstal



USING WORLD WIDE WEB SERVICES

You can get product, upgrade, and technical support 
information about Process Software Corporation  products 
through our new World Wide Web server on the Internet. 

To access our World Wide Web Home Page, you need a browser
such as Mosaic running on your machine. Enter the Uniform 
Resource Locator (URL) http://www.process.com/. Save this 
address following the rules for your browser.

Follow the rules for your browser for subsequent access  
to this server (www.process.com).


MULTIPLE NETWORK DRIVE TYPES SUPPORT

NFSware Server supports multiple network drive types such 
as Lan Manager and Novell. This means corporations can 
export different network drive types to clients through 
NFSware.

When exporting a NetWare drive, make sure that the account
name and password on the NetWare machine matches the account
name and password under which NFSware runs on the NFSware 
Server.


INVALID NODE NAME PROBLEM FIXED IN EXPORT DATABASE

If you enter an invalid host name, receive an invalid or 
nonexistent node name message, and then select "Close", 
NFSware no longer deletes the export database.


ONLINE HELP

The NFSware online help provides multiple access routes to
the various help topics within the help system. Context 
sensitive help has been included with the NFSware button 
bar. The NFSware Database and Server Configuration dialog 
boxes also include context sensitive help. 


ENHANCEMENTS TO THE USER INTERFACE

The following enhancements have been added to the NFSware 
user interface:

o  Full word search through the help file using the Find 
   button on the NFSware help button bar.

o  Drag and drop of a single file or directory from the 
   file manager to the export database.

o  The ability to map UID and GID entries from the UNIX 
   /etc/passwd and /etc/group files to Windows NT account 
   and group names.

o  Automatic display of a list of tips about building 
   databases if the database is empty.

o  Click on and off PCNFS password authentication.
   
o  Easy configuration to allow multiple servers use the 
   User and Group database located in a single directory.  


USING THE ONLINE HELP SYSTEM

The Glossary and Index help options include an alphabetical
button bar. Clicking on a letter in the alphabetical button
bar takes you directly to the list of entries beginning 
with that letter.

The "Content" window and Help Topic title bars include 
matching icons.

You can move around in the online help system by:

o  Using the "Search" feature to locate help topics.

o  Using the "Find" feature to do a word search though the
   help file and to display the topic(s) containing the 
   designated word.

o  Clicking on the icons in the "Contents" window to go to
   a listing of major topics associated with that icon.

o  Clicking on the icons located in the Help Topic title 
   bar to go back to the main topic selection list 
   associated with that icon. 
   
o  Using the "Back" button to return to the last topic you
   viewed.

o  Using the << and >> browse buttons to display the 
   previous or next topic in a series of related topics 
   until you reach the last topic in the series.

o  Using the Index to select a topic from an alphabetical 
   listing of help topics and pop-up windows.

o  Clicking on jumps and pop-up references highlighted in 
   green within the help topics.


NOTE:  When using NFSware's context sensitive help, 
       clicking on a particular screen area immiediately
       after having clicked on another may cause the 
       previous pop-up to repeat.  To view the 
       appropriate help pop-up, click again on the 
       screen area for which you would like to view
       context help.

CONTACTING PROCESS SOFTWARE CORPORATION ABOUT NFSware

To contact Process Software Corporation, please send email
to:
	
		SUPPORT@PROCESS.COM

or call 1-800-722-7770 and ask for NFSware Technical 
Support. If calling from outside the United States, enter 
the U.S code then 508-879-6994.


