RPM's distribution based installation¶

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

Stable¶

Puppet¶

yumrepo { 'foreman':
    descr => 'Foreman Repo',
    baseurl => 'http://yum.theforeman.org/stable',
    gpgcheck => '0',
    enabled => '1'
}

Quick and dirty¶

cat > /etc/yum.repos.d/foreman.repo << EOF
[foreman]
name=Foreman Repo
baseurl=http://yum.theforeman.org/stable
gpgcheck=0
enabled=1
EOF

yum install foreman

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

http://fedoraproject.org/wiki/EPEL

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

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

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

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)

5.) Configure

Edit /etc/foreman/settings.yaml and /etc/foreman/database.yml
su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate

6.) Start the foreman service or set up passenger

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

Example RHEL6 setup:

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

***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

Getting the RPMS¶

If you just want to get the rpms:

http://yum.theforeman.org