                              
                              
                              
                              
                              
                              
                              
                              
                              
                      Tropic NFS Server
                         version 1.0
                              
                              
                              
                         NFS server
                  for Microsoft Windows 3.1
                              
                              
                              
                              
                              
                              
                      November 20, 1994
                              













DISCLAIMER:
THESE PROGRAMS ARE SHAREWARE AND ARE NOT TO BE RESOLD OR
DISTRIBUTED FOR SALE WITH OTHER PROGRAMS WHICH ARE FOR SALE.
THE    SOFTWARE   IS   PROVIDED  AS-IS.   THE   AUTHORS  AND
TROPIC SOFTWARE  DISCLAIMS  ALL WARRANTIES,  EITHER  EXPRESS
OR  IMPLIED,  INCLUDING   BUT   NOT
LIMITED   TO   IMPLIED   WARRANTIES OF  MERCHANTABILITY   OR
FITNESS  FOR    A   PARTICULAR  PURPOSE.  NO  LIABILITY   IS
ASSUMED  FOR DAMAGES,  DIRECT  OR  CONSEQUENTIAL, WHICH  MAY
RESULT  FROM  THE USE OF THIS SOFTWARE.




 Copyright 1993-94 by Tropic Software.











All  trademarks  appearing  in this  document  are  the
property of their respective owners.




Introduction

The Network File System (NFS) is a protocol developed by Sun
Microsystem that allows different computers to access each
other's filesystem as if they were local. Initialy designed
to work with UNIX systems, it is now available in many other
other systems including small personal computers like IBM
PCs. NFS is logically composed of two pieces: a server
program that runs on the machine that is exporting (i.e.
making available) its local filesystem and a client program
that runs on the machine that mounts (i.e. uses) the other
machines's exported filesystem. Tropic NFS server is a NFS
server program that runs on Windows 3.1 environment and
exports the local PC filesystem allowing NFS clients running
in other machines to have access to the local PC filesystem.

Features
  The Tropic NFS server offers you the following
  characteristics:

   Uses Winsock 1.1 API: the program is based on this
    standard windows socket API. This means that you can use
    with any Winsock 1.1 compliant TCP/IP stack.
   Selective file export : You may export either a whole
    disk or any selected sub-directory
   Selective client : you may allow any machine to have
    access to the local filesystem or you may specify which
    machines have access to which part of your local disks.


Using Tropic NFS server

To use Tropic NFS server you need to install it and
configure it as described in the section that follows.
After the installation and configuration is done, you may
run the Tropic NFS server in the usual Windows way by
clicking in the NFS server program icon. After running the
Tropic NFS server program, you may
mount the exported directories in the client machines. You
need to have the Client program running in the client
machine. The tropic NFS server , as the name suggests,
provides only the server program of the NFS. If you are
mounting from a unix or unix like machine, the client
program is part of the operating system. If your client
machine is a DOS/WINDOWS machine, you need a DOS/WINDOWS
client program.

Installation and Configuration of Tropic NFS server

Before Installing Tropic NFS server , make sure you have the
minimum hardware and software requirements as described
below.
 Hardware Requirements
   386 or later IBM PC or compatible computer with 1M of
    free hard disk space

 Software Requirements
   DOS 5.1 or later version
   Windows 3.1
 Any Winsock 1.1 compliant TCP/IP stack

To install the Topic NFS server, you must copy all files
listed in the Package Contents section to either a temporary
directory or a floppy disk . Then, from windows Program
Manager menu choose RUN and specify the file
"xxx"\setup.exe where "xxx" is the directory (or disk
letter) where you copied the files.
The setup program has further instruction os how to continue
with the instalation.
     
To configure Tropic NFS server you must do the following:

 Edit the file named exports that resides in the
  directory where the Tropic NFS server was installed (notice
  that this directory is not the same as the temporary
  directory you used to initially copy the files. This is the
  directory you specified when installing the Tropic NFS
  server)

 Use each line to specify the exported directories. The
  sintax is the following:
   <filespec>  <client> <client>  ... <client>
    where:
         <filespec> : is a fully specified directory including
          disk drive letter, e.g.  c:\windows, e:\export
         <client> : is a client ip address in dotted notation
          like 123.5.6.7 or a host name in internet domain format like
          amazon.forest.com. This is optional. Specifiyng a list of
          clients limits the access to the directories only to the
          clients whose ip address matches one of the list. If you do
          not provide any client address, access is granted to any
          machine.
 If the line contains the symbol `#', anything that
  follows is considered a comment

Sample configuration session

Lets consider you want to export (i.e. make available for
remote use) the following directories. Also you want some of
the directories to have access limited to certain machines:

 the whole disk C with access limited to machine
  123.45.67.3
 directory C:\pub with free access
 directory C:\other with access limited to machine
  123.45.67.8
 directory E:\pub with free access

The corresponding exports file would contain the following:

#this is a full line  comment
C:\  123.45.67.3      #notice that  only machine 123.45.67.3 has  access to disk C
C:\pub                #any machine may access c:\pub (no specific client specified)
C:\other 123.45.67.8  #this would be accessed only by machine 123.456.67.8 and 123.45.67.3
E:\pub                #free access to directory pub in disk E

Notice:  at the client side, you must specify a read size and write size of  1024 or less. If you forget
to set this two values, the server will refuse to work. The following command will work for a unix
(risc/6000) client:
  mount  -o rsize=1024  -o wsize=1024  amazon.forest.com:/c  /tmp/mydirectory

for a pc client running Tsoft's NFS driver:
  mount  -r 1024 -w 1024 amazon.forest.com:/c  auth=none f:


Package Contents

If you downloaded this program in compressed format, the
following list refers to the files after they are
uncompressed. The   following   files  are  included  in
the  distribution package:

TRONFS.EXE     the main program.
EXPORTS        the nfs configuration file.
README.WRI     this file in windows write format.
README.TXT     this file in text format
BWCC.DLL       Borlandc Custom Control DLL.
ORDER.FRM      order form.


Troubleshooting

If you find any problem,  please contact Tropic software in
the following e-mail address:

  e.jucah@ieee.org

This does not imply that support is being offered for you.
The mainly purpose of  this is for reporting bugs. Anybody
whose bug report  is found to be pertinent will be notified
of the correction. New releases will always be made
available either trough network repositories or distribution
diskettes.
Please feel free to Tell  us  everything you like or dislike
about this program in  order to let us make it better.

Change Log

 V1.0 - shareware version made publicly available


Licensing and Registration

This software is not free. It is shareware. You are granted
the right to test this software for a period of  30  days.
After   this   you  have  to  register  the  product   (see
registration conditions later in this document) and, if this
applies to you, pay the required registration fee. You  may
redistribute this program to other persons as long as  you
keep the package complete with all the files  that are
listed  in the "Package Contents" section in this  document.

Registration Fee

Please see the order.frm file for pricing information.
Contact Tropic Software for registration.
