home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 May / PCO_5_97.ISO / FilesBBS / OS2 / APACH113.ARJ / APACH113 / APACH113.ZIP / apache_1.1.3 / readme.os2 < prev    next >
Encoding:
Text File  |  1997-02-04  |  6.1 KB  |  166 lines
  1. Apache for OS/2
  2.  
  3. The newest version of this document can be found
  4. at http://www.slink.com/ApacheOS2/
  5.  
  6. The primary motivation for this port is to show that OS/2 is a viable and
  7. powerful server platform and to promote its use as such. The secondary
  8. reason was to have a free industrial strength HTTP server with a growing
  9. feature set available to OS/2. The Apache Project (http://www.apache.org/)
  10. is strongly committed to these ideals and was selected as the best server
  11. for porting to OS/2.
  12.  
  13. Download Apache for OS/2 Version 1.1.1b (1.4 Meg)
  14.  
  15. Runtime Requirements:
  16.  
  17.     OS/2 Version 2.11 or greater. OS/2 Warp Version 4 or OS/2 Warp Connect
  18.     suggested for best performance.
  19.  
  20.     One of the following TCP/IP packages for OS/2.
  21.     (Listed in order of preference.)
  22.  
  23.         IBM TCP/IP included with OS/2 Warp Connect or OS/2 Warp Version 4.
  24.  
  25.         IBM TCP/IP 2.0 Base Kit with CSD64092 or greater applied.
  26.  
  27.         The Internet Access Kit from OS/2 Warp's Bonus pack.
  28.  
  29.     Info-Zip for OS/2 to extract the distribution. Available as
  30.     UNZIP520.EXE.
  31.  
  32.     EMX 0.9c runtime with fix 2. Available as EMXRT.ZIP.
  33.  
  34.     An OS/2 HPFS formatted partition for Apache to run from.
  35.  
  36.     OS/2 versions of many UNIX file commands available as GNUFU.ZIP.
  37.  
  38.       (Only needed if the HTPASSWD or HTDIGEST utilities will be used.)
  39.  
  40. Please refer to INSTALL.OS2 for detailed installation procedures.
  41.  
  42. Recompiling Requirements:
  43.  
  44.     SH shell for OS/2. Available many places as KSH527RT.ZIP.
  45.  
  46.     GNU SED 2.05 or greater, available many places as GNUSED.ZIP.
  47.  
  48.     GNU grep, available many places as GNUGREP.ZIP.
  49.  
  50.     EMX 0.9c development system with fix 2.
  51.  
  52.     OS/2 port of libufc.lib, Available many places as GNUUFC.ZIP.
  53.  
  54.     OS/2 versions of many UNIX file commands available as GNUFU.ZIP.
  55.  
  56.     OS/2 port of GNU make. Available many places as GNUMAKE.ZIP.
  57.  
  58.     OS/2 port of GNU DBM. Available many places as GNUGDBM.ZIP.
  59.  
  60. Most of the files need for runtime or development can be found at
  61. ftp://hobbes.nmsu.edu/os2/unix/ or
  62. ftp://ftp.leo.org/pub/comp/os/os2/leo/.
  63.  
  64. NOTE: Whenever modifications where made to the original UNIX
  65. source code the unaltered file can be found with .ORIG extension.
  66.  
  67. WARNING: If you are going to edit "makefile" or "configuration" you must do it
  68. with E otherwise GNU make won't be able to parse it. Most editors expand
  69. tabs to spaces, E won't and GNU make requires tabs in certain places.
  70.  
  71. Future Enhancements
  72.  
  73.     TGI Interface from Andrea Montefusco.
  74.     For more details goto http://bws.roma.ccr.it/httpd2doc/httpd2in.html.
  75.  
  76.     mSQL authority module.
  77.  
  78. Limitations
  79.  
  80.     The XBITHACK is not currently supported under OS/2.
  81.  
  82.     INETD is not supported under OS/2.
  83.  
  84. Apache for OS/2 Release Notes
  85.  
  86. The Apache for OS/2 documentation is available at
  87. http://www.slink.com/ApacheOS2/
  88. and the generic Apache documentation for all platforms is at
  89. http://www.apache.org/docs/.
  90.  
  91. For details on local testing of Apache for OS/2 refer to the
  92. TESTING.OS2.
  93.  
  94. OS/2 drive letters are supported in Apache's configuration files, but
  95. you must use "/" where you would normally use "\" in pathnames. This is
  96. to maintain maximum compatibility with the base UNIX source code of Apache.
  97. Also be aware that Apache won't know that "c:/" is equivalent to "/" if c:
  98. is the current drive. This is especially important when specifying options
  99. for access configuration. Network paths can also be use in the configuration
  100. files as in "//{server}/{device name or alias}/{path}/", but once again
  101. use "/" where you would normally use "\". Apache for OS/2 (actually EMX)
  102. will do the translation.
  103.  
  104. VirtualHosts are supported through multiple LAN adapters or
  105. through a workaround available in the Apache OS2 directory as
  106. virtppp.cmd.
  107.  
  108. The compiled version included with the distribution includes agent log, referer
  109. log, Netscape Cookie support, asis, server side image maps, status and info
  110. modules, digest authority, proxy services and dbm authority modules. You can
  111. add other modules or remove modules by recompiling Apache.
  112.  
  113. The correct way to stop Apache for OS/2 is to run the TERMINATE.CMD
  114. command located in the os2 directory included in the apache distribution.
  115. If you switch to Apache and press Ctrl-C or Ctrl-Break, you may not
  116. always kill the parent process. The only way to get rid of Apache then
  117. is to shutdown and reboot.
  118.  
  119. Most CGI Perl scripts available on the Internet will work well with the
  120. OS/2 port of Perl5 and as a result work with Apache for OS/2. The best way
  121. to call them from a CGI is to refer to a CMD file and have that call PERL5
  122. with the script name and appropriate parameters. For an example of a CMD
  123. cgi script refer to TEST-CGI.CMD in the CGI-BIN directory.
  124.  
  125. The default directories for OS/2 Apache are the same as OS2HTTPD so it can
  126. be use with an existing OS2HTTPD document structure. However you will need to
  127. use OS/2 Apache conf files. OS2HTTPD conf files don't include several options
  128. REQUIRED by Apache for OS/2.
  129.  
  130. Some users have reported problems where the error.log file grows
  131. continuously until it takes up all free space. This has been traced to
  132. having an older versions of EMX installed. To determine your version
  133. level run EMXREV from the directory where Apache is installed. Your
  134. results should be higher or equal to:
  135.  
  136. EMX : revision = 50
  137. EMXIO : revision = 50
  138. EMXLIBC : revision = 50
  139. EMXLIBCM : revision = 50
  140. EMXLIBCS : revision = 52
  141. EMXWRAP : revision = 50
  142.  
  143. We are very interested in hearing about successes achieved with Apache
  144. for OS/2 as well as problems. So please send suggestions or comments
  145. about Apache for OS/2 to garey@slink.com or join the Apache for OS/2 users
  146. mailing list at http://www.slink.com/ApacheOS2/.
  147.  
  148. The following sites may also be of interest to new or experienced webmasters.
  149.  
  150.     The official Apache Project site at
  151.  
  152.     http://www.apache.org/.
  153.  
  154.     World Wide Web Security FAQ at
  155.  
  156.     http://www.genome.wi.mit.edu/WWW/faqs/www-security-faq.html.
  157.  
  158.     NCSA httpd documentation at
  159.  
  160.     http://hoohoo.ncsa.uiuc.edu/.
  161.  
  162.     The YAHOO World Wide Web pages at
  163.  
  164.     http://www.yahoo.com/Computers_and_Internet/Internet/World_Wide_Web/.
  165.  
  166.