{{toc}}

h1. 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.

h2. Installation

h3. Using GIT

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

h3. 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

h2. 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

h2. Setup/Configuration

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

h3. Standalone installation

h4. only Foreman

<pre>

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

</pre>

h4. Both foreman and its proxy:

<pre>

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

</pre>

h4. On your Puppet Master

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

<pre>

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

</pre>

h4. All in one box (Puppet, Foreman, Proxy)

if you want to install it all on one box

<pre>

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

</pre>