Debian-Ubuntu installation by packages » History » Version 11
Greg Sutcliffe, 10/23/2012 10:34 AM
| 1 | 1 | Romain Vrignaud | h1. Debian-Ubuntu installation by packages |
|---|---|---|---|
| 2 | |||
| 3 | 3 | Greg Sutcliffe | {{toc}} |
| 4 | 1 | Romain Vrignaud | |
| 5 | The Foreman packages should work on the following Debian-based Linux distributions: |
||
| 6 | |||
| 7 | 3 | Greg Sutcliffe | h2. Distributions |
| 8 | |||
| 9 | 1 | Romain Vrignaud | * Debian Linux 6.0 (Squeeze) |
| 10 | 9 | Greg Sutcliffe | * Ubuntu Linux 12.04 LTS |
| 11 | 5 | Greg Sutcliffe | |
| 12 | 11 | Greg Sutcliffe | Foreman might still work on these distros, but it has not been tested (let us know if it works for you): |
| 13 | 1 | Romain Vrignaud | |
| 14 | 5 | Greg Sutcliffe | * Debian Linux 5.0 (Lenny) |
| 15 | 7 | Greg Sutcliffe | * Ubuntu Linux 11.04 |
| 16 | 3 | Greg Sutcliffe | * Ubuntu Linux 10.10 |
| 17 | 1 | Romain Vrignaud | |
| 18 | 6 | David Swift | If you encounter any errors during the installation, "please file a bug report!":http://theforeman.org/projects/foreman/issues/new |
| 19 | 1 | Romain Vrignaud | |
| 20 | 3 | Greg Sutcliffe | h2. Apt Configuration |
| 21 | 1 | Romain Vrignaud | |
| 22 | 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@): |
||
| 23 | |||
| 24 | <pre> |
||
| 25 | # Stable packages |
||
| 26 | |||
| 27 | 11 | Greg Sutcliffe | # Debian Squeeze |
| 28 | deb http://deb.theforeman.org/ squeeze stable |
||
| 29 | # Ubuntu Precise |
||
| 30 | deb http://deb.theforeman.org/ precise stable |
||
| 31 | 1 | Romain Vrignaud | |
| 32 | # Nightly builds. Beware: HERE BE DRAGONS |
||
| 33 | 11 | Greg Sutcliffe | |
| 34 | # Debian Squeeze |
||
| 35 | deb http://deb.theforeman.org/ squeeze nightly |
||
| 36 | # Ubuntu Precise |
||
| 37 | deb http://deb.theforeman.org/ precise nightly |
||
| 38 | 1 | Romain Vrignaud | </pre> |
| 39 | |||
| 40 | The public key for "secure APT":http://wiki.debian.org/SecureApt can be downloaded "here":http://deb.theforeman.org/foreman.asc |
||
| 41 | |||
| 42 | You can add this key with |
||
| 43 | <pre> |
||
| 44 | apt-key add foreman.asc |
||
| 45 | </pre> |
||
| 46 | |||
| 47 | or combine downloading and registering: |
||
| 48 | <pre> |
||
| 49 | wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add - |
||
| 50 | </pre> |
||
| 51 | |||
| 52 | The key fingerprint is |
||
| 53 | <pre> |
||
| 54 | 1DCB 15D1 2CA1 40EE F494 7E57 66CF 053F E775 FF07 |
||
| 55 | 3 | Greg Sutcliffe | Foreman Archive Signing Key <packages@theforeman.org> |
| 56 | 1 | Romain Vrignaud | </pre> |
| 57 | |||
| 58 | 5 | Greg Sutcliffe | Remember to update your package lists! |
| 59 | 1 | Romain Vrignaud | |
| 60 | <pre> |
||
| 61 | 5 | Greg Sutcliffe | apt-get update |
| 62 | 1 | Romain Vrignaud | </pre> |
| 63 | |||
| 64 | 5 | Greg Sutcliffe | h2. Install packages |
| 65 | 1 | Romain Vrignaud | |
| 66 | 5 | Greg Sutcliffe | The packages are now split by gem dependencies - there are 11 foreman* packages to choose from. These are: |
| 67 | 1 | Romain Vrignaud | |
| 68 | 3 | Greg Sutcliffe | Main package |
| 69 | * foreman |
||
| 70 | |||
| 71 | Database gems - you need at least one of these |
||
| 72 | * foreman-sqlite3 |
||
| 73 | * foreman-mysql2 |
||
| 74 | * foreman-mysql |
||
| 75 | * foreman-pgsql |
||
| 76 | |||
| 77 | Optional functionality |
||
| 78 | * foreman-console |
||
| 79 | * foreman-fog |
||
| 80 | * foreman-libvirt |
||
| 81 | * foreman-ovirt |
||
| 82 | 1 | Romain Vrignaud | * foreman-test |
| 83 | 3 | Greg Sutcliffe | * foreman-vmware |
| 84 | 1 | Romain Vrignaud | |
| 85 | 3 | Greg Sutcliffe | Installation instructions are: |
| 86 | 1 | Romain Vrignaud | <pre> |
| 87 | # Install packages (adjust additional packages as needed) |
||
| 88 | apt-get install foreman foreman-sqlite3 foreman-libvirt |
||
| 89 | |||
| 90 | 3 | Greg Sutcliffe | # Copy sample db config to /etc |
| 91 | 1 | Romain Vrignaud | cp /usr/share/foreman/config/database.yml.example /etc/foreman/database.yml |
| 92 | |||
| 93 | # Review settings and DB config |
||
| 94 | 10 | Matt John | vi /etc/foreman/settings.yaml /etc/foreman/database.yml |
| 95 | 3 | Greg Sutcliffe | |
| 96 | # Perform initial DB setup |
||
| 97 | su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate |
||
| 98 | </pre> |
||
| 99 | 4 | Greg Sutcliffe | |
| 100 | 8 | Greg Sutcliffe | 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. |
| 101 | 3 | Greg Sutcliffe | |
| 102 | 5 | Greg Sutcliffe | h2. Upgrading from 0.4.2 |
| 103 | 3 | Greg Sutcliffe | |
| 104 | 5 | Greg Sutcliffe | 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: |
| 105 | 4 | Greg Sutcliffe | |
| 106 | 5 | Greg Sutcliffe | <pre> |
| 107 | apt-get update |
||
| 108 | apt-get dist-upgrade |
||
| 109 | </pre> |
||
| 110 | 3 | Greg Sutcliffe | |
| 111 | 5 | Greg Sutcliffe | 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). |
| 112 | |||
| 113 | <pre>apt-cache search foreman</pre> |