Project

General

Profile

RPM's distribution based installation » History » Version 27

Rytis Sileika, 08/01/2012 10:16 AM

1 1 Romain Vrignaud
h1. RPM's distribution based installation
2
3
We maintain a repository for RHEL and Fedora (and clones) - you may add it via:
4
5 23 Anonymous
h2. Release
6 1 Romain Vrignaud
7 24 Anonymous
1.) For RHEL 6 ensure your system is subscribed to EPEL. 
8
9
For RHEL 5 you will need to be subscribed to both EPEL and the RHEL Virtualization RHN Channel.
10
Also be advised, that on RHEL5 the Foreman Repo will update Ruby to version 1.8.7. This has 
11
the potential to break stuff (like passenger, notes on getting it working again below), 
12
so be sure you want to proceed before committing to the installation.
13
14
<pre>
15
http://fedoraproject.org/wiki/EPEL
16
</pre>
17
18
2.) Install the foreman-release.rpm for your version of RHEL or Fedora
19
<pre>
20 25 Anonymous
http://yum.theforeman.org/releases/1.0/el5/foreman-release.rpm
21
http://yum.theforeman.org/releases/1.0/el6/foreman-release.rpm
22
http://yum.theforeman.org/releases/1.0/f16/foreman-release.rpm
23
http://yum.theforeman.org/releases/1.0/f17/foreman-release.rpm
24 24 Anonymous
</pre>
25
26
3.) Install foreman and other foreman-* packages to add functionality:
27
<pre>
28
foreman               Foreman server
29
foreman-proxy         Foreman Smart Proxy
30
foreman-cli           Foreman CLI utility
31
foreman-libvirt       libvirt provisioning support
32
foreman-ovirt         ovirt/RHEV provisioning support
33
foreman-ec2           EC2 provisioning support
34
foreman-vmware        VMware provisioning support
35
foreman-console       Console additions
36
foreman-mysql         MySQL database support
37
foreman-mysql2        MySQL database support
38
foreman-postgresql    PostgreSQL database support
39
foreman-sqlite        SQLite database support
40
foreman-test          Testing support (dependency rpm's not built yet)
41
foreman-devel         Development support (dependency rpm's not built yet)
42
</pre>
43
44
5.) Configure
45
<pre>
46
Edit /etc/foreman/settings.yaml and /etc/foreman/database.yml
47
su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate
48
</pre>
49
50
6.) Start the foreman service or set up passenger
51
<pre>
52
service foreman start
53
</pre>
54 1 Romain Vrignaud
55 26 Rytis Sileika
7.) Set up Nginx + Passenger
56
57 24 Anonymous
58
On RHEL5 the RPM's at the URL above will not run after updating ruby. Fortunately it is fairly easy to get it working again. 
59
After foreman is installed ensure /usr/sbin is in your path so that the axps binary can be found, otherwise the rpm's may 
60
fail to build while complaining about being unable to find some files. Then do the following:
61
<pre>
62
yum localinstall http://passenger.stealthymonkeys.com/rhel/5/x86_64/rubygem-daemon_controller-0.2.5-1.noarch.rpm
63
wget http://passenger.stealthymonkeys.com/SRPMS/rubygem-passenger-3.0.12-1.src.rpm 
64
yum-builddep rubygem-passenger-3.0.12-1.src.rpm 
65
rpmbuild --rebuild rubygem-passenger-3.0.12-1.src.rpm
66
</pre>
67
68 2 Anonymous
h2. Development
69 1 Romain Vrignaud
70 19 Anonymous
1.) For RHEL 6 ensure your system is subscribed to EPEL. 
71
72
For RHEL 5 you will need to be subscribed to both EPEL and the RHEL Virtualization RHN Channel.
73
Also be advised, that on RHEL5 the Foreman Repo will update Ruby to version 1.8.7. This has 
74 20 Anonymous
the potential to break stuff (like passenger, notes on getting it working again below), 
75 19 Anonymous
so be sure you want to proceed before committing to the installation.
76
77 2 Anonymous
<pre>
78
http://fedoraproject.org/wiki/EPEL
79 1 Romain Vrignaud
</pre>
80 14 Anonymous
81 11 Anonymous
2.) Install the foreman-release.rpm for your version of RHEL or Fedora
82 1 Romain Vrignaud
<pre>
83 14 Anonymous
http://yum.theforeman.org/development/el5/foreman-release.rpm
84 5 Anonymous
http://yum.theforeman.org/development/el6/foreman-release.rpm
85
http://yum.theforeman.org/development/f16/foreman-release.rpm
86
http://yum.theforeman.org/development/f17/foreman-release.rpm
87 2 Anonymous
</pre>
88 1 Romain Vrignaud
89 2 Anonymous
3.) Install foreman and other foreman-* packages to add functionality:
90 3 Anonymous
<pre>
91 7 Anonymous
foreman               Foreman server
92
foreman-proxy         Foreman Smart Proxy
93
foreman-cli           Foreman CLI utility
94
foreman-libvirt       libvirt provisioning support
95
foreman-ovirt         ovirt/RHEV provisioning support
96 12 Anonymous
foreman-ec2           EC2 provisioning support
97 7 Anonymous
foreman-vmware        VMware provisioning support
98
foreman-console       Console additions
99
foreman-mysql         MySQL database support
100
foreman-mysql2        MySQL database support
101
foreman-postgresql    PostgreSQL database support
102
foreman-sqlite        SQLite database support
103
foreman-test          Testing support (dependency rpm's not built yet)
104
foreman-devel         Development support (dependency rpm's not built yet)
105 2 Anonymous
</pre>
106
107
5.) Configure
108
<pre>
109
Edit /etc/foreman/settings.yaml and /etc/foreman/database.yml
110 9 Anonymous
su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate
111 2 Anonymous
</pre>
112
113
6.) Start the foreman service or set up passenger
114
<pre>
115
service foreman start
116 21 Anonymous
</pre>
117 16 Anonymous
Or:
118
119 1 Romain Vrignaud
Passenger packages/repos are available at http://passenger.stealthymonkeys.com/
120 21 Anonymous
121
On RHEL5 the RPM's at the URL above will not run after updating ruby. Fortunately it is fairly easy to get it working again. 
122
After foreman is installed ensure /usr/sbin is in your path so that the axps binary can be found, otherwise the rpm's may 
123
fail to build while complaining about being unable to find some files. Then do the following:
124
<pre>
125 16 Anonymous
yum localinstall http://passenger.stealthymonkeys.com/rhel/5/x86_64/rubygem-daemon_controller-0.2.5-1.noarch.rpm
126 18 Anonymous
wget http://passenger.stealthymonkeys.com/SRPMS/rubygem-passenger-3.0.12-1.src.rpm 
127 2 Anonymous
yum-builddep rubygem-passenger-3.0.12-1.src.rpm 
128 1 Romain Vrignaud
rpmbuild --rebuild rubygem-passenger-3.0.12-1.src.rpm
129 15 Anonymous
</pre>
130
131 22 Anonymous
h2. Nightly Builds
132
133
Create a /etc/yum.repos.d/foreman-nightly.repo with the following contents:
134
el5:
135
<pre>
136
[foreman-nightly]
137
name=foreman-nightly
138
baseurl=http://yum.theforeman.org/nightly/el5/$basearch
139
gpgcheck=0
140
enabled=1
141
142
[foreman-nightly-source]
143
name=foreman-nightly
144
baseurl=http://yum.theforeman.org/nightly/el5/source
145
gpgcheck=0
146
enabled=0
147
</pre>
148
149
el6:
150
<pre>
151
[foreman-nightly]
152
name=foreman-nightly
153
baseurl=http://yum.theforeman.org/nightly/el6/$basearch
154
gpgcheck=0
155
enabled=1
156
157
[foreman-nightly-source]
158
name=foreman-nightly
159
baseurl=http://yum.theforeman.org/nightly/el6/source
160
gpgcheck=0
161
enabled=0
162
</pre>
163
164
f16:
165
<pre>
166
[foreman-nightly]
167
name=foreman-nightly
168
baseurl=http://yum.theforeman.org/nightly/f16/$basearch
169
gpgcheck=0
170
enabled=1
171
172
[foreman-nightly-source]
173
name=foreman-nightly
174
baseurl=http://yum.theforeman.org/nightly/f16/source
175
gpgcheck=0
176
enabled=0
177
</pre>
178
179
f17:
180
<pre>
181
[foreman-nightly]
182
name=foreman-nightly
183
baseurl=http://yum.theforeman.org/nightly/f17/$basearch
184
gpgcheck=0
185
enabled=1
186
187
[foreman-nightly-source]
188
name=foreman-nightly
189
baseurl=http://yum.theforeman.org/nightly/f17/source
190
gpgcheck=0
191
enabled=0
192
</pre>
193
194 1 Romain Vrignaud
h2. Getting the RPMS
195 6 Anonymous
196 1 Romain Vrignaud
If you just want to get the rpms:
197 6 Anonymous
198 1 Romain Vrignaud
http://yum.theforeman.org