Katello 2.4 Documentation


What is the CLI?

The Hammer CLI provides users with a command-line interface for interacting with Katello. It’s our goal to make all functionality that’s accessible through Katello’s Web UI also available through Hammer so that users may use Hammer for their entire Katello workflow.


The first step to install the CLI is to setup the appropriate repositories: foreman, katello and epel.

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 localinstall http://fedorapeople.org/groups/katello/releases/yum/2.4/katello/el6/x86_64/katello-repos-latest.rpm
yum -y localinstall http://yum.theforeman.org/releases/1.10/el6/x86_64/foreman-release.rpm
yum -y localinstall http://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm

After setting up the appropriate repositories, install Katello:

yum -y install rubygem-hammer_cli_katello

How do I use Hammer?

To get started with hammer, view the help:

hammer -u <user> -p <password> --help

How do I contribute to Hammer?

See the Katello Hammer CLI project if you want to get setup for contributing to the hammer code.

A new bug fix release for Foreman 1.15 is available. See the Foreman 1.15.1 release notes for more details.

Foreman 1.15.0 is now available, featuring a new notifications UI, template changes, and improvements to host owners and SSH keys. Read about all of the changes in the release notes, and follow the quick start to install it.