Tropic NFS Server version 1.5 NFS server for Microsoft Windows 3.1 October 25, 1995 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-95 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: * ... where: * : is a fully specified directory including disk drive letter, e.g. c:\windows, e:\export * : 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 SETUP.EXE setup program SETUP.LS_ setup auxiliary file TRONFS.INF setup auxiliary file MSCOMSTF.DLL setup stuff MSCUISTF.DLL setup stuff MSDETSTF.DLL setup stuff MSINSSTF.DLL setup stuff MSUILSTF.DLL setup stuff TRONFS.EX_ the main program EXPORTS._ the nfs configuration file BWCC.DL_ Borland C Custom Control DLL TRONFS.WRI this file in windows write format TRONFS.TXT this file in text format ORDER.FRM order form FILE_ID.DIZ brief information for BBS sysop After decompression the following file will be on the directory you had choosen during setup: TRONFS.EXE the main program EXPORTS the nfs configuration file BWCC.DLL Borland C Custom Control DLL TRONFS.WRI this file in windows write format TRONFS.TXT this file in text format ORDER.FRM order form FILE_ID.DIZ brief information for BBS sysop Troubleshooting If you find any problem, please contact Tropic software in one of the following e-mail address: e.jucah@ieee.org or 100666.2345@compuserve.com 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 (first uploads to SimTel and CICA) 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 * V1.1a - Fixed problem with unix autentication mechanism that didn't allow more than 8 groups. - Fixed problem in directory look up - Added warning message to display when memory usage is too high. * V1.5 - Fixed a few reported bugs; specially recursive copy "cp -R" on some systems. - Added a new feature that allows export of read-only filesystems. 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. Please use one of the following E-Mail addresses: e.jucah@ieee.org or 100666.2345@compuserve.com FILE_ID.DIZ (redundant) (v1.5) TRNFS15.ZIP - Tropic NFS Server program. 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. Uses Winsock 1.1 API; Selective file export; Selective client. Shareware (See ORDER.FRM). © 1993-94-95 Tropic Software. Contacts: e.jucah@ieee.org or 100666.2345@compuserve.com