Project

General

Profile

Foreman installer » History » Version 9

Ohad Levy, 02/22/2012 04:18 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 7 Ohad Levy
h3. Using GIT
13
14 9 Ohad Levy
  git clone --recursive git://github.com/theforeman/foreman-installer.git
15 7 Ohad Levy
16
h3. Direct download
17
18
Since we are no longer using one repository for all sources, a single tarball is no longer provided.
19
You can either follow the script below, or download the source code for each module on its own:
20
21
http://github.com/theforeman/puppet-apache/tarball/master
22
http://github.com/theforeman/puppet-foreman/tarball/master
23
http://github.com/theforeman/puppet-foreman_proxy/tarball/master
24
http://github.com/theforeman/puppet-passenger/tarball/master
25
http://github.com/theforeman/puppet-puppet/tarball/master
26
http://github.com/theforeman/puppet-tftp/tarball/master
27
http://github.com/theforeman/puppet-xinetd/tarball/master
28
29 1 Romain Vrignaud
h2. Requirements
30 3 Ohad Levy
31 1 Romain Vrignaud
if you are using RHEL, EPEL repo must be enabled http://fedoraproject.org/wiki/EPEL
32 4 Ohad Levy
33 3 Ohad Levy
if you are using Debian (or Ubuntu), see the additional notes in README.debian
34 1 Romain Vrignaud
35 4 Ohad Levy
h2. Setup/Configuration
36
37 1 Romain Vrignaud
*Please review the variables under */manifests/params.pp*
38
39 8 Ohad Levy
h3. only Foreman
40 1 Romain Vrignaud
41
<pre>
42
echo include foreman | puppet --modulepath /path_to/extracted_tarball
43
</pre>
44 3 Ohad Levy
45 8 Ohad Levy
h3. Both foreman and its proxy:
46 3 Ohad Levy
47 1 Romain Vrignaud
<pre>
48
echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball
49 3 Ohad Levy
</pre>
50 1 Romain Vrignaud
51 8 Ohad Levy
h3. On your Puppet Master
52 7 Ohad Levy
53 3 Ohad Levy
if you just want to include the relavant bits to run on your puppet master you may
54 1 Romain Vrignaud
55 7 Ohad Levy
<pre>
56 1 Romain Vrignaud
include foreman::params, foreman::config::enc, foreman::config::reports
57
</pre>
58 3 Ohad Levy
59 8 Ohad Levy
h3. All in one box (Puppet, Foreman, Proxy)
60 1 Romain Vrignaud
61 7 Ohad Levy
if you want to install it all on one box
62
63 1 Romain Vrignaud
<pre>
64 3 Ohad Levy
export MODULE_PATH="/etc/puppet/modules/common"
65
mkdir -p $MODULE_PATH
66 7 Ohad Levy
for mod in apache foreman foreman_proxy passenger puppet tftp xinetd; do
67
  mkdir -p $MODULE_PATH/$mod
68
  wget http://github.com/theforeman/puppet-$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
69
done;
70 3 Ohad Levy
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH
71
</pre>