Debian-Ubuntu installation by packages » History » Revision 11

Revision 10 (Matt John, 09/03/2012 03:39 PM) → Revision 11/12 (Greg Sutcliffe, 10/23/2012 10:34 AM)

h1. Debian-Ubuntu installation by packages 


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

 h2. Distributions 

 * Debian Linux 6.0 (Squeeze) 
 * Ubuntu Linux 12.04 LTS 

 Foreman might still work on these distros, but it has not been tested (let us know if it works for you): 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!": 

 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@): 

 # Stable packages 

 # Debian Squeeze 
 deb squeeze stable 

 # Ubuntu Precise Testing packages 
 deb precise stable testing main 

 # Nightly builds. Beware: HERE BE DRAGONS 

 # Debian Squeeze 
 deb squeeze nightly 
 # Ubuntu Precise 
 deb precise 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 -O- | apt-key add - 

 The key fingerprint is 
 1DCB 15D1 2CA1 40EE F494    7E57 66CF 053F E775 FF07 
 Foreman Archive Signing Key <> 

 Remember to update your package lists! 

 apt-get update 

 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: 
 # 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/foreman/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. 

 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: 

 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). 

 <pre>apt-cache search foreman</pre>