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