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