Installing Jenkins on tomcat 8

Posted on Saturday, January 25, 2014

This guide will go over installing and setting up Jenkins on an fresh Ubuntu 12.04 server.

Installing Java 7

Install the latest java 7 files

>  sudo apt-get purge openjdk*
>  sudo apt-get install python-software-properties
sudo add-apt-repository ppa:webupd8team/java
>  sudo apt-get update
>  sudo apt-get install oracle-java7-installer
>  java -version

Installing Tomcat 8.0

Download Tomcat to the local directory

The Tomcat 8.0 download page can be found at

(this link may change over time)

>  wget

Extract the file

>  tar xvzf apache-tomcat-8.0.0-RC10.tar.gz

Move the tomcat over

>  sudo mv apache-tomcat-8.0.0-RC10 /opt/tomcat

Now set up the tomcat users.

> sudo vi /opt/tomcat/conf/tomcat-users.xml

Add the following lines within the <tomcat-users> element  (put your own password)

  <role rolename="manager-gui"/>
  <role rolename="admin-gui"/>
  <user name="admin"   password="mypassword"
                              roles="admin-gui, manager-gui,
                              manager-script, admin-script" />

Fix the connector, This has some issue with Jenkins if not fixed.

> sudo vi +68 /opt/tomcat/conf/server.xml

And add this to the connector

Set up start up script

> sudo vi /etc/init.d/tomcat

Then place the following in it.

# Tomcat auto-start
# description: Auto-starts tomcat
# processname: tomcat
# pidfile: /var/run/

export JAVA_HOME=/usr/lib/jvm/java-7-oracle
export JENKINS_HOME=/opt/jenkins

case $1 in
sh /opt/tomcat/bin/
sh /opt/tomcat/bin/
sh /opt/tomcat/bin/
sh /opt/tomcat/bin/
exit 0

Make it executable

> sudo chmod 755 /etc/init.d/tomcat

Add it to autostart

> sudo update-rc.d tomcat defaults

Reboot to test auto start of tomcat

> sudo reboot now


Install Jenkins

Download Jenkins 1.548 from [2]

> wget

Go to the tomcat manager to install the war file

For Context path enter /jenkins
For the war location enter /home/patman/jenkins.war
And click deploy

Now Jenkins is installed

Open Jenkins

Check to make sure the jenkins home directory is correct.
Click on Manage Jenkins

Then configure system

Home directory should be /opt/jenkins

Set up Jenkins security

Now that Jenkins is set up we need to set up its security to prevent unwanted users from logging in an running builds.  Out of the box anyone can get into Jenkins which is a bit of a security risk.

From the main Jenkins screen click on “Manage Jenkins”

Then click on Configure Global Security

Checkbox Enable Security

We are going to use our unix users /groups.  
Checkbox “Unix user/group database”  then click test to test the connection.  If it returns success you are good.

After clicking Test you should see "Success"

Select the Matrix-based Security and add each user individually

Add users or groups by hand

Then give them every permission (but make sure anonymous has no permissions).

Click Save at the bottom.

Now if you go to jenkins you will get a login prompt.

Put in your username/password  and login

That is it for a basic Jenkins install I have not set up any builds yet in it or set up Ant.

I will cover those in other articles.

[1]        Tomcat 8.0 download page
                Accessed 01/2014
[2]        Jenkins hompage
                Accessed 01/2014

1 comment: