Project

General

Profile

Installation instructions » History » Version 57

Romain Vrignaud, 11/17/2011 08:58 AM

1 8 Ohad Levy
{{toc}}
2 1 Ohad Levy
3 38 Paul Kelly
h1. Requirements for the foreman core component
4 8 Ohad Levy
5 1 Ohad Levy
before you start, make sure you have:
6 1 Ohad Levy
7 1 Ohad Levy
* Puppet >= 0.24-4
8 1 Ohad Levy
* rake >= 0.84 
9 8 Ohad Levy
* rubygems
10 8 Ohad Levy
* ruby-sqlite3 (libsqlite3-ruby) if you are going to use sqlite as your database
11 8 Ohad Levy
* git (if installing from source )
12 1 Ohad Levy
13 44 Jochen Schalanda
The installation has been successfully tested on RHEL[5,6], Fedora[13,14], Debian Linux 5.0 (Lenny) and 6.0 (Squeeze) and Ubuntu Linux 10.04, 10.10, and 11.04. For older operating systems you might need additional packages (e.g. sqlite).
14 44 Jochen Schalanda
15 34 Ohad Levy
It is also known to work on Solaris and Mac.
16 1 Ohad Levy
17 8 Ohad Levy
h1. Download
18 1 Ohad Levy
19 13 Ohad Levy
h2. Puppet Module ready to use
20 13 Ohad Levy
21 13 Ohad Levy
You may try out the puppet Foreman module, this should take care for most of the basic setup.
22 13 Ohad Levy
23 25 Ohad Levy
The module could be downloaded via: http://github.com/ohadlevy/puppet-foreman/tarball/master
24 1 Ohad Levy
25 1 Ohad Levy
you may use puppet (if you don't want to add it as a module to your puppetmaster) in the following way:
26 1 Ohad Levy
27 32 Ohad Levy
if you are using RHEL, EPEL repo must be enabled http://fedoraproject.org/wiki/EPEL
28 1 Ohad Levy
29 25 Ohad Levy
If you are using puppet store configs please set $using_store_configs to true in foreman/manifests/init.pp.
30 25 Ohad Levy
If you want this module to configure passenger as well, set $using_passenger to true in foreman/manifests/init.pp
31 21 Ohad Levy
32 25 Ohad Levy
usage:
33 25 Ohad Levy
34 21 Ohad Levy
<pre>
35 35 Andrew Niemantsverdriet
echo include foreman | puppet  --verbose --modulepath /path_to/extracted_tarball
36 21 Ohad Levy
</pre>
37 21 Ohad Levy
38 13 Ohad Levy
*Its recommend to review the module prior usage.*
39 13 Ohad Levy
40 56 Romain Vrignaud
h2. [[Debian-Ubuntu installation by packages]]
41 29 Ohad Levy
42 1 Ohad Levy
43 55 Romain Vrignaud
h2. [[RPM's distribution based installation]]
44 1 Ohad Levy
45 23 Ohad Levy
46 56 Romain Vrignaud
h2. [[Installing latest code ]]
47 28 Ohad Levy
48 12 Ohad Levy
49 3 Ohad Levy
50 57 Romain Vrignaud
h2. [[Initial setup]]
51 52 Mikael Fridh
52 38 Paul Kelly
h1. Smart proxy installation
53 38 Paul Kelly
54 38 Paul Kelly
A smart proxy is an autonomous web-based foreman component that is placed on a host performing a specific function in the host commissioning phase. 
55 1 Ohad Levy
It receives requests from Foreman to perform operations that are required during the commissioning process and executes them on its behalf. More details can be found on the [[Foreman Architecture]] page.
56 1 Ohad Levy
57 42 Ohad Levy
To fully manage the commissioning process then a smart proxy will have to manipulate these services, DHCP, DNS, Puppet CA, Puppet and TFTP. These services may exist on separate machines or several of them may be hosted on the same machine. As each smart proxy instance is capable of managing all the of these services, there is only need for one proxy per host.
58 39 Paul Kelly
In the special case of a smart proxy managing a windows DHCP server, the host machine must be running Windows and support the *netsh dhcp* utility, it does not need to be the Microsoft DHCP server itself.
59 42 Ohad Levy
60 42 Ohad Levy
see [[Smart-Proxy:Installation_instructions]]
61 39 Paul Kelly
62 39 Paul Kelly
h2. Download
63 39 Paul Kelly
64 39 Paul Kelly
Download the smart proxy code from
65 39 Paul Kelly
* the git repository 
66 39 Paul Kelly
* the rpm location
67 40 Paul Kelly
* this zip file. 
68 39 Paul Kelly
69 39 Paul Kelly
When downloaded, extract into a suitable location and follow the README file.
70 1 Ohad Levy
71 8 Ohad Levy
h1. Future Updates
72 1 Ohad Levy
73 9 Ohad Levy
see [[Upgrade instructions]]
74 1 Ohad Levy
75 9 Ohad Levy
h1. Problems?
76 9 Ohad Levy
77 9 Ohad Levy
see [[Troubleshooting]]