home *** CD-ROM | disk | FTP | other *** search
/ Dream 42 / Amiga_Dream_42.iso / RiscPC / Internet / Web / a185.arc / ReadMeDocs / Problems < prev    next >
Encoding:
Text File  |  1997-05-16  |  18.4 KB  |  415 lines

  1. Problems
  2. ========
  3.  
  4. This file is part of ArcWeb, and acts as a troubleshooting guide for those
  5. who have had difficulty installing, configuring and operating ArcWeb.  It
  6. assumes that you have read 'Instruct' and 'ReadMe1st', and if the question
  7. is about proxies, then 'WotIsProxy' as well.
  8.  
  9. Recent changes: questions and/or answers for Q24, Q25
  10.  
  11.  
  12. Question Summary
  13. ================
  14.  
  15. Q1.  I try to run !ArcWeb I get a message saying:
  16. "Find ChangeFSI before loading".
  17.  
  18. Q2.  When I try to load !ArcWeb, it says that it requires at least
  19. version Y.YY of module XXX.   What is it and where do I get it?
  20.  
  21. Q3.  When I use the Open URL dialogue box and specify something like
  22. http://www.demon.net/ in the box, I get an error saying that there is
  23. no application loaded which can fetch that URL. What's this mean?
  24.  
  25. Q4.  When I try to use the Open URL dialogue box to open a local file using
  26. local: URLs, I get an error saying that no fetcher is available for that
  27. URL.
  28.  
  29. Q5.  When I try to use the Open URL dialogue box to open a local file using
  30. riscos: URLs, I get an error saying that no fetcher is available for that
  31. URL.
  32.  
  33. Q6.  Sometimes when I load a page, the inlined images are not displayed
  34.  
  35. Q7.  I have heard that UniSys have been threatening to enforce a patent on
  36. the LZ compression used in the GIF file format, as used by many WWW sites.
  37. Does this affect ArcWeb?
  38.  
  39. Q8. When I try to load !ArcWeb, it says 'nager: Sprites22'.  What on
  40. earth does this mean?
  41.  
  42. Q9.  [obsolete & removed]
  43.  
  44. Q10.  How do I change fonts, colours and default options if I don't like
  45. them?
  46.  
  47. Q11.  How do I set up !ArcWeb for use on a shared network
  48.  
  49. Q12.  I try to run ArcWeb and nothing happens/machine locks up/odd errors
  50. appear (eg. Permission denied).
  51.  
  52. Q13.  What does icon 'x' do?
  53.  
  54. Q14.  When I follow a link to some URLs, I get a dialogue box saying that
  55. authentication is required.  What does this mean?
  56.  
  57. Q15.  When I follow a link to some URLs, I get a dialogue box saying that a
  58. non-default port is being used.  What does this mean?
  59.  
  60. Q16.  When I try to run !ArcWeb, I get a stack backtrace/Directory Full
  61. errors
  62.  
  63. Q17.  Why do I get a save dialogue box when trying to read some pages, even
  64. when the object is HTML?
  65.  
  66. Q18.  Sometimes I get 'Too Long' (or similar) error messages whilst the page
  67. is being drawn and then none of the graphics are on the page.  Why?
  68.  
  69. Q19.  What do I do to cure 'unable to lookup host's address' errors?
  70.  
  71. Q20.  ArcWeb keeps dying with fatal internal error type=5 messages.
  72. What can I do to stop this?
  73.  
  74. Q21.  When I try to run ArcWeb, I get a message that my Filter Manager is
  75. too old and that I need version 0.09 or later.  Why?
  76.  
  77. Q21a. Why doesn't ArcWeb attempt to load the more recent Filter Manager that
  78. I've got in my !System.
  79.  
  80. Q22.  Why does ArcWeb take up so much memory?
  81.  
  82. Q23.  Email and ftp work fine on my machine, but ArcWeb has trouble
  83.       downloading anything at a reasonable speed: why?
  84.  
  85. Q24.  How do I enable the font blending options?
  86.  
  87. Q25.  When I try to run ArcWeb it tells me that "The cache has been locked by
  88. a browser running on another machine".  Should I click Cancel or should I
  89. override the lock?
  90.  
  91.  
  92. Questions & Answers
  93. ===================
  94.  
  95. Q1.  I try to run !ArcWeb or !ArcWebImg and I get a message saying:
  96. "Find ChangeFSI before loading".
  97.  
  98. A1.  ArcWebImg uses ChangeFSI as its image manipulator.  It invokes it on the
  99. command line to transform GIFs, JPEGs and other formats into RISC OS sprite
  100. files.  If the Filer has not seen ChangeFSI, then ArcWebImg does not know
  101. where it will be able to find this tool.  Open a directory viewer containing
  102. !ChangeFSI and then try to run ArcWebImg again.  If ArcWebImg was auto run
  103. by ArcWeb, then you will have to quit ArcWeb and load it again, or open the
  104. !WebHelper application (double-click it - no SHIFT required) and run !ArcwebImg
  105. directly.
  106.  
  107.  
  108. Q2.  When I try to load !ArcWeb, it says that it requires at least
  109. version Y.YY of module XXX.   What is it and where do I get it?
  110.  
  111. A2. All the necessary modules are provided in the !System supplied with this
  112. version of ArcWeb (ie. in the separate toolbox.arc archive). You should merge
  113. the !System directory with your master copy.  RISC OS 3.1 users should run
  114. !SysMerge to do this. For RISC OS 3.5 and later, double-click on your !Boot
  115. directory and click on the System icon and drop the new !System directory
  116. into the new window, although some people have reported that this doesn't
  117. work properly, but that using !SysMerge does.
  118.  
  119.  
  120.  
  121. Q3.  When I use the Open URL dialogue box and specify something like
  122. http://www.demon.co.uk/ in the box, I get an error saying that there is
  123. no application loaded which can fetch that URL. What's this mean?
  124.  
  125. A3.  ArcWeb has rejected the URL as one it cannot handle itself, and it
  126. has failed to find another application willing to deal with it.  If you
  127. need a specialise application loaded and it isn't already loaded, you
  128. should load it and retry the URL.  Otherwise, look in the Network options
  129. (from the icon bar Configure submenu) and check that the appropriate
  130. protocol box at the top of the window is checked.  You cannot check WAIS
  131. because this is not supported by ArcWeb.
  132.  
  133.  
  134. Q4.  When I try to use the Open URL dialogue box to open a local file using
  135. local: URLs, I get an error saying that no fetcher is available for that
  136. URL.
  137.  
  138. A4.  This shouldn't happen since local: URLs are handled by Arcweb
  139. internally. However, this may indicate  some failure occurred finding the
  140. file.  This may be because:
  141.  
  142.   i) the filing system you used does not exist
  143.  ii) the URL specified a non-existent file
  144. iii) you did not specify the URL correctly.  Remember that all / and .
  145.      characters after the :: in the filing system name, are transposed.
  146.  
  147. Remember that these URLs will look odd.  Examples of valid URLs:
  148. local://ADFS::HardDisc4/$/WWW/index.html  (ADFS::HardDisc4.$.WWW.index/html)
  149. local://SCSI::ScsiDisc7/$/Internet/me.gif (SCSI::ScsiDisc7.$.Internet.me/gif)
  150. local://resources:/$/Apps/!Help           (resources:$.Apps.!Help)
  151.  
  152. Note in particular the strange format for local URLs on filing systems which
  153. do not use device names (eg. resources:)
  154.  
  155.  
  156. Q5.  When I try to use the Open URL dialogue box to open a local file using
  157. riscos: URLs, I get an error saying that no fetcher is available for that
  158. URL.
  159.  
  160. A5.  riscos: URLs were handled by earlier versions of ArcWebLcl.  This URL
  161. naming scheme is now obsolete, superceded by local: URLs, which you must now
  162. use.  NOTE: Running on old version of ArcwebLcl alongside the new ArcWebLcl
  163. will not work, as support for the riscos: name system in ArcWeb itself has
  164. been removed.  This is because separate routines were needed for resolving
  165. relative references involving riscos: URLs, and these no longer exist.
  166.  
  167.  
  168. Q6.  Sometimes when I load a page, the inlined images are not displayed
  169.  
  170. A6.  Look at the page's menu under the Options submenu to make sure that you
  171. haven't disabled the loading of inlined images.  There is another problem
  172. caused whenever ImageFS is loaded and intercepting GIF and JPEG formats.  You
  173. should disable ImageFS whilst using ArcWeb for the moment, although I hope to
  174. release a version which recognised and takes advantage of ImageFS's
  175. facilities soon.
  176.  
  177.  
  178. Q7.  I have heard that UniSys have been threatening to enforce a patent on
  179. the LZ compression used in the GIF file format, as used by many WWW sites.
  180. Does this affect ArcWeb?
  181.  
  182. A7.  No.  ArcWeb does not contain any code for handling GIF format graphics
  183. files.  It merely tests files for filetype &695 (GIF) or for starting GIF87a
  184. or GIF89a, and pulls out the image pixel size (for imagemaps).  [GIF is a
  185. registered trademark (and service mark) of CompuServe Inc.]
  186.  
  187.  
  188. Q8. When I try to load !ArcWeb, it says 'nager:Sprites22'.  What on
  189. earth does this mean?
  190.  
  191. A8. This is a fault in RISC OS 3.50.  An error has occurred whilst trying
  192. to run the !ArcWeb.!Run file but due to the OS fault, the error message
  193. has been overwritten with the end of the string "WindowManager:Sprites22".
  194. The error could be any number of things, from a failure to locate a module
  195. in the RMEnsure statements; failing to set ArcWeb$CacheDir; failure to
  196. allocate enough memory.  You need to check the following common causes:
  197.  
  198. * Not having FilterManager 0.09 or later (see Q21 for details)
  199.  
  200. * Failing to load a sufficiently up-to-date version of the DrawFile module.
  201.  
  202.  
  203.  
  204. Q10.  How do I change fonts, colours and default options if I don't like
  205. them?
  206.  
  207. A10.  There are two levels at which the changes can be made - system wide,
  208. or user specific.  ArcWeb checks the following files for font definitions
  209. and colour schemes in this order: 1)  <WebCache$Dir>.Choices 
  210. 2) <ArcWeb$Dir>.Defaults   3) built-in defaults (you can't change these).
  211.  
  212. All the configuration windows are linked from the the Options menu on the
  213. web pages or on the Configuration submenu of the icon bar menu.  You can
  214. alter the settings and then make them permanent by using "Save Options".
  215.  
  216.  
  217. Q11.  How do I set up !ArcWeb for use on a shared network
  218.  
  219. In order to stop proliferation of ArcWeb into everyone's home directories,
  220. ArcWeb is willing to cooperate in a network environment.  !ArcWeb may be
  221. installed in a read-only filing system. Users will also need to have seen a
  222. !WebCache application to which they have exclusive use and to which they have
  223. read-write access.  Only one instance of ArcWeb may use any !WebCache
  224. directory.
  225.  
  226. If you are connected to the Internet via a UNIX gateway, then I strongly
  227. recommend running some form of proxy HTTP server on it.
  228.  
  229. The system administrator may wish to edit !ArcWeb.!Run to refuse to run if
  230. Arcweb$CacheDir is not set (as supplied, if it isn't set, it sets it to a
  231. subdirectory of itself).  The system administrator may choose to edit the
  232. !ArcWeb.Defaults file to change any system wide options.
  233.  
  234.  
  235.  
  236. Q12.  I try to run ArcWeb and nothing happens/machine locks up/odd errors
  237. appear (eg. Permission denied).
  238.  
  239. A12.  This might be caused by !WebCache not being installed in a read/write
  240. filing system.  Unless you have appropriate archiving software (eg. SparkFS
  241. or ArcFS 2), you will have to extract the !WebCache application to a
  242. writable filing system, and then double-click on the WebCache icon to
  243. install it.
  244.  
  245. Q13.  What does icon 'x' do?
  246.  
  247. A13.  ArcWeb supports interactive help.  Load the Acorn !Help application and
  248. you will be given help about the buttons under the pointer when in an ArcWeb
  249. window.  Note that in the window displaying the page itself, the help is
  250. purely the URL which would be opened if you were to click SELECT.
  251.  
  252. Q14.  When I follow a link to some URLs, I get a dialogue box saying that
  253. authentication is required.  What does this mean?
  254.  
  255. A14.  To allow information providers to restrict access to certain web
  256. pages, there is an authentication capability in the HTTP protocol.  The
  257. authentication domain is a combination of the host name and a 'realm' (just
  258. a keyword indicating which user/password is required).  If you do not have
  259. a valid user name and password, then you will not be able to access the URL.
  260. If you do, then enter them in the boxes and press RETURN (or click OK).  If
  261. you toggle the authetication window to full size, you will see which server
  262. is asking for authentication and in which domain.  NOTE:  Authentication
  263. checking is performed at the *server* not the client, so you can't get
  264. around it by hacking at ArcWeb.  ArcWeb will cache the user/password
  265. together with the server and realm and attempt to auto-authenticate you in
  266. future connections to that server.  This cache is destroyed when ArcWeb
  267. exits (although you can override this behaviour).
  268.  
  269. Q15.  When I follow a link to some URLs, I get a dialogue box saying that a
  270. non-default port is being used.  What does this mean?
  271.  
  272. Most Internet based protocols such as FTP, HTTP, Finger, SMTP, NNTP etc. are
  273. defined as existing at a particular 'port' on a server which supports the
  274. protocol.  eg. HTTP is usually at port 80, FTP is at port 21.  Sending
  275. control messages of one protocol to a different server port may cause damage
  276. at the local machine (your machine!) or at the server, or it may connect you
  277. to undesirable (and sometimes illegal - although this is very uncommon)
  278. services.  To help you recognise these rogue URLs, you will be asked for
  279. confirmation when ArcWeb finds that the default port has been overridden
  280. (except for HTTP, as it is commonly run on port 8001, 8080 as well as 80). 
  281. It's not by any means a foregone conclusion that any non-standard port
  282. connection is dangerous or illegal, but this way you at least have the option
  283. of blocking the connection.
  284.  
  285.  
  286. Q16.  When I try to run !ArcWeb, I get a stack backtrace/Directory Full
  287. errors
  288.  
  289. A16.  You must remove your old !WebCache directory before installing the
  290. new !WebCache because the directory hierarchy underneath the !WebCache.Data
  291. directory has changed in order to allow you over a 1000 entries in the cache
  292. instead of limiting it to 75.  If this isn't the problem, then email me the
  293. stack backtrace.  (Tech: you can capture the stack backtrace to a file by
  294. adding " 2>stacktrace " to the end of the last line of !ArcWeb.!Run.  The
  295. stack backtrace will then appear in a file called stacktrace in the current
  296. directory.)
  297.  
  298.  
  299. Q17.  Why do I get a save dialogue box when trying to read some pages, even
  300. when the object is HTML?
  301.  
  302. A17.  If the server did not send, or the fetcher failed to parse, the special
  303. Content-Type header returned by the server (this won't happen with KA9Q), then
  304. ArcWeb does not know what to do with the object.  From version 0.25, there is
  305. an option on the Options menu to attempt to 'execute' unknown objects.  There
  306. is also a fix for an incorrect parse of Content-Type headers in A/TCP 0.21
  307.  
  308.  
  309. Q18.  Sometimes I get 'Too Long' (or similar) error messages whilst the page
  310. is being drawn and then none of the graphics are on the page.  Why?
  311.  
  312. A18.  ArcWeb uses external programs to convert GIF and JPEG files into
  313. RISC OS sprites.  To do this, it constructs a command line which invokes
  314. the translator and tells it the input and output files.  When RISC OS runs
  315. the command string through its routines, it is possible for an overflow to
  316. occur (ie. the command ends up longer than the maximum permitted command
  317. length).  This is when the OS generates the Too Long error.  To fix it, you
  318. need to move the relevant programs closer to your root directory. 
  319. Specifically, !WebCache and !ChangeFSI are the programs that are
  320. concerned.  Using ..$Path variables does not seem to help, as the OS is
  321. canonicalising the paths.
  322.  
  323.  
  324. Q19.  What do I do to cure 'unable to lookup host's address' errors?
  325.  
  326. A19.  First of all, check you've spelt the hostname correctly in the URL.
  327. Check the DNS configuration.  Open the DNS tester by choosing it
  328. from the Show menu on the icon bar menu.  If all three of the DNS boxes
  329. at the top read 'None', then it indicates that the resconf file was not
  330. found.  Check that InetDBase$Path points to a directory containing a
  331. resconf and hosts files.  If it doesn't you need to do:
  332. *Set InetDBase$path The.full.pathname.to.!Internet.files.
  333. (including the final .)   If the DNS resolvers are known, then click on
  334. the Lookup Name icon next to the top one.  The Answer box should come
  335. back with the official name of the machine.  If it fails, then it means
  336. that all the DNS servers in your list are not working (or that your
  337. computer cannot find a way to reach them because you aren't connected
  338. or something).
  339.  
  340.  
  341. Q20.  ArcWeb keeps dying with fatal internal error type=5 messages.
  342. What can I do to stop this?
  343.  
  344. A20.  This means that something has gone wrong internally for some
  345. reason.  Although the problem might not be caused by ArcWeb, something which
  346. it interacts with has caused some condition which was unexpected.  The
  347. best way to deal with this is to follow the instructions on sending
  348. bug reports by following the link from the default home page.
  349.  
  350.  
  351. Q21.  When I try to run ArcWeb, I get a message that my Filter Manager is
  352. too old and that I need version 0.09 or later
  353.  
  354. Q21a. Why doesn't ArcWeb attempt to load the more recent Filter Manager that
  355. I've got in my !System.
  356.  
  357. A21/A21a.  ArcWeb requires FilterManager 0.09 or later to be installed on
  358. your machine.  It may be the case that you have this module in your System
  359. directory but have an earlier version in ROM.  ArcWeb will NOT kill the
  360. earlier Filter Manager module if it is active, because some tasks which don't
  361. behave properly fail to cope with the Filter Manager dying and the whole
  362. desktop dies task by task.  The cure for this is to ensure that FilterMgr is
  363. loaded BEFORE entering the Wimp on boot up by loading it during your boot
  364. sequence.  For Risc PC owners, this will be in the Misc section of
  365. !Boot.Choices.Boot.PreDesktop.  For other machines, it will depend on your
  366. setup.
  367.  
  368.  
  369. Q22.  Why does ArcWeb take up so much memory?
  370.  
  371. A22.  Simply because it contains so much code.  ArcWeb attempts to cater for
  372. all kinds of rubbish being downloaded (either maliciously or accidentally).
  373. Some things which are required are not available as part of the OS, so have
  374. to be implemented by me instead (eg. multiline text icons in the cookie
  375. and meta-info dialogue boxes).  Some code is included as a work around for
  376. bugs in the OS (libjpeg).
  377.  
  378.  
  379. Q23.  Email and ftp work fine on my machine, but ArcWeb has trouble
  380.       downloading anything at a reasonable speed: why?
  381.  
  382. A23.   Sometimes the Internet just gets overloaded, however, Web browsing
  383. puts a heavy load on your computer compared with things like ftp --
  384. especially if you are using a modem -- and your poor machine just can't keep
  385. up with all the data being thrown at it.  If you are running lots of nice
  386. desktop enhancements, these can use more processor time than you might
  387. imagine.  Try not using any more software than is necessary when running
  388. ArcWeb, and use smaller screen modes with fewer pixels and colours to consume
  389. less bandwidth on older machines.  [Thanks to Chris Latham for this]
  390.  
  391.  
  392. Q24.  How do I enable the font blending options?
  393.  
  394. A24.  First of all, you must have RISC OS 3.7 or later.  If you don't, then
  395. this facility (provided by the Font Manager) is not available - sorry.  If
  396. you do, then just enable the option in the Browser configuration window
  397.  
  398.  
  399. Q25.  When I try to run ArcWeb it tells me that "The cache has been locked by
  400. a browser running on another machine".  Should I click Cancel or should I
  401. override the lock?
  402.  
  403. A25.  This message may appear if your machine crashed whilst ArcWeb was
  404. running.  If this was the case, then you should override the lock.  If you
  405. are using a shared directory for the cache, then it is possible that another
  406. machine is already using the !WebCache directory.  If two running versions of
  407. ArcWeb attempt to share the same cache, it's asking for trouble (Choices,
  408. bookmarks and cache contents can become corrupt).  If the machine named is
  409. not running ArcWeb, then you can safely override the lock.
  410.  
  411.  
  412. --
  413. Stewart Brodie
  414. 14th May 1997
  415.