===============================================================================
Apache SSL for OS/2                                                 20-Jan-1999
===============================================================================

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

This is Apache 1.3.4 Webserver with SSL 0.81b.  I compiled it basing on the
source codes downloaded from www.apache.org and SSLeay sites. The server
works fine 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 SSLeay0.81b
-- Servlet support with JServ 1.0b2
-- Java servlet SSI support
-- 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.41 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.90d
Each line  in config file "jserv.properties"(Only this file) must be ended LF
without RTN, you can use special editors to edit it or use some convertors like
"flip.exe" to strip RTN 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 and SSL functions.
5. You can generate you own key and certificate by using makecert.cmd with
   necessary modifications.
   
Notice
======
I promise nothing by using this software. It is your own business when something
goes wrong.

D. Yang
yangdh@online.sh.cn
