How I got Win32 Apache Web Server, JServ, and GNUJSP
running on a Win98 box.

Software Used:
Windows98
Sun's jdk1.2
Sun's jsdk2.0
Apache_1_3_6_win32.exe
ApacheJServ1.0b2-Apche1.3.4.exe
GNUJSP 0.9.9

Apache homepage: http://www.apache.org
Java Apache homepage: http://java.apache.org
GNUJSP Homepage: http://www.klomp.org/gnujsp/

The JServ documentation, the faq at java.apache.org, and its links 
were very helpful - I'd use them as your main references.

This is what worked for me - may not all be necessary.  I reference the
default folder names througout this document, but actually installed 
everything as follows (including two new folders under Apache):

Apache32
 |-Apache
 |  |-servlets
 |     |-java
 |
 |-JServ
 |
 |-gnujsp
 
corresponds to:

Apache Group
 |-Apache
 |
 |-Apache JServ
 |
 |-gnujsp
 

I Don't know if the Java Plugin is necessary or helpful, but I have 
the one from Sun (v1.1) installed on my system.
        
I did the minimum to get things running, as my primary purpose
at this time is to learn about java, servlets, and jsp.  Obviously,
you should be concerned about figuring out the proper security
configuration if you want to use this stuff in a production environment.

Apache Web Server and JServ
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

1.  Install JDK1.2 and JRE

2.  Install JSDK2.0

3.  Set up paths and classpaths for the first two  (class paths for the
      development kits are a whole 'nother thing that I'm not getting into
      here.  One thing that I found helpful was this entry in 
      my classpath: \jsdk2.0\lib\jsdk.jar)

4.  Install apache_1_3_6_win32.exe - (custom, pick everything)

5.  Install ApacheJServ1.0b2-Apche1.3.4.exe - (pick top option, where 
      it integrates with the Web server, not the custom)
    Allow setup to modify config files.

6.  Unzip Apache-JServ-1.0b3.jar.zip, rename to "ApacheJServ.jar" and
      move to "Apache JServ" root folder, replacing 0KB file with same name.

7.  Fetch ApacheModuleJServ1b3_136.dll via FTP (_not_ http), rename
      to ApacheModuleJServ.dll and move to "Apache\modules" folder,
      replacing file with same name

8.  Config (setup has already done a lot)

    Apache\conf\httpd.conf
    ======================
    ServerName ###.###.###.###  (I used machine's IP number)
    ApJServDefaultHost ###.###.###.### (same as last)
    ApJServMount /servlet /root  (I changed to /servlet from /servlets -
      this seems common, to put servlet class files in a physical
      folder named /servlets, but to reference /servlet/ in the URL)
    
    Apache JServ\conf\jserv.properties
    ==================================
    (classpath stuff - setup configured the first correctly, but 
     got the jsdk path from JBuilder, so I changed it to Sun's.  We'll
     add JSP stuff here later.)
    wrapper.classpath=D:\Apache Group\Apache JServ\ApacheJServ.jar
    wrapper.classpath=D:\jsdk2.0\lib\jsdk.jar
    zones=root (I left this alone, but it is an important config item)
    root.properties=D:\Apache Group\Apache JServ\conf\zone.properties 
      (again, left alone)
    security.allowedAddresses=###.###.###.### (same as above ip)
    log.file=D:\Apache Group\Apache JServ\logs\jserv.log  
      (this was included in setup, but when I originally did stuff 
       manually this log never appeared.  It is a very helpful log for 
       troubleshooting!)
        
    Apache JServ\conf\zone.properties
    =================================
    repositories=D:\Apache Group\Apache\servlets (This is a folder
      you create to put your servlet class files in.  Note that 
      earlier we set the URL reference to be /servlet,
      without the "s".  Later we'll add a \java subfolder and
      stuff for JSPs here)
        
That should be enough to get Apache and JServ running.  I don't refer to
aliases here because they're not necessary to get things running.

The logs:

Apache Group\Apache\logs\error.log
Apache Group\Apache JServ\jserv.log
Apache Group\Apache JServ\mod_jserv.log

are helpful for troubleshooting.  I had ClassDef not found (whatever) errors
and problems with the jvm starting and crashing, and all kinds of weird stuff
when I tried setting stuff up manually.  The above steps took care of all the
problems.

Now you should be able to call up the servlets on a localhost with a 
URL like this:

http://machine_name/servlet/SimpleServlet


GNUJSP 0.9.9
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

GNUJSP Homepage: http://www.klomp.org/gnujsp/
Another helpful page for installing with JServ (listed in gnujsp install): 
http://www.bestiary.com/moose/jsp/install.html
        
The install file and the bestiary url were sufficient for me to get JSP 
working.  I had a lot easier time with this than with JServ (except for
a misspelled line in zone.properties Init Parameters, ouch.)

I unzipped the download file, renamed the root folder to "gnujsp" and
put it under the Apache Group folder.


Following along with the gnujsp install directions:

1.  Add the gnujsp.jar file to the CLASSPATH used by the web server.
      (and specific notes about Apache JServ 1.0b2 and jdk1.2)
        
    Apache JServ\conf\jserv.properties
    ==================================
    wrapper.classpath=D:\jdk1.2\lib\tools.jar
    wrapper.classpath=D:\Apache Group\gnujsp\lib\gnujsp.jar
   
    Apache Group\Apache JServ\conf\zone.properties
    ==============================================
    (The following entry should be on same line - I don't know if you
     can break them apart.  The last entry is _crucial_ - the install
     file included with gnujsp makes no mention of this but the bestiary
     doc emphasizes it.  I got all kinds of weird problems when I
     left it out.)
    repositories=[previous entry],D:\Apache Group\gnujsp\lib\gnujsp.jar,
      D:\Apache Group\Apache\servlets\java
        
2.  Create a directory to store the generated java and class files.

    I used D:\Apache Group\Apache\servlets\java (This is the same as that
      critical last entry in step 1.)
        
3.  Configure the GNUJSP servlet.

    Apache Group\Apache JServ\conf\zone.properties
    ==============================================
        
    servlet.gnujsp.code=org.gjt.jsp.JSPServlet
    servlet.gnujsp.initArgs=repository=d:\Apache Group\Apache\servlets\java
   
4.  Associate the extension ".jsp" with the GNUJSP servlet

    Apache\conf\httpd.conf
    ======================
   
    ApJServAction .jsp /servlet/gnujsp


I used a servlet alias for steps 3 and 4, but you can probably use the 
full class name for initArgs and ApJServAction

Now you can put the example .jsp files from gnujsp into your web server doc
directory and try them out.  Usually: Apache\htdocs

example url:
  http://machine_name/session.jsp

I first tried this at work and had much better luck.  At home I ran into two
new problems: I forgot to add the path to servlets\java in the zone.properties
repositories entry (fixed easily enough), and...

I ran into an extremely aggravating problem where my isp connection dialog
would appear whenever I started the web server.  If I pressed cancel it would
keep popping up.  Servlets and JSPs didn't work.  I went into Internet from
Control Panel and selected the Connection tab.  Here I selected the option
to connect to the internet using a local area network (the modem option had
been selected).  This took care of the problem, and I can still launch 
dial-up-networking to connect with my modem.  I'm not sure what else that
setting will affect - maybe for the option to connect-as-needed?  I don't like
that option anyway.

Please direct any questions to Scott_Carpenter@bigfoot.com.  I'd also be 
happy to hear if you found this guide helpful for configuring these software
products, or if you have recommendations on where things could be made clearer.