Instant ASP Logo


Configuring iASP on Zeus Web Server with Apache JServ

  1. If you haven't installed Apache JServ, you need to download it from http://java.apache.org. The Version used in this tutorial is 1.0. 

  2. Make sure you have a Java Runtime Environment. i.e. that you can run Java programs on your machine! JREs for many platforms are freely available from: http://java.sun.com/cgi-bin/java-ports.cgi 

  3. Make sure you have a copy of Sun's Java Servlet Development Kit v2.0, freely available from:
    http://java.sun.com/products/servlet/index.html. The version of JServ used in this tutorial needed exactly the 2.0 version. 

  4. The only files you need from Apache JServ distribution are: 

    ApacheJServ-1.0/src/java/ApacheJServ.jar
    ApacheJServ-1.0/conf/jserv.properties
    ApacheJServ-1.0/conf/zone.properties

    We are going to install JServ in /usr/local/jserv in this example: 

    $ mkdir /usr/local/jserv
    $ cd ApacheJServ-1.0
    $ cp src/java/ApacheJServ.jar /usr/local/jserv
    $ mkdir /usr/local/jserv/conf
    $ cp conf/jserv.properties /usr/local/jserv/conf
    $ cp conf/zone.properties /usr/local/jserv/conf

  5. Now we need to edit the config files we have put in /usr/local/jserv/conf. 

    First, edit jserv.properties. This file contains various global settings for the JServ servlet runner. You may need to alter the settings in here to suit your environment. 

    E.g. in this example, the only alterations we made were:

    alter
    root.properties=... 
    to
    root.properties=/usr/local/jserv/conf/zone.properties

    and
    log.file=... 
    to
    log.file=/tmp/jserv.log

    Now edit zone.properties. This zone file defines settings for all the servlets in a particular zone, such as where the servlets should be found on disk. JServ can be setup to run with multiple zones, generally you have one per virtual server. In this example, we only have one zone defined in the jserv.properties file called "root", and we have set the "root.properties" value to point to the zone.properties file we are now editing. For more information on zones, check out the JServ documentation on the JServ website. 

    In our example, all we are going to do to the zone.properties file is alter the repositories line to define where our servlets will live on disk. (/usr/local/jserv/servlets in our case). 

    So we set
    repositories=/iasp/servlets

  6. We are now ready to start up the JServ servlet runner. The servlet runner is started independently of Zeus Server. JServ need not be run on the same machine as the webserver, as Zeus can communicate with JServ over the network. In our example, we have the Java Runtime Environment installed in /usr/java, so the Java interpreter is accessed as /usr/java/bin/java. We have also copied the "jsdk.jar" file from Sun's Java Servlet Development kit you downloaded in step 2, to /iasp/lib/jsdk.jar.(if Apache Jserv you are using is not support JSDK2.1.)

    $ cd /usr/local/jserv
    $ /usr/java/bin/java -classpath=/usr/java/lib/classes.zip:/iasp/servlets:/iasp/lib/classes:/iasp/lib/activation.jar:/iasp/lib/iasplib.jar:/iasp/lib/buttons.jar:
    /iasp/lib/jsdk.jar:/iasp/lib/rjax.jar:/iasp/lib/ejbcorba.jar:/iasp/lib/iasp_image.jar:/iasp/lib/iasp_sock.jar:
    /iasp/lib/iasp_mail.jar:/iasp/lib/iasp_chart.jar:/iasp/lib/iasp_pop3.jar:/iasp/lib/iasp_exec.jar:jsdk.jar:ApacheJServ.jar  org.apache.jserv.JServ conf/jserv.properties

    JServ should now startup, and print out a version number. 

    ApacheJServ/1.0

    To run the program in the background, you should append a "&" on the end of the command above.

  7. Now JServ is setup and running, we can now configure Zeus Webserver to communicate with it. 
  1. Verify that Instant ASP is running correctly by pointing your web browser at

    http://<hostname:portnumber>/

  2. Choose the "Hello World" sample from the General samples link in the left-hand pane.

  3. You will see several lines displaying the phrase "Hello World" in increasing font sizes.

 

If you encounter any problems or errors, please contact support@halcyonsoft.com


Copyright © 1998-2000, Halcyon Software Inc. All rights reserved.