Difference between revisions of "Jetty/Starting/Downloads"

From Eclipsepedia

Jump to: navigation, search
(39 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Jetty}}
+
{{Jetty Starting
 +
| 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>.
  
== Downloading Jetty ==
+
| prereqs =
 +
=== Hardware ===
  
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.
+
* ~7 MB of disk space for Jetty source
 +
* ~7 MB for Jetty binaries
  
=== Jetty Releases from Eclipse ===
+
=== Operating System ===
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. 
+
  
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.y  jetty-maven-plugin-7.0.0.y+1 from the org.mortbay packages.
+
* Any operating system that supports J2SE 1.5 or greater.
  
* [http://www.eclipse.org/jetty/downloads.php Eclipse Downloads] (core components)
+
=== Environment ===
* [http://dist.codehaus.org/jetty/ Codehaus Downloads] (some integrations and accessories)
+
  
=== Older Jetty Releases from codehaus ===
+
* J2SE 1.5 or [http://java.sun.com/javase/downloads/index.jsp greater]
  
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]
+
| body =
 +
== Jetty@eclipse Download==
 +
*[http://download.eclipse.org/jetty/ Eclipse Downloads]
 +
** Core Jetty Web Server (HTTP & Websocket)
 +
** Core Jetty Servlet Container
 +
** JNDI, JMX, OSGi, JASPI modules
 +
** HTTP Client
  
=== Maven Repositories ===
+
<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://repository.codehaus.org/ public Maven 2 releases] (org.eclipse.jetty)
+
== Jetty@codehaus Download==
* [http://oss.sonatype.org/content/groups/jetty/ public snapshots] (org.eclipse.jetty)
+
*[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
  
=== Linux Distributions ===
+
<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>
  
* [http://docs.codehaus.org/display/JETTY/Using+the+Jetty+RPMs Jetty RPMs]
+
== Maven Repositories ==
* [http://docs.codehaus.org/display/JETTY/Debian+Packages Jetty Debian Packages]
+
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])
  
===  Hightide Releases ===
+
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://docs.codehaus.org/display/JETTY/Hightide+Documentation Hightide] is a release of Jetty bundled with JNDI, JTA, JMS, and other EE technologies.
+
== OSGi Update Repositories ==
* [http://www.webtide.com/resources/downloads.jsp Download for Jetty Hightide releases].
+
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].
  
=== Other ===
 
  
* [http://www.webtide.com/eclipse Jetty Eclipse plugin download site]
+
== Source Download ==
  
== Versions ==
+
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.
  
Versions are described in the [http://dev.eclipse.org/svnroot/rt/org.eclipse.jetty/jetty/trunk/VERSION.txt Jetty 7 Changelog].
+
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/.
  
{{:Jetty/Getting Started/Jetty Version Comparison Table
+
== Linux Distributions ==
| hidetitle=true}}
+
  
You can also see [http://docs.codehaus.org/display/JETTY/Downloading+Jetty#DownloadingJetty-Versions the comparison table for earlier version of Jetty].
+
* Debs:  http://central.maven.org/maven2/org/mortbay/jetty/dist/jetty-deb/
 +
* RPMs:  http://central.maven.org/maven2/org/mortbay/jetty/dist/jetty-rpm/
  
== Licenses ==
+
=== Distribution Contents ===
  
Jetty 7 is [http://eclipse.org/jetty/licenses.php dual-licensed] under the Apache License 2.0 and Eclipse Public License 1.0.
+
Here's a quick rundown of the distribution's contents. The top-level directory contains:
  
== Additional Resources ==
+
* 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 [[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
 +
 
 +
=== Starting and Stopping ===
 +
 
 +
To start:
 +
 
 +
<source lang="bash">
 +
/etc/init.d/jetty start
 +
</source>
 +
 
 +
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]
  
* [[Jetty/Getting Started/Quick Start Guide|Quick Start Guide]]
+
}}

Revision as of 23:10, 25 September 2012


Contents

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