Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Hudson-ci/Containers/Winstone"

Line 1: Line 1:
{{hudson|pageTitle=Using Winstone as a Container}}
+
{{hudson|pageTitle=Using Winstone as a Container}}  
  
{{stub}}
+
{{Note|Update Needed!|With the Eclipse move, Winstone is no longer the default container}}
 +
 
 +
== Installation ==
 +
 
 +
Hudson ships with Winstone, so no additional installation needed. Just run with {{code|java -jar hudson.war}}.
 +
 
 +
== Notes ==
 +
 
 +
* [http://www.nabble.com/problem-with-AJP13-and-apache-tf3587565.html Running behind Apache with AJP]
 +
* [http://winstone.sourceforge.net/#commandLine List of available command line options for example to change the HTTP port]
 +
 
 +
= Setting HUDSON_HOME =
 +
 
 +
Specify the -D option to the invocation:
 +
<pre>
 +
$ java -DHUDSON_HOME=/path/to/home -jar hudson.war
 +
</pre>
 +
Or if that fails for some reason, you should still be able to use the environment variable:
 +
<pre>
 +
$ export HUDSON_HOME=/path/to/hudson_home
 +
$ java -jar hudson.war
 +
</pre>
 +
 
 +
= Securing Hudson on Winstone =
 +
 
 +
Winstone supports pluggable authentication as explained [http://winstone.sourceforge.net/#authRealms here]. For example, to use FileRealm, you'd do:
 +
<pre>
 +
$ cat users.xml
 +
<tomcat-users>
 +
<role rolename="admin"/>
 +
<user username="joe" password="secret" roles="admin"/>
 +
</tomcat-users>
 +
$ java -jar hudson.war --realmClassName=winstone.realm.FileRealm --fileRealm.configFile=users.xml
 +
</pre>

Revision as of 07:30, 2 September 2011

Hudson Continuous Integration Server
Website
Download
Community
Mailing ListForumsIRCmattermost
Issues
OpenHelp WantedBug Day
Contribute
Browse Source
Hudson-bust.png Using Winstone as a Container











Note.png
Update Needed!
With the Eclipse move, Winstone is no longer the default container


Installation

Hudson ships with Winstone, so no additional installation needed. Just run with java -jar hudson.war.

Notes

Setting HUDSON_HOME

Specify the -D option to the invocation:

$ java -DHUDSON_HOME=/path/to/home -jar hudson.war

Or if that fails for some reason, you should still be able to use the environment variable:

$ export HUDSON_HOME=/path/to/hudson_home
$ java -jar hudson.war

Securing Hudson on Winstone

Winstone supports pluggable authentication as explained here. For example, to use FileRealm, you'd do:

$ cat users.xml
<tomcat-users>
<role rolename="admin"/>
<user username="joe" password="secret" roles="admin"/>
</tomcat-users>
$ java -jar hudson.war --realmClassName=winstone.realm.FileRealm --fileRealm.configFile=users.xml

Back to the top