Apache::Wombat is a connector for the Wombat servlet engine that embeds the engine in an Apache web server built with mod_perl.
This guide will help you quickly get Wombat installed, configured and running for the purposes of demonstration. It is not a user manual for Wombat (one of those is forthcoming). It assumes intermediate to advanced knowledge of building and configuring Apache, mod_perl, and CPAN modules.
firstname.lastname@example.org mailing list and
send them to us.
The master versions of these documents are located at
Make sure you have at least version 5.6.0 of perl.
Make sure you have built mod_perl with Apache. Apache 1.3.0 is required. Any recent version of mod_perl will do). mod_perl must be built with the following hooks enabled:
Obviously the easy way is to build with EVERYTHING.
Install Apache::Wombat. This will catch all of the non-optional dependencies, including libservlet and Wombat (you will still have to install dependencies for optional components, such as DBI for DBIRealm, separately):
$ perl -MCPAN -e 'install Apache::Wombat'
The build process will ask you some questions about your installation preferences. You can simply hit enter to accept the defaults. You can also use '.' to refer to the current working directory (the directory from which you ran Makefile.PL) and '~' to refer to your home directory.
The below instructions assume you made the following choices:
wombat-webapps package into the webapps
directory you just specified.
$ cd /usr/local/apache/webapps $ lwp-download http://prdownloads.sourceforge.net/wombat/wombat-webapps.tar.gz $ tar xzvf wombat-webapps.tar.gz
Add an Include directive to
httpd.conf to include the
If you installed Apache::Wombat into a non-standard
location, add that location to
$PERL5LIB in your
$ export PERL5LIB=/where/my/libs/are:$PERL5LIB
Now you should be able to start Apache. You should see something like this printed to the console:
[Thu Oct 25 18:20:37 2001] [info]  Engine[Apache-Wombat]: StandardSessionManager started [Thu Oct 25 18:20:37 2001] [info]  Engine[Apache-Wombat]: ApacheConnector[Apache/mod_perl Connector]: Apache/mod_perl Connector started [Thu Oct 25 18:20:37 2001] [info]  Engine[Apache-Wombat]: ApacheConnector[Apache/mod_perl Connector]: Apache/mod_perl Connector started [Thu Oct 25 18:20:37 2001] [error]  Engine[Apache-Wombat]: Wombat/0.7.0 configured -- resuming normal operations
Point your browser at
/wombat-examples and begin viewing
At this point you can start customizing the configuration. For reference, use the following documents:
Use the Examples application as a template for your own
web.xml deployment descriptor located
WEB-INF application resource directory is
essential. Refer to the Java (TM) Servlet Specification for a
discussion of the contents of
web.xml and the Wombat man
page for a list of supported elements and features.
Good luck and have fun!