home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / utils / sossntr3 / install.old < prev    next >
Text File  |  1995-05-18  |  10KB  |  248 lines
  1.             SOSS Installation Guide
  2.             -----------------------
  3.  
  4. Installing SOSS is a simple task which should only take a few minutes.
  5. Before you get started, make sure you have the following items in
  6. place:
  7.  
  8.     - A dedicated 80x86-based PC running DOS 3.3 or above (it
  9.       _may_ work with an 8088 and/or older version of DOS, but
  10.       in that event the performance will be quite lacking).
  11.     - An Ethernet card supported by the Clarkson drivers package,
  12.       such as:
  13.         3Com 501, 503, 505, 523; ARCNET; AT&T StarLAN series;
  14.         BICC Isolan 4110; IBM token ring; NetBIOS; Novell NE1000,
  15.         NE2000; Racal/Interlan NI5010, NI5210, NI6510, NI9210;
  16.         SLIP8250; Tiara LANCARD/E; or Western Digital WD8003.
  17.     - The Clarkson drivers package, as distributed in DRIVERS.ZIP
  18.       via anonymous ftp on sun.soe.clarkson.edu.
  19.     - The SOSS distribution kit itself, along with ZOO to
  20.       extract it.
  21.     - An NFS client system connected to the PC on the same Ethernet.
  22.       SOSS has been tested against NFS running on several flavors
  23.       of Unix:  SCO Unix 3.2.2, AIX (RS/6000) 3.1, SunOs.  The
  24.       client must be capable of using 1024-byte (or smaller) read/
  25.       write operations.
  26.     - If you want the best performance, you should install extended
  27.       memory (2-4 Mb) on the SOSS server PC and get a disk-caching
  28.       program such as PCKWIK.  SOSS itself does not use extended
  29.       memory.
  30.  
  31.  
  32. Configuration Parameters
  33. ------------------------
  34.  
  35. To plan your installation, determine several configuration parameters:
  36.  
  37.     - Whether the PC is using thin- or thick-wire Ethernet;
  38.     - The I/O address, DMA address, and hardware interrupt number
  39.       of the Ethernet LAN card;
  40.     - The 4-byte IP address you will use for the PC;
  41.     - The subnet mask of your TCP/IP network (for a typical
  42.       Class C network, you would use 255.255.255.0);
  43.     - The directory trees you wish to make available for remote
  44.       mounting.
  45.     - Your timezone.
  46.     - The size of read/write operations (usually 1024).
  47.  
  48.  
  49. Procedure
  50. ---------
  51.  
  52. 1.  Configure your Ethernet LAN card if you haven't already been using
  53.     it with the Clarkson drivers.  Make sure its interrupt vector,
  54.     I/O base address, and DMA addresses don't conflict with other cards.
  55.  
  56. 2.  Unpack the SOSS installation kit.  You've probably already done that
  57.     in order to read this INSTALL file.  Here's an example:
  58.  
  59.     C:\>mkdir \soss
  60.     C:\>cd \soss
  61.     C:\SOSS>zoo x// a:soss
  62.  
  63. 3.  Edit your CONFIG.SYS file to contain these two lines:
  64.  
  65.     FILES=15      (or greater)
  66.     DEVICE=NETDEV
  67.  
  68. 4.  Configure the PC/IP driver, using CUSTOM.EXE and NETDEV.SYS found
  69.     in the EXE subdirectory.  Copy NETDEV.SYS to the root directory (or
  70.     wherever you store your drivers) and run CUSTOM on this file:
  71.  
  72.     C:\>custom netdev.sys
  73.  
  74.     Go into the  "Site Customizations" menu and set the Internet
  75.     address, the number of subnet bits, the domain name server(s)
  76.     and time server addresses.  Note that the number of subnet bits
  77.     you select is added to 8 (the minimum Class A network mask)
  78.     to form the network mask, so this means you should specify a
  79.     value of 16 to get a 24-bit Class C mask.
  80.  
  81.     Go into the hardware customization menu and set the interrupt
  82.     vector number, DMA channel and address, and the I/O address.
  83.     You should not need to set the hardware Ethernet addresses.
  84.  
  85.     Reboot the machine to load NETDEV into memory.  (If the machine
  86.     fails to boot, make sure your copy of NETDEV.SYS was downloaded in
  87.     binary mode and is 599 bytes long.  Don't laugh--this problem
  88.     _has_ happened.)
  89.  
  90. 6.  Invoke the packet driver using the appropriate parameters.  An
  91.     example for the Racal/Interlan NI-5210 card, using hardware vector
  92.     number 5, I/O address 300 and DMA address D000 is:
  93.  
  94.     C:\>ni5210 -n 0x7e 5 0x300 0xd000
  95.  
  96.     Note that SOSS uses software interrupt 7E.  If it loads correctly,
  97.     it should display the following after the copyright message:
  98.  
  99.     Packet driver loaded at segment xxxx
  100.     TDR Ok
  101.     Interrupt number 0x5 (5)
  102.     I/O port 0x300 (768)
  103.     Memory address 0xD000 (53248)
  104.     My Ethernet address is xx:xx:xx:xx:xx
  105.  
  106. 7.  Load NetWare, if you are using it in conjunction with SOSS.  A
  107.     program called IPXPDI (from BYU) is provided with SOSS to allow you
  108.     to do this.  Run IPXPDI after the packet driver and before NET3 or
  109.     NET4.  NetWare-386 server versions 3.10 and 3.11 are compatible
  110.     with SOSS off-the-shelf; you will probably have to ECONFIG the
  111.     server to ignore 802.3 packets if you have an older version of
  112.     NetWare.
  113.         NOTE
  114.     SOSS does _not_ at present run as an NLM (NetWare Loadable Module)
  115.     on the same PC as the Novell server software; you have to have a
  116.     separate PC.  SOSS can thus provide NFS clients access to files on
  117.     Novell servers, using a gateway approach, but at significantly
  118.     lower performance than would an NLM.
  119.  
  120. 8.  Set up the EXPORT.US file.  An example is provided in the EXE
  121.     subdirectory; you can start with a file simply containing:
  122.  
  123.     C:\
  124.  
  125. 9.  Set the timezone environment variable to indicate how many hours
  126.     past GMT your site is.  For example:
  127.  
  128.     C:\>set TZ=EST5EDT
  129.  
  130. 10. Making sure you're 'cd'-ed to the directory containing EXPORT.US,
  131.     run SOSS.  You should not need to use any command-line options.
  132.  
  133. 11. On your client system, add the SOSS server PC's IP address to its
  134.     host table, and give it a name (e.g., 'dosbox').  The procedures
  135.     for doing this vary; check the documentation for your name daemon,
  136.     if you're using it.
  137.  
  138. 12. Make sure there is proper connectivity to the SOSS PC.  On a
  139.     typical Unix client system, you can try these commands:
  140.  
  141.     $ showmount -e dosbox
  142.     $ ping dosbox
  143.  
  144.     If these don't work, check your installation.  If you have another
  145.     NFS server on the network, make sure the client system can talk
  146.     to the other server before you begin to doubt the PC installation.
  147.     You should then get PC/IP (from sun.soe.clarkson.edu), if you
  148.     don't already have it, and use its debugging capabilities to find
  149.     out why the interface isn't working.  A brief debugging section is
  150.     presented at the end of this guide.
  151.  
  152. 13. Create an empty directory on your client system to use as a mount
  153.     point (e.g., /usr/soss).  From an appropriately privileged account,
  154.     issue the mount command on your client system.  Again, this varies
  155.     from system to system, so check your documentation.  For a System V
  156.     Unix box, the following should work:
  157.  
  158.     # mount -f NFS,intr,rsize=1024,wsize=1024 dosbox:/c /usr/soss
  159.  
  160.     SOSS will work with read and write requests up to 1024 bytes.
  161.     Many client systems assume up to 8192 bytes, so make sure you
  162.     specify this parameter.
  163.  
  164. 14. Test the installation by listing the top-level directory (/usr/soss)
  165.     to make sure expected files are there and by creating and modifying
  166.     new files.
  167.  
  168. 15. Once you are satisfied with the installation, modify the AUTOEXEC.BAT
  169.     file on your server to start up SOSS.  Here is an example:
  170.  
  171.     ni5210 -n 0x7e 5 0x300 0xd000    
  172.     set tz=EST5EDT
  173.     ipxpdi
  174.     net3
  175.     key-fake "login server/user" 13 "passwd" 13 "castoff all" 
  176.     setclock
  177.     cd \soss\run
  178.     soss
  179.  
  180.     The KEY-FAKE program is provided to allow you to create scripts to
  181.     answer prompts for passwords and the like.
  182.  
  183.  
  184. Troubleshooting
  185. ---------------
  186.  
  187. The most common symptom of a faulty installation is simply that the
  188. client system won't talk to the NFS server at all.  Once you can mount
  189. the filesystems, SOSS will usually run correctly (aside from the
  190. limitations discussed in the manual pages).  If you can't mount them,
  191. check the following things:
  192.  
  193.     - Run 'ping' on your client system, giving it the SOSS server
  194.       address; make sure SOSS responds.
  195.     - Shut down SOSS, and run PC/IP 'ping' on that PC, giving it
  196.       your client system's address.  If that doesn't work, try
  197.       other IP addresses on your network.  If it does, try
  198.       logging into the client system using PC/IP 'tn'.
  199.  
  200. If you can't do either of the above, you probably have a problem with
  201. the LAN card installation or the parameters you gave the Clarkson
  202. driver.  Double-check that you set up NETDEV with the correct parameters,
  203. and check your LAN card's documentation to confirm the hardware
  204. parameters against those you used to run the Clarkson driver.  Then
  205. get a copy of the PC/IP distribution kit from sun.soe.clarkson.edu or
  206. from your SOSS distributor and review its installation procedures.  If
  207. the PC/IP utilities are not working, SOSS won't either.
  208.  
  209. If you have connectivity, do the following:
  210.  
  211.     - Issue the 'showmount -e dosbox' command on your client
  212.       system.  You should get output similar to the following:
  213.  
  214.         export list for dosbox:
  215.         /c            everyone
  216.         /h            everyone
  217.         /c/soss/src        everyone
  218.  
  219.     - Make sure the mount command uses lower-case when naming
  220.       the remote filesystem; Unix commands are case-sensitive.
  221.     - Check the mount command's documentation.  SunOs, for
  222.       example, uses the '-t' option to specify the filesystem
  223.       type, rather than '-f' given in the earlier example.
  224.     - Make sure your client system is issuing read and write
  225.       requests small enough to fit in the 1024-byte limit.  If
  226.       it expects smaller values, you might want to use the '-b'
  227.       command line option to SOSS.
  228.     - Check that SOSS is receiving I/O requests across the
  229.       network by running it with the '-v' command line option.
  230.     - Turn on SOSS' debugging flags with a command like
  231.  
  232.         C:\>set nfsdebug=all
  233.  
  234.       prior to running SOSS.  This will provide you with quite
  235.       a bit of trace information for every I/O request.
  236.     - Using the debugging trace output as a guide, scan the
  237.       source code (provided with the SOSS distribution) to see
  238.       what the server is trying to do with your client requests.
  239.       The file nfs.c contains the top-level dispatcher and
  240.       request-handling routines.  You can recompile SOSS with
  241.       Microsoft C version 5.1; contact the authors for help in
  242.       making source code changes.
  243.  
  244. SOSS is designed for 24-hour unattended use, and should be able to run
  245. for days or weeks at a time.  If you find problems with system crashes,
  246. please contact the maintainer (rbraun@spdcc.com) via e-mail so they can
  247. be corrected.
  248.