home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / source / kboot22.zoo / kboot22.2 / README < prev   
Text File  |  1991-02-22  |  4KB  |  99 lines
  1. Kboot is a program used to monitor, boot and configure Shiva Fastpaths
  2. from a sun running SunOS 4.x.  It was originally written by Dan Tappan
  3. of BBN, and ran under SunOS 3.5.  I've ported it to SunOS 4.x and
  4. added support for KSTAR version 8.0 and up.  Complaints, suggestions
  5. and bug fixes can be sent to me.
  6.  
  7. Bob Schwartzkopf
  8. The RAND Corporation
  9. 1700 Main Street
  10. PO Box 2138
  11. Santa Monica, Ca. 90407-2138
  12. bobs@rand.org
  13.  
  14. The kboot package consists of 2 separate programs, kboot and aarpd.
  15. kboot is the program that monitors, configures and downloads Shiva
  16. Fastpaths; aarpd implements some of the Appletalk ARP protocol.
  17. Aarpd obtains an Appletalk node number dynamically for the
  18. local host; kboot queries aarpd via an RPC call to learn the
  19. node number it should use when communicating with Fastpaths.
  20. Please note that kboot and aarpd must be run on a sun on the same
  21. ethernet as the Fastpaths it will be talking to, as it depends on
  22. broadcasts to learn the Appeltalk addresses of each Fastpath specified
  23. in its configuration file.
  24.  
  25. To build kboot and aarpd:
  26.  
  27.     - Edit Makefile and set ETCDIR and MANDIR
  28.  
  29.     - Edit config.h as necessary
  30.  
  31.     - make
  32.  
  33. To install:
  34.  
  35.     - make install
  36.  
  37.     - make install.man
  38.  
  39. Once kboot and aarpd are installed you must create the following
  40. files in ETCDIR:
  41.  
  42. kbootcf    - kboot configuration file.
  43. KSTAR    - KSTAR software, which comes with Fastpath Manager and is also
  44.       available via anonymous ftp from shiva.com.
  45.  
  46. You will also need a configuration file for each Fastpath.  These
  47. files also are installed in ETCDIR with the name FASTPATH.config
  48. or FASTPATH.state, where FASTPATH is the hostname of the Fastpath.
  49. The .config files are ascii configuration files created by Fastpath
  50. Manager.  The .state files are binary files created by kboot, which
  51. has an option to read the state of a currently running Fastpath
  52. and save it to ETCDIR/FASTPATH.state.
  53.  
  54. The kboot configuration file (ETCDIR/kbootcf) contains a list of
  55. FASTPATH hostnames followed by the name of the KSTAR image to download.
  56. For example, if you have 2 Fastpaths, one running 7.0.1 and the other
  57. running 8.0, you could copy the appropriate KSTAR software to
  58. ETCDIR/KSTAR-7.0.1 and ETCDIR/KSTAR-8.0.  Your kbootcf file would
  59. then look like:
  60.  
  61.     fastpath1    KSTAR-7.0.1
  62.     fastpath2    KSTAR-8.0
  63.  
  64. Kboot learns the ethernet address of each configured Fastpath by
  65. looking at the ethernet header of the packets sent to it by each Fastpath.
  66. It verifies that address with the address in the ethers NIS map (or
  67. file if you're not running NIS), so it is necessary that each
  68. configured Fastpath have its ethernet address entered in the ethers map.
  69. Kboot will complain about unknown Fastpaths if the ethers map
  70. is not correct.
  71.  
  72. NOTE:    The appletalk phase II zonelist (specified in Fastpath
  73.     Manager) is not included in the Fastpath configuration
  74.     structure.  Hence it is not downloaded when a Fastpath
  75.     is configured.  Instead, it is converted into s-records
  76.     and downloaded with the KSTAR software.  Since a zonelist
  77.     is not part of the configuration structure, the configuration
  78.     read by kboot and stored in ETCDIR/FASTPATH.state will not
  79.     contain the zonelist in use by the Fastpath.
  80.  
  81.     The Fastpath Manager software does include the zonelist in
  82.     the ascii configuration file, and kboot knows how to read
  83.     it from there, convert it to s-records, and download it to
  84.     the Fastpath.  Hence, if you're running Appletalk phase II,
  85.     and have a non empty zonelist, you cannot use the binary
  86.     state files generated by kboot.  You must instead use
  87.     Fastpath manager to create an ascii configuration file which
  88.     includes the zonelist and copy it to ETCDIR.
  89.  
  90.     Since I have no documentation on the Fastpath I had to reverse
  91.     engineer the format of the s-records, the address where they're
  92.     stored in the Fastpath, and how they're encoded in the
  93.     configuration file.  My thanks to Phil Budne of Shiva who
  94.     helped me with some of this stuff.  I don't guarantee this
  95.     code is perfect (especially since we're not running phase II
  96.     yet), however the one test I ran did seem to work.  Please
  97.     let me know if you have any problems with zonelists, or any
  98.     other part of kboot for that matter.
  99.