Project

General

Profile

Edit History

Installation Guide » Installation instructions »

RPM's distribution based installation » History » Version 23

Anonymous, 07/23/2012 02:18 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
    23
    Anonymous
    
http://theforeman.org/projects/foreman/wiki/RPM%2527s_distribution_based_installation/edit





    8
    2
    Anonymous
    
h2. Development





    9
    1
    Romain Vrignaud
    





    10
    19
    Anonymous
    
1.) For RHEL 6 ensure your system is subscribed to EPEL. 





    11
    
    
    





    12
    
    
    
For RHEL 5 you will need to be subscribed to both EPEL and the RHEL Virtualization RHN Channel.





    13
    
    
    
Also be advised, that on RHEL5 the Foreman Repo will update Ruby to version 1.8.7. This has 





    14
    20
    Anonymous
    
the potential to break stuff (like passenger, notes on getting it working again below), 





    15
    19
    Anonymous
    
so be sure you want to proceed before committing to the installation.





    16
    
    
    





    17
    2
    Anonymous
    
<pre>





    18
    
    
    
http://fedoraproject.org/wiki/EPEL





    19
    1
    Romain Vrignaud
    
</pre>





    20
    14
    Anonymous
    





    21
    11
    Anonymous
    
2.) Install the foreman-release.rpm for your version of RHEL or Fedora





    22
    1
    Romain Vrignaud
    
<pre>





    23
    14
    Anonymous
    
http://yum.theforeman.org/development/el5/foreman-release.rpm





    24
    5
    Anonymous
    
http://yum.theforeman.org/development/el6/foreman-release.rpm





    25
    
    
    
http://yum.theforeman.org/development/f16/foreman-release.rpm





    26
    
    
    
http://yum.theforeman.org/development/f17/foreman-release.rpm





    27
    2
    Anonymous
    
</pre>





    28
    1
    Romain Vrignaud
    





    29
    2
    Anonymous
    
3.) Install foreman and other foreman-* packages to add functionality:





    30
    3
    Anonymous
    
<pre>





    31
    7
    Anonymous
    
foreman               Foreman server





    32
    
    
    
foreman-proxy         Foreman Smart Proxy





    33
    
    
    
foreman-cli           Foreman CLI utility





    34
    
    
    
foreman-libvirt       libvirt provisioning support





    35
    
    
    
foreman-ovirt         ovirt/RHEV provisioning support





    36
    12
    Anonymous
    
foreman-ec2           EC2 provisioning support





    37
    7
    Anonymous
    
foreman-vmware        VMware provisioning support





    38
    
    
    
foreman-console       Console additions





    39
    
    
    
foreman-mysql         MySQL database support





    40
    
    
    
foreman-mysql2        MySQL database support





    41
    
    
    
foreman-postgresql    PostgreSQL database support





    42
    
    
    
foreman-sqlite        SQLite database support





    43
    
    
    
foreman-test          Testing support (dependency rpm's not built yet)





    44
    
    
    
foreman-devel         Development support (dependency rpm's not built yet)





    45
    2
    Anonymous
    
</pre>





    46
    
    
    





    47
    
    
    
5.) Configure





    48
    
    
    
<pre>





    49
    
    
    
Edit /etc/foreman/settings.yaml and /etc/foreman/database.yml





    50
    9
    Anonymous
    
su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate





    51
    2
    Anonymous
    
</pre>





    52
    
    
    





    53
    
    
    
6.) Start the foreman service or set up passenger





    54
    
    
    
<pre>





    55
    
    
    
service foreman start





    56
    21
    Anonymous
    
</pre>





    57
    16
    Anonymous
    
Or:





    58
    
    
    





    59
    1
    Romain Vrignaud
    
Passenger packages/repos are available at http://passenger.stealthymonkeys.com/





    60
    21
    Anonymous
    





    61
    
    
    
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. 





    62
    
    
    
After foreman is installed ensure /usr/sbin is in your path so that the axps binary can be found, otherwise the rpm's may 





    63
    
    
    
