Project

General

Profile

Installation instructions » History » Version 6

Ohad Levy, 09/11/2009 09:19 AM

1 1 Ohad Levy
h2. Requirements
2 1 Ohad Levy
3 1 Ohad Levy
before you start, make sure you have:
4 1 Ohad Levy
5 1 Ohad Levy
* Puppet >= 0.24-4
6 1 Ohad Levy
* rake >= 0.84 
7 1 Ohad Levy
* git
8 1 Ohad Levy
9 1 Ohad Levy
The installation has been successfully tested on RHE5 and Ubuntu 8.04 -  9.04,  for older operating systems you might need additional packages (e.g. sqlite)
10 1 Ohad Levy
11 1 Ohad Levy
h2. Download
12 1 Ohad Levy
13 1 Ohad Levy
to get latest "stable" version do:
14 1 Ohad Levy
15 4 Ohad Levy
<pre><code>git clone git://github.com/ohadlevy/foreman.git foreman
16 4 Ohad Levy
cd foreman
17 1 Ohad Levy
git submodule init
18 1 Ohad Levy
git submodule update
19 1 Ohad Levy
</code></pre>
20 1 Ohad Levy
21 1 Ohad Levy
* if you are behind a proxy or firewall and dont have access to github using the git protocol, use http protocol instead (e.g.)
22 5 Rama Krishna
<pre>
23 5 Rama Krishna
git clone http://github.com/ohadlevy/foreman.git foreman
24 5 Rama Krishna
cd foreman
25 5 Rama Krishna
sed -i 's/git:\/\//http:\/\//g' .gitmodules
26 5 Rama Krishna
git submodule init
27 5 Rama Krishna
git submodule update
28 5 Rama Krishna
</pre>
29 5 Rama Krishna
30 3 Ohad Levy
31 1 Ohad Levy
h2. Initial setup
32 1 Ohad Levy
33 6 Ohad Levy
h3. Database
34 1 Ohad Levy
35 6 Ohad Levy
Foreman uses a database, this database can be shared with Puppet store-configs (they are compatible, as Foreman extends the puppet database schema).
36 6 Ohad Levy
By default, SQLite is used, if you want to use other database (e.g. MySQL) please modify the configuration file under +config/database.yml+.
37 6 Ohad Levy
38 6 Ohad Levy
If you want to share the database with Puppets (storeconfig), just modify +config/database.yml+ to point to the same database configuration as puppet is.
39 6 Ohad Levy
40 6 Ohad Levy
In both cases, please use the *production* settings.
41 6 Ohad Levy
42 1 Ohad Levy
to initialize the database schema type:
43 1 Ohad Levy
<code>RAILS_ENV=production rake db:migrate</code>
44 6 Ohad Levy
45 6 Ohad Levy
h3. Import Data from Puppet
46 6 Ohad Levy
47 6 Ohad Levy
At this point, you might want to go through the [[FAQ]] to see how can you import your data into Foreman.
48 6 Ohad Levy
49 6 Ohad Levy
h3. Start The Web Server
50 6 Ohad Levy
51 6 Ohad Levy
Start the built in web server by typing:
52 1 Ohad Levy
<code>./script/server -e production</code>
53 1 Ohad Levy
54 6 Ohad Levy
and point your browser to http://foreman:3000
55 6 Ohad Levy
56 1 Ohad Levy
If you would like to keep the server running, I would recommend to setup passenger, an puppet manifest example could be found [[Passenger setup example|here]].
57 1 Ohad Levy
58 1 Ohad Levy
59 6 Ohad Levy
h2. Future Updates
60 1 Ohad Levy
61 1 Ohad Levy
If you would like to update to the latest version of the foreman, execute the following on the foreman directory
62 1 Ohad Levy
<pre><code>git pull
63 6 Ohad Levy
git submodule init
64 6 Ohad Levy
git submodule update
65 1 Ohad Levy
RAILS_ENV=production rake db:migrate
66 1 Ohad Levy
</code></pre>
67 1 Ohad Levy
68 1 Ohad Levy
and restart your web service.