JReceiver: Server Install - Jetty

Jetty

Jetty is a lean open-source Java-based web server and servlet container. Support for other 2.3 Servlet containers (such as Tomcat) is planned and may already work with the existing distribution binaries. If you get it running on Tomcat, let us know.

JReceiver-0.2.5 is known to work with the 4.2.9 release of Jetty. It'll probably work with newer versions of Jetty as well, so we refer to it generically as "Jetty-4.2.X" below.
Linux

Install Files

Download Jetty-4.2.X.tgz from here.

Extract the downloaded file and set up a symlink:

    cd /usr/local
    tar fvxz /download/Jetty-4.2.X.tgz
    ln -s Jetty-4.2.X jetty

Verify

To test your installation enter the following command:

    /usr/local/jetty/bin/jetty.sh
Jetty should start without complaint where you shouldn't see any error messages. Point your web browser at:
    http://localhost:8080

to ensure that Jetty is up and running in demo mode.

Any errors seen should be diagnosed and resolved before continuing. See the resources at the bottom of this page.

Windows

Install Files

Download Jetty-4.2.X.zip from here.

Extract the files (with folder names) from the .zip to

    C:\Program Files
All files will automatically be placed under a Jetty-4.2.X folder.

Configure Environment

Just as you did for JAVA_HOME earlier, add a environment variable to point to the Jetty install directory:

Variable Name Variable Value
JETTY_HOME C:\Program Files\Jetty-4.2.X

Be sure to change the Jetty version label (in bold) appropriately.

IMPORTANT: Be accurate in the case used. From Jetty's point of view, "Program Files" and "program files" are completely different. In particular, you will almost certainly find that your PC thinks of your C: drive as "C:", not "c:".

Verify

To test your installation, open a new Command Prompt and enter the following command:

    java -D"jetty.home=%JETTY_HOME%" -jar "%JETTY_HOME%\start.jar"

The quotes are necessary whenever there are spaces in the pathname.

Jetty should start without complaint where you shouldn't see any error messages. If a browser hasn't already popped up with the demo page, point your web browser at:

    http://localhost:8080

to ensure that Jetty is up and running in demo mode.

Any errors seen should be diagnosed and resolved before continuing. See the resources at the bottom of this page.

Tip: a common problem seems to be that Jetty only works if you run it in the cmd.exe shell, not command.com, not 4DOS, not 4NT... If you don't know what shell you're running, then chances are that you're in cmd.exe.

Jetty Troubleshooting Resources

Yahoo Group Forums: jetty-support and jetty-discuss.

Jetty Resources

NEXT STEP: [Install Server]


Copyright © 2001-2002, Reed Esau & the JReceiver Project (http://jreceiver.sourceforge.net), All Rights Reserved