Jump to: navigation, search

Difference between revisions of "Jetty/Starting/Downloads"

(32 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
{{Jetty Starting
 
{{Jetty Starting
| introduction = The following provides quick start installation instructions for Jetty. You can download the latest Jetty core components directly from Eclipse, or you can follow the link to download older Jetty versions . This page also provides Jetty packaged for Linux distributions and Hightide.
+
| introduction = You can download Jetty as a distribution bundle, a Maven dependency, an OSGi bundle, or install it via a Debian/RPM distribution. When you download and unpack the binary, it is extracted into a directory called jetty-distribution-<var>VERSION</var>. Put this directory into a convenient location. The rest of the instructions in this wiki will refer to this location as either <tt>JETTY_HOME</tt> or as <tt>$(jetty.home)</tt>.
 +
 
 +
| prereqs =
 +
=== Hardware ===
 +
 
 +
* ~7 MB of disk space for Jetty source
 +
* ~7 MB for Jetty binaries
 +
 
 +
=== Operating System ===
 +
 
 +
* Any operating system that supports J2SE 1.5 or greater.
 +
 
 +
=== Environment ===
 +
 
 +
* J2SE 1.5 or [http://java.sun.com/javase/downloads/index.jsp greater]
  
 
| body =  
 
| body =  
== Downloading Jetty ==
+
== Jetty@eclipse Download==
=== Jetty Releases from Eclipse ===
+
*[http://download.eclipse.org/jetty/ Eclipse Downloads]
Jetty 7 and later core components have moved to Eclipse.  Some accessories (maven-plugin rpms, debs, hightide) will still be available from codehaus.  Jetty 7 version numbers use four digits; the last digit may differ between Eclipse and codehaus. 
+
** Core Jetty Web Server (HTTP & Websocket)
 +
** Core Jetty Servlet Container
 +
** JNDI, JMX, OSGi, JASPI modules
 +
** HTTP Client
  
An example of versioning: for jetty-server-7.0.0.X in the org.eclipse.jetty packages, there could be several matching releases of jetty-maven-plugin-7.0.0.jetty-maven-plugin-7.0.0.y+1 from the org.mortbay packages.
+
<source lang="bash">
 +
JETTY_VERSION=7.5.0.v20110901
 +
wget http://download.eclipse.org/jetty/$JETTY_VERSION/dist/jetty-distribution-$JETTY_VERSION.tar.gz
 +
tar xfz jetty-distribution-$JETTY_VERSION.tar.gz
 +
cd jetty-distribution-$JETTY_VERSION
 +
java -jar start.jar
 +
</source>
  
* [http://www.eclipse.org/jetty/downloads.php Eclipse Downloads] (core components)
+
== Jetty@codehaus Download==
* [http://dist.codehaus.org/jetty/ Codehaus Downloads] (some integrations and accessories)
+
*[http://dist.codehaus.org/jetty/ Codehaus Downloads]:
 +
** Hightide Application Server (Jetty WebServer plus EE features)
 +
** Jetty with non-eclipse modules: JSP, Spring, Terracotta, Openspaces, etc.
 +
** Jetty Maven plugin
 +
** Debian, RPM distributions
 +
** Older Jetty releases
  
=== Older Jetty Releases from codehaus ===
+
<source lang="bash">
 +
wget http://dist.codehaus.org/jetty/jetty-hightide-8.0.0/jetty-hightide-8.0.0.v20110901.tar.gz
 +
tar xfz jetty-hightide-8.0.0.v20110901.tar.gz
 +
cd jetty-hightide-8.0.0.v20110901
 +
java -jar start.jar
 +
</source>
  
Older Jetty releases can be downloaded by following the instructions on the [http://docs.codehaus.org/display/JETTY/Downloading+Jetty#DownloadingJetty-download codehaus wiki page]
+
== Maven Repositories ==
 +
The distribution bundles from both Eclipse and Codehaus are available as Maven artefacts:
 +
* [http://repo2.maven.org/maven2/org/eclipse/jetty/jetty-distribution/ jetty@eclipse] ([http://oss.sonatype.org/content/groups/jetty/org/eclipse/jetty/jetty-distribution/ snapshots])
 +
* [http://repo2.maven.org/maven2/org/mortbay/jetty/jetty-hightide/ jetty@codehaus] ([http://oss.sonatype.org/content/groups/jetty/org/mortbay/jetty/jetty-hightide/ snapshots])
  
=== Maven Repositories ===
+
The individual Jetty modules are also available as Maven artefacts under the [http://repo2.maven.org/maven2/org/eclipse/jetty org.eclipse.jetty] and [http://repo2.maven.org/maven2/org/mortbay/jetty org.mortbay.jetty] group IDs. See [[Jetty/Howto/Use Jetty with Maven]] for more details.
  
* [http://repository.codehaus.org/ public Maven 2 releases] (org.eclipse.jetty)
+
== OSGi Update Repositories ==
* [http://oss.sonatype.org/content/groups/jetty/ public snapshots] (org.eclipse.jetty)
+
Jetty is available as OSGi bundles from P2 update sites: [http://download.eclipse.org/jetty/updates/jetty-bundles-7.x/ Jetty 7.x P2 Update] and [http://download.eclipse.org/jetty/updates/jetty-bundles-8.x Jetty 8.x P2 Update].
  
=== Linux Distributions ===
 
  
* [http://docs.codehaus.org/display/JETTY/Using+the+Jetty+RPMs Jetty RPMs]
+
== Source Download ==
* [http://docs.codehaus.org/display/JETTY/Debian+Packages Jetty Debian Packages]
+
  
===  Hightide Releases ===
+
Each jetty module has an equivalent jar containing the sources for that module. These sources jars have the same name as the binary jar, but with a "-sources" qualifier. These can be found on the maven repository at http://repo2.maven.org/maven2/org/eclipse/jetty in the relevant jetty module directories.
  
[http://docs.codehaus.org/display/JETTY/Hightide+Documentation Hightide] is a release of Jetty bundled with JNDI, JTA, JMS, and other EE technologies.
+
Additionally, we provide some handy binary and source jars that contain a useful mixture of classes. The list of these aggregate jars is at http://repo1.maven.org/maven2/org/eclipse/jetty/aggregate/.
* [http://www.webtide.com/resources/downloads.jsp Download for Jetty Hightide releases].
+
  
=== Other ===
+
== Linux Distributions ==
  
* [http://www.webtide.com/eclipse Jetty Eclipse plugin download site]
+
* Debs:  http://central.maven.org/maven2/org/mortbay/jetty/dist/jetty-deb/
 +
* RPMs:  http://central.maven.org/maven2/org/mortbay/jetty/dist/jetty-rpm/
  
== Versions ==
+
=== Distribution Contents ===
  
Versions are described in the [http://dev.eclipse.org/svnroot/rt/org.eclipse.jetty/jetty/trunk/VERSION.txt Jetty 7 Changelog].
+
Here's a quick rundown of the distribution's contents. The top-level directory contains:
  
{{:Jetty/Getting Started/Jetty Version Comparison Table
+
* LICENSE-APACHE-2.0.TXT : license file for Jetty (Jetty 7 is dual-licensed)
| hidetitle=true}}
+
* LICENSE-ECLIPSE-1.0.HTML : license file for Jetty (Jetty 7 is dual-licensed)
 +
* META-INF : for packaging
 +
* README.txt : contains useful getting started information
 +
* VERSION.txt : Release information 
 +
* about.html : "About This Content" page from Eclipse
 +
* bin : utility shell scripts to help run Jetty on unix systems
 +
* contexts : hot deploy contexts directory
 +
* etc : directory for Jetty configuration files
 +
* javadoc : contains the javadoc
 +
* lib : contains all the JAR files necessary to run jetty
 +
* logs : directory for request logs
 +
* notice.html : licenses information and exceptions.
 +
* resources : directory containing additional resources for classpath
 +
* start.ini : Default start arguments
 +
* start.jar : JAR which invokes jetty-7 (see also [[Jetty/Howto/Run Jetty|How to Run Jetty]])
 +
* webapps : directory containing webapps which will be run under the default configuration of Jetty; contains demo webapps
  
You can also see [http://docs.codehaus.org/display/JETTY/Downloading+Jetty#DownloadingJetty-Versions the comparison table for earlier version of Jetty].
+
=== Starting and Stopping ===
  
== Licenses ==
+
To start:
  
Jetty 7 is [http://eclipse.org/jetty/licenses.php dual-licensed] under the Apache License 2.0 and Eclipse Public License 1.0.
+
<source lang="bash">
 +
/etc/init.d/jetty start
 +
</source>
  
== Installing Jetty ==
+
To stop:
 +
 
 +
<source lang="bash">
 +
/etc/init.d/jetty stop
 +
</source>
 +
 
 +
Other commands:
 +
 
 +
<source lang="bash">
 +
/etc/init.d/jetty help
 +
</source>
 +
 
 +
==== Using setuid ====
 +
 
 +
When using the [[Jetty/Howto/Port80#Configuring_Jetty.27s_SetUID_feature | setuid feature]] you need to ensure that the $JETTY_HOME/etc/jetty-setuid.xml file is first on the list of xml files to execute. To do this, edit the $JETTY_HOME/etc/jetty.conf file and insert the line "--pre=etc/jetty-setuid.xml" before "--pre=etc/jetty-logging.xml". Like this:
 +
 
 +
<source lang="bash">
 +
# ========================================================
 +
# jetty.conf Configuration for jetty.sh script
 +
# --------------------------------------------------------
 +
# This file is used by the jetty.sh script to provide
 +
# extra configuration arguments for the start.jar command
 +
# created by that script.
 +
#
 +
# Each line in this file becomes an argument to start.jar
 +
# unless this file contains an --ini option, then these
 +
# arguments will be in addition to those found in the
 +
# start.ini file
 +
# =======================================================
 +
--pre=etc/jetty-setuid.xml
 +
--pre=etc/jetty-logging.xml
 +
</source>
 +
 
 +
 
 +
=== Old Jetty-6 Linux distros ===
 +
* [http://docs.codehaus.org/display/JETTY/Using+the+Jetty+RPMs Jetty RPMs]
 +
* [http://docs.codehaus.org/display/JETTY/Debian+Packages Jetty Debian Packages]
  
Please see the [[Jetty/Getting Started/Quick Start Guide|Quick Start Guide]] for installing binary versions of Jetty. For installing other versions please see [[Jetty/Getting Started/Quick Start Guide#Installation Instructions for Other Versions|Installation Instructions for other Versions]].
 
 
}}
 
}}

Revision as of 22:10, 25 September 2012


Introduction

You can download Jetty as a distribution bundle, a Maven dependency, an OSGi bundle, or install it via a Debian/RPM distribution. When you download and unpack the binary, it is extracted into a directory called jetty-distribution-VERSION. Put this directory into a convenient location. The rest of the instructions in this wiki will refer to this location as either JETTY_HOME or as $(jetty.home).

Jetty@eclipse Download

  • Eclipse Downloads
    • Core Jetty Web Server (HTTP & Websocket)
    • Core Jetty Servlet Container
    • JNDI, JMX, OSGi, JASPI modules
    • HTTP Client
JETTY_VERSION=7.5.0.v20110901
wget http://download.eclipse.org/jetty/$JETTY_VERSION/dist/jetty-distribution-$JETTY_VERSION.tar.gz
tar xfz jetty-distribution-$JETTY_VERSION.tar.gz
cd jetty-distribution-$JETTY_VERSION
java -jar start.jar

Jetty@codehaus Download

  • Codehaus Downloads:
    • Hightide Application Server (Jetty WebServer plus EE features)
    • Jetty with non-eclipse modules: JSP, Spring, Terracotta, Openspaces, etc.
    • Jetty Maven plugin
    • Debian, RPM distributions
    • Older Jetty releases
wget http://dist.codehaus.org/jetty/jetty-hightide-8.0.0/jetty-hightide-8.0.0.v20110901.tar.gz
tar xfz jetty-hightide-8.0.0.v20110901.tar.gz
cd jetty-hightide-8.0.0.v20110901
java -jar start.jar

Maven Repositories

The distribution bundles from both Eclipse and Codehaus are available as Maven artefacts:

The individual Jetty modules are also available as Maven artefacts under the org.eclipse.jetty and org.mortbay.jetty group IDs. See Jetty/Howto/Use Jetty with Maven for more details.

OSGi Update Repositories

Jetty is available as OSGi bundles from P2 update sites: Jetty 7.x P2 Update and Jetty 8.x P2 Update.


Source Download

Each jetty module has an equivalent jar containing the sources for that module. These sources jars have the same name as the binary jar, but with a "-sources" qualifier. These can be found on the maven repository at http://repo2.maven.org/maven2/org/eclipse/jetty in the relevant jetty module directories.

Additionally, we provide some handy binary and source jars that contain a useful mixture of classes. The list of these aggregate jars is at http://repo1.maven.org/maven2/org/eclipse/jetty/aggregate/.

Linux Distributions

Distribution Contents

Here's a quick rundown of the distribution's contents. The top-level directory contains:

  • LICENSE-APACHE-2.0.TXT : license file for Jetty (Jetty 7 is dual-licensed)
  • LICENSE-ECLIPSE-1.0.HTML : license file for Jetty (Jetty 7 is dual-licensed)
  • META-INF : for packaging
  • README.txt : contains useful getting started information
  • VERSION.txt : Release information
  • about.html : "About This Content" page from Eclipse
  • bin : utility shell scripts to help run Jetty on unix systems
  • contexts : hot deploy contexts directory
  • etc : directory for Jetty configuration files
  • javadoc : contains the javadoc
  • lib : contains all the JAR files necessary to run jetty
  • logs : directory for request logs
  • notice.html : licenses information and exceptions.
  • resources : directory containing additional resources for classpath
  • start.ini : Default start arguments
  • start.jar : JAR which invokes jetty-7 (see also How to Run Jetty)
  • webapps : directory containing webapps which will be run under the default configuration of Jetty; contains demo webapps

Starting and Stopping

To start:

/etc/init.d/jetty start

To stop:

/etc/init.d/jetty stop

Other commands:

/etc/init.d/jetty help

Using setuid

When using the setuid feature you need to ensure that the $JETTY_HOME/etc/jetty-setuid.xml file is first on the list of xml files to execute. To do this, edit the $JETTY_HOME/etc/jetty.conf file and insert the line "--pre=etc/jetty-setuid.xml" before "--pre=etc/jetty-logging.xml". Like this:

# ========================================================
# jetty.conf Configuration for jetty.sh script
# --------------------------------------------------------
# This file is used by the jetty.sh script to provide 
# extra configuration arguments for the start.jar command
# created by that script.
# 
# Each line in this file becomes an argument to start.jar
# unless this file contains an --ini option, then these
# arguments will be in addition to those found in the
# start.ini file
# =======================================================
--pre=etc/jetty-setuid.xml
--pre=etc/jetty-logging.xml


Old Jetty-6 Linux distros