|
|
| Line 1: |
Line 1: |
| - | [[Category:Continuous Integration]] | + | #Redirect [[Jenkins]] |
| - | | + | |
| - | Hudson is a continuous integration tool built using Java. It can work as a standalone server since it has the Winstone Servlet Container or it can work on various Servlet Containers or JEE servers such as [[Apache Tomcat]], Glassfish, JBoss, IBM WebSphere, Jetty 6, etc. Hudson supports Apache Ant and [[Maven]] as well as SCM tools such as CSV and [[Subversion]].
| + | |
| - | | + | |
| - | == Installation ==
| + | |
| - | * Download the latest hudson from the hudson web site.
| + | |
| - | * Deploy <code>hudson.war</code> file as a web application to Tomcat server.
| + | |
| - | | + | |
| - | == Use Subdomain to Access Hudson (with SSL) ==
| + | |
| - | * Install and enable [[Apache Tomcat#Using mod jk|mod_jk]].
| + | |
| - | * Open the <code>workers.properties</code> file in the <code>/etc/apache2</code> directory.
| + | |
| - | * Add a new <code>worker</code> for hudson.
| + | |
| - | workers.tomcat_home=/opt/tomcat
| + | |
| - | workers.java_home=/usr/lib/jvm/java-6-sun
| + | |
| - | ps=/
| + | |
| - | worker.list=worker1,'''hudson'''
| + | |
| - | worker.worker1.port=8009
| + | |
| - | worker.worker1.host=localhost
| + | |
| - | worker.worker1.type=ajp13
| + | |
| - | worker.worker1.lbfactor=1
| + | |
| - | '''worker.hudson.port=8009'''
| + | |
| - | '''worker.hudson.host=hudson.yourdomain.com'''
| + | |
| - | '''worker.hudson.type=ajp13'''
| + | |
| - | '''worker.hudson.lbfactor=1'''
| + | |
| - | | + | |
| - | * Set up <code>JkMount</code> in the apache virtual host configuration.
| + | |
| - | <VirtualHost *:443>
| + | |
| - | ServerAdmin master@yourdomain.com
| + | |
| - |
| + | |
| - | SSLEngine on
| + | |
| - |
| + | |
| - | SSLOptions +StrictRequire
| + | |
| - |
| + | |
| - | SSLCertificateFile /etc/ssl/certs/server.crt
| + | |
| - | SSLCertificateKeyFile /etc/ssl/private/server.key
| + | |
| - |
| + | |
| - | ServerName hudson.yourdomain.com
| + | |
| - |
| + | |
| - | JkMount / hudson
| + | |
| - | JkMount /* hudson
| + | |
| - |
| + | |
| - | </VirtualHost>
| + | |
| - | | + | |
| - | * Open the <code>$CATALINA_HOME/conf/server.xml</code> file to set up a new tomcat virtual host for the hudson.
| + | |
| - | * Add the virtual host info inside the <code>Engine</code> element.
| + | |
| - | <source lang="xml">
| + | |
| - | <Engine name="Catalina" defaultHost="localhost">
| + | |
| - | ... Default Host Info ...
| + | |
| - | | + | |
| - | <Host name="hudson.yourdomain.com" appBase="/opt/tomcat_user_dir/hudson_webapps"
| + | |
| - | unpackWARs="true" autoDeploy="true"
| + | |
| - | xmlValidation="false" xmlNamespaceAware="false">
| + | |
| - | </Host>
| + | |
| - | </Engine>
| + | |
| - | </source>
| + | |
| - | | + | |
| - | * If the virtual host is for Hudson only (e.g. http://hudson.yourdomain.com),
| + | |
| - | # Remove all the files and directories in the <code>appBase</code> directory which is, in the example above, <code>/opt/tomcat_user_dir/hudson_webapps</code>.
| + | |
| - | # Copy <code>hudson.war</code> file to the <code>appBase</code> directory and change <code>hudson.war</code> to <code>ROOT.war</code>.
| + | |
| - | | + | |
| - | * Restart tomcat and apache.
| + | |
| - | $ /etc/init.d/tomcat stop
| + | |
| - | $ /etc/init.d/tomcat start
| + | |
| - | $ /etc/init.d/apache restart
| + | |
| - | | + | |
| - | * access https://hudson.yourdomain.com.
| + | |
| - | | + | |
| - | === Known Problem ===
| + | |
| - | ==== More than One Hudson Instance ====
| + | |
| - | * This problem will not happen if the instructions above are used to install Hudson.
| + | |
| - | | + | |
| - | * If Hudson complains about two hudson instances using the same HUDSON_HOME with the following error message, stop the tomcat server and check $CATALINA_HOME/work directory and removes duplicate ones if found.
| + | |
| - | <pre>
| + | |
| - | Hudson detected that you appear to be running more than one instance of Hudson that share the same home directory
| + | |
| - | ...
| + | |
| - | This greatly confuses Hudson and you will likely experience strange behaviors, so please correct the situation.
| + | |
| - | </pre>
| + | |
| - | * Check <code>server.xml</code>.
| + | |
| - | * If the virtual host is only for Hudson and <code>server.xml</code> has the virtual host setup like below with <code>hudson.war</code> placed in the <code>webapps</code> directory, Tomcat server will create two instances (<code>hudson</code> and <code>ROOT</code>) of Hudson when it starts.
| + | |
| - | <source lang="xml">
| + | |
| - | <Engine name="Catalina" defaultHost="localhost">
| + | |
| - | ... Default Host Info ...
| + | |
| - | | + | |
| - | <Host name="hudson.yourdomain.com" appBase="/opt/tomcat_user_dir/hudson_webapps"
| + | |
| - | unpackWARs="true" autoDeploy="true"
| + | |
| - | xmlValidation="false" xmlNamespaceAware="false">
| + | |
| - | <!-- WARNING: This is WRONG!!! -->
| + | |
| - | <Context path="" docBase="hudson" debug="0" reloadable="true" />
| + | |
| - | </Host>
| + | |
| - | </Engine>
| + | |
| - | </source>
| + | |
| - | * To solve this problem, as mentioned already (Read the instructions to <code>Use Subdomain to Access Hudson (with SSL)</code>),
| + | |
| - | # Remove all the files and directories in the <code>appBase</code> directory which is, in the example above, <code>/opt/tomcat_user_dir/hudson_webapps</code>.
| + | |
| - | # Copy <code>hudson.war</code> file to the <code>appBase</code> directory and change <code>hudson.war</code> to <code>ROOT.war</code>.
| + | |
| - | # Remove <code>Context</code> element in the <code>server.xml</code> file.
| + | |
| - | | + | |
| - | ==== AWT is not properly configured ====
| + | |
| - | After installation and accessing Hudson, if it displays an error message like
| + | |
| - | <pre>
| + | |
| - | AWT is not properly configured on this server. Perhaps you need to run your container with "-Djava.awt.headless=true"?
| + | |
| - | | + | |
| - | java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
| + | |
| - | (...)
| + | |
| - | </pre>
| + | |
| - | Add the following line to the end of the <code>$TOMCAT_HOME/conf/catalina.properties</code> file (This is not necessary unless it has the error described above).
| + | |
| - | <pre>
| + | |
| - | java.awt.headless=true
| + | |
| - | </pre>
| + | |
| - | | + | |
| - | | + | |
| - | == Configuration ==
| + | |
| - | * To set the Tomcat to use UTF-8 to decode URLs, open <code>$CATALINA_HOME/conf/server.xml</code> file.
| + | |
| - | * Add <code>URIEncoding="UTF-8"</code> to the following Connector element.
| + | |
| - | <source lang="xml">
| + | |
| - | <Connector port="8080" protocol="HTTP/1.1"
| + | |
| - | connectionTimeout="20000"
| + | |
| - | redirectPort="8443" />
| + | |
| - | </source>
| + | |
| - | * So it should be like this
| + | |
| - | <source lang="xml">
| + | |
| - | <Connector port="8080" protocol="HTTP/1.1"
| + | |
| - | connectionTimeout="20000"
| + | |
| - | redirectPort="8443"
| + | |
| - | URIEncoding="UTF-8" />
| + | |
| - | </source>
| + | |
| - | | + | |
| - | | + | |
| - | * If it uses <code>mod_jk</code>, add <code>URIEncoding="UTF-8"</code> to
| + | |
| - | <source lang="xml">
| + | |
| - | <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
| + | |
| - | </source>
| + | |
| - | * So this should be
| + | |
| - | <source lang="xml">
| + | |
| - | <Connector port="8009" protocol="AJP/1.3" redirectPort="8443"
| + | |
| - | URIEncoding="UTF-8" />
| + | |
| - | </source>
| + | |
| - | * Restart the tomcat server.
| + | |
| - | * <code>JkOptions +ForwardURICompatUnparsed</code> option needs to be added to the <code>/etc/apache2/mods-enabled/jk.load</code> file or in the virtual host setup.
| + | |
| - | <VirtualHost *:443>
| + | |
| - | ServerAdmin master@yourdomain.com
| + | |
| - |
| + | |
| - | SSLEngine on
| + | |
| - |
| + | |
| - | SSLOptions +StrictRequire
| + | |
| - |
| + | |
| - | SSLCertificateFile /etc/ssl/certs/server.crt
| + | |
| - | SSLCertificateKeyFile /etc/ssl/private/server.key
| + | |
| - |
| + | |
| - | ServerName hudson.yourdomain.com
| + | |
| - |
| + | |
| - | '''JkOptions +ForwardURICompatUnparsed'''
| + | |
| - |
| + | |
| - | JkMount / hudson
| + | |
| - | JkMount /* hudson
| + | |
| - |
| + | |
| - | </VirtualHost>
| + | |
| - | | + | |
| - | * Restart the apache server.
| + | |