fail to build while complaining about being unable to find some files. Then do the following:





    64
    
    
    
<pre>





    65
    16
    Anonymous
    
yum localinstall http://passenger.stealthymonkeys.com/rhel/5/x86_64/rubygem-daemon_controller-0.2.5-1.noarch.rpm





    66
    18
    Anonymous
    
wget http://passenger.stealthymonkeys.com/SRPMS/rubygem-passenger-3.0.12-1.src.rpm 





    67
    2
    Anonymous
    
yum-builddep rubygem-passenger-3.0.12-1.src.rpm 





    68
    1
    Romain Vrignaud
    
rpmbuild --rebuild rubygem-passenger-3.0.12-1.src.rpm





    69
    15
    Anonymous
    
</pre>





    70
    
    
    





    71
    22
    Anonymous
    
h2. Nightly Builds





    72
    
    
    





    73
    
    
    
Create a /etc/yum.repos.d/foreman-nightly.repo with the following contents:





    74
    
    
    
el5:





    75
    
    
    
<pre>





    76
    
    
    
[foreman-nightly]





    77
    
    
    
name=foreman-nightly





    78
    
    
    
baseurl=http://yum.theforeman.org/nightly/el5/$basearch





    79
    
    
    
gpgcheck=0





    80
    
    
    
enabled=1





    81
    
    
    





    82
    
    
    
[foreman-nightly-source]





    83
    
    
    
name=foreman-nightly





    84
    
    
    
baseurl=http://yum.theforeman.org/nightly/el5/source





    85
    
    
    
gpgcheck=0





    86
    
    
    
enabled=0





    87
    
    
    
</pre>





    88
    
    
    





    89
    
    
    
el6:





    90
    
    
    
<pre>





    91
    
    
    
[foreman-nightly]





    92
    
    
    
name=foreman-nightly





    93
    
    
    
baseurl=http://yum.theforeman.org/nightly/el6/$basearch





    94
    
    
    
gpgcheck=0





    95
    
    
    
enabled=1





    96
    
    
    





    97
    
    
    
[foreman-nightly-source]





    98
    
    
    
name=foreman-nightly





    99
    
    
    
baseurl=http://yum.theforeman.org/nightly/el6/source





    100
    
    
    
gpgcheck=0





    101
    
    
    
enabled=0





    102
    
    
    
</pre>





    103
    
    
    





    104
    
    
    
f16:





    105
    
    
    
<pre>





    106
    
    
    
[foreman-nightly]





    107
    
    
    
name=foreman-nightly





    108
    
    
    
baseurl=http://yum.theforeman.org/nightly/f16/$basearch





    109
    
    
    
gpgcheck=0





    110
    
    
    
enabled=1





    111
    
    
    





    112
    
    
    
[foreman-nightly-source]





    113
    
    
    
name=foreman-nightly





    114
    
    
    
baseurl=http://yum.theforeman.org/nightly/f16/source





    115
    
    
    
gpgcheck=0





    116
    
    
    
enabled=0





    117
    
    
    
</pre>





    118
    
    
    





    119
    
    
    
f17:





    120
    
    
    
<pre>





    121
    
    
    
[foreman-nightly]





    122
    
    
    
name=foreman-nightly





    123
    
    
    
baseurl=http://yum.theforeman.org/nightly/f17/$basearch





    124
    
    
    
gpgcheck=0





    125
    
    
    
enabled=1





    126
    
    
    





    127
    
    
    
[foreman-nightly-source]





    128
    
    
    
name=foreman-nightly





    129
    
    
    
baseurl=http://yum.theforeman.org/nightly/f17/source





    130
    
    
    
gpgcheck=0





    131
    
    
    
enabled=0





    132
    
    
    
</pre>





    133
    
    
    





    134
    1
    Romain Vrignaud
    
h2. Getting the RPMS





    135
    6
    Anonymous
    





    136
    1
    Romain Vrignaud
    
If you just want to get the rpms:





    137
    6
    Anonymous
    





    138
    1
    Romain Vrignaud
    
http://yum.theforeman.org