Project

General

Profile

Foreman installer » History » Version 14

Greg Sutcliffe, 05/09/2012 07:07 PM

1 4 Ohad Levy
{{toc}}
2
3 3 Ohad Levy
h1. Puppet modules for managing Foreman
4 1 Romain Vrignaud
5 5 Ohad Levy
The installer can be used in multiple ways:
6
* Installs Foreman as a standalone application or using apache passenger.
7
* Installs Foreman Proxy
8
* May install an example puppet master setup using passenger as well, including the tweaks required for foreman.
9 1 Romain Vrignaud
10 7 Ohad Levy
h2. Installation
11 1 Romain Vrignaud
12 12 Greg Sutcliffe
h3. A note on older puppet versions
13
14
The "master" branches are being updated with parameterized classes. If you are running a version of Puppet which doesn't support this (0.25.x or lower) then you should check out the "oldstable" versions of the modules. We will try to fix bugs in either branch, so bug reports are appreciated in either case. Currently, "oldstable" branches exist for:
15 13 Greg Sutcliffe
* puppet-foreman_proxy (master not parameterized yet, but contains references to experimental DHCP/DNS modules)
16
* puppet-puppet        (master parameterized for both agent and server, see README for details)
17 12 Greg Sutcliffe
18 7 Ohad Levy
h3. Using GIT
19 1 Romain Vrignaud
20 12 Greg Sutcliffe
<pre>
21
git clone --recursive git://github.com/theforeman/foreman-installer.git              (for the latest installer)
22
git clone --recursive git://github.com/theforeman/foreman-installer.git -b oldstable (for puppet 0.25.x or lower)
23
</pre>
24 7 Ohad Levy
25
h3. Direct download
26
27
Since we are no longer using one repository for all sources, a single tarball is no longer provided.
28
You can either follow the script below, or download the source code for each module on its own:
29
30
http://github.com/theforeman/puppet-apache/tarball/master
31
http://github.com/theforeman/puppet-foreman/tarball/master
32 1 Romain Vrignaud
http://github.com/theforeman/puppet-foreman_proxy/tarball/master
33 12 Greg Sutcliffe
http://github.com/theforeman/puppet-git/tarball/master
34 7 Ohad Levy
http://github.com/theforeman/puppet-passenger/tarball/master
35
http://github.com/theforeman/puppet-puppet/tarball/master
36
http://github.com/theforeman/puppet-tftp/tarball/master
37 1 Romain Vrignaud
http://github.com/theforeman/puppet-xinetd/tarball/master
38 12 Greg Sutcliffe
39
Optional Modules:
40
41
These provide support for the experimental DHCP/DNS auto configuration in the proxy. Use at your own risk (but send me bug reports :P)
42
http://github.com/GregSutcliffe/puppet-dhcp/tarball/master
43
http://github.com/GregSutcliffe/puppet-dns/tarball/master
44 14 Greg Sutcliffe
http://github.com/GregSutcliffe/pupmod-concat/tarball/master (dependency)
45 7 Ohad Levy
46 1 Romain Vrignaud
h2. Requirements
47 3 Ohad Levy
48 1 Romain Vrignaud
if you are using RHEL, EPEL repo must be enabled http://fedoraproject.org/wiki/EPEL
49 4 Ohad Levy
50 3 Ohad Levy
if you are using Debian (or Ubuntu), see the additional notes in README.debian
51 1 Romain Vrignaud
52 11 Lukas Zapletal
Make sure SELinux is disabled or permissive when running on Fedora/RHEL.
53
54 4 Ohad Levy
h2. Setup/Configuration
55
56 1 Romain Vrignaud
*Please review the variables under */manifests/params.pp*
57
58 8 Ohad Levy
h3. only Foreman
59 1 Romain Vrignaud
60
<pre>
61
echo include foreman | puppet --modulepath /path_to/extracted_tarball
62
</pre>
63 3 Ohad Levy
64 8 Ohad Levy
h3. Both foreman and its proxy:
65 3 Ohad Levy
66 1 Romain Vrignaud
<pre>
67
echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball
68 3 Ohad Levy
</pre>
69 1 Romain Vrignaud
70 8 Ohad Levy
h3. On your Puppet Master
71 7 Ohad Levy
72 3 Ohad Levy
if you just want to include the relavant bits to run on your puppet master you may
73 1 Romain Vrignaud
74 7 Ohad Levy
<pre>
75 1 Romain Vrignaud
include foreman::params, foreman::config::enc, foreman::config::reports
76
</pre>
77 3 Ohad Levy
78 8 Ohad Levy
h3. All in one box (Puppet, Foreman, Proxy)
79 1 Romain Vrignaud
80 7 Ohad Levy
if you want to install it all on one box
81
82 1 Romain Vrignaud
<pre>
83 3 Ohad Levy
export MODULE_PATH="/etc/puppet/modules/common"
84
mkdir -p $MODULE_PATH
85 10 Greg Sutcliffe
for mod in apache foreman foreman_proxy git passenger puppet tftp xinetd; do
86 7 Ohad Levy
  mkdir -p $MODULE_PATH/$mod
87
  wget http://github.com/theforeman/puppet-$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
88
done;
89 3 Ohad Levy
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH
90
</pre>