Environment: Cobalt RaQ3, apache 1.3.6 with mod_so
Installation includes: ClasspathX_Servlet, Jikes, ApacheJServ 1.1, GNUJSP

1. Install ClasspathX and ApacheJServ
   Log on to the administrative interface for the Cobalt, select Maintenance, and select Install Software.
   

   Install from the following URL's:
   ftp://ftp.cobaltnet.com/pub/developer/Apache/i386/ClasspathX_Servlet-1.1-1.i386.pkg
   ftp://ftp.cobaltnet.com/pub/developer/Apache/i386/ApacheJServ-1.1-1.i386.pkg

2. Install Jikes
   

   Jikes is a better java compilier from IBM. Get it from http://www10.software.ibm.com/developerworks/opensource/jikes/project/stable/jikes-1.06-1.i386.rpm and install by

   
   rpm -Uvh jikes-1.06-1.i386.rpm
   
   

3. Configure Jserv
   

   Add "Include /etc/httpd/conf/jserv/jserv.conf" to the end of the /etc/httpd/conf/httpd.conf file, change owner/group of /usr/logs to httpd:httpd and restart Apache by apachectl restart

4. Test operation of JServ
   

   use a web browser to go to http:///servlets/Hello

   A page should come up saying

   
   Example Apache JServ Servlet
   Congratulations, ApacheJServ 1.1 is working!
   
   

   from the same machine, you can open a browser to display the status of JServ at http://localhost/jserv

   If you want to check it from other systems, you must modify the permissions in the /etc/httpd/conf/jserv/jserv.conf file.

5. Install GnuJSP
   

   get from http://www.klomp.org/gnujsp/downloads/gnujsp-1.0.0.tar.gz and install by

   
   cd /usr/local; tar xzvf gnujsp-1.0.0.tar.gz
   cp /etc/httpd/conf/jserv/zone.properties /etc/httpd/conf/jserv/alph.properties
   
   

   In the alph.properties file, change the list of repositories to:

   
   repositories=/usr/local/gnujsp-1.0.0/lib/gnujsp10.jar
   repositories=/usr/local/gnujsp-1.0.0/lib/servlet-2.0-plus.jar
   
   

   and add these to the Servlet Aliases section:

   
   servlet.gnujsp.code=org.gjt.jsp.JspServlet
   servlet.gnujsp.initArgs=checkclass=true,pagebase=/home/httpd/html/,
   	scratchdir=/var/local/apache/jsp,debug=true,compiler=builtin-javac
   	-classpath %classpath%:%scratchdir%:
   	/usr/local/gnujsp-1.0.0/lib/servlet-2.0-plus.jar:
   	/usr/local/gnujsp-1.0.0/lib/gnujsp10.jar -d %scratchdir%
   	-deprecation %source%
   
   

   If using jikes, the initArgs line should read:

   
   servlet.gnujsp.initArgs=checkclass=true,pagebase=/home/httpd/html/,
   	scratchdir=/var/local/apache/jsp,debug=true,compiler=/usr/bin/jikes
   	-classpath %classpath%:%scratchdir%:
   	/usr/local/gnujsp-1.0.0/lib/servlet-2.0-plus.jar:
   	/usr/local/gnujsp-1.0.0/lib/gnujsp10.jar:/usr/local/jdk1.2.2/jre/lib/rt.jar
   	-d %scratchdir% -deprecation %source%
   
   

   If it isn't obvious, the servlet.gnujsp.initArgs lines are a single line, not multiple lines as above shown for clarity! Change the "zones=root" line in the jserv.properties file to include the newly create "alph" zone, e.g. zones=root,alph
   and add a line to point to the properties file such as alph.properties=/etc/httpd/conf/jserv/alph.properties

   add to the /etc/httpd/conf/jserv/jserv.conf file:

   
   ApJServAction .jsp /alph/gnujsp     
   ApJServMount /alph /alph
   
   

   Make sure that the log files and scratch directory selected exist. Also verify that all .jar files are where you said they are. Restart Apache by apachectl restart

6. Test operation of GnuJSP
   

   Copy the example files from the gnujsp/examples directory to a directory such as "myexamples" under your apache document root.

   in a browser, try bringing up a file such as http://yourhost/myexamples/hello.jsp

   You should get the Congratulations message. If you don't, go back and check the paths, syntax errors, etc.
   Unfortunately, the error logs are going to be fairly cryptic if you have a problem. Look at the jserv.log and mod_jserv.log files and you may get sufficient hints to correct any issues.