Debian-Ubuntu installation by packages¶

• Table of contents
• Debian-Ubuntu installation by packages
  • Distributions
  • Apt Configuration
  • Install packages
  • Upgrading from 0.4.2

The Foreman packages should work on the following Debian-based Linux distributions:

Distributions¶

• Debian Linux 6.0 (Squeeze)
• Ubuntu Linux 12.04 LTS (32bit 12.04 has some problems with native libraries at the moment)

Foreman might still work on these distros, but it has not been tested:

• Debian Linux 5.0 (Lenny)
• Ubuntu Linux 11.04
• Ubuntu Linux 10.10

If you encounter any errors during the installation, please file a bug report!

Apt Configuration¶

Add one of the following lines to your /etc/apt/sources.list (alternatively in a separate file in /etc/apt/sources.list.d/foreman.list):

# Stable packages
deb http://deb.theforeman.org/ stable main

# Testing packages
deb http://deb.theforeman.org/ testing main

# Nightly builds. Beware: HERE BE DRAGONS
deb http://deb.theforeman.org/ nightly main

The public key for secure APT can be downloaded here

You can add this key with

apt-key add foreman.asc

or combine downloading and registering:

wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add -

The key fingerprint is

1DCB 15D1 2CA1 40EE F494  7E57 66CF 053F E775 FF07
Foreman Archive Signing Key <packages@theforeman.org>

Remember to update your package lists!

apt-get update

Install packages¶

The packages are now split by gem dependencies - there are 11 foreman* packages to choose from. These are:

Main package

• foreman

Database gems - you need at least one of these

• foreman-sqlite3
• foreman-mysql2
• foreman-mysql
• foreman-pgsql

Optional functionality

• foreman-console
• foreman-fog
• foreman-libvirt
• foreman-ovirt
• foreman-test
• foreman-vmware

Installation instructions are:

# Install packages  (adjust additional packages as needed)
apt-get install foreman foreman-sqlite3 foreman-libvirt

# Copy sample db config to /etc
cp /usr/share/foreman/config/database.yml.example /etc/foreman/database.yml

# Review settings and DB config
vi /etc/settings/settings.yaml /etc/foreman/database.yml

# Perform initial DB setup
su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate

The packages should auto-run db:migrate if /etc/foreman/database.yml exists. So the initial db:migrate is only needed during first install, upgrades should just work.

Upgrading from 0.4.2¶

Upgrading from 0.4.2 to 1.0 has been tested on Debian 6 (32 and 64 bit) and we expect that simply upgrading should work fine:

apt-get update
apt-get dist-upgrade

The packages include a db:migrate, so your database will be migrated too. However, please note the new split-package architecture - you may want check and see if any of the new dependencies fit your usecase(s).

apt-cache search foreman