Kevin at 15:20, 10 August 2012

2012-08-10T15:20:15Z

← Older revision		Revision as of 15:20, 10 August 2012
Line 157:		Line 157:

	* Restart the apache server.		* Restart the apache server.
		+
		+	== Git and Gitolite ==
		+	$ su - tomcat
		+
		+	$ ssh-keygen -t rsa
		+	/opt/tomcat_user_home/.ssh/tomcat@host
		+
		+	# Modify ~/.ssh/config
		+	Host tomcat-host
		+	Hostname host.address
		+	Port 1234
		+	User tomcat
		+	IdentityFile /opt/tomcat_user_home/.ssh/tomcat@host
		+
		+	# edit ~/.gitconfig
		+	[user]
		+	name = Tomcat
		+	email = tomcat@host.address
		+
		+	* Test if it works!!!!!!!!!!
		+	$ ssh git@tomcat-host

Kevin: Created page with "Category:Continuous Integration Jenkins is a continuous integration tool built using Java. It can work as a standalone server since it has the Winstone Servlet Container or ..."

2012-08-10T11:33:19Z

Created page with "Category:Continuous Integration Jenkins is a continuous integration tool built using Java. It can work as a standalone server since it has the Winstone Servlet Container or ..."

New page

[[Category:Continuous Integration]]

Jenkins 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. Jenkins supports Apache Ant and [[Maven]] as well as SCM tools such as CSV and [[Subversion]].

== Installation ==
* Download the latest Jenkins from the Jenkins web site.
* Deploy <code>jenkins.war</code> file as a web application to Tomcat server.

== Use Subdomain to Access Jenkins (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 Jenkins.
workers.tomcat_home=/opt/tomcat
workers.java_home=/usr/lib/jvm/java-6-sun
ps=/
worker.list=worker1,'''jenkins'''
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13
worker.worker1.lbfactor=1
'''worker.jenkins.port=8009'''
'''worker.jenkins.host=jenkins.yourdomain.com'''
'''worker.jenkins.type=ajp13'''
'''worker.jenkins.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 jenkins.yourdomain.com

JkMount / jenkins
JkMount /* jenkins

</VirtualHost>

* Open the <code>$CATALINA_HOME/conf/server.xml</code> file to set up a new tomcat virtual host for the jenkins.
* Add the virtual host info inside the <code>Engine</code> element.
<source lang="xml">
<Engine name="Catalina" defaultHost="localhost">
... Default Host Info ...

<Host name="jenkins.yourdomain.com" appBase="/opt/tomcat_user_dir/jenkins_webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">
</Host>
</Engine>
</source>

* If the virtual host is for Jenkins only (e.g. http://jenkins.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/jenkins_webapps</code>.
# Copy <code>jenkins.war</code> file to the <code>appBase</code> directory and change <code>jenkins.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://jenkins.yourdomain.com.

=== Known Problem ===
==== More than One Jenkins Instance ====
* This problem will not happen if the instructions above are used to install Jenkins.

* If Jenkins complains about two jenkins instances using the same JENKINS_HOME with the following error message, stop the tomcat server and check $CATALINA_HOME/work directory and removes duplicate ones if found.
<pre>
Jenkins detected that you appear to be running more than one instance of Jenkins that share the same home directory
...
This greatly confuses Jenkins 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 Jenkins and <code>server.xml</code> has the virtual host setup like below with <code>jenkins.war</code> placed in the <code>webapps</code> directory, Tomcat server will create two instances (<code>jenkins</code> and <code>ROOT</code>) of Jenkins when it starts.
<source lang="xml">
<Engine name="Catalina" defaultHost="localhost">
... Default Host Info ...

<Host name="jenkins.yourdomain.com" appBase="/opt/tomcat_user_dir/jenkins_webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

<Context path="" docBase="jenkins" debug="0" reloadable="true" />
</Host>
</Engine>
</source>
* To solve this problem, as mentioned already (Read the instructions to <code>Use Subdomain to Access Jenkins (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/jenkins_webapps</code>.
# Copy <code>jenkins.war</code> file to the <code>appBase</code> directory and change <code>jenkins.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 jenkins, 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 jenkins.yourdomain.com

'''JkOptions +ForwardURICompatUnparsed'''

JkMount / jenkins
JkMount /* jenkins

</VirtualHost>

* Restart the apache server.

Jenkins - Revision history

Kevin at 15:20, 10 August 2012

Kevin: Created page with "Category:Continuous Integration Jenkins is a continuous integration tool built using Java. It can work as a standalone server since it has the Winstone Servlet Container or ..."