Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Jetty/Howto/Run Jetty"
(→Standalone Startup) |
(→Standalone Startup) |
||
| Line 26: | Line 26: | ||
:'''OPTIONS=option,....''' | :'''OPTIONS=option,....''' | ||
| − | :: OPTIONS allows you to specify the jetty | + | :: 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. | ||
| − | + | ::: Mode: '''*''' | |
| + | :::: Special mode for various required entries. (always present) | ||
| + | ::: Mode: '''All''' | ||
| + | :::: Special mode name that includes all resources found in the following other modes | ||
| + | ::: Mode: '''default''' | ||
| + | :::: Default mode of operation, includes dependencies to run the core Server with Servlet API, WebApp, Continuations, Deployment, Security, and a collection of useful Jetty Servlet Filters. (see [[Jetty/Servlets]] for more info) | ||
| + | :::: Also includes the /lib/ext/ and /resources/ folders into the classpath | ||
| + | ::: Mode: '''Server''' | ||
| + | :::: Similar to '''default'' mode, with the addition of being able to configure the Jetty Server via XML configurations, and removal of /lib/ext/ and /resources/ folders. | ||
| + | ::: Mode: '''ext''' | ||
| + | :::: A meta mode that simply adds the contents of the /lib/ext/ folder to the classpath. | ||
| + | ::: Mode: '''resources''' | ||
| + | :::: A meta mode that adds the /resources/ folder to the classpath. | ||
| + | ::: Mode: '''xml''' | ||
| + | :::: Adds XML Configuration Support. | ||
| + | ::: Mode: '''security''' | ||
| + | :::: Adds Authorization and Authentication Support. | ||
| + | ::: Mode: '''servlet''' | ||
| + | :::: Adds Servlet Support via a ServletContext and a DefaultServlet implementation. | ||
| + | ::: Mode: '''webapp''' | ||
| + | :::: Adds WebApp (WAR File) Support | ||
| + | ::: Mode: '''deploy''' | ||
| + | :::: Adds Context and WebApp (WAR File) Deployer support | ||
| + | ::: Mode: '''servlets''' | ||
| + | :::: Adds various useful Servlet Filters and Servlet Implementations (DoS, Gzip, Put, UserAgent, QoS, Multipart, Proxy, etc...) | ||
| + | ::: Mode: '''rewrite''' | ||
| + | :::: Adds jetty handler support for rewriting and redirecting requests based on rules. | ||
| + | ::: Mode: '''jmx''' | ||
| + | :::: Adds JMX Support | ||
| + | ::: Mode: '''ajp''' | ||
| + | :::: Adds Apache JServ Protocol version 1.3 Support | ||
| + | ::: Mode: '''slf4j''' | ||
| + | :::: Adds Simple Logging Facade for Java Support | ||
| + | ::: Mode: '''jsp''' | ||
| + | :::: Adds JSP Support | ||
| + | ::: Mode: '''jsp-2.1''' | ||
| + | :::: Adds JSP Support (Identical to '''jsp''' mode.) | ||
| + | ::: Mode: '''plus''' | ||
| + | :::: Adds JAAS and JNDI Support | ||
| + | ::: Mode: '''annotations''' | ||
| + | :::: Adds Java Annotations Support to WebApps and Servlets for configuring themselves | ||
| + | ::: Mode: '''client''' | ||
| + | :::: Adds the Jetty Async HTTP Client Support for Handlers, WebApps, and Servlets to use to initiate outgoing HTTP connections. | ||
| + | ::: Mode: '''policy''' | ||
| + | :::: Adds SecurityManager Policy Support. | ||
==Alternative Startup Techniques== | ==Alternative Startup Techniques== | ||
Revision as of 18:12, 1 July 2009
Contents
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] [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
- 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.
- Mode: *
- Special mode for various required entries. (always present)
- Mode: All
- Special mode name that includes all resources found in the following other modes
- Mode: default
- Default mode of operation, includes dependencies to run the core Server with Servlet API, WebApp, Continuations, Deployment, Security, and a collection of useful Jetty Servlet Filters. (see Jetty/Servlets for more info)
- Also includes the /lib/ext/ and /resources/ folders into the classpath
- Mode: Server
- Similar to 'default mode, with the addition of being able to configure the Jetty Server via XML configurations, and removal of /lib/ext/ and /resources/ folders.
- Mode: ext
- A meta mode that simply adds the contents of the /lib/ext/ folder to the classpath.
- Mode: resources
- A meta mode that adds the /resources/ folder to the classpath.
- Mode: xml
- Adds XML Configuration Support.
- Mode: security
- Adds Authorization and Authentication Support.
- Mode: servlet
- Adds Servlet Support via a ServletContext and a DefaultServlet implementation.
- Mode: webapp
- Adds WebApp (WAR File) Support
- Mode: deploy
- Adds Context and WebApp (WAR File) Deployer support
- Mode: servlets
- Adds various useful Servlet Filters and Servlet Implementations (DoS, Gzip, Put, UserAgent, QoS, Multipart, Proxy, etc...)
- Mode: rewrite
- Adds jetty handler support for rewriting and redirecting requests based on rules.
- Mode: jmx
- Adds JMX Support
- Mode: ajp
- Adds Apache JServ Protocol version 1.3 Support
- Mode: slf4j
- Adds Simple Logging Facade for Java Support
- Mode: jsp
- Adds JSP Support
- Mode: jsp-2.1
- Adds JSP Support (Identical to jsp mode.)
- Mode: plus
- Adds JAAS and JNDI Support
- Mode: annotations
- Adds Java Annotations Support to WebApps and Servlets for configuring themselves
- Mode: client
- Adds the Jetty Async HTTP Client Support for Handlers, WebApps, and Servlets to use to initiate outgoing HTTP connections.
- Mode: policy
- Adds SecurityManager Policy Support.
- Mode: *
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.