home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / www / ArcWEB / Instruct < prev    next >
Encoding:
Text File  |  1995-06-15  |  6.2 KB  |  158 lines
  1.                              ArcWeb Instructions
  2.                              ===================
  3.  
  4. Instructions
  5. ============
  6.  
  7. This file gives some instruction on how to get ArcWeb up and running at
  8. least on a local basis.  Once this has been achieved, there are help files
  9. supplied in HTML format.  Run !ArcWeb and click SELECT over the icon bar
  10. icon to open the index page, and then you can follow links to information
  11. about the helper applications and their configuration.  I suggest you read
  12. the instructions for ArcWebTCP very carefully.  There are instructions
  13. further down for upgrading your current ArcWeb to this version.
  14.  
  15. If you get stuck, try the Problems file.
  16.  
  17.  
  18. Before running for the first time
  19. =================================
  20.  
  21. Copy any auxiliary applications you have into !WebHelper application.  To do
  22. this, double-click on !WebHelper and the subdirectory will be displayed.
  23. ArcWebImg and ArcWebLcl are already installed in this directory.  Before
  24. running ArcWebTCP, you must configure your e-mail address and on-line news
  25. server name (if you have one).    See 'Configuration' below.
  26. ArcWebTCP is ONLY for use with Acorn TCP/IP release 2 (or other network
  27. packages which support the same BSD socket interface as Acorn TCP/IP 2 and
  28. provide that interface in SWI chunk &41200).  FreeNet does.
  29.  
  30. InetDB
  31. ======
  32.  
  33. If you want to use ArcWebTCP you need InetDB - read InetDB.ReadMe1st
  34. for more information
  35.  
  36. Upgrading from an older version (older than 0.22)
  37. =================================================
  38.  
  39. You must delete your current !WebCache as the new version is incompatiable
  40. (the file structure and the index structure has changed)
  41.  
  42.  
  43.  
  44. To run it
  45. =========
  46.  
  47. Launch !ArcWeb by double-click on !ArcWeb in directory viewer, or
  48. double-clicking on HTML files.  Click icon bar icon to bring up 'home' page.
  49. All applications inside !WebHelper will be loaded automatically.
  50.  
  51. Rather than babble on at great length on what each menu entry does, I
  52. recommend loading the Acorn !Help application and then an exploring of the
  53. menus.  !ArcWeb, !ArcwebLcl and !ArcwebImg support full interactive help on
  54. all windows, dialogue boxes and menus.
  55.  
  56. Basically: To follow a link, click SELECT over it; to open a new page choose
  57. Open URL from the Navigate menu over a document (or from the icon bar menu).
  58.  
  59.  
  60. If you get 'Too Long' errors
  61. ============================
  62.  
  63. Move !WebCache and !WebHelper closer to the root directory of the device
  64. on which they are stored.
  65.  
  66.  
  67. Configuration
  68. =============
  69.  
  70. If you are going to be using ArcWebTCP, you MUST reconfigure the e-mail
  71. address and the news server address.  Click SELECT over the ArcWebTCP icon
  72. bar icon to open the configuration window.  You may wish to set up proxy
  73. servers for HTTP, FTP, gopher and WAIS.  ArcWebTCP will handle FTP and HTTP
  74. itself if you want it to. 
  75.  
  76. The 'home page' is controlled by an environment variable ArcWeb$Home.  If
  77. this variable is not set when ArcWeb is run, it will set it to a default
  78. document within an ArcWeb subdirectory.
  79.  
  80. The 'cache directory' is controlled by an environment variable
  81. Arcweb$CacheDir.  If this variable is not set when ArcWeb is run, it will
  82. set it to a default directory within an ArcWeb subdirectory.  The !WebCache
  83. application supplied contains a !Boot file which initialises this variable
  84. to a subdirectory of itself.  This allows !ArcWeb to be stored in a R/O FS.
  85.  
  86. The 'authentication database' holds a cache of servers and their realms which
  87. have required authentication in the current session.  By default, it is
  88. wiped when ArcWebTCP exits (but can be reconfigured in the config window) as
  89. a security precaution.  Its location is controlled by ArcWeb$AuthFile which
  90. is set by !WebCache or !ArcWebTCP when it is run and !WebCache hasn't set
  91. it yet.
  92.  
  93. To flush the cache, use the menu entry in ArcWeb version 0.20.  (Earlier
  94. versions required you to open the !WebCache directory).  You can wipe it
  95. all or just the images.
  96.  
  97. Don't put extra files in the cache directories.  The cache manager will find
  98. these and remove them.  By default it allows 75 files to be cached (no size
  99. limit) so it doesn't want other things clogging up the directory.  The cache
  100. manager will remove anything not in the index, and remove anything from the
  101. index which doesn't exist in the sources directory.  IF the Cache Manager
  102. cannot remove a file (because it is open for example), it will leave it
  103. there.
  104.  
  105. Every 60 seconds, the cache is checked for documents which have passed their
  106. expiry date.  These old documents are removed (unless they are currently
  107. being fetched, or are currently being viewed, or if it is inlined image
  108. which is part of a currently being fetched/viewed document.)  This facility
  109. can be disabled on the ArcWeb options menu.
  110. Choices file.
  111.  
  112. Configuration of ArcWeb
  113. =======================
  114.  
  115. I am currently working on a configuration utility for ArcWeb which will
  116. provide a more sensible approach to change fonts and default option
  117. settings.
  118.  
  119.  
  120. Full Icon Bar Problem
  121. =====================
  122.  
  123. From version 0.13 this is not a problem as ArcWebLcl and ArcWebImg are
  124. supplied configured not to install icon bar icons.  ArcWebTCP is
  125. configured to install an icon so that you can change the proxying
  126. information.   For an explanation of proxying and ArcWebTCP use, load
  127. !ArcWeb and open the default page (click on icon bar icon) and follow
  128. the link to the ArcWebTCP information page.  Each program decides whether to
  129. install an icon by checking its command line.  If it contains -iconbar then
  130. it will install one.  If it contains -noiconbar and doesn't contain -iconbar
  131. then it won't.  If it contains neither then it will.  When ArcWeb autostarts
  132. applications, it uses -noiconbar.  This means that any applications
  133. autostarted by ArcWeb (except ArcWebTCP which needs its icon for email
  134. sending) won't have icon bar icons (unless you edit the !Run file), and if
  135. you run them manually then they will.
  136.  
  137. See the Problems file for more on how to reconfigure these programs.
  138.  
  139.  
  140. Comments and bug reports via e-mail as below, please.
  141.  
  142. Thanks for your help,
  143. Stewart
  144. --
  145.  
  146. Contact Addresses
  147. =================
  148.  
  149. Mountbatten Building, Level 3
  150. Department of Electronics & Computer Science
  151. Southampton University
  152. Highfield
  153. Southampton
  154. SO17 1BJ
  155.  
  156. E-mail:  S.N.Brodie@ecs.southampton.ac.uk
  157. WWW   :  http://louis.ecs.soton.ac.uk/~snb94r/
  158.