home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / internet / arcweb / !ArcWeb / HelpData / NetConf
Encoding:
Text File  |  1996-12-10  |  8.7 KB  |  223 lines
  1. Instructions for configuring Network & EMail options
  2.  
  3. ====================================================
  4.  
  5.  
  6. There are currently 3 sections to the Network configuration window:
  7. Fetchers, Proxies, Miscellaneous.  There are 3 sections in the
  8. EMail & News window: User details, E-Mail Gateways, News server
  9.  
  10.  
  11. Note that any changes are not effected until you click on OK, and
  12. they are NOT saved unless you click on Save Options.
  13.  
  14.  
  15. Fetchers
  16.  
  17. ========
  18.  
  19.  
  20. This box contains 4 entries, HTTP FTP WAIS Gopher, the WAIS entry greyed 
  21. out. These indicate whether ArcWeb will respond to URLs starting http: ftp:
  22. wais: gopher: respectively.  If you do not have them selected, then you will
  23. most likely get a 'No fetcher for ...' error whenever you try to access
  24. anything non-local.
  25.  
  26.  
  27. So leave the HTTP box switched on always, and probably leave the FTP one
  28. switched on, unless you find that you are having trouble with ftp: URLs
  29. crashing the machine.  Also leave the gopher one switch on.
  30.  
  31.  
  32. The reason why the WAIS option is greyed out and unselectable is because
  33. ArcWeb doesn't (yet!) know how to do that itself.  It needs a proxy server
  34. to do it for it, which is explained in the next section...
  35.  
  36.  
  37. Proxies
  38.  
  39. =======
  40.  
  41.  
  42. This section contains 4 proxy definitions, and 1 'No proxy' definition.
  43. Read the file WotIsProxy which was in the root of the ArcWeb archive.
  44. Follow the instructions at the bottom of that file in order to read
  45. the HTML version of my definition of a proxy.
  46.  
  47.  
  48. Each line in this section of the window represents a different URL scheme
  49. (HTTP, FTP, Gopher and WAIS).  The large middle box contains the name of the
  50. proxy server, and the small box contains the TCP port number on which the
  51. proxy service is provided.  The proxy is only used if the checkbox for that
  52. scheme is switched on.  You probably want to leave all 4 of these switched
  53. on.  If you are a Demon subscriber, then you want to ensure that all four
  54. host/port pairs are set to www-cache.demon.co.uk and 8080 ; UK academic
  55. community users want wwwcache.hensa.ac.uk in all the host boxes, and 8080 in
  56. the HTTP, FTP and Gopher ports, and 80 in the WAIS port.
  57.  
  58.  
  59. Whenever a request is issued, ArcWeb looks first at the proxy configuration
  60. to see if the proxy for that URL scheme is configured and enabled (* except
  61. see the No Proxy section below).  If it is not, then it looks at the state of
  62. the 'Fetchers' section.  If the scheme is not enabled in there either, then
  63. ArcWeb ignores the request and you will get a 'No fetcher for ...' error. 
  64. But if the 'Fetchers' section does mark the scheme as enabled, then ArcWeb
  65. will communicate directly with the host who's name is given in the URL.
  66.  
  67.  
  68. If the proxy *is* enabled for the scheme, then ArcWeb talks to the configured
  69. proxy server for that scheme in preference to making a direct connection.
  70.  
  71.  
  72. (*) The 'No proxy' box is used to avoid proxying requests to 'nearby'
  73. machines (in network terms, not necessarily geographical distances). 
  74. Usually, if the scheme is enabled in *both* the 'Proxies' section and the
  75. 'Fetchers' section of the window, then the proxy will 'win' and be used in
  76. preference to the direct connection method.  However, if the host name used
  77. in the URL matches the No Proxy entry, then the proxy will not win, and a
  78. direct connection will be attempted.
  79.  
  80.  
  81. ArcWeb will compare the *end* bit of the hostname with the contents of the
  82. no proxy box in order to match the entries.  So for example, if I set the no
  83. proxy to "ac.uk" and I ask for "http://www.ecs.soton.ac.uk/" then this is
  84. classified as a match, because the hostname ends "ac.uk".  If I ask for
  85. "http://www.demon.co.uk/" then this does not match.  Similarly, if I ask for
  86. "http://lilac.ukansas.edu/" (I don't know if this exists or not - it is only
  87. an example) then this does *NOT* match, despite the ac.uk in the middle.
  88.  
  89.  
  90. You can have a comma seperated list of match domains in the no proxy box,
  91. eg. ac.uk,acorn.co.uk which will cause addresses to be compared with
  92. "ac.uk" and then with "acorn.co.uk".  An address has to not match any of
  93. these entries in order to be proxied.
  94.  
  95.  
  96. Miscellaneous
  97.  
  98. =============
  99.  
  100.  
  101. The top 2 options in this section regard the actions that ArcWeb
  102. should take at particular points of its execution.
  103.  
  104.  
  105. If the 'Retain authentication' option is *OFF* (as recommended), then the
  106. cache of user name/passwords used during the current session will be DELETED
  107. as a security precaution.  If the option in *ON*, then the data is retained
  108. in the cache permanently (until you switch the option off and quit ArcWeb, or
  109. manually delete the !WebCache.Data.Auth_DB file).  If you are the only user
  110. of your machine and it is relatively physically secure, then there is no harm
  111. of switching on this option.  For example, you can access the Clan Acorn
  112. pages (if you are a member) and once you have entered the password then that
  113. will be remembered in future sessions.
  114.  
  115.  
  116. If the 'Ask for confirmation when using unofficial ports' is switched *ON*
  117. (as recommended), then any attempt to use a particular scheme on a different
  118. port from its well-known port will be intercepted and you will be prompted to
  119. confirm the fetch. For example, the gopher protocol runs on TCP port 70.  If
  120. you find a URL such as "gopher://some.host.name:79/0hello" then this will be
  121. trapped, since port 79 is not the standard gopher port (it is the 'finger'
  122. port actually) and you will be asked to confirm that the connection should
  123. go ahead.  The result of continuing this fetch (in this example) will be to
  124. actually perform the equivalent of 'finger hello@some.host.name' and won't
  125. have anything to do with gopher at all.  The results of talking to a server
  126. using the wrong protocol are at best undefined.
  127.  
  128.  
  129. NOTE: since many people who run http servers (under UNIX) do not have 'root'
  130. user access, they cannot run the server on the well-known port for http
  131. (which is 80).  This is the reason you see http servers run on port 8080,
  132. 8001 and others.  For this reason, http URLs are *never* trapped in this
  133. manner by ArcWeb.
  134.  
  135.  
  136. The second two options control some extra information that ArcWeb can
  137. provide to remote servers.
  138.  
  139.  
  140. Send Referer information to HTTP servers refers to a special header which
  141. ArcWeb sends to the server to tell it the URL of the page you found the
  142. link to the page you are fetching.  (It is never sent if the page was
  143. local:, or was typed in directly).
  144.  
  145.  
  146. Send e-mail id to HTTP servers refers to the ability to send your e-mail
  147. id with the request.  There's not really anu harm in having this switched
  148. on, unless you paranoid about security and people knowing what you are
  149. looking at.
  150.  
  151.  
  152. EMail & News Configuration
  153.  
  154. ==========================
  155.  
  156.  
  157. This window contains the information which ArcWeb requires in order to
  158. service mailto: URLs and some news: or nntp: URLs.   Note that this will NOT
  159. download your mail or news from your provider as it is not a 'transport' for
  160. any other application you might have.  The gateways section will disappear as
  161. soon as suitable support is built into other applications.
  162.  
  163.  
  164. User Details
  165.  
  166. ============
  167.  
  168.  
  169. You should enter you full name in the Name box, and your complete e-mail
  170. address in the Address box.  This will enable services which are provided
  171. by submitting forms via e-mail to respond to you!  They are also used if
  172. you send e-mail with ArcWeb.
  173.  
  174.  
  175. E-Mail gateways
  176.  
  177. ===============
  178.  
  179.  
  180. You should enable the second option "Smarthost mail gateway", and enter
  181. the hostname of your smart host mail gateway.  This is the machine which
  182. will accept any mail FROM you to anyone else.  eg. Demon users can use
  183. post.demon.co.uk as a smarthost.
  184.  
  185.  
  186.  
  187. MX mail delivery isn't implemented currently, hence it is greyed out.
  188. This will usually be more efficient (the message will get to its
  189. destination quicker), but may take longer to send if the MX host is
  190. a long way away.
  191.  
  192.  
  193. If you follow a 'mailto:' URL link, then ArcWeb will create a small text file
  194. and open it in your current text file editor.   Once you have completed the
  195. e-mail, you should 'Save' the document *directly* from the editor onto
  196. ArcWeb's icon bar icon, and it will then be sent.  This is a *kludgy* way of
  197. sending mail and much better support will be provided in the future by proper
  198. e-mail programs.  What You See in the editor is What Is Sent to the mail
  199. server, so don't mess around with the headers except to change the subject
  200. line.  In particular, don't move the To: line because ArcWeb relies on
  201. finding it there.  There is *no* concept of adding taglines, signatures or
  202. anything.
  203.  
  204.  
  205. News Server
  206.  
  207. ===========
  208.  
  209.  
  210. The 'News Server' big box contains the name of a news server which is willing
  211. to talk to you. If you have the News Server icon switched on, then ArcWeb
  212. will attempt to retrieve specific articles from the given server.  Note that
  213. this is, again, a *kludge* so that specific articles can be read.  It does
  214. *NOT* provide any kind of menu of articles, threading etc. (yet!)
  215.  
  216.  
  217. --
  218.  
  219. Stewart Brodie
  220.  
  221. 10th December 1996
  222.  
  223.