home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / comms / nbserver / ReadMe
Encoding:
Text File  |  1995-04-03  |  4.4 KB  |  106 lines
  1.   ReadMe
  2.   ------
  3.  
  4.     *** THIS RELEASE IS A DEVELOPEMENT VERSION OF THE SOFTWARE ***
  5.  
  6. This file outlines how to set up Newsbase and TTFN on a network. Included
  7. in this archive are two programs, !NBClient and !NBServer. Documentation
  8. for these programs can be seen by clicking 'help' on the application menu
  9. (which opens the directory <prog>.Docs).
  10.  
  11. Within the applications are two !Runimage files, called FullImage and
  12. DebugImage.  You should use FullImage (rename FullImage to !RunImage for
  13. the program to work) to use the proram, but if you find a problem (such as
  14. crashing out unexpectedly) then please use the DebugImage as a !Runimage
  15. instead - this logs everything (pretty much) that the program does within
  16. the application directory  <prog>.Debug.  If you can replicate the problem
  17. you are having (after first making sure the <prog>.debug directory is
  18. empty) then please email the debug files to me with an outline of what you
  19. were doing at the time.  Better still (to save me on phone bills ;o) if you
  20. can send me an accurate set of steps with which you can induce the bug i
  21. would be much happier.  Note: If you are running the  debugging version
  22. read/write access is needed for each client application (you should have a
  23. local version of !NBClient to run since shared versions would try to write
  24. to the same files).
  25.  
  26. The Docs directory contains:
  27.  
  28.   Acks:      acknowledgements of people who helped me in writing this
  29.   Bugs:      bugs or problems that i currently know about
  30.   Future:    What will be happening to future programs - that i plan
  31.              on putting in for a proper release, and also a wishlist
  32.   Notes:     A few pointers of information i think you should know about
  33.   Version:   An outline of additions to the program between releases
  34.  
  35.   To set up
  36.   ---------
  37.  
  38. Newsbase and NBserver have to be set up on a machine with local harddisc on
  39. an AUN network (such as Econet, Nexus Networking, or ethernet with !AUN
  40. running on it).  This should prefereably also be on the machine you intend
  41. to use !TCPIP upon.
  42.  
  43. The easiest method is to use !TTFN with Newsbase on the server machine to
  44. create each user you want on the system (must be the same as their account
  45. name).  Then, for each user you have created copy the directory
  46.   !Newsdir.UserHome.<username>  into the users network account, so
  47. their account looks like
  48.   <username root directory>.<userhome directory> ie, i would copy
  49. !Newsdir.Userhome.Dunc into my URD to get
  50.   $.Users.Dunc.Dunc.NewsRC/RLN/Signature
  51.  
  52. Then also include a !ArmBOOT file containing something like which will run
  53. both !TTFN and !NBClient when logging on
  54.  
  55. --------------
  56.   Set UserHome$dir <obey$dir>
  57.   Filer_Boot <path to local version of !NBClient>
  58.   Filer_Boot <path to local version of !TTFN>
  59.  
  60.   Filer_Run NBClient:!Run
  61.   Filer_Run <TTFN$Dir>.!Run
  62. --------------
  63.  
  64. You should also change the line in !TTFN.!Boot
  65.   Set TTFN$Dir <Obey$Dir>
  66. to
  67.   If "<TTFN$Dir>" = "" Then Set TTFN$Dir <Obey$Dir>
  68.  
  69. Upon starting up TTFN and NBClient you may get the error 'Default user is
  70. unknown - please reset to something sensible' or something similar.  This
  71. is because !TTFn can only find the  one username in UserHome$Dir - this can
  72. either be ignored or a default user name copied into each users directory.
  73. This problem should be solved when the author of TTFN can modify the
  74. program.
  75.  
  76. If the server is online then the !NBClient icon should change
  77. appropriatly, from which point you should be able to use TTFN with Newsbase
  78. 'normally'.
  79.  
  80. The only part of the system that can be changed by the user while the program
  81. is running is whether or not the server is serving or not (via the menu
  82. button on !NBServer's icon bar).
  83.  
  84. If the client hasnt yet found the server on the network but the server is
  85. up and running then the client can re-broadcast for attention by clicking
  86. with select on the !NBClient icon.
  87.  
  88. If you have any problems in setting up !NBServer or !NBClient then I can be
  89. reached either via Email at:
  90.  
  91.   Dunc@queeg.demon.co.uk  (nighttime)
  92. (or)
  93.   dunc@decc.demon.co.uk   (daytime)
  94.  
  95. or, if absolutely necessary (only, please) at
  96.   01384 634155 (ask for Duncan Ferguson)
  97.  
  98. The sources have not been supplied with this version:
  99.   a) i dont want to embarress myself with people pointing out the
  100.      badly written code ;o)
  101.   b) I am unsure whether i will release the sources in the future
  102.      yet - I may have to when i lose access to AUN networks for testing
  103.      purposes and further development to the software is needed.
  104.  
  105. I hope you find this program of use in this, its early developement
  106. stage.