Configuring iASP on the Zeus Web Server Using Apache JServ

Before you can configure the Zeus Web server to run iASP, you must have the following items installed:

You will use the following files from Apache JServ distribution: 

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

Installing and Configuring JServ Files

The following instructions show how to configure JServ files needed to run iASP. These instructions use Apache JServ, version 1.0.

  1. Create a directory for JServ. (This example installs JServ in the /usr/local/jserv directory.) 
    $ mkdir /usr/local/jserv
  2. Change directories to the ApacheJServ directory.
    $ cd ApacheJServ-1.0
  3. Copy the ApacheJServ.jar file into your new jserv directory.
    $ cp src/java/ApacheJServ.jar /usr/local/jserv
  4. Make a configuration (conf) directory in your new directory.
    $ mkdir /usr/local/jserv/conf
  5. Copy the jserv.properties file into your new conf directory.
    $ cp conf/jserv.properties /usr/local/jserv/conf
  6. Copy the zone.properties file into your new conf directory.
    $ cp conf/zone.properties /usr/local/jserv/conf
  7. Change directories to your new jserv directory.
    $ cd /usr/local/jserv

  8. Using the conventions required by your environment, make the following changes to the /usr/local/conf/jserv.properties file:
    root.properties=/usr/local/jserv/conf/zone.properties
    log.file=/tmp/jserv.log

    This file contains various global settings for the JServ servlet runner.
  9. Using the conventions required by your environment, make the following changes to the /usr/local/conf/zone.properties file:
    repositories=/iasp/servlets
    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, refer to the JServ documentation on the JServ website. 

  10. Start up the JServ servlet runner.

    $ /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


    When JServ starts, the name and version number is printed to your screen:  

    ApacheJServ/1.0

    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 to /iasp/lib/jsdk.jar (if the Apache Jserv you are using is not support JSDK2.1).

  11. Configuring the Zeus Web Server

The following instructions show how to configure the Zeus Web Server to run your ASP applications with iASP.

  1. Using the Zeus administration server, click the Web icon to select or create a new webserver. This example uses the name "iasptest" for the new webserver.

  2. Select the New Server icon under Actions.

    zeus.gif (5127 bytes)

  3. Add the following information in the New Server window:

    Server Name:iasptest
    Server address:192.9.200.100:5000
    Document Root:/iasp
    Clone Server:default setting

  4. Click the Create Server button.

  5. Click the Edit icon in the Status window.

    zeus1.gif (4892 bytes)

  6. Select Module Configuration.

    zeus3.gif (23971 bytes)

  7. On the module configuration page, enable the Jserv module. (Click the red x to change it to a green check mark.)
    zeus2.gif (5905 bytes)

  8. Click the word "jserv" to get to the JServ configuration page.
  9. Click Add to add the default mount point for a virtual server to add Jserv support to.
    The defaults are setup to work with an out-of-the-box JServ configuration. URLs beginning with a prefix of "/jserv" will now cause the webserver to forward to request onto the JServ server.

  10. On the module configuration page, enable the URL to physical file mapping. (Click the red x to change it to a green check mark.)
  11. Click the word "map"
  12. Add the following under the Handler section:

    File extension: asp
    Handler: /jserv/Dispatcher.DispatcherServlet
  13. Click the Add button.

  14. Return to the traffic-light page and restart the virtual server so the configuration modifications take effect.

  15. Verify that Instant ASP is running correctly.

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


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