Project

General

Profile

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>