home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / web / arcweb / Instruct < prev    next >
Encoding:
Text File  |  1995-10-07  |  11.2 KB  |  301 lines
  1.                              ArcWeb Instructions
  2.                              ===================
  3.  
  4. Contents
  5. ========
  6.     Introduction
  7.     Before running for the first time
  8.     How to install InetDB (the DNS resolver)
  9.     How to install ResolverZM (my DNS resolver)
  10.     Special instructions on upgrading from versions prior to 0.22
  11.     Special instructions on upgrading from versions prior to 0.35
  12.     How to run it
  13.     How to cure the 'Too Long' errors
  14.     How to cure the 'unable to lookup hosts's address' errors
  15.     How to configure ArcWebTCP for mail and news
  16.     How to change the default page
  17.     How to change the location of the disk cache
  18.     How to remove everything from the cache
  19.     How to control the authentication database
  20.     Running with RISC OS 3.60 and later (inlining JPEGs)
  21.  
  22.  
  23. Introduction
  24. ============
  25.  
  26. This file gives some instruction on how to get ArcWeb up and running at
  27. least on a local basis.  Once this has been achieved, there are help files
  28. supplied in HTML format.  Run !ArcWeb and click SELECT over the icon bar
  29. icon to open the index page, and then you can follow links to information
  30. about the helper applications and their configuration.  I suggest you read
  31. the instructions for ArcWebTCP very carefully.  There are instructions
  32. further down for upgrading your current ArcWeb to this version.
  33.  
  34. If you get stuck, try the Problems file.  This is a FAQ style document
  35. containing around 20 common questions and answers.
  36.  
  37. I realise that it may seem that you have to read a lot of instructions
  38. before you can do anything, but I've tried to spell it all out in as
  39. much detail as possible in an attempt to pre-empt the common problems
  40. which people have had in the past.  I get so many e-mails about the
  41. "Too Long" problem, still.
  42.  
  43.  
  44. Before running for the first time
  45. =================================
  46.  
  47. ArcWeb cannot do everything itself.  It needs 'helper' applications.  These
  48. are stored inside the !WebHelper application.  KA9Q users need to read the
  49. section immediately below.  FreeNet/Acorn users can skip to the next
  50. non-indented paragraph.
  51.  
  52.     KA9Q users only
  53.     ---------------
  54.  
  55.     If you are still using KA9Q for web browsing, I suggest that you
  56.     investigate using FreeNet, even if only just for web browsing.
  57.     SlipSwitch and the FreeNet Starter Pack both contain details of
  58.     how to switch between KA9Q and FreeNet without dropping the SLIP
  59.     connection.
  60.   
  61.     If you *still* want to use KA9Q, then you will have to get a copy
  62.     of !WebGopher (on ftp.demon.co.uk) and install that inside !WebHelper
  63.     (procedure described below) and delete !ArcWebTCP
  64.     
  65.  
  66. Copy any auxiliary applications you have into !WebHelper application.  To do
  67. this, double-click on !WebHelper and the subdirectory will be displayed.
  68. !ArcWebTCP is already installed in this directory.  If you are going to be
  69. using ArcWebTCP (everyone except KA9Q users will), you must configure your
  70. e-mail address and on-line news server name (if you have one).  See
  71. 'Configuration' below.
  72.  
  73. You may choose to install things like SoundCon inside !WebHelper so that
  74. they automatically load when ArcWeb does.
  75.  
  76. If you have read all of this file and all of ReadMe1st you can delete
  77. the !DeleteMe application inside !WebHelper, which is included for
  78. deliberate annoyance of users who refuse to read instruction files.
  79. The use of a VDU4-like window and not a Wimp application is also deliberate.
  80.  
  81.  
  82. InetDB
  83. ======
  84.  
  85. InetDB is a relocatable module which provides the name lookup service
  86. to ArcWebTCP.  If you are not using ArcWebTCP then you do not need it
  87. for ArcWeb (although other clients may want it).
  88.  
  89. Name Lookup service means that it is responsible for asking other
  90. machines (nameservers) to convert hostnames which the user sees
  91. (like delenn.ecs.soton.ac.uk) into IP addresses (like 152.78.67.42)
  92. which it needs in order to be able to connect to a given machine.
  93.  
  94. If you want to use ArcWebTCP you need to load either InetDB or ResolverZM
  95. Read InetDB.ReadMe1st for more information on configuring both these
  96. modules, since the configuration file is common, although ResolverZM will
  97. ignore some of the entries.
  98.  
  99.  
  100. ResolverZM
  101. ==========
  102.  
  103. Read the InetDB introduction above first.
  104.  
  105. This is a drop-in replacement for InetDB and is my own port of the
  106. Berkeley Internet Name Daemon (BIND) resolver.  Unlike InetDB, it
  107. does NOT do any cacheing.  For this reason, I recommend that you
  108. use InetDB for dialup connections and ResolverZM for Ethernet
  109. connections, although you may like to experiment with both.
  110.  
  111.  
  112.  
  113. Upgrading from an older version (older than 0.22)
  114. =================================================
  115.  
  116. You must delete your current !WebCache as the new version is incompatiable
  117. (the file structure and the index structure has changed).  Now read the
  118. section immediately below too ...
  119.  
  120.  
  121. Upgrading from an older version (older than 0.35)
  122. =================================================
  123.  
  124. ArcWebLcl and ArcWebImg no longer exist as seperate programs as their
  125. functionality has been incorporated straight into ArcWeb itself.  Hence
  126. you should delete them from inside !WebHelper.  It won't cause you any
  127. problem leaving them there, except to waste 128K of memory.
  128.  
  129. The supplied HTML files in !ArcWeb.PublicHTML are also much reduced and
  130. changed.  You should delete the !ArcWeb.PublicHTML directory and allow
  131. it to be replaced by the contents of this archive.
  132.  
  133.  
  134.  
  135.  
  136. To run it
  137. =========
  138.  
  139. Launch !ArcWeb by double-click on !ArcWeb in directory viewer, or
  140. double-clicking on HTML files.  Click icon bar icon to bring up 'home' page.
  141. All applications inside !WebHelper will be loaded automatically.
  142.  
  143. Rather than babble on at great length on what each menu entry does, I
  144. recommend loading the Acorn !Help application and then an exploring of the
  145. menus.  !ArcWeb supports full interactive help on all windows, dialogue boxes
  146. and menus.
  147.  
  148. Basically: To follow a link, click SELECT over it; to open a new page choose
  149. Open URL from the Navigate menu over a document (or from the icon bar menu).
  150. Alternatively, to go to a specific URL you can enter it in the icon at the
  151. top of an open ArcWeb page.
  152.  
  153.  
  154. If you get 'Too Long' errors
  155. ============================
  156.  
  157. Quit !ArcWeb. Move !WebCache closer to the root directory of the device on
  158. which they are stored, and then 'run' it by double-clicking on its icon.
  159. See Problems Q18 for more details of why you must do this.
  160.  
  161.  
  162. How to cure the 'unable to lookup hosts's address' errors
  163. =========================================================
  164.  
  165. This is due to one of two things:
  166.  
  167. 1) Heavy packet loss (won't happen so much on Ethernet networks, far
  168.    more of a problem on SLIP connections)
  169.    
  170. 2) Cache corruption
  171.  
  172. 3) Misconfiguration
  173.  
  174. You can cure (1) by using a SerialBuffer (see demon.ip.support.archimedes
  175. for more details.  Not being a SLIP user myself, I can't help you any
  176. more than give you a pointer to a suitable newsgroup)
  177.  
  178. You can cure (2) by rerunning the module.  Just double-click on it in
  179. a Filer window
  180.  
  181. You can cure (3) by changing the configuration.  Check the file
  182. InetDB.ReadMe1st very carefully and ensure that you have set up resboot
  183. and resconf correctly.  Then ensure that the routing is setup.  If you
  184. do get these errors, try using simpler clients (eg. telnet) and see if
  185. they can resolve and connect properly.
  186.  
  187.  
  188. Configuration
  189. =============
  190.  
  191. If you are going to be using ArcWebTCP, you MUST reconfigure the e-mail
  192. address and the news server address.  Click SELECT over the ArcWebTCP icon
  193. bar icon to open the configuration window.  You may wish to set up proxy
  194. servers for HTTP, FTP, gopher and WAIS.  ArcWebTCP will handle FTP and HTTP
  195. and gopher itself if you want it to.
  196.  
  197. More help is available by clicking SELECT over the !ArcWebTCP icon bar icon
  198. and then clicking on the Information icon (the same as !Help's icon) at the
  199. top of that window
  200.  
  201. How to change the default page
  202. ==============================
  203.  
  204. The 'home page' is controlled by an environment variable ArcWeb$Home.  If
  205. this variable is not set when ArcWeb is run, it will set it to a default
  206. document within an ArcWeb subdirectory.
  207.  
  208. How to change the cache location
  209. ================================
  210.  
  211. The 'cache directory' is controlled by environment variable Arcweb$CacheDir
  212. If this variable is not set when ArcWeb is run, it will set it to a default
  213. directory within an ArcWeb subdirectory.  The !WebCache application supplied
  214. contains a !Boot file which initialises this variable to a subdirectory of
  215. itself.  This allows !ArcWeb to be stored in a read only filing system.
  216.  
  217. Don't put extra files in the cache directories.  The cache manager will find
  218. these and remove them.  By default it allows 75 files to be cached (no size
  219. limit) so it doesn't want other things clogging up the directory.  The cache
  220. manager will remove anything not in the index, and remove anything from the
  221. index which doesn't exist in the sources directory.  IF the Cache Manager
  222. cannot remove a file (because it is open for example), it will leave it
  223. there.
  224.  
  225. How to remove everything from the cache
  226. =======================================
  227.  
  228. Use the Options menu and click on the 'Flush images' or 'Flush everything'
  229. menu items.  You will be prompted to confirm the action.
  230.  
  231. Every 60 seconds, the cache is checked for documents which have passed their
  232. expiry date.  These old documents are removed (unless they are currently
  233. being fetched, or are currently being viewed, or if it is inlined image
  234. which is part of a currently being fetched/viewed document.)  This facility
  235. can be disabled on the ArcWeb options menu.
  236.  
  237.  
  238. How to control the authentication database
  239. ==========================================
  240.  
  241. The 'authentication database' holds a cache of servers and their realms which
  242. have required authentication in the current session.  By default, it is
  243. wiped when ArcWebTCP exits (but can be reconfigured in the config window) as
  244. a security precaution.  Its location is controlled by ArcWeb$AuthFile which
  245. is set by !WebCache or !ArcWebTCP when it is run and !WebCache hasn't set
  246. it yet.
  247.  
  248.  
  249. Running with RISC OS 3.60 and later (inlining JPEGs)
  250. ====================================================
  251.  
  252. ArcWeb 0.37 and later contain support for inlined JPEGs - a facility
  253. built into the RISC OS ROMs in RISC OS 3.60 and later.  Since I do 
  254. not have a Risc PC700 to test with, this feature is not enabled by
  255. default as I have no way of testing it personally.  To the best of
  256. my knowledge it will work though.
  257.  
  258. To enable the JPEG option, you must edit !ArcWeb.!Run and insert
  259. -jpeg just before the -cache option.  ArcWeb will note that the
  260. option has been used and verify that you have SpriteExtend 0.80
  261. or later before attempting anything clever.
  262.  
  263. It appears that Draw has a problem with the draw files that I
  264. export though.  I'm not sure why this is at the moment and it
  265. is still under investigation.
  266.  
  267.  
  268.  
  269. Configuration of ArcWeb
  270. =======================
  271.  
  272. I am currently working on a configuration utility for ArcWeb which will
  273. provide a more sensible approach to change fonts and default option
  274. settings.
  275.  
  276.  
  277. See the Problems file for more on how to reconfigure these programs.
  278.  
  279.  
  280. Comments and bug reports via e-mail as below, please.
  281.  
  282. Thanks for your help,
  283. Stewart
  284. --
  285.  
  286. Contact Addresses
  287. =================
  288.  
  289. Mountbatten Building, Level 3
  290. Department of Electronics & Computer Science
  291. Southampton University
  292. Highfield
  293. Southampton
  294. SO17 1BJ
  295.  
  296. E-mail:  S.N.Brodie@ecs.southampton.ac.uk
  297. WWW   :  http://www.dsse.ecs.soton.ac.uk/~snb94r/
  298. WWW   :  http://delenn.ecs.soton.ac.uk/
  299. gopher:  gopher://delenn.ecs.soton.ac.uk/
  300. finger:  finger://delenn.ecs.soton.ac.uk/stewart
  301.