home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 8 / CDACTUAL8.iso / share / os2 / varios / apache / readme.os2 < prev    next >
Encoding:
Text File  |  1996-03-23  |  5.3 KB  |  118 lines
  1. Apache for OS/2
  2. -----------------------------------------------------------------------
  3.  
  4. The primary motivation for this port is to show that OS/2 is a viable
  5. and powerful server platform and to promote it's use as such. The
  6. secondary reason was to have a free industrial strength HTTP server with
  7. a growing feature set available to OS/2. The Apache Project is strongly
  8. committed to these ideals and was selected as the best server for
  9. porting to OS/2.
  10.  
  11. Runtime Requirements:
  12.      o OS/2 Version 2.11 or greater. OS/2 Warp Connect suggested for
  13.      best performance.
  14.      o One of the following TCP/IP packages for OS/2. (Listed in order
  15.      of preference.)
  16.           o IBM TCP/IP 3.0 included in OS/2 Warp Connect.
  17.           o IBM TCP/IP 2.0 Base Kit with CSD64092 or greater applied.
  18.           o The Internet Access Kit from OS/2 Warp's Bonus pack.
  19.      o Info-Zip for OS/2 to extract the distribution. Available as
  20.      UNZ512X1.EXE .
  21.      o EMX 0.9b runtime with fix 3. Available as EMXRT.ZIP .
  22.      o An OS/2 HPFS formatted partition for Apache to run from.
  23.  
  24. Please refer to INSTALL.OS2 for detailed installation procedures.
  25.  
  26. Recompiling Requirements:
  27.      o SH shell for OS/2. Available many places as KSH522RT.ZIP .
  28.      o GNU SED 2.05 or greater, available many places as GNUSED.ZIP .
  29.      o GNU grep, available many places as GNUGREP.ZIP .
  30.      o EMX 0.9b development system with fix 3.
  31.      o OS/2 port of libufc.lib, Available many places as GNUUFC.ZIP .
  32.      o OS/2 versions of many UNIX file commands available as GNUFU.ZIP .
  33.      o OS/2 port of GNU make. Available many places as GNUMAKE.ZIP .
  34.      o OS/2 port of GNU DBM. Available many places as GNUGDBM.ZIP .
  35.  
  36. Most of the files need for runtime or development can be found at
  37. ftp://hobbes.nmsu.edu/os2/unix/ or ftp://ftp.leo.org/pub/comp/os/os2/ .
  38.  
  39. NOTE: Whenever modifications where made to the original original UNIX
  40. source code the unaltered file can be found with .ORIG extension.
  41.  
  42. WARNING: If you are going to edit "makefile" or "configuration" you must
  43. do it with E otherwise GNU make won't be able to parse it. Most editors
  44. expand tabs to spaces, E won't and GNU make requires tabs in certain
  45. places.
  46.  
  47.  
  48. Future Enhancements
  49.      o TGI Interface from Andrea Montefusco . For more details goto
  50.      http://bws.roma.ccr.it/httpd2doc/httpd2in.html .
  51.      o Keep Alive socket connections.
  52.      o Proxy services.
  53.  
  54. Limitations
  55.      o The XBITHACK is not currently supported under OS/2.
  56.  
  57. Apache for OS/2 Release Notes
  58.  
  59. The complete Apache documentation is available on-line at
  60. http://www.apache.org/docs/ .
  61.  
  62. For details on local testing of Apache for OS/2 refer to the
  63. LOCALTESTING.OS2 .
  64.  
  65. OS/2 drive letters are supported in Apache's configuration files, but
  66. you must use "/" where you would normally use "\" in pathnames. This is
  67. to maintain maximum compatibility with the base UNIX source code of
  68. Apache. Also be aware that Apache won't know that "c:/" is equivalent to
  69. "/" if c: is the current drive. This is especially important when
  70. specifying options in the access configuration file. Network paths can
  71. also be use in the configuration files as in "//{server}/{device name or
  72. alias}/{path}/", but once again use "/" where you would normally use
  73. "\". Apache for OS/2 (actually EMX) will do the translation.
  74.  
  75. VirtualHosts are supported through multiple LAN adapters or through a
  76. workaround available in the Apache directory as os2\virtppp.cmd .
  77.  
  78. If an error about insufficient filehandles occurs add "SET EMXOPT=-hxxx"
  79. to your CONFIG.SYS. "xxx" is any value between 10-254. This will
  80. increase the number of filehandles to the value specified.
  81.  
  82. The compiled version included with the distribution includes agent log,
  83. referer log, Netscape Cookie and dbm authority modules.
  84.  
  85. The correct way to stop Apache for OS/2 is to run the TERMINATE.CMD
  86. command located in the os2 directory included in the apache
  87. distribution. If you switch to Apache and press Ctrl-C or Ctrl-Break,
  88. you may not always kill the parent process. The only way to get rid of
  89. Apache then is to shutdown and reboot.
  90.  
  91. Most CGI Perl scripts available on the Internet will work well with the
  92. OS/2 port of Perl5 and as a result work with Apache for OS/2. The best
  93. way to call them from a CGI is to refer to a CMD file and have that call
  94. PERL5 with the script name and appropriate parameters. For an example of
  95. a CMD cgi script refer to TEST-CGI.CMD in the CGI-BIN directory.
  96.  
  97. The default directories for OS/2 Apache are the same as OS2HTTPD so it
  98. can be use with an existing OS2HTTPD document structure. However you
  99. will need to use OS/2 Apache conf files. OS2HTTPD conf files don't
  100. include several options REQUIRED by Apache for OS/2.
  101.  
  102. Some users have reported problems where the error.log file grows
  103. continuously until it takes up all free space. This has been traced to
  104. having an older versions of EMX installed. To determine your version
  105. level run EMXREV from the directory where Apache is installed. Your
  106. results should be higher or equal to:
  107.  
  108.     EMX : revision = 41
  109.     EMXIO : revision = 40
  110.     EMXLIBC : revision = 40
  111.     EMXLIBCM : revision = 42
  112.     EMXLIBCS : revision = 42
  113.     EMXWRAP : revision = 40
  114. We are very interested in hearing about successes achieved with Apache
  115. for OS/2 as well as failures and problems. So please send suggestions or
  116. comments about Apache for OS/2.
  117.  
  118.