Project

General

Profile

Foreman installer » History » Version 19

Greg Sutcliffe, 10/25/2012 10:49 AM

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 17 Greg Sutcliffe
http://github.com/theforeman/puppet-concat/tarball/master (dependency for the next two)
43
http://github.com/theforeman/puppet-dhcp/tarball/master
44
http://github.com/theforeman/puppet-dns/tarball/master
45
46 7 Ohad Levy
47 1 Romain Vrignaud
h2. Requirements
48 3 Ohad Levy
49 1 Romain Vrignaud
if you are using RHEL, EPEL repo must be enabled http://fedoraproject.org/wiki/EPEL
50 4 Ohad Levy
51 3 Ohad Levy
if you are using Debian (or Ubuntu), see the additional notes in README.debian
52 1 Romain Vrignaud
53 11 Lukas Zapletal
Make sure SELinux is disabled or permissive when running on Fedora/RHEL.
54
55 19 Greg Sutcliffe
h2. Setup/Configuration
56 18 Greg Sutcliffe
57
*Please review the variables under */manifests/params.pp*
58 1 Romain Vrignaud
59 8 Ohad Levy
h3. only Foreman
60 1 Romain Vrignaud
61
<pre>
62
echo include foreman | puppet --modulepath /path_to/extracted_tarball
63
</pre>
64 3 Ohad Levy
65 8 Ohad Levy
h3. Both foreman and its proxy:
66 3 Ohad Levy
67 1 Romain Vrignaud
<pre>
68
echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball
69 3 Ohad Levy
</pre>
70 1 Romain Vrignaud
71 8 Ohad Levy
h3. On your Puppet Master
72 7 Ohad Levy
73 3 Ohad Levy
if you just want to include the relavant bits to run on your puppet master you may
74 1 Romain Vrignaud
75 7 Ohad Levy
<pre>
76 1 Romain Vrignaud
include foreman::params, foreman::config::enc, foreman::config::reports
77
</pre>
78 3 Ohad Levy
79 8 Ohad Levy
h3. All in one box (Puppet, Foreman, Proxy)
80 1 Romain Vrignaud
81 16 Lee Lowder
if you want to install it all on one box (2.6.x and older)
82 7 Ohad Levy
83 1 Romain Vrignaud
<pre>
84 3 Ohad Levy
export MODULE_PATH="/etc/puppet/modules/common"
85
mkdir -p $MODULE_PATH
86 10 Greg Sutcliffe
for mod in apache foreman foreman_proxy git passenger puppet tftp xinetd; do
87 7 Ohad Levy
  mkdir -p $MODULE_PATH/$mod
88
  wget http://github.com/theforeman/puppet-$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
89
done;
90 1 Romain Vrignaud
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH
91 16 Lee Lowder
</pre>
92
93
if you want to install it all on one box (2.7.x and newer)
94
95
<pre>
96
export MODULE_PATH="/etc/puppet/modules/common"
97
mkdir -p $MODULE_PATH
98 19 Greg Sutcliffe
for mod in apache foreman foreman_proxy git passenger puppet tftp xinetd; do
99 16 Lee Lowder
  mkdir -p $MODULE_PATH/$mod
100
  wget http://github.com/theforeman/puppet-$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
101
done;
102
echo include puppet, puppet::server, foreman, foreman_proxy | puppet apply --modulepath $MODULE_PATH
103 3 Ohad Levy
</pre>