Skip to end of metadata

 

Go to start of metadata

 

On RPM-based distributions, such as Red Hat Enterprise Linux (RHEL), CentOS, Fedora or Scientific Linux, you can install Jenkins through yum.

Recent versions are available in a YUM repository.

Installation

Add the Jenkins repository to the yum repos, and install Jenkins from here.

Installation of a stable version

There is also a LTS YUM repository for the LTS Release Line

Installation of Java

Jenkins requires Java in order to run, yet certain distros don't include this by default. To install the Open Java Development Kit (OpenJDK) run the following:

sudo yum install java

Note: If running CentOS, ensure you follow the guide below.

Start/Stop

  • sudo service jenkins start/stop/restart
  • sudo chkconfig jenkins on

Note: if you get the following error message, ensure that Java has been installed:

Starting jenkins (via systemctl):  Job for jenkins.service failed. See 'systemctl status jenkins.service' and 'journalctl -xn' for details.
                                                           [FAILED]

What does this package do?

  • Jenkins will be launched as a daemon on startup. See /etc/init.d/jenkins for more details.
  • The 'jenkins' user is created to run this service. If you change this to a different user via the config file, you must change the owner of /var/log/jenkins, /var/lib/jenkins, and /var/cache/jenkins.
  • Log file will be placed in /var/log/jenkins/jenkins.log. Check this file if you are troubleshooting Jenkins.
  • /etc/sysconfig/jenkins will capture configuration parameters for the launch.
  • By default, Jenkins listen on port 8080. Access this port with your browser to start configuration.  Note that the built-in firewall may have to be opened to access this port from other computers.  (See http://www.cyberciti.biz/faq/disable-linux-firewall-under-centos-rhel-fedora/ for instructions how to disable the firewall permanently)
  • A Jenkins RPM repository is added in /etc/yum.repos.d/jenkins.repo

Disable the firewall

firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --zone=public --add-service=http --permanent
firewall-cmd --reload
firewall-cmd --list-all

Important Note on CentOS Java

Jenkins requires Java in order to run, however yum install jenkins does not enforce that java is already installed. Check to make sure that you already hava java installed by running java -version. To further make things difficult for CentOS users, the default CentOS version of Java is not compatible with Jenkins. Jenkins typically works best with a Sun implementation of Java, which is not included in CentOS for licensing reasons.

If you get output similar to the following, it means you're using the default (GCJ) version of Java, which will not work with Jenkins:

java -version
java version "1.5.0"
gij (GNU libgcj) version 4.4.6 20110731 (Red Hat 4.4.6-3)

To correct this, you may need to remove the GCJ version of Java and install a Sun-compatible version.

If you received the above output, uninstall the default java:

yum remove java

Then after you've uninstalled Java (or if you didn't have Java installed at all to begin with). You need to install a Sun-compatible version of Java. The easiest approach is using OpenJDK, which is available through the EPEL repository (alternatively you may install an official RPM directly from Oracle). To install OpenJDK run the following:

yum install java-1.7.0-openjdk

Depending on your version of CentOS, the package name for OpenJDK may differ. Use yum search openjdk to check for the name of the package. If OpenJDK is not found at all through yum, you probably need to install the EPEL yum repository. After installation, you should be able to get the following output for java -version:

java -version
java version "1.7.0_79"
OpenJDK Runtime Environment (rhel-2.5.5.1.el6_6-x86_64 u79-b14)
OpenJDK 64-Bit Server VM (build 24.79-b02, mixed mode)
  • No labels

