home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / networks / landon.zip / READ.ME < prev   
Text File  |  1993-07-10  |  13KB  |  343 lines
  1. READ.ME file for The LANdon Bridge, Unregistered Shareware Version 1.0a
  2. -----------------------------------------------------------------------
  3.  
  4. COPYRIGHT (C) 1993, Limerick Software.  All rights reserved.
  5.  
  6. THIS PRODUCT IS SHAREWARE.
  7.  
  8. FEEL FREE TO DISTRIBUTE COPIES OF The LANdon Bridge, AS LONG AS YOU INCLUDE
  9. ALL THE ACCOMPANYING FILES LISTED UNDER "FILE LIST" BELOW, AND INCLUDE ALL
  10. ACCOMPANYING COPYRIGHT NOTICES.
  11.  
  12.  
  13.  
  14. FILE LIST
  15. =========
  16.  
  17. The files included with this shipment of The LANdon Bridge are:
  18.  
  19.     BRIDGE.EXE            The LANdon Bridge program
  20.     READ.ME                The file you are reading right now
  21.     MANUAL.TXT            A rough copy of the text of the manual
  22.                     which can be read from a text editor
  23.                     or word processor, or can be dumped
  24.                     to a printer
  25.  
  26. Due to a general lack of interest, the PostScript(TM) version of the manual
  27. will not be included in this and future shareware releases.
  28.  
  29.  
  30. WHAT The LANdon Bridge IS
  31. =========================
  32.  
  33. The LANdon Bridge is a software bridge/repeater/router for Artisoft(R)
  34. LANtastic(R) networks.  It allows users to mix and match supported hardware
  35. types on their LANtastic(R) network, and allows all network nodes to log
  36. into all servers and send messges to all nodes, regardless of what kind of
  37. hardware they are using.
  38.  
  39. Users of the LANtsatic(R) 2Mbps adapters or the LANtastic(R)/Z network can
  40. connect to each other or to a 10Mbps network segment, such as Thinnet or
  41. twisted pair, and not be subject to the usual hardware restrictions of
  42. such an arrangement.  See MANUAL.TXT for more details.
  43.  
  44. The LANdon Bridge is a product of Limerick Software, Arcata, CA, and
  45. is NOT a product of Artisoft, Inc.  No endorsement of this product has
  46. been made by Artisoft, Inc.
  47.  
  48.  
  49.  
  50. TIME-RESTRICTED VERSION
  51. =======================
  52.  
  53. This version of The LANdon Bridge is intended as a shareware demonstration
  54. program.  It is a fully functional copy of the registered version of The
  55. LANdon Bridge, with one exception.
  56.  
  57. After approximately 1 hour of operation, it will execute the SHUTDOWN command
  58. internally.  The SHUTDOWN command is documented in the manual.  After the
  59. initial 1 hour of operation, the RESTART command will not succeed.
  60. The FLUSH and REMOVE commands will still work, however, so you can cleanly
  61. remove the demonstration program from memory, even after the 1 hour
  62. demonstration period has expired.
  63.  
  64. Note that there will be no warning before the SHUTDOWN command is executed
  65. internally.  Workstations may have to be rebooted, and data may be lost if
  66. they are actively accessing servers via the bridge when a SHUTDOWN occurs,
  67. depending on the particular application program's response to the loss of
  68. connection with the server.
  69.  
  70.  
  71.  
  72. CHANGES FROM VERSION 1.0
  73. ========================
  74.  
  75. The following features have been added:
  76.  
  77.     *    The RUN_BURST switch has been added.  The valid range
  78.         for this switch is from 2 to 127 ticks.  The default
  79.         is 8.  This value dictates the longest period the bridge
  80.         will process requests before yielding to the system.  It
  81.         only takes effect during periods of heavy network traffic
  82.         across the bridge.
  83.  
  84. The following problems have been addressed:
  85.  
  86.     *    Switch settings causing a DOS out-of-memory condition
  87.         would lock the machine up in version 1.0.  Now, the
  88.         error will be reported properly and the program will
  89.         return to DOS.
  90.  
  91.     *    If VERBOSE was the only command-line switch invoked,
  92.         and an error ocurred while installing version 1.0,
  93.         erroneous VERBOSE information would be output,
  94.         but the error message would not.  Now, the VERBOSE
  95.         output will not occur if there is an error, and the
  96.         error will be reported.
  97.  
  98.     *    Installing version 1.0, REMOVE-ing it, and re-installing
  99.         it a second time would cause the addition of erroneous
  100.         names to the NetBIOS name table of each adapter in
  101.         the bridge machine.  This will not occur in version 1.0a.
  102.  
  103.     *    Version 1.0 would not recognize some Artisoft(R) 2Mbps
  104.         adapters.  Version 1.0a now recognizes these adapters.
  105.  
  106.     *    Quasi-circular network topologies, such as when a bridge
  107.         machine with three adapters is connected to another
  108.         server on the network on two of those adapters (the
  109.         other server has two adapters in it), would cause
  110.         various problems and lockups.  Similar problems would
  111.         arise if there were different machines on different
  112.         bridged network segments using the same machine name.
  113.         Version 1.0a is much better prepared to handle the
  114.         NetBIOS name conflicts which arise under such conditions.
  115.  
  116.     *    The ADD_SERVER_NAME switch returned incorrect error
  117.         messages in some situations.  Version 1.0a should
  118.         report correctly now.
  119.  
  120. In addition, the following internal changes have been made:
  121.  
  122.     *    A local stack has been provided, rather than relying upon
  123.         the foreground task's stack.
  124.  
  125.     *    All NetBIOS POST routines are now queued for execution
  126.         during the timer tick interrupt, rather than at the time
  127.         NetBIOS calls them.  While performance may suffer a bit
  128.         as a result, this makes for a much more stable NetBIOS
  129.         environment.
  130.  
  131.     *    The code for adding and deleting NetBIOS names has been
  132.         restructured considerably.
  133.  
  134.     *    The size of the buffer used when emulating a workstation's
  135.         REDIR has been increased to match that used in LANtastic(R)
  136.         Version 5.0.  The new value works for previous versions
  137.         of LANtastic(R), as well.
  138.  
  139.     *    The default value for the REQUEST_SIZE switch has been
  140.         changed from 14 to 32, to reflect the change in the
  141.         SERVER.EXE default between LANtastic(R) Version 5.0 and
  142.         LANtastic(R) Version 4.x.  The maximum value for this
  143.         switch has also been changed, from 2048 to 32767.  While
  144.         Version 5.0 of Artisoft's SERVER.EXE accepts a REQUEST_SIZE
  145.         as large as 65535, Version 1.0a of BRIDGE.EXE can only go
  146.         as high as 32767.
  147.  
  148.  
  149.  
  150. **NOTE**  This is STILL an EXTREMELY EARLY VERSION of this program  **NOTE**
  151.  
  152.  
  153. KNOWN PROBLEMS
  154. ==============
  155.  
  156. To the best of our ability, all known problems with The LANdon Bridge, version
  157. 1.0, have been addressed.  The following guidelines should be followed to help
  158. insure a stable network environment:
  159.  
  160.     *    When running AILANBIOS.EXE, make sure that each machine
  161.         on a given network segment is using the same values for
  162.         the INITIAL_SEND_SIZE and SIZE switches.
  163.  
  164.     *    When running LANBIOS.EXE, LANBIOS2.EXE, or LANBIOS3.exe,
  165.         make sure that each machine on the 2Mbps network segment
  166.         is using the same value for the BUFFERS switch.
  167.  
  168.     *    Whatever NetBIOS drivers you are using, make sure that
  169.         there are ample NAMES, NCBS, and SESSIONS allocated
  170.         for each adapter in the bridge machine.  A good value to
  171.         use for each is 32.
  172.  
  173.     *    When running REDIR.EXE, make sure that each machine on each
  174.         network segment is using the same value for the SIZE switch,
  175.         and that that same value is used for the BRIDGE.EXE
  176.         BUFFER_SIZE switch.
  177.  
  178.     *    When running SERVER.EXE, make sure that each server on each
  179.         network segment is using the same value for the
  180.         NETWORK_BUFFER_SIZE switch.  If the REDIR.EXE SIZE switch
  181.         value is different from the SERVER.EXE NETWORK_BUFFER_SIZE
  182.         switch value, then you may use the SERVER.EXE
  183.         NETWORK_BUFFER_SIZE switch value for the BRIDGE.EXE
  184.         BUFFER_SIZE value, rather than using the REDIR.EXE SIZE value
  185.         for the BRIDGE.EXE BUFFER_SIZE.  This will result in increased
  186.         bridge performance.  Note that both REDIR.EXE and BRIDGE.EXE
  187.         require the value be in bytes, and that SERVER.EXE requires
  188.         the value be in kilobytes.  Be sure to make the appropriate
  189.         translation.
  190.  
  191.     *    When running SERVER.EXE, also make sure that each server on
  192.         each network segment is using the same value for the
  193.         REQUEST_SIZE switch, and that that same value is used for
  194.         the BRIDGE.EXE REQUEST_SIZE switch.
  195.  
  196.     *    If you experience system lock-ups of the bridge machine, try
  197.         using switch values to increase the size of the bridge's heap.
  198.         A good way to do this is to increase the number of LOGINS on
  199.         the BRIDGE.EXE command line.
  200.  
  201.     *    If you experience problems with the nodes accesing servers via
  202.         the bridge, then try increasing the number of TASKS on the
  203.         BRIDGE.EXE command line.
  204.  
  205.  
  206. TO REPORT BUGS OR OTHER PROBLEMS
  207. ================================
  208.  
  209. You can send bug reports to us at the address given below, or you can contact
  210. the author of The LANdon Bridge, Jim Welsh, via CompuServe(R) at 71302,2423.
  211. Please be as detailed and as patient as possible.  We will respond to all bug
  212. reports as soon as possible.  While we will try to respond individually
  213. to bug reports, if the volume regarding a particular class of problem dictates,
  214. we may respond by form letter or equivalent.
  215.  
  216. When reporting bugs, please provide as much information as possible about
  217. the network activity leading up to the problem.  Please include printouts
  218. of your CONFIG.SYS, AUTOEXEC.BAT and STARTNET.BAT files, or their equivalents
  219. for your system.
  220.  
  221. Also, describe or illustrate your network topology. The more information
  222. we have about your network environment, the easier it is for us to solve
  223. your problem.
  224.  
  225. Please indicate whether the bridge machine is having the problem or if it is
  226. the nodes accessing the bridge, or the servers being accessed, and whether it
  227. is affecting other nodes on the network.  Indicate which versions of the
  228. various network programs are being used, since this infomation is not
  229. necessarily available from STARTNET.BAT alone.  If you use the @switchfile
  230. option with network programs, please include printouts of the switchfile as
  231. well.  STARTNET.BAT printouts from a typical workstation from each network
  232. segment would be helpful, as well.
  233.  
  234.  
  235. WHAT REGISTERED USERS GET
  236. =========================
  237.  
  238. Registered users will receive the most current version of The LANdon Bridge,
  239. along with a nicely typeset soft-cover manual, and one license, allowing
  240. the use of The LANdon Bridge on any single computer at any one time.
  241.  
  242.  
  243.  
  244. SPECIAL OFFER FOR NEW USERS
  245. ===========================
  246.  
  247. The offer to new users who registered before May 31, 1993 to get six
  248. months' free upgrades is now closed.
  249.  
  250. New users who register on or before July 31, 1993 will continue to be able
  251. to get The LANdon Bridge at its introductory price of $50.00.  After that
  252. date, the price will go up to $79.95.
  253.  
  254.  
  255.  
  256. HOW TO REGISTER
  257. ===============
  258.  
  259. You can become a registered user of The LANdon Bridge one of two ways.
  260.  
  261. You can send a check or money order for $50.00, along with your name and
  262. address for delivery, and a request for The LANdon Bridge to:
  263.  
  264.         The LANdon Bridge
  265.         Limerick Software
  266.         P.O. Box 919
  267.         Arcata, CA  95521-0919
  268.  
  269.         Attn: Jim Welsh
  270.  
  271. Californa residents should add 7.25% sales tax.
  272.  
  273. CompuServe(R) members have the option of registering by using the
  274. Shareware Registration Database.  Just GO SWREG, then follow the prompts
  275. to "Register Shareware".  For more information on the Shareware Registration
  276. Database on CompuServe(R), GO SWREG and choose the "Information on How To
  277. Register Shareware" option.  The LANdon Bridge is Registration ID #862.
  278.  
  279. In either case, please allow 4-6 weeks for delivery of your disk & manual.
  280. Users who register via Compuserve are likely to have their orders filled
  281. more quickly.
  282.  
  283.  
  284.  
  285. COMING SOON
  286. ===========
  287.  
  288. With the release of The LANdon Bridge, Version 1.1, we anticipate having added
  289. some or all of the following features:
  290.  
  291.     *    A command line switch such as SHOW or INFO, which
  292.         will list servers in the internal server name table,
  293.         logins to various servers via the bridge, the number
  294.         of available server names, and logins, etc.
  295.  
  296.     *    A command line switch such as RPL=YES/NO, or RPL_SERVER=xxxxx,
  297.         to allow RPL logins across the bridge.  At the current time,
  298.         servers configured as RPL boot image servers cannot
  299.         be accessed by the boot ROM via The LANdon Bridge.
  300.  
  301.     *    A command line switch such as REMOVE_SERVER_NAME, to
  302.         allow the deletion of individual server names from the
  303.         internal server name list, rather than forcing users
  304.         to FLUSH the bridge, as is currently the case.
  305.  
  306.     *    Possible command line switches to restrict logins to
  307.         an explicit list of machine names, machines other
  308.         than those cannot login via the bridge.  This would
  309.         add a layer to the already considerable security built
  310.         into LANtastic(R).
  311.  
  312.     *    Possible support for NET CHAT, The Network Eye, and
  313.         other NetBIOS session-based application software is
  314.         planned for version 2.0.
  315.  
  316. Version 1.1 is planned for release in early August, 1993.
  317.  
  318.  
  319.  
  320. ERRATA
  321. ======
  322.  
  323. The manual omits an acknowledgement to Warren D. Belkin, of ZyBel MicroSystems
  324. Inc., who wrote the original article which formed the basis for Chapter 2.
  325.  
  326. The page numbers given in the Table of Contents in MANUAL.TXT are inaccurate.
  327. The Table of Contents has been left in as a general guide to the manual.
  328.  
  329. The hook preventing Microsoft(TM) Windows(TM), Version 3.1, from starting
  330. in Enhanced mode has been removed.  To the best of our knowledge, Windows(TM)
  331. MAY be run in Enhanced mode on a machine running The LANdon Bridge.
  332.  
  333.  
  334.  
  335. TRADEMARKS
  336. ==========
  337.  
  338. The LANdon Bridge is a trademark of Limerick Software.
  339.  
  340. Artisoft and LANtastic are registered trademarks of Artisoft, Inc.  Other
  341. brand names and product names are trademarks or registered trademarks of
  342. their respective companies.
  343.