Difference between revisions of "Hudson-ci/Using Hudson/Installing Hudson"

From Eclipsepedia

Jump to: navigation, search
 
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:hudson|pageTitle=Installing Hudson}}
+
{{Template:hudson|pageTitle=Installing Hudson}}  
== Prerequisites ==
+
  
Hudson only needs a Java 5 or newer runtime.
+
== Distributions ==
 +
Hudson can be downloaded from both [http://www.eclipse.org/hudson/download.php eclipse.org] and [http://hudson-ci.org hudson-ci.org]. More information about the available distributions can be found [http://wiki.eclipse.org/Hudson-ci/development/releaseartifacts here].
  
== WAR file ==
 
  
After you download [http://www.eclipse.org/hudson|hudson.war], you can launch it by executing {{Template:code|java -jar hudson.war}}. This is mostly useful for testing purposes. For production we recommend using native packages for simplified install or deployment in a servlet container that supports Servlet 2.4/JSP 2.0 or later, such as Glassfish, Tomcat 5, JBoss, Jetty 6, etc. See [[#Containers]] for more about container-specific installation instruction.
+
== Prerequisites  ==
  
Once the war file is exploded, run {{chmod 755 hudson}} in the exploded {{hudson/WEB-INF}} directory so that you can execute this shell script.
+
Hudson only needs a Java 6 or newer runtime. An internet connection will be required if you want to be able to install and auto-update plug-ins.
  
== Unix/Linux Installation ==
 
  
The Hudson project provides native packages for various Linux distributions. These are the simplest way to run Hudson in production, since the packages set up user, service and all other configuration as well as integrate with the native upgrade mechanism of the operating system.
+
== WAR file  ==
  
* [[Hudson-ci/Installing_Hudson_on_Ubuntu|Installing Hudson on Ubuntu]]
+
After you download [http://www.eclipse.org/hudson/download.php hudson.war], you can launch it by executing {{Template:code|java -jar hudson.war}}. This is mostly useful for testing purposes. For production we recommend using native packages for simplified install or deployment in a servlet container that supports Servlet 2.4/JSP 2.0 or later, such as Glassfish, Tomcat 5, JBoss, Jetty 6, etc. See [[Hudson-ci/Containers|Containers]] for more about container-specific installation instruction.
* [[Hudson-ci/Installing_Hudson_on_Debian|Installing Hudson on Debian]]
+
* [[Hudson-ci/Installing_Hudson_on_Oracle_Linux|Installing Hudson on Oracle Enterprise Linux]]
+
* [[Hudson-ci/Installing_Hudson_on_Red_Hat|Installing Hudson on Red Hat Enterprise Linux]]
+
* [[Hudson-ci/Installing_Hudson_on_CentOS|Installing Hudson on CentOS]]
+
* [[Hudson-ci/Installing_Hudson_on_Fedora|Installing Hudson on Fedora]]
+
* [[[[Hudson-ci/Installing_Hudson_on_openSUSE|Installing Hudson on openSUSE]]
+
  
For other operating systems check out the following pages for help.
+
Once the war file is exploded, run {{Template:code|chmod 755 hudson}} in the exploded {{Template:path|hudson/WEB-INF}} directory so that you can execute this shell script.
  
* [Installing Hudson as a Unix daemon]
+
== Unix/Linux Installation  ==
* [Installing Hudson on OpenSolaris]
+
* [Installing Hudson on Gentoo]
+
* [FreeBSD]
+
* [FreeBSD 4|FreeBSD 4.9]
+
* [Installing Hudson as Solaris 10 service|http://pauloswald.com/blog/article/29/hudson-solaris-smf-manifest]
+
* [Installing Hudson as a Unix daemon] if your flavor of Unix isn't any of the ones above.
+
  
Alternatively, if you have a servlet container that supports Servlet 2.4/JSP 2.0, such as Glassfish v2, Tomcat 5 (or any later versions), ou can run them as services, and deploy {{hudson.war}} as you would any other war file. [Container specific|Containers] documentation is available if you choose this route.
+
The Hudson project provides native packages for various Linux distributions. These are the simplest way to run Hudson in production, since the packages set up user, service and all other configuration as well as integrate with the native upgrade mechanism of the operating system.  
[_Top of page_|#top]
+
  
h1. Windows Installation
+
*[[Hudson-ci/Installing Hudson DEB|Installing Hudson on Ubuntu and Debian]]
 +
*[[Hudson-ci/Installing Hudson RPM|Installing Hudson on Oracle Enterprise Linux, RedHat, CentOS & Fedora ]]
 +
*[[Hudson-ci/Installing Hudson SUSE|Installing Hudson on openSUSE]]
  
If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. The easiest way is follow [Installing Hudson as a Windows service]. Alternatively, you can install a servlet container like GlassFish and Tomcat, which can run as a service by itself, and then deploy Hudson to it.
+
For other operating systems check out the following pages for help.  
  
Since Hudson was written to work on unix-like platforms, some parts assume the presence of unix-utilities. It is advised to install these as well on Windows. Install [UnxUtils|http://unxutils.sourceforge.net/] (this includes a shell that seems to work with forward and backwards slashes and does globbing correctly), put it in the Windows {{PATH}}, and copy {{sh.exe}} to {{C:\bin\sh.exe}} (or whichever drive you use) to make shebang lines work. This should get you going.
+
*[[Hudson-ci/Installing Hudson Unix Daemon|Installing Hudson as a Unix daemon]]
 +
*[[Hudson-ci/Installing Hudson Gentoo|Installing Hudson on Gentoo]]
 +
*[[Hudson-ci/Installing Hudson FreeBSD]]
 +
*[http://pauloswald.com/blog/article/29/hudson-solaris-smf-manifest Installing Hudson as Solaris 10 service]
  
If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. One way is to first install Tomcat as a service and then deploy Hudson to it in the usual way.  Another way is to use the [Java Service Wrapper|http://wrapper.tanukisoftware.org/doc/english/introduction.html]. However, there may be problems using the service wrapper, because the Main class in Hudson in the default namespace conflicts with the service wrapper main class. Deploying inside a service container (Tomcat, Jetty, etc.) is probably more straightforward, even for developers without experience with such containers.
+
Alternatively, if you have a servlet container that supports Servlet 2.4/JSP 2.0, such as Glassfish v2, Tomcat 5 (or any later versions), you can run them as services, and deploy '''hudson.war''' as you would any other war file. [[Hudson-ci/Containers|Containers]] documentation is available if you choose this route.
* [Installing Hudson as a Windows service]
+
  
[_Top of page_|#top]
+
== Windows Installation  ==
  
h1. Case Studies
+
If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. The easiest way is follow [[Hudson-ci/Installing Hudson Windows Service|Installing Hudson as a Windows service]]. Alternatively, you can install a servlet container like GlassFish and Tomcat, which can run as a service by itself, and then deploy Hudson to it.  
  
Also, see how other people are deploying Hudson to get some idea of how to make it fit your environment.
+
Since Hudson was written to work on unix-like platforms, some parts assume the presence of unix-utilities. It is advised to install these as well on Windows. Install [http://unxutils.sourceforge.net/ UnxUtils] (this includes a shell that seems to work with forward and backwards slashes and does globbing correctly), put it in the Windows {{Template:Code|PATH}}, and copy {{Template:Code|sh.exe}} to {{Template:Path|C:\bin\sh.exe}} (or whichever drive you use) to make shebang lines work. This should get you going.  
* [Case study of Sven Reimers]
+
* [Case study of Kohsuke Kawaguchi]
+
* [Case study of Rhett Sutphin]
+
* [Case study of Ned Collyer]
+
* [Case Study of Arnaud Lacour]
+
* [Case Study of JBoss|http://jboss-qa.blogspot.com/2007/10/taking-continuous-integration-to.html]
+
* we'd love to list yours here. Please talk to us.
+
  
[_Top of page_|#top]
+
If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. One way is to first install Tomcat as a service and then deploy Hudson to it in the usual way. Another way is to use the [http://wrapper.tanukisoftware.org/doc/english/introduction.html Java Service Wrapper]. However, there may be problems using the service wrapper, because the Main class in Hudson in the default namespace conflicts with the service wrapper main class. Deploying inside a service container (Tomcat, Jetty, etc.) is probably more straightforward, even for developers without experience with such containers.
 +
 
 +
*[[Hudson-ci/Installing Hudson Windows Service|Installing Hudson as a Windows service]]

Latest revision as of 19:17, 12 March 2013

Hudson Continuous Integration Server
Website
Download
Community
Mailing ListForumsIRC
Bugzilla
Open
Help Wanted
Bug Day
Contribute
Browse Source
Hudson-bust.png Installing Hudson











Contents

[edit] Distributions

Hudson can be downloaded from both eclipse.org and hudson-ci.org. More information about the available distributions can be found here.


[edit] Prerequisites

Hudson only needs a Java 6 or newer runtime. An internet connection will be required if you want to be able to install and auto-update plug-ins.


[edit] WAR file

After you download hudson.war, you can launch it by executing java -jar hudson.war. This is mostly useful for testing purposes. For production we recommend using native packages for simplified install or deployment in a servlet container that supports Servlet 2.4/JSP 2.0 or later, such as Glassfish, Tomcat 5, JBoss, Jetty 6, etc. See Containers for more about container-specific installation instruction.

Once the war file is exploded, run chmod 755 hudson in the exploded hudson/WEB-INF directory so that you can execute this shell script.

[edit] Unix/Linux Installation

The Hudson project provides native packages for various Linux distributions. These are the simplest way to run Hudson in production, since the packages set up user, service and all other configuration as well as integrate with the native upgrade mechanism of the operating system.

For other operating systems check out the following pages for help.

Alternatively, if you have a servlet container that supports Servlet 2.4/JSP 2.0, such as Glassfish v2, Tomcat 5 (or any later versions), you can run them as services, and deploy hudson.war as you would any other war file. Containers documentation is available if you choose this route.

[edit] Windows Installation

If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. The easiest way is follow Installing Hudson as a Windows service. Alternatively, you can install a servlet container like GlassFish and Tomcat, which can run as a service by itself, and then deploy Hudson to it.

Since Hudson was written to work on unix-like platforms, some parts assume the presence of unix-utilities. It is advised to install these as well on Windows. Install UnxUtils (this includes a shell that seems to work with forward and backwards slashes and does globbing correctly), put it in the Windows PATH, and copy sh.exe to C:\bin\sh.exe (or whichever drive you use) to make shebang lines work. This should get you going.

If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. One way is to first install Tomcat as a service and then deploy Hudson to it in the usual way. Another way is to use the Java Service Wrapper. However, there may be problems using the service wrapper, because the Main class in Hudson in the default namespace conflicts with the service wrapper main class. Deploying inside a service container (Tomcat, Jetty, etc.) is probably more straightforward, even for developers without experience with such containers.