• Table of contents
• Puppet modules for managing Foreman
  • Installation
    • Using GIT
    • Direct download
  • Requirements
  • Setup/Configuration
    • only Foreman
    • Both foreman and its proxy:
    • On your Puppet Master
    • All in one box (Puppet, Foreman, Proxy)

Puppet modules for managing Foreman¶

The installer can be used in multiple ways:

• Installs Foreman as a standalone application or using apache passenger.
• Installs Foreman Proxy
• May install an example puppet master setup using passenger as well, including the tweaks required for foreman.

Installation¶

Using GIT¶

git clone --recursive git://github.com/theforeman/puppet-puppet.git

Direct download¶

Since we are no longer using one repository for all sources, a single tarball is no longer provided.
You can either follow the script below, or download the source code for each module on its own:

http://github.com/theforeman/puppet-apache/tarball/master
http://github.com/theforeman/puppet-foreman/tarball/master
http://github.com/theforeman/puppet-foreman_proxy/tarball/master
http://github.com/theforeman/puppet-passenger/tarball/master
http://github.com/theforeman/puppet-puppet/tarball/master
http://github.com/theforeman/puppet-tftp/tarball/master
http://github.com/theforeman/puppet-xinetd/tarball/master

Requirements¶

if you are using RHEL, EPEL repo must be enabled http://fedoraproject.org/wiki/EPEL

if you are using Debian (or Ubuntu), see the additional notes in README.debian

Setup/Configuration¶

Please review the variables under */manifests/params.pp

only Foreman¶

echo include foreman | puppet --modulepath /path_to/extracted_tarball

Both foreman and its proxy:¶

echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball

On your Puppet Master¶

if you just want to include the relavant bits to run on your puppet master you may

include foreman::params, foreman::config::enc, foreman::config::reports

All in one box (Puppet, Foreman, Proxy)¶

if you want to install it all on one box

export MODULE_PATH="/etc/puppet/modules/common" 
mkdir -p $MODULE_PATH
for mod in apache foreman foreman_proxy passenger puppet tftp xinetd; do
  mkdir -p $MODULE_PATH/$mod
  wget http://github.com/theforeman/puppet-$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
done;
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH