Jetty Debian Packages

Official debs

Beginning jetty-6.1.18, jetty6 will be available in the ubuntu repos.

Building the source

Checkout http://svn.codehaus.org/jetty-contrib/jetty-deb/trunk/
See README.txt

Binaries

libjetty6-java

• Jetty 6 core modules
• includes:
  jetty-util, jetty-util5, jetty, jetty-sslengine, jetty-start

libjetty6-extra-java

• Jetty 6 extra modules (depends: libjetty6-java)
• includes:
  jetty-management, jetty-naming, jetty-servlet-tester, jetty-ajp, jetty-java5-threadpool, jetty-client, jetty-rewrite-handler

jetty6

• The standalone http server (depends: libjetty6-java)
• includes:
  scripts, config files, docs

Installing

$ sudo apt-get install libjetty6-java
$ sudo apt-get install libjetty6-extra-java
$ sudo apt-get install jetty6

Starting

Edit /etc/default/jetty6
Set:
NO_START=0

Then do:
$ sudo service jetty6 start

Stopping

$ sudo service jetty6 stop

Symlinks

/usr/share/java/jetty6-ajp.jar -> ../jetty6/lib/ext/jetty-ajp-6.1.18.jar
/usr/share/java/jetty6-client.jar -> ../jetty6/lib/ext/jetty-client-6.1.18.jar
/usr/share/java/jetty6.jar -> ../jetty6/lib/jetty-6.1.18.jar
/usr/share/java/jetty6-java5-threadpool.jar -> ../jetty6/lib/ext/jetty-java5-threadpool-6.1.18.jar
/usr/share/java/jetty6-management.jar -> ../jetty6/lib/management/jetty-management-6.1.18.jar
/usr/share/java/jetty6-naming.jar -> ../jetty6/lib/naming/jetty-naming-6.1.18.jar
/usr/share/java/jetty6-rewrite-handler.jar -> ../jetty6/lib/ext/jetty-rewrite-handler-6.1.18.jar
/usr/share/java/jetty6-servlet-tester.jar -> ../jetty6/lib/ext/jetty-servlet-tester-6.1.18.jar
/usr/share/java/jetty6-sslengine.jar -> ../jetty6/lib/sslengine/jetty-sslengine-6.1.18.jar
/usr/share/java/jetty6-start.jar -> ../jetty6/start.jar
/usr/share/java/jetty6-util5.jar -> ../jetty6/lib/util5/jetty-util5-6.1.18.jar
/usr/share/java/jetty6-util.jar -> ../jetty6/lib/jetty-util-6.1.18.jar

Notes

Dependencies to add:
libslf4j-java

• Simple logging facade for java

Modules to add:
jetty-jsp-2.1

• glassfish jsp source + jetty-jsp source needs to be compiled/built to generate a separate deb package

jetty-plus

• geronimo-jta must be available as a deb package (build & runtime dependency)

Packages and Installation Order

Having downloaded all of the jetty debian packages, you should install them using dpkg or synaptic or your favourite package installer in this order, where <version> is replaced by the version of jetty you want to install:

• libjetty6-java_<version>_all.deb
• libjetty6-jsp-java_<version>_all.deb
• libjetty6-extra-java_<version>_all.deb
• jetty6_<version>_all.deb
• jetty6-examples_<version>_all.deb

Installation Directories

The home directory for the debian distribution of jetty is /usr/share/jetty6. Other directories under /var and /etc are linked to from the /usr/share/jetty6 directory.

The configuration of the server is in /etc/jetty6. The configuration files listed in /etc/jetty6/jetty.conf are passed to the command line when it is started by /etc/init.d/jetty6.

Webapps can be deployed by placing them in /var/lib/jetty6/webapps (linked from /usr/share/jetty6/webapps). Additional contexts can be configured and (hot) deployed via the /etc/jetty6/contexts directory (linked from /usr/share/jetty6/contexts).

/usr/share/jetty6                - jetty.home directory
                  /contexts       - webapp context files
                  /database       - default database install dir
                  /etc            - configuration files
                  /lib            - jar files
                  /logs           - log files
                  /resources      - extra runtime config
                  start.jar
                  /webapps        - webapp static deployment directory

/etc/init.d/jetty6      --> start/stop script
/etc/default/jetty6     --> default values read by start/stop script
/etc/jetty6             --> /usr/share/jetty6/etc
/etc/jetty6/contexts    -->  /usr/share/jetty6/contexts
/var/lib/webapps        --> /usr/share/jetty6/webapps
/var/log/jetty6         --> /usr/share/jetty6/logs
/var/run/jetty6.pid     --> running jetty process id

Starting/Stopping Jetty

If you have just installed the debian packages, then you will need to edit the /etc/default/jetty6 file. Make the change indicated in comment:

NO_START=1 # change to 0 to allow Jetty to start

You can now start jetty:

/etc/init.d/jetty6 start

To stop jetty:

/etc/init.d/jetty6 stop

You can list all of the commands to control jetty by typing:

/etc/init.d/jetty6 help