Debian-Ubuntu installation by packages » History » Revision 5
Revision 4 (Greg Sutcliffe, 07/10/2012 09:50 AM) → Revision 5/12 (Greg Sutcliffe, 08/02/2012 04:11 PM)
h1. Debian-Ubuntu installation by packages
{{toc}}
The Foreman packages should work on the following Debian-based Linux distributions:
h2. Distributions
* Debian Linux 5.0 (Lenny), see [[Debian-Ubuntu installation by packages#Debian-Linux-50-Lenny|notes below]]
* Debian Linux 6.0 (Squeeze)
* Ubuntu Linux 12.04 LTS
* Ubuntu Linux 11.04
Foreman might still work on these distros, but it has not been tested:
* Debian Linux 5.0 (Lenny)
* Ubuntu Linux 10.10
If you encounter any errors during the installation, please file a bug report!
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! h2. Stable / Testing Install
To install Foreman, run
<pre>
sudo apt-get update
# Depending on the database you want to use with Foreman,
# install one of these meta-packages:
sudo apt-get install foreman-mysql
sudo apt-get install foreman-pgsql
sudo apt-get install foreman-sqlite3
# or install the foreman main package and configure the
# database manually in /etc/foreman/database.yml
sudo apt-get install foreman
</pre>
The only purpose of the meta-packages @foreman-mysql@, @foreman-pgsql@, and @foreman-sqlite3@ is to pull in any dependencies on the respective database system during the package installation. If you don't want to run the Foreman database on the same host, please use the @foreman@ package and configure the database settings in @/etc/foreman/database.yml@. You cannot use @dbconfig-common@ in this case.
h2. Nightly Install packages
The nightly packages are now split by gem dependencies - there are 11 12 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-development
* 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 Debian Linux 5.0 (Lenny)
Upgrading from 0.4.2 Lenny is unlikely to work with the 1.0 release of Foreman, but this has not yet been tested on - let us know if you get it working :)
For 0.4, users of Debian 6 (32 Lenny will have to install "rake":http://packages.debian.org/lenny-backports/rake and 64 bit) and we expect that simply upgrading should work fine: "libsinatra-ruby":http://packages.debian.org/lenny-backports/libsinatra-ruby from @lenny-backports@.
<pre>
apt-get update
apt-get dist-upgrade
</pre>
The packages include a db:migrate, so See http://backports.debian.org/Instructions/ for instructions on how to add @lenny-backports@ to your database will be migrated too. However, please note the new split-package architecture - you may want check list of repositories and see if any of the new dependencies fit your usecase(s).
<pre>apt-cache search foreman</pre>
install a package from it.