Foreman installer » History » Revision 7
Revision 6 (Ohad Levy, 12/28/2011 08:32 AM) → Revision 7/20 (Ohad Levy, 02/21/2012 07:58 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/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: installer from http://github.com/ohadlevy/puppet-foreman/tarball/master
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*
h2. Installation
h3. Standalone installation
h4. Foreman only Foreman
<pre>
echo include foreman | puppet --modulepath /path_to/extracted_tarball
</pre>
h4. Both foreman h3. Foreman and its proxy: Proxy on the same host
<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 h3. install it all on one box (PuppetMaster, Foreman and the proxy)
<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 http://github.com/ohadlevy/puppet-foreman/tarball/master -O - | tar |tar xzvf - -C $MODULE_PATH/$mod $MODULE_PATH --strip-components=1
done;
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH
</pre>