Debian-Ubuntu installation by packages » History » Revision 7
Revision 6 (David Swift, 08/02/2012 04:37 PM) → Revision 7/12 (Greg Sutcliffe, 08/03/2012 06:31 PM)
h1. Debian-Ubuntu installation by packages
{{toc}}
The Foreman packages should work on the following Debian-based Linux distributions:
h2. Distributions
* Debian Linux 6.0 (Squeeze)
* Ubuntu Linux 12.04 LTS (32bit 12.04 has some problems with native libraries at the moment)
* Ubuntu Linux 11.04
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!":http://theforeman.org/projects/foreman/issues/new
h2. 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@):
<pre>
# 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
</pre>
The public key for "secure APT":http://wiki.debian.org/SecureApt can be downloaded "here":http://deb.theforeman.org/foreman.asc
You can add this key with
<pre>
apt-key add foreman.asc
</pre>
or combine downloading and registering:
<pre>
wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add -
</pre>
The key fingerprint is
<pre>
1DCB 15D1 2CA1 40EE F494 7E57 66CF 053F E775 FF07
Foreman Archive Signing Key <packages@theforeman.org>
</pre>
Remember to update your package lists!
<pre>
apt-get update
</pre>
h2. 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:
<pre>
# 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
</pre>
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.
h2. 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:
<pre>
apt-get update
apt-get dist-upgrade
</pre>
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).
<pre>apt-cache search foreman</pre>