Foreman installer

Version 6 (Ohad Levy, 12/28/2011 08:32 am)

1 4 Ohad Levy
{{toc}}
2 4 Ohad Levy
3 3 Ohad Levy
h1. Puppet modules for managing Foreman
4 1
5 5 Ohad Levy
The installer can be used in multiple ways:
6 5 Ohad Levy
* Installs Foreman as a standalone application or using apache passenger.
7 5 Ohad Levy
* Installs Foreman Proxy
8 5 Ohad Levy
* May install an example puppet master setup using passenger as well, including the tweaks required for foreman.
9 1
10 6 Ohad Levy
download the installer from http://github.com/ohadlevy/puppet-foreman/tarball/master
11 1
12 3 Ohad Levy
h2. Requirements
13 1
14 6 Ohad Levy
if you are using RHEL, EPEL repo must be enabled http://fedoraproject.org/wiki/EPEL
15 1
16 3 Ohad Levy
if you are using Debian (or Ubuntu), see the additional notes in README.debian
17 1
18 4 Ohad Levy
h2. Setup/Configuration
19 3 Ohad Levy
20 1
*Please review the variables under */manifests/params.pp*
21 4 Ohad Levy
22 4 Ohad Levy
h2. Installation
23 3 Ohad Levy
24 3 Ohad Levy
h3. Foreman only
25 3 Ohad Levy
26 1
<pre>
27 3 Ohad Levy
echo include foreman | puppet --modulepath /path_to/extracted_tarball
28 1
</pre>
29 1
30 3 Ohad Levy
h3. Foreman and its Proxy on the same host
31 3 Ohad Levy
32 3 Ohad Levy
<pre>
33 3 Ohad Levy
echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball
34 3 Ohad Levy
</pre>
35 3 Ohad Levy
36 3 Ohad Levy
if you just want to include the relavant bits to run on your puppet master you may
37 3 Ohad Levy
<pre>
38 3 Ohad Levy
include foreman::params, foreman::config::enc, foreman::config::reports
39 3 Ohad Levy
</pre>
40 3 Ohad Levy
41 3 Ohad Levy
h3. install it all on one box (PuppetMaster, Foreman and the proxy)
42 3 Ohad Levy
43 3 Ohad Levy
<pre>
44 3 Ohad Levy
export MODULE_PATH="/etc/puppet/modules/common"
45 3 Ohad Levy
mkdir -p $MODULE_PATH
46 3 Ohad Levy
wget http://github.com/ohadlevy/puppet-foreman/tarball/master -O - |tar xzvf - -C $MODULE_PATH --strip-components=1
47 3 Ohad Levy
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH
48 3 Ohad Levy
</pre>