Debian-Ubuntu installation by packages » History » Revision 8
Revision 7 (Greg Sutcliffe, 08/03/2012 06:31 PM) → Revision 8/12 (Greg Sutcliffe, 08/05/2012 08:01 AM)
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":http://theforeman.org/projects/foreman/wiki/Debian-Ubuntu_installation_by_packages/#Issues-with-Ubuntu) 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!":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.
h3. Issues with Ubuntu
Presently Ubuntu12.04 has a couple of issues. Firstly, it already contains some of the libraries we require, but at newer versions than we can use. As such, you may need to downgrade them if they are already installed. This applies to both 64bit and 32bit.
32-bit Ubuntu has significant errors to do with native libraries, which we have not yet been able to track down yet. The native-arch packages (such as ruby-libvirt or ruby-sqlite3) will install but will not actually be usable. The simplest fix to this is to do "gem install sqlite3" (or whatever the broken gem is) which should fix the issue.
We will look into providing a separate Ubuntu repository at some point in the future when we can provide packages dedicated to solving these issues.
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>