===============================================================================
Apache SSL for OS/2                                                 08-Apr-1999
===============================================================================

Introduction
============

This is Apache 1.3.6 Webserver with OpenSSL 0.92b.  I compiled it basing on the
source codes downloaded from www.apache.org and www.OpenSSL.org sites. 
The server works well in my OS/2 Aurora preview and OS/2 Warp Server Advanced 4.0
(Fixpack 38, MPTS8424 and TCPIP00959) with IBM Java 1.1.7a.

Extra Features Compiled in
==========================
-- HTTP and FTP proxies
-- 128 bit SSL support with OpenSSL0.92b
-- Servlet support with JServ 1.0b3
-- Java servlet SSI support
-- GNUjsp support with version 0.99
-- Gsp support with version 0.86
-- Apache Cocoon 1.1.1(LotusXSL, OpenXML)
-- User authentication using mSQL database
-- User authentication using GDBM

Packages in This Zipped File
============================
There are two packages in the zipped file. One is mSQL 2.0.4.1 for OS/2 and
the other is Apache SSL.

Installation
============
1. mSQL
Unzip mSQL.zip file on root directory of a HPFS or JFS partition, make sure
that the directory tree is maintained.
2. Apache SSL
Unzip ApacheSSL.zip file on root directory of a HPFS or JFS partition, make
sure that the directory tree is maintained.
3. Configuration
The Apache SSL is compiled with default user authentication using mSQL. The
database is named "UserBase" and the table containing users is "userpassword",
whose structure can be viewed by "SELECT" SQL statement after the mSQL daemon is
started(Just execute dbStart.cmd in dir \Database\mSQL\bin).
The config files in dir \OS2Httpd\conf must be modified in accordance with
your environment. The config files given here adaptive to my computer
environment:
-- OS:  OS/2 Warp Server for e-business preview(Aurora)
-- TCPIP: 4.21, DDNS is running
-- Domain: ygd.tongji.edu.cn, Netmask: 255.255.255.0
-- Host name: dehua, IP: 202.120.182.10
-- Virtual hosts: java.ygd.tongji.edu.cn/202.120.182.101
                  data.ygd.tongji.edu.cn/202.120.182.100
-- JDK: h:\java11                  
-- EMX: version 0.9d
Each line  in config file "jserv.properties"(Only this file) must be ended LF
without CR, you can use special editors to edit it or use some convertors like
"flip.exe" to strip CRs from the file after edited using ordinary OS/2 editors.

Running
=======
1. mSQL daemon. Execute "dbStart.cmd" in dir /Database/mSQL2/bin
2. Apache SSL. Execute "httpsd.exe" in dir /OS2Httpd/os2
3. Start a browser pointing to URL "http://<your host>", you should see the
   "index.html" document in dir /OS2Httpd/public/htdocs.
4. Click the hyperlinks to test user authentication, servlet, SSL functions and so on.
5. You can generate you own key and certificate by using makecert.cmd with
   necessary modifications.
   
Notice
======
I promise nothing by using this software except it seems running well on my computer.
It is your own business when something goes wrong.

D. Yang
yangdh@online.sh.cn
