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

download the installer from <http://github.com/ohadlevy/puppet-foreman/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*

h2. Installation

h3. Foreman only

<pre>

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

</pre>

h3. Foreman and its Proxy on the same host

<pre>

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

</pre>

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>

h3. install it all on one box (PuppetMaster, Foreman and the proxy)

<pre>

export MODULE_PATH="/etc/puppet/modules/common"

mkdir -p $MODULE_PATH

wget http://github.com/ohadlevy/puppet-foreman/tarball/master -O - |tar xzvf - -C $MODULE_PATH --strip-components=1

echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH

</pre>