This section will lead you through installing my Java CGI package with copious explanations so that you know what the effects of your actions will be. If you just want to install the programs and don't care about the whys & wherefores, skip to Setting Up Your Server to Run Java CGI Programs (The Short Form).
This software should work on any unix-like web server that has the Java Development Kit installed. I am using it on a Debian Linux system running apache as the HTTP daemon. If you find that it does not run on your server, please contact the mailing list. See The Mailing List for details.
Unfortunatly, the Java run-time interpreter seems to be something of a memory hog -- you may want to throw another few megabytes of RAM onto your server if you will be using Java CGI programs a lot.
The software that I wrote to aid in this is called Java CGI. You can get it from ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz. (The version number may have changed.)
Find a convenient directory to unpack this package into.
(If you don't already have a standard place to put packages,
I suggest that you use
Unpack the distribution with this command:
gzip -dc java_cgi-0.5.tgz | tar -xvf -This will create a directory called
java_cgi-0.5. In there you will find the files referenced in the rest of this document. (If the version number has changed, use the instructions from within that distribution from this point on.)
You need to decide where you want your Java CGI
programs to live. Generally, you will want to put them in a directory in
parallel with your
cgi-bin directory. My apache
server came configured to use
/var/www/cgi-bin as the
cgi-bin directory, so I use
/var/www/javacgi as the
directory to put Java CGI programs in. You probably do not want to
put your Java CGI programs into one of the existing
Edit the Makefile to reflect your system configuration.
Make sure that you are logged in as the root user and run
This will compile the Java programs, modify the
to fit in with your system and install the programs in the appropriate
If you want the HTML version of this documentation and an HTML test document
in addition, run
make all instead.
Installed from the distribution are HTML documents called
If you installed
all in the previous section, it will be in the
directory you specified for WEBDIR in the
If you didn't, you can run
make test to build them from
When you are sure that your installation is working correctly, you may
wish to remove
your JAVACGI directory and
from your WEBDIR directory as they show the
user information that is normally only available to the server.