Foreman installer » History » Revision 11
Revision 10 (Greg Sutcliffe, 03/03/2012 07:45 AM) → Revision 11/20 (Lukas Zapletal, 03/27/2012 07:48 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
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
Make sure SELinux is disabled or permissive when running on Fedora/RHEL.
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 git 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>