Project

General

Profile

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>