10 Comments

    1. Gary Anderson

      ---Can we get someone who knows how to run a yum repo to run createrepo to rebuild the repository metadata? Maybe in a cron job? Thanks.---

      Nevermind, someone did it.

    2. Carl Verbiest

      You need

      yum install java-1.7.0-openjdk

      instead of

      yum install java-1.6.0-openjdk

      with 1.6.0 Jenkins wont start

      # service jenkins start
      Starting Jenkins Jenkins requires Java7 or later, but you are running 1.6.0_35-b35 from /usr/lib/jvm/java-1.6.0-openjdk-1.6.0.35.x86_64/jre
      java.lang.UnsupportedClassVersionError: 50.0
      at Main.main(Main.java:90)

    3. dhinesh ram

      hi,

      we done the first two steps of installation

      for the third step, i imported the rpm package to the server.

      i am using the redhat version as Red Hat Enterprise Linux ES release 4 (Nahant Update 7)

      when we tried to install the jenkins , we are getting the following error as below

      please suggest for this issue
      error:
      [root@ptaf11-labvm1 testtool]# sudo yum install jenkins-1.618-1.1.noarch.rpm

      Setting up Install Process

      Setting up Repos

      jenkins                   100% |=========================|  951 B    00:00

      http://gospodin.tecnomen.com/rhel/4ES/os/i386/repodata/repomd.xml: [Errno 4] IOError: <urlopen error (110, 'Connection timed out')>

      Trying other mirror.

      Cannot open/read repomd.xml file for repository: base

      failure: repodata/repomd.xml from base: [Errno 256] No more mirrors to try. 

      [root@ptaf11-labvm1 testtool]# sudo yum install jenkins-1.618-1.1.noarch.rpm
      Setting up Install Process
      Setting up Repos
      jenkins                   100% |=========================|  951 B    00:00http://gospodin.tecnomen.com/rhel/4ES/os/i386/repodata/repomd.xml: [Errno 4] IOError: <urlopen error (110, 'Connection timed out')>
      Trying other mirror.
      Cannot open/read repomd.xml file for repository: base
      failure: repodata/repomd.xml from base: [Errno 256] No more mirrors to try. 

      1. Evan Cunningham

        For one your key does not match the download.

        Try:

        sudo rpm --import http://pkg.jenkins-ci.org/redhat-stable/jenkins-ci.org.k

        And secondly are you using a proxy?

    4. Joseph Applegate

      The default JENKINS_HOME directory will be in /var/lib/jenkins.

    5. Phani Krishna K V S

      Can anyone please share how to install jenkins as a service from Jenkins.war file. I am trying to install it on a Rhel 6.5 machine which sits behind a corporate firewall, so not able to access internet freely.

      So if anyone could share how to install jenkins as service from its war file, it would be really helpful.(Note: I want to use the default Jetty server of jenkins rather than using tomcat to deploy the war file)

    6. AA BB

      Unfortunately, installation seemed successful until I went to access the GUI http://:8080 and page doesn't open in browser.   Any help would be greatly appreciated. 

      JenkinsLog:

      WARNING:: Upgrade Jenks. Failed to Update the default Update Site 'default'. Plugin upgrades may fail.....

    7. Stephen Grossman

      I upgraded a Jenkins 1.6 server today to LTS 2.7.4.  It wasn't quite as described above. 

      The steps I followed were:

      1. rm -rf /var/cache/yum/x*/7/jenkins
      2. service jenkins stop
      3. sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins.io/redhat-stable/jenkins.repo
      4. sudo rpm --import http://pkg.jenkins.io/redhat-stable/jenkins.io.key
      5. service jenkins start

      Not sure if these are exactly right, I'm not really a sysadmin.  But, after some problems and working through the messages this is what I hit on that work.  I really wanted to have the LTS release, not the latest build.  I had to remove the cache (there may be a better way to clear it) to get yum to install 2.7.4 instead of 2.22.

      All this was on a CentOS 7.2 machine.

    8. Sachin Soneji

      We changed the user in /etc/sysconfig/jenkins per below instruction and also chown -R for all 3 locations. 

      • The 'jenkins' user is created to run this service. If you change this to a different user via the config file, you must change the owner of /var/log/jenkins, /var/lib/jenkins, and /var/cache/jenkins.

      We are unable to launch jenkins after this. Error "Starting Jenkins runuser: cannot set groups: Operation not permitted"

      Anyone had this issue? While it does seem to be permission issue, not sure if which permission needs to be granted for "new" user here.
      Starting Jenkins runuser: cannot set groups: Operation not permitted

    9. Neelam N

      Hi ,
      I am trying to follow the above steps to install jenkins on Oracle Enterprise Linux7 OS.
      When I try commands:
      sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo
      or
      sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
      I get connection timeout error.
      Resolving pkg.jenkins-ci.org (pkg.jenkins-ci.org)... 52.202.51.185
      Connecting to pkg.jenkins-ci.org (pkg.jenkins-ci.org)|52.202.51.185|:80... failed: Connection timed out.
      Retrying
      What am I suppose to do now?
      Any help is appreciated!
      Thanks