RPM's distribution based installation » History » Version 25
Anonymous, 07/23/2012 02:21 PM
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 | Or: |
||
55 | |||
56 | Passenger packages/repos are available at http://passenger.stealthymonkeys.com/ |
||
57 | |||
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 |