Difference between revisions of "Jetty/Howto/Run Jetty"

Revision as of 05:03, 31 July 2009

Introduction

This howto covers how to start up Jetty as standalone, and links to pages which cover alternative methods of startup.

Steps

Standalone Startup

Using the Start.jar

The easiest way to start jetty, is to use the start.jar that comes with the distribution.

 [jetty-distribution-7.0.0.M3]$ java -jar start.jar

Command Line Options

 $ java -jar start.jar --help
 Usage: java -jar start.jar [--help|--stop|--version|--dry-run|--list-options|--secure] [OPTIONS=option,...] [name=value ...] [config ...]

Command Line Option Help

--help

Help / Usage Information

--stop

Stop the actively running Jetty Server (started with a previous use of start.jar)

--version

Show the version information about Jetty

--secure

Enable Security: JVM Security Manager, Security Policies, Secure & Audit Logging

--dry-run

Print the command line that the start.jar generates, then exit.

--list-options

List available options, then exit.

OPTIONS=option,....

OPTIONS allows you to specify the jetty classpath entries that you want to use when starting up Jetty.

OPTIONS lets you specify which bits and pieces of Jetty you want to use.

Default OPTIONS set is "default,*

NOTE: the "*" Option is always appended to the OPTIONS list.

DEBUG=true

Enable verbose debug output

The exact JARs and classpath entries that will be activated for each option are listed in the Start Options reference .

Alternative Startup Techniques

Embedded Startup

Jetty can be configured and started as an embedded Web App Server from within another Java program. See Embedded Jetty for more details.

Eclipse Startup

Eclipse can be started up from within Eclipse using a variety of techniques, see Use Jetty with Eclipse IDE for details.

JUnit Startup