The Java Apache Project

How to install Apache JServ on UNIX systems

Requirements

The following requirements exist for building Apache JServ:

Choose how to add the mod_jserv module to Apache

There are two choices:

Configure Apache

If you are using a source distribution then you have to configure Apache first (some generated header files are needed for Apache JServ to pass its configure checks). You do not need to worry about specifying the mod_jserv module used to communicate to the servlet engine.

If you are using DSO then you can ignore this step. If you have a source distribution and would like to build it with DSO support and install it for use by Apache JServ then use the following options when configuring Apache:

--enable-rule=SHARED_CORE --enable-module=so

Configure Apache JServ

Now you are ready to configure Apache JServ. To do this you may (or may not) need to specify quite a few arguments to configure. These are:

Build

Once you have configured Apache JServ you can run make.

Run 'make install' to make a .jar file, and copy it and the docs into the directory you specified as --prefix.

If you are using an Apache source distribution then you also have to run 'make install' in the Apache source directory to build Apache with Apache JServ support in it.

You can see if Apache has loaded the mod_jserv module by executing 'httpd -l'.

Configuration Files

At this point, you must configure the Apache JServ directives for Apache. There are example configuration files in the conf and example directories that come with the Apache JServ package that help with this process. The files in the example directory will help you configure a default zone named "example" so that your URL's will look like this:

<http://www.yourserver.com/example/Hello>

There are three different types of configuration files for Apache JServ, the first one should be included in your httpd.conf file with the Apache "Include" directive. For example, in your httpd.conf file, you should have a line like this: "Include /path/to/jserv.conf".

Within your "jserv.conf" file, there is a line that gives the path to the second type of configuration file, the "jserv.properties" file. The line in the jserv.conf file looks like this: "ApJServProperties /path/to/jserv.properties".

Lastly, within the "jserv.properties" file is a line that points to your zone configuration file. If you have a zone called "example", then you will need to have an "example.properties" file and the location to this file is then defined with this line in your "jserv.properties" file: "example.properties=/path/to/file/example.properties"

You should make sure to edit all of these files and fill in the appropriate information according to the comments provided in each of the files. If you have questions about the definitions, you should consult the documentation in the docs directory, on the website, FAQ-O-Matic and/or the Users mailing list.

See the other howto's for info on setting up and running servlets.

Copyright (c) 1997-99 The Java Apache Project.
$Id: howto.unix_install.html,v 1.7 1999/06/09 05:21:28 jonbolt Exp $
All rights reserved.