Wednesday, March 11, 2015

Installing the Foreman/Katello Project on CentOS 6.6

This article will cover the basic/default installation of Foreman project with the Katello plugin. We will be installing the most stable releases of Foreman (1.7), Katello (2.1), and Puppet to date of this article. We will not be using the nightly releases as I have found them to be buggy and inconsistent. Foreman provides the main interface for all the projects and handles the provisioning, monitoring and dashboard capabilities of your environment and the Katello project manages customized repositories and package management to all registered content hosts (will cover more of that in the next articles). Let's Begin!

Installing Foreman with Katello on Centos 6.6

1) Ensure that your hostname resolves correctly in DNS. Had a problem with the hostname that I had to resolve by correcting entries in the /etc/hosts file and also in the /etc/sysconfig/network file. Check ‘hostname -f’ against nslookup/host on other machines. Just be sure that you have consistency between your host and other devices on your network as puppet will not be happy if you don't!

2) Turn off iptables and ip6tables. Atleast during the installation process. It will make your life easier! Consult the Foreman documentation if you can't and need information on specific ports etc.
    # service iptables stop ; chkconfig iptables off
    # service ip6tables stop; chkconfig ip6tables off

3) Disable selinux. Pulp (service that runs inside Katello) and selinux aren’t currently playing nice. Open /etc/sysconfig/selinux in a text editor and set to disabled.

4) Install the following repos/versions. I didn't have luck with the nightly's so I did not use them.

   # rpm -ivh
    # rpm -ivh
    # yum install -y
    # wget -O /etc/yum.repos.d/scl.repo
    # yum install -y

5) Install Katello packs and grab a cold one. ~400 packages
    # yum install -y katello

6) Deploy Katello. This is install the defaults. See "katello-installer --help" for additional parameters and custom settings.
    # katello-installer

This will take several minutes to complete (so grab another cold one!). At this point though it will either fail or succeed. It will give you progress along the way and tell you why it failed in the event it does. On successful completion you should see something like below:

[root@hostname ~]# katello-installer
Installing             Done                                               [100%] [.]
  * Katello is running at
      Initial credentials are admin / mfmVBo6M7yFenvAp
  * Capsule is running at
  * To install additional capsule on separate machine continue by running:"

      capsule-certs-generate --capsule-fqdn "$CAPSULE" --certs-tar "~/$CAPSULE-certs.tar"

  The full log is at /var/log/katello-installer/katello-installer.log

This concludes the default installation process of Foreman with the Katello plugin. This is enough to get you going with the WEB UI and start poking around. There will be follow up blog posts that examine and explain the aspects of the project that make it so powerful.


  1. Thanks for sharing, nice post!

    Chia sẻ các bạn Kawasaki z1000 giá bao nhiêu với kiểu dáng tuyệt đẹp hay cách chữa ong đốt hiệu quả nhất tại nhà bạn nên biết hay 094 là mạng gì và các số tổng đài liên quan hay 0126 là mạng nào và tổng đài MobiFone hỗ trợ khách hàng hay chia sẻ làm sao để biết người ấy thích mình để biết người ta có thật lòng thích mình hay không hay ý nghĩa của các con số trong điện thoại nói lên điều gì rất thú vị hay tác dụng của lá vối trong việc chữa bệnh cực hữu hiệu hay những bài hát tiếng Anh hay nhất mọi thời đại nghe là nghiền có thể bạn chưa biết hay chia sẻ các bạn cách tự nhuộm tóc tại nhà cực đẹp tự nhiên hay rửa mặt bằng nước vo gạo có ăn nắng không hay chia sẻ các bạn cách làm đẹp từ nước vo gạo với cách rửa mặt bằng nước vo gạo đúng cách hay chia sẻ các mẹ cách hướng dẫn cách tắm nắng cho trẻ sơ sinh đúng cách nhất hay ý nghĩa các loài hoa trong cuộc sống đầy thú vị hay thắc mắc của các mẹ là trẻ sơ sinh có nên uống nước hay không có tốt cho trẻ hay không hay sữa mẹ để ngoài được bao lâu có tốt không hay những bộ phim ma hay nhất mọi thời đại bạn ko nên bỏ qua hay bùa yêu có thật không và những cây chuyện bùa yêu có thật.

  2. The REPO

    wget -O /etc/yum.repos.d/scl.repo

    doesn't exist anymore so I used

    yum install centos-release-scl

    which adds the repos from the following URL

    When I try running yum install katello I get the following dependency errors

    --> Finished Dependency Resolution
    Error: Package: foreman-proxy-1.12.4-1.el6.noarch (foreman)
    Requires: rubygem(sinatra)
    Error: Package: tfm-rubygem-katello- (katello)
    Requires: tfm-rubygem(foreman-tasks) >= 0.8.0
    Available: tfm-rubygem-foreman-tasks-0.7.17-1.fm1_12.el6.noarch (foreman-plugins)
    tfm-rubygem(foreman-tasks) = 0.7.17
    Installing: tfm-rubygem-foreman-tasks-0.7.18-1.fm1_12.el6.noarch (foreman-plugins)
    tfm-rubygem(foreman-tasks) = 0.7.18
    You could try using --skip-broken to work around the problem
    You could try running: rpm -Va --nofiles --nodigest

    Do you have any suggestions ??