Project

General

Profile

Foreman installer » History » Version 11

Lukas Zapletal, 03/27/2012 07:48 AM
selinux note

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 11 Lukas Zapletal
Make sure SELinux is disabled or permissive when running on Fedora/RHEL.
36
37 4 Ohad Levy
h2. Setup/Configuration
38
39 1 Romain Vrignaud
*Please review the variables under */manifests/params.pp*
40
41 8 Ohad Levy
h3. only Foreman
42 1 Romain Vrignaud
43
<pre>
44
echo include foreman | puppet --modulepath /path_to/extracted_tarball
45
</pre>
46 3 Ohad Levy
47 8 Ohad Levy
h3. Both foreman and its proxy:
48 3 Ohad Levy
49 1 Romain Vrignaud
<pre>
50
echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball
51 3 Ohad Levy
</pre>
52 1 Romain Vrignaud
53 8 Ohad Levy
h3. On your Puppet Master
54 7 Ohad Levy
55 3 Ohad Levy
if you just want to include the relavant bits to run on your puppet master you may
56 1 Romain Vrignaud
57 7 Ohad Levy
<pre>
58 1 Romain Vrignaud
include foreman::params, foreman::config::enc, foreman::config::reports
59
</pre>
60 3 Ohad Levy
61 8 Ohad Levy
h3. All in one box (Puppet, Foreman, Proxy)
62 1 Romain Vrignaud
63 7 Ohad Levy
if you want to install it all on one box
64
65 1 Romain Vrignaud
<pre>
66 3 Ohad Levy
export MODULE_PATH="/etc/puppet/modules/common"
67
mkdir -p $MODULE_PATH
68 10 Greg Sutcliffe
for mod in apache foreman foreman_proxy git passenger puppet tftp xinetd; do
69 7 Ohad Levy
  mkdir -p $MODULE_PATH/$mod
70
  wget http://github.com/theforeman/puppet-$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
71
done;
72 3 Ohad Levy
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH
73
</pre>