Home Contact Us Search

[ Order a Server ] [ Server Support ]


[ Getting Started ] [ Server Help ] [ Add on Help ] [ Solution ] [ Trouble Shooting ]

PLEASE NOTE, THIS IS VERY OLD ARCHIVE INFORMATION AND MAY NOT FUNCTION ON NEW SERVERS

[ DNS ] [ Email ] [ Server Admin ] [ Web Server ]

mod_jserv Dynamic Module

The mod_jserv Dynamic Module is a 100% pure Java servlet engine fully compliant with the JavaSoft Java Servlet API 2.0 specification.

NOTE: Only the latest version of our Apache Web Server includes mod_jserv Dynamic Module support.

NOTE: The Java servlet engine can be very memory intensive. For this reason it is recommended that it be used on a Virtual Server C or larger.

Installation

Connect to your Virtual Server via Telnet or SSH and do the following.

  1. Issue the command below that matches your Virtual Server O/S to install the mod_jserv software. 

    
FreeBSD
% vinstall mod_jserv

    NOTE: If your Virtual Server was ordered after Nov 22, 1999, you are likely running FreeBSD. To find out which O/S your Virtual Server is running, use the uname command: 

    % uname

    If your Virtual Server is not already running FreeBSD, Upgrade to a New FreeBSD Virtual Server today!

  2. Using your favorite UNIX editor find the following line in your ~/www/conf/httpd.conf file and uncomment it to enable mod_jserv. To uncomment the line, remove the "#" character. 

    #LoadModule jserv_module /usr/local/etc/httpd/modules/mod_jserv.so

  3. Finally, run "restart_apache" to reload your configuration file. 

    % restart_apache

Is mod_jserv Running?

At this point, if you run the top program you should see the Java servlet engine running. The output to top will look something like this. The line with the COMMAND java is the Java servlet engine. 

last pid: 24593;  load averages:  0.00,  0.01,  0.00   up 10+04:48:51  20:10:25
11 processes:  1 running, 10 sleeping
CPU states:  0.4% user,  0.0% nice,  1.5% system,  0.0% interrupt, 98.1% idle
Mem: 18M Active, 160M Inact, 24M Wired, 6304K Cache, 8273K Buf, 29M Free
Swap: 512M Total, 512M Free

  PID USERNAME PRI NICE  SIZE    RES STATE  C   TIME   WCPU    CPU COMMAND
24593 biff      28   0  1500K   720K CPU1   1   0:00  3.08%  0.29% top
24192 biff      18   0 20676K  3240K pause  0   0:47  0.00%  0.00% java
24185 biff      10   0  2108K  1300K nanslp 1   0:01  0.00%  0.00% httpsd
24181 biff      18   0  2156K  1384K pause  0   0:00  0.00%  0.00% httpsd
24590 biff      18   0  1304K   964K pause  0   0:00  0.00%  0.00% tcsh

You can also check to see if the Java servlet engine is running by trying this URL.

http://YOUR-DOMAIN.NAME/servlet/Hello

If you see the following message in your browser then it is installed and running correctly.

Example Apache JServ Servlet

Congratulations, ApacheJServ 1.1 is working!

If you don't get the above message then check your error_log file and try enabling Apache Jserv logging by editing the following line in your ~/www/conf/jserv/jserv.properties file to read true instead of false. 

log=false

You may also try adding the "Debug log channel" by adding the following to your jserv.properties file. 

log.channel.debug=true

NOTE: Logging can be a very expensive operation in terms of performance. You should turn logging off as soon as you correct the problem you are diagnosing.

More Information

For more information, see:

[ DNS ] [ Email ] [ Server Admin ] [ Web Server ]

PLEASE NOTE, THIS IS OLD ARCHIVE INFORMATION AND MAY NOT FUNCTION ON NEW SERVERS