home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / cern_os2.zip / readme.os2 < prev    next >
Text File  |  1995-06-19  |  7KB  |  143 lines
  1. *** cern httpd 3 OS/2-Version 1.01 *** (19.06.95)
  2.  
  3. This is a quick (and perhaps dirty) port of the nice
  4. WWW-Server (and WWW-Library) by CERN to OS/2 2.x.
  5.  
  6. *** what's new?
  7.  
  8. This is the second release. It contains bugfixes for transmitting of
  9. binary files (e.g. inline images for image maps) and for convenient
  10. use under OS/2 which only supports uppercase environment variables.
  11. This prevented the cern-WWW-Server to act as a proxy client, since
  12. it asked for the existence of the environment variable "http_proxy"
  13. which OS/2 (i.e. the standard shell cmd.exe) cannot provide. Now,
  14. if it finds "http_proxy", "gopher_proxy", "wais_proxy" etc. to be
  15. empty, it tries the respective variable with uppercased name.
  16.  
  17. Additionally, the linemode browser WWW has been ported to OS/2
  18. (this has just been a recompile, it worked "out of the box").
  19. See the file LineMode/readme for a short description of how to use.
  20. The standard documentation can be found online at w3.www.org.
  21.  
  22. *** Credits
  23.  
  24. Tim Berners-Lee, Ari Luotonen and the other developpers of the WWW project!
  25. (which started at CERN (info.cern.ch) and now resides at w3.www.org)
  26.  
  27. Eberhard Mattes for emx+gcc, emacs, and gdb for OS/2!
  28.  
  29. *** Requirements
  30.  
  31. To use this software you need some sort of TCP/IP stack, either
  32. network interface card connected to a network (internet or just
  33. internal), or modem or other means (SL/IP, PPP etc.). This means
  34. that the DLL files tcp32dll.dll and so32dll.dll must be in your
  35. LIBPATH.
  36.  
  37. It is tested with OS/2 2.10GA (german) and OS/2 Warp for Windows V3
  38. (english), IBM TCP/IP 2.0 (CSD UN64092), and the IBM WebExplorer 1.01
  39. as client.
  40.  
  41. Note: the WebExplorer upto version 1.01 does not support gatewaying
  42. through the "proxy" entry field, i.e. if you fill out the respective
  43. line, the request sent to the server becomes unusable.
  44.  
  45. *** Installation
  46.  
  47. I recommend running it off a hard drive formatted with HPFS or other
  48. "nice" file system that suports long filenames. I did not bother
  49. converting/renaming files or implementing algorithms that "shorten"
  50. names to the sick FAT 8+3 file system and vc.vs. Be sure that you
  51. have enough free space on your swap drive. I recommend that you
  52. set the initial size of the swapfile to at least the amount of
  53. "real" memory that is built into your computer (16 MB Ram -> 16 MB
  54. initial size via "swappath=d:\swap 16384 16384" e.g.).
  55.  
  56. It *is* possible to configure different drives for e.g. the
  57. configuration file and the data directory. I do not recommend this
  58. way. Better install all the stuff on one drive and do not mess with
  59. drive letters in the configuration file (Pass rules etc.). The way
  60. drive letters are handled is not very nice (URL-access types and drive
  61. letters are both recognized by the trailing colon ':') and I suspect
  62. it may lead to strange results when someone sends a malformed
  63. HTTP-request to the server (http:c:/config.sys or the like).
  64.  
  65. All you need is httpd_os2.exe and a configuration file, which may
  66. consist more or less of a "pass /* /your/path/*" to test the
  67. functionality. Of course, if you want to use sophisticated features
  68. like document protection, caching or proxy-ing, there is a lot more to
  69. configure. See all.conf, proxy.conf, caching.conf in the conf/
  70. subdirectory.
  71.  
  72. For the first few tries RUN THE DAEMON IN VERBOSE MODE! This is
  73. quite important for security and performance reasons. Do something
  74. like "start /C httpd_os2 -v -r myconf.cnf". You may then stop the
  75. server using ctrl-break or ctrl-c (strg-untbr or strg-c on german
  76. keyboards). Later on I recommend using "detach httpd_os2 -r xy.conf"
  77. since it saves some more ressources when running without terminal i/o.
  78.  
  79. *** Technical hints
  80.  
  81. The daemon uses the emx+gcc 0.9a#5 Library; thus, emx.dll has to be in
  82. the LIBPATH. Be sure that there are no older emx.dll-files in
  83. "earlier" locations referred to in the LIBPATH-statement. This is very
  84. important because strange things (core dumps, file sharing/opening
  85. problems) may happen if too old a version of emx.dll is used (I speak
  86. from knowledge ...). Before running it in "production" mode check with
  87. the enclosed emxrev.cmd ((c) Eberhard Mattes like the emx runtime
  88. environment) whether there are other emx.dll files. It might run with
  89. emx.dll 0.9a#3 (this fix introduced inheritance of sockets to child
  90. processes) but I did not try. If you do not know what I mean just kill
  91. all other emx.dll files. If you get an error message like "...\emx.dll
  92. access denied" there are programs running that need and reference the
  93. DLL currently. Find out that process and stop it (Emacs, gdb, emx+gcc
  94. itself, the emxload server etc.). Afterwards unpack and move the
  95. emx.dll to a "nice" place. It is no problem to update emx.dll! All
  96. versions are upwards compatible, i.e. "old" programs always run with
  97. a newer emx.dll.
  98.  
  99. Use the supplied simple configuration file httpd.conf which is
  100. tested. If you want to use the sophisticated features like proxy and
  101. caching, you are on your own.
  102.  
  103. *** Recommendations
  104.  
  105. If you have the ressources DON'T (I mean *don't*) run a caching server
  106. on the same drive that contains your swapper.dat. This is very
  107. important since the cern httpd does not check whether the file system
  108. is full when writing files it wants to cache. Worse yet it does ignore
  109. the settings of the maximum cache size (set it to 100 M and it will
  110. happily write 130 M to the file system if there are this many
  111. different requests). The cache size will only be correct after a
  112. garbage collection.
  113.  
  114. This is a known bug (or "feature") of cern 3.0 and will probably be
  115. corrected in the next release from w3.org.
  116.  
  117. If OS/2 cannot allocate room on this drive when it needs to, it will
  118. fail, probably stopping with a "hard error" and you have to push
  119. reset. This is quite disturbing because chkdsk needs to run for each
  120. "dirty" drive, and this may take some time on large (especially quite
  121. full) drives.
  122.  
  123. *** Full Documentation for cern httpd
  124.  
  125. Read the documentation for the daemon at
  126. http://www.w3.org/hypertext/WWW/TheProject.html
  127. or at
  128. http://www.uni-giessen.de/www-doc/
  129. (this is possibly outdated but convenient inside Germany).
  130.  
  131. *** Next version
  132.  
  133. This version is quite slow since it uses the fork() emulation of the
  134. emx-C-Library and has to spawn off cmd.exe for each cgi-script. The
  135. next release will make efficient use of OS/2 threads.
  136.  
  137. *** Who dunnit?
  138.  
  139. Please send bugreports or comments to
  140. thomas.seeling@math.uni-giessen.de
  141. or
  142. ths@texbox.lahn.de
  143.