h1. RPM's distribution based installation

We maintain a repository for RHEL and Fedora (and clones) - you may add it via:

h2. Stable

h3. Puppet 

<pre>

yumrepo { 'foreman':

    descr => 'Foreman Repo',

    baseurl => 'http://yum.theforeman.org/stable',

    gpgcheck => '0',

    enabled => '1'

}

</pre>

h3. Quick and dirty

<pre>

cat > /etc/yum.repos.d/foreman.repo << EOF

[foreman]

name=Foreman Repo

baseurl=http://yum.theforeman.org/stable

gpgcheck=0

enabled=1

EOF

</pre>

<pre>

yum install foreman

</pre>

h2. Development

1.) For RHEL 6 ensure your system is subscribed to EPEL. For RHEL 5 you will need to be subscribed to both EPEL and the RHEL Virtualization RHN Channel

<pre>

http://fedoraproject.org/wiki/EPEL

</pre>

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

<pre>

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

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

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

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

</pre>

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

<pre>

foreman               Foreman server

foreman-proxy         Foreman Smart Proxy

foreman-cli           Foreman CLI utility

foreman-libvirt       libvirt provisioning support

foreman-ovirt         ovirt/RHEV provisioning support

foreman-ec2           EC2 provisioning support

foreman-vmware        VMware provisioning support

foreman-console       Console additions

foreman-mysql         MySQL database support

foreman-mysql2        MySQL database support

foreman-postgresql    PostgreSQL database support

foreman-sqlite        SQLite database support

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

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

</pre>

5.) Configure

<pre>

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

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

</pre>

6.) Start the foreman service or set up passenger

<pre>

service foreman start

(passenger packages/repos available at http://passenger.stealthymonkeys.com/ ***See note )

</pre>

Example RHEL6 setup:

<pre>

yum install http://mirror.symnds.com/distributions/fedora-epel/6/i386/epel-release-6-7.noarch.rpm 

yum install http://yum.theforeman.org/development/el6/foreman-release.rpm

yum install foreman foreman-proxy foreman-ovirt foreman-sqlite foreman-ec2 foreman-console foreman-cli foreman-libvirt foreman-mysql foreman-vmware 

vi /etc/settings/settings.yaml /etc/settings/database.yml

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

</pre>

<pre>

***Because Foreman requires ruby 1.8.7 it is upgraded on RHEL5 and so the RPM's at the URL above will not run on RHEL5. Fortunately the answer is fairly easy:

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

wget http://passenger.stealthymonkeys.com/SRPMS/rubygem-passenger-3.0.12-1.src.rpm; yum-builddep rubygem-passenger-3.0.12-1.src.rpm; rpmbuild --rebuild rubygem-passenger-3.0.12-1.src.rpm

If you get errors about being unable to find httpd.h or other files, ensure /usr/sbin is in your path so that the axps binary can be found

</pre>

h2. Getting the RPMS

If you just want to get the rpms:

http://yum.theforeman.org