
		The TrueGrid NFS Server
		INSTALLATION  &  SETUP

	A Freeware NFS Server for Windows 95/NT

COPYRIGHT (C) BY XYZ SCIENTIFIC APPLICATIONS, INC., 1998
ALL RIGHTS RESERVED.  TrueGrid IS A TRADEMARK OF
XYZ SCIENTIFIC APPLICATIONS, INC.

		XYZ Scientific Applications, Inc.
		1324 Concannon Blvd.
		Livermore, CA  94550

DISCLAIMER OF WARRANTY
----------------------
NO WARRANTIES. THE SOFTWARE PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY
OF ANY KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, XYZ
AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY AGAINST
INFRINGEMENT, WITH REGARD TO THE SOFTWARE PRODUCT. THIS LIMITED
WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY HAVE OTHERS, WHICH
VARY FROM STATE/JURISDICTION TO STATE/JURISDICTION.

CUSTOMER REMEDIES. XYZ'S ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY
SHALL NOT EXCEED THE PRICE PAID FOR THE SOFTWARE PRODUCT.

NO LIABILITY FOR DAMAGES. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE
LAW, IN NO EVENT SHALL XYZ OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES
WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS
PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY
OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE
THIS XYZ PRODUCT, EVEN IF XYZ HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.

-----------------------
Distribution
-----------------------
DOCUMENTS
	README.TXT	Overview & Licensing of NFS Server
	LICENSE.TXT	A copy of the disclaimer
	INSTALL.TXT	Installation guide
	NOTES.TXT	Technical notes
	rfc1094.txt	Full copy of the RFC For NFS Version 2
SERVER EXECUTABLES
	PORTMAP.EXE	TrueGrid Portmapper
	NFS.EXE		TrueGrid NFS Server
	PCNFSD.EXE	TrueGrid PCNFS Daemon
UTILITIES
	SHOWMOUNT.EXE	Utility for displaying exported file systems
			and mounted file systems
	RPCINFO.EXE	RPC information utility.  Displays information
			about registered RPC programs on the local
			machine and on remote machines.
	FINDHOST.EXE	Host utility.  Converts IP addresses to host
			names and vice-versa.
	RSH.EXE		Remote Shell utility.  Works great with UNIX
			systems.
LIBRARY
	SUNRPC.DLL	used by the servers and by showmount, rpcinfo
CONFIGURATION
	rpc		used by RPCINFO
	exports		Sample exports file for the NFS Server
	passwd		required for PCNFSD

-----------------------
BACKGROUND
-----------------------
This is a freeware implementation of an NFS Server.  This basic
server has been used to mount PC file systems on the following
UNIX machines
		SGI	IRIX 4.x 5.x 6.x
		SUN	SUNOS 4.x SOLARIS 2.x
		IBM	AIX 4.x
		DEC	DEC UNIX 2.x+
		HP	HPUX 9.x 10.x
The NFS Server conforms to RFC 1094 as closely as possible
(included here as RFC1094.TXT).

This program is freeware.  It is not supported.  However, you can
send bug reports to nfs@truegrid.com.  If you like the program,
then please add the following to your web page

<A HREF="http://www.truegrid.com/nfs.html">TrueGrid Pro NFS Server</A>

Make sure to mention the "TrueGrid Pro NFS Server", and let use know
about your pointer.  If there are enough pointers, then we will offer
free upgrades and enhancements.  You may *not* directly distribute this 
program in whole or in part.  We retain the copyright to this program.

		XYZ Scientific Applications, Inc.
		1324 Concannon Blvd.
		Livermore, CA  94550
		nfs@truegrid.com

-----------------------
ETC CONFIGURATION FILES
-----------------------
(*) Create an ETC directory

	mkdir %WINDIR%\ETC

(*) Create a default export file in the ETC directory.

	copy EXPORTS %WINDIR%\ETC\EXPORTS

Edit the file and add -access entry to the default
entries so that only selected hosts can access your
disk.

