Foreman installer » History » Revision 9
Revision 8 (Ohad Levy, 02/21/2012 07:59 AM) → Revision 9/20 (Ohad Levy, 02/22/2012 04:18 AM)
{{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/foreman-installer.git 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. only Foreman
<pre>
echo include foreman | puppet --modulepath /path_to/extracted_tarball
</pre>
h3. Both foreman and its proxy:
<pre>
echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball
</pre>
h3. 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>
h3. 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>