Katello 3.2 Documentation

Katello 3.2 Installation

Note: After installation of Katello, be sure to trust Katello’s CA certificate on your system. This is required for the encrypted NoVNC connections. You will find katello-server-ca.crt in the /pub directory of your Katello server (e.g. http://katello.example.com/pub/katello-server-ca.crt).

Hardware Requirements

Katello may be installed onto a baremetal host or on a virtual guest. The minimum requirements are:

  • Two Logical CPUs
  • 8 GB of memory (12 GB highly recommended)
  • The filesystem holding /var/lib/pulp needs to be large, but may vary depending on how many different Operating Systems you wish to syncronize:
    • Allocate 30 GB of space for each operating system. Even though an operating system may not take up this much space now, this allows space for future updates that will be syncronized later.
  • The path /var/spool/squid/ is used as a temporary location for some types of repository syncs and may grow to consume 10s of GB of space before the files are migrated to /var/lib/pulp. You may wish to put this on the same partition as /var/lib/pulp.
  • The filesystem holding /var/lib/mongodb needs at least 4 GB to install, but will vary depending on how many different Operating Systems you wish to syncronize:
    • Allocate around 40% of the capacity that has been given to the /var/lib/pulp filesystem
  • The root filesystem needs at least 20 GB of Disk Space

Required Ports

The following ports need to be open to external connections:

  • 80 TCP - HTTP, used for provisioning purposes
  • 443 TCP - HTTPS, used for web access and api communication
  • 5647 TCP - qdrouterd - used for client and capsule actions
  • 9090 TCP - HTTPS - used for communication with the smart proxy

Production

Katello provides a puppet based installer for deploying production installations. Production installations are supported on the following OSes:

OS
CentOS 6 X
CentOS 7 X
RHEL 6 X
RHEL 7 X

Katello can only run on an x86_64 operating systems.

Installation may be done manually or via our recommended approach of using katello-deploy.

Required Repositories

Select your Operating System:

yum -y  --disablerepo="*" --enablerepo=rhel-6-server-rpms install yum-utils wget
yum-config-manager --disable "*"
yum-config-manager --enable rhel-6-server-rpms epel
yum-config-manager --enable rhel-6-server-optional-rpms
yum -y update
yum -y localinstall http://fedorapeople.org/groups/katello/releases/yum/3.2/katello/el6/x86_64/katello-repos-latest.rpm
yum -y localinstall http://fedorapeople.org/groups/katello/releases/yum/foreman/1.13/el6/x86_64/foreman-release.rpm
yum -y localinstall https://yum.puppetlabs.com/puppetlabs-release-pc1-el-6.noarch.rpm # will install with Puppet 4
#yum -y localinstall http://yum.puppetlabs.com/puppetlabs-release-el-6.noarch.rpm # use this instead if you prefer Puppet 3
yum -y localinstall http://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
yum -y install foreman-release-scl

Installation

After setting up the appropriate repositories, update your system:

yum -y update

Then install Katello:

yum -y install katello

At this point the foreman-installer should be available to setup the server. The installation may be customized, to see a list of options:

foreman-installer --scenario katello --help

Note

Prior to running the installer, the machine should be set up with a time service such as ntpd or chrony, since several Katello features will not function well if there is minor clock skew.

These may be set as command line options or in the answer file (/etc/foreman-installer/scenarios.d/katello-answers.yaml). Now run the options:

foreman-installer --scenario katello <options>

Katello Deploy

Katello provides a git repository designed to streamline setup by setting up all the proper repositories. Katello deploy provides the ability to deploy a virtual machine instance via Vagrant or direct deployment on an already provisioned machine. For details on how to install using katello-deploy, please see the README.



The Foreman Community Survey is now live, and has prizes! Fill it out here!

A new bug fix release for Foreman 1.14 is available. See the Foreman 1.14.1 release notes for more details.

Foreman 1.14.0 is now available, featuring new automatic IPv6 support, LDAP and template enhancements, and easier email configuration. Read about all of the changes in the release notes, and follow the quick start to install it.