home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / web / arcweb / !WebHelper / AppDir / !ArcWebTCP / Instruct < prev    next >
Encoding:
Text File  |  1995-10-12  |  8.3 KB  |  161 lines
  1. Instructions for configuring ArcWebTCP
  2. ======================================
  3.  
  4. There are currently 4 sections to the configuration window:  Fetchers,
  5. Proxies, Service Gateways, Miscellaneous.   Note that any changes are
  6. not effected until you click on Save or OK.
  7.  
  8. Fetchers
  9. ========
  10.  
  11. This box contains 4 entries, HTTP FTP WAIS Gopher, the WAIS entry greyed 
  12. out. These indicate whether ArcWebTCP will respond to requests from ArcWeb
  13. to fetch URLs starting http: ftp: wais: gopher: respectively.  If you do not
  14. have them selected, then ArcWebTCP will notbe doing anything and you will
  15. most likely get a 'No fetcher for ...' error whenever you try to access
  16. anything non-local.
  17.  
  18. So leave the HTTP box switched on always, and probably leave the FTP one
  19. switched on, unless you find that you are having trouble with ftp: URLs
  20. crashing the machine.  Also leave the gopher one switch on.
  21.  
  22. The reason why the WAIS option is greyed out and unselectable is because
  23. ArcWebTCP doesn't (yet!) know how to do that itself.  It needs a proxy server
  24. to do it for it, which is explained in the next section...
  25.  
  26.  
  27. Proxies
  28. =======
  29.  
  30. This section contains 4 proxy definitions, and 1 'No proxy' definition.
  31. Read the file WotIsProxy which was in the root of the ArcWeb archive.
  32. Follow the instructions at the bottom of that file in order to read
  33. the HTML version of my definition of a proxy.
  34.  
  35. Each line in this section of the window represents a different URL scheme
  36. (HTTP, FTP, Gopher and WAIS).  The large middle box contains the name of the
  37. proxy server, and the small box contains the TCP port number on which the
  38. proxy service is provided.  The proxy is only used if the checkbox for that
  39. scheme is switched on.  You probably want to leave all 4 of these switched
  40. on.  If you are a Demon subscriber, then you want to ensure that all four
  41. host/port pairs are set to www.demon.co.uk and 8080 ; UK academic community
  42. users want wwwcache.hensa.ac.uk in all the host boxes, and 8080 in the HTTP,
  43. FTP and Gopher ports, and 80 in the WAIS port.
  44.  
  45. Whenever a request is received from ArcWeb, ArcWebTCP looks first at the
  46. proxy configuration to see if the proxy for that URL scheme is configured and
  47. enabled (* except see the No Proxy section below).  If it is not, then it
  48. looks at the state of the 'Fetchers' section.  If the scheme is not enabled
  49. in there either, then ArcWebTCP ignores the request and you will get a 'No
  50. fetcher for ...' error.  But if the 'Fetchers' section does mark the scheme
  51. as enabled, then ArcWebTCP will communicate directly with the host who's name
  52. is given in the URL.
  53.  
  54. If the proxy *is* enabled for the scheme, then ArcWebTCP talks to the
  55. configured proxy server for that scheme in preference to making a direct
  56. connection.
  57.  
  58. (*) The 'No proxy' box is used to avoid proxying requests to 'nearby'
  59. machines (in network terms, not necessarily geographical distances). 
  60. Usually, if the scheme is enabled in *both* the 'Proxies' section and the
  61. 'Fetchers' section of the window, then the proxy will 'win' and be used in
  62. preference to the direct connection method.  However, if the host name used
  63. in the URL matches the No Proxy entry, then the proxy will not win, and a
  64. direct connection will be attempted.
  65.  
  66. ArcWebTCP will compare the *end* bit of the hostname with the contents of the
  67. no proxy box in order to match the entries.  So for example, if I set the no
  68. proxy to "ac.uk" and I ask for "http://www.ecs.soton.ac.uk/" then this is
  69. classified as a match, because the hostname ends "ac.uk".  If I ask for
  70. "http://www.demon.co.uk/" then this does not match.  Similarly, if I ask for
  71. "http://lilac.ukansas.edu/" (I don't know if this exists or not - it is only
  72. an example) then this does *NOT* match, despite the ac.uk in the middle.
  73.  
  74.  
  75. Service Gateways
  76. ================
  77.  
  78. This section contains the information which ArcWebTCP requires in order to
  79. service mailto: URLs and some news: or nntp: URLs.   Note that this will NOT
  80. download your mail or news from your provider as it is not a 'transport' for
  81. any other application you might have.  The gateways section will disappear
  82. as soon as suitable support is built into other applications.
  83.  
  84. The 'Mail Server' large box is for the name of a machine which handles
  85. outgoing mail.  (eg. post.demon.co.uk).  The large box immediately below is
  86. for your full e-mail address to go in.  Once you have set both of these up,
  87. you can switch on the Mail Server option icon.   If you submit a FORM which
  88. has been marked as submitted via e-mail, then ArcWebTCP will send the e-mail
  89. with no interaction from the user.  If you follow a 'mailto:' URL link, then
  90. ArcWebTCP will create a small text file and open it in your current text file
  91. editor.   Once you have completed the e-mail, you should 'Save' the document
  92. *directly* from the editor onto ArcWebTCP's icon bar icon, and it will then
  93. be sent.  This is a *kludgy* way of sending mail and much better support will
  94. be provided in the future by proper e-mail programs.  What You See in the
  95. editor is What Is Sent to the mail server, so don't mess around with the
  96. headers except to change the subject line.  In particular, don't move the To:
  97. line because ArcWebTCP relies on finding it there.  There is *no* concept of
  98. adding taglines, signatures or anything.
  99.  
  100. The 'News Server' big box contains the name of a news server which is willing
  101. to talk to you.  The TCP port number 119 is the port for nntp, and probably
  102. will not need to be changed.  If you have the News Server icon switched on,
  103. then ArcWebTCP will attempt to retrieve specific articles from the given
  104. server.  Note that this is, again, a *kludge* so that specific articles can
  105. be read.  It does *NOT* provide any kind of menu of articles, threading etc.
  106.  
  107.  
  108. Miscellaneous
  109. =============
  110.  
  111. There are 4 options in this section regarding the actions that ArcWebTCP
  112. should take at particular points of its execution.
  113.  
  114. If the 'Quit ArcWebTCP when ArcWeb quits' option is on, then ArcWebTCP will
  115. automatically exit whenever it sees ArcWeb dying normally (if ArcWeb crashes
  116. very badly it won't).  If you have ArcWebTCP automatically launched when
  117. you start ArcWeb, then you almost certainly want this option switched on.
  118.  
  119. If the 'Use non-blocking socket I/O' option is *ON* (as recommended), then
  120. ArcWebTCP will attempt to multitask whilst it is making the connection to the
  121. remote server (Document data retrieval is always multitasked anyway).  This
  122. can result in a lot less 'freezing up' on the desktop.  Some people have had
  123. trouble with this option causing 'ArcWebTCP has suffered a fatal internal
  124. error type=5' kind of thing.  If this happens, switch off this option and
  125. see if that cures it.
  126.  
  127. If the 'Retain authentication' option is *OFF* (as recommended), then the
  128. cache of user name/passwords used during the current session will be DELETED
  129. as a security precaution.  If the option in *ON*, then the data is retained
  130. in the cache permanently (until you switch the option off and quit ArcWebTCP,
  131. or manually delete the !WebCache.Data.Auth_DB file).  If you are the only
  132. user of your machine and it is relatively physically secure, then there is
  133. no harm of switching on this option.  For example, you can access the Clan
  134. Acorn pages (if you are a member) and once you have entered the password then
  135. that will be remembered in future sessions.
  136.  
  137. If the 'Ask for confirmation when using unofficial ports' is switched *ON*
  138. (as recommended), then any attempt to use a particular scheme on a different
  139. port from its well-known port will be intercepted and you will be prompted to
  140. confirm the fetch. For example, the gopher protocol runs on TCP port 70.  If
  141. you find a URL such as "gopher://some.host.name:79/hello" then this will be
  142. trapped, since port 79 is not the standard gopher port (it is the 'finger'
  143. port actually) and you will be asked to confirm that the connection should
  144. go ahead.  The result of continuing this fetch (in this example) will be to
  145. actually perform the equivalent of 'finger hello@some.host.name' and won't
  146. have anything to do with gopher at all.  The results of talking to a server
  147. using the wrong protocol are at best undefined.
  148.  
  149. NOTE: since many people who run http servers (under UNIX) do not have 'root'
  150. user access, they cannot run the server on the well-known port for http
  151. (which is 80).  This is the reason you see http servers run on port 8080,
  152. 8001 and others.  For this reason, http URLs are *never* trapped in this
  153. manner by ArcWebTCP.
  154.  
  155.  
  156. --
  157. Stewart Brodie
  158. 12th October 1995
  159.  
  160. ==END==
  161.