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.
- Create a directory for JServ. (This example installs JServ in the
/usr/local/jserv directory.)
$ mkdir /usr/local/jserv
- Change directories to the ApacheJServ directory.
$ cd ApacheJServ-1.0
- Copy the ApacheJServ.jar file into your new jserv directory.
$ cp src/java/ApacheJServ.jar /usr/local/jserv
- Make a configuration (conf) directory in your new directory.
$ mkdir /usr/local/jserv/conf
- Copy the jserv.properties file into your new conf directory.
$ cp conf/jserv.properties /usr/local/jserv/conf
- Copy the zone.properties file into your new conf directory.
$ cp conf/zone.properties /usr/local/jserv/conf
- Change directories to your new jserv directory.
$ cd /usr/local/jserv
- 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.
- 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.
- 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).
-
Configuring the Zeus Web Server
The following instructions show how to configure the Zeus Web Server
to run your ASP applications with iASP.
- 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.
- Select the New Server icon under Actions.

-
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
-
Click the Create Server button.
-
Click the Edit icon in the Status window.

-
Select Module Configuration.

-
On the module configuration page, enable the Jserv module. (Click
the red x to change it to a green check mark.)

- Click the word "jserv" to get to the JServ configuration
page.
- 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.
- On the module configuration page, enable the URL to physical file
mapping. (Click the red x to change it to a green check mark.)
- Click the word "map"
- Add the following under the Handler section:
File extension: asp
Handler: /jserv/Dispatcher.DispatcherServlet
-
Click the Add button.
-
Return to the traffic-light page and restart the virtual server so
the configuration modifications take effect.
-
Verify that Instant ASP is running correctly.
If you encounter any problems or errors, please contact support@halcyonsoft.com
|