Project

General

Profile

Edit History

Installation Guide » Installation instructions »

RPM's distribution based installation » History » Version 24

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
    
    
    
http://yum.theforeman.org/release/1.0/el5/foreman-release.rpm





    21
    
    
    
http://yum.theforeman.org/release/1.0/el6/foreman-release.rpm





    22
    
    
    
http://yum.theforeman.org/release/1.0/f16/foreman-release.rpm





    23
    
    
    
http://yum.theforeman.org/release/1.0/f17/foreman-release.rpm





    24
    
    
    
</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