(*) Copy the RPC file to the ETC directory

	copy RPC %WINDIR%\ETC\RPC

-----------------------
HOSTS FILE AND DNS
-----------------------
You must have a HOSTS file on your PC, or else
you must have enabled remote DNS lookup.  Otherwise
WinSock calls to convert names to IP addresses
will not function.

	Windows NT: %WINDIR%\SYSTEM32\DRIVERS\ETC\HOSTS
	Windows 95: %WINDIR%\HOSTS

The hosts file should contain a localhost entry

	127.0.0.1	loopback localhost

and an entry for your machine

	IP_Address	hostname alias1 ...

All machines to which you will be exporting should
be listed in the hosts file.  You can make sure that
the host lookup is functioning properly with the
hostfind utility provided:

	HOSTFIND localhost

SAMPLE OUTPUT
	OFFICIAL NAME:localhost
	      ADDRESS:127.0.0.1


	HOSTFIND 127.0.0.1

SAMPLE OUTPUT
	OFFICIAL NAME:localhost
	        ALIAS:loopback
	      ADDRESS:127.0.0.1

The exact output is not important, but it is important
that HOSTFIND be able to convert all concerned host names
to IP address and vice-versa.  If not, then your system
is not configured correctly (keyword:DNS).

-----------------------
STARTING THE SERVER
-----------------------
Windows NT

	Execute these commands to install and start the
	NFS server.
		PORTMAP add
		NFS add
		NFS start
	These will be started automatically whenever the
	machine is rebooted.  You must have Administrative
	priveleges to install the services this way.  The
	case of "add" and "start" is important.
	
Windows 95

	Execute the portmapper and the nfs server in that
	order.
		PORTMAP
		NFS
	Add these to a start-up group in that order to
	start automatically when the machine is rebooted.

------------------------
TESTING THE INSTALLATION
------------------------
Execute the RPCINFO command to check whether or not
the portmapper is running, and if the NFS server was
able to register itself with the portmapper:

	RPCINFO -p

SAMPLE OUTPUT
   program vers proto   port
    100000    2   tcp    111  portmapper
    100000    2   udp    111  portmapper
    100005    1   udp    790  mountd
    100005    1   tcp    793  mountd
    100003    2   udp   2049  nfs

If the NFS server is not registered, then you will not
see "mountd" or "nfs" entries.   If the portmapper is
not working, then you will not see "portmapper" entries.

Next, check whether or not the NFS server is exporting
something:

	SHOWMOUNT -e

SAMPLE OUTPUT
	/c	hosta,hostb,...
	/d	hosta,hostb,...

NOTE:NFS version 3 is not supported.  Neither is NFS over
     TCP.  Network file locking is not supported.  If you
     would like to contribute a network lock daemon, then
     please let me know.  You are free to use the RPC
     libraries that I have.

-----------------------
MOUNTING THE PC DRIVES
-----------------------
Try the mount command on a UNIX machine.  First, create a
directory on which to mount a PC file system.
	mkdir /home
	mkdir /home/c
Then, as root, issue the mount command
	mount -o wsize=1024,rsize=2048 pc_host:/c /home/c
This will mount the "/c" directory from the PC whose host name is
"pc_host" on the directory /home/c.  Now, when you "cd" into /home/c,
you are viewing the PC files in "C:\".

WARNING: The machine name reported by RPC on the UNIX machine
to the PC host must *exactly* match the hosts that are given
permission to mount the PC directory (these are listed in the
exports file on the PC).  There is no IP address checking,
so be cautious.  You may want to remove "access=" entries from
the exports file temporarily for debugging purposes if the mount
command results in an error message which indicates that permission
is denied to your host.  This requires restarting the server.

	Windows 95 : Use the task manager to kill "NFS"
		     nfs (no arguments)
	Windows NT : nfs stop
		     nfs start

-----------------------
LIMITATIONS
-----------------------
The "TrueGrid Pro NFS Server" will not function correctly if
there are more than 8191 directories on an exported drive or
if any directory contains more than 16383 files.
