Project

General

Profile

Installation instructions » History » Version 4

Ohad Levy, 09/09/2009 01:23 PM

1 1 Ohad Levy
h2. Requirements
2
3
before you start, make sure you have:
4
5
* Puppet >= 0.24-4
6
* rake >= 0.84 
7
* git
8
9
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
11
h2. Download
12
13
to get latest "stable" version do:
14
15 4 Ohad Levy
<pre><code>git clone git://github.com/ohadlevy/foreman.git foreman
16
cd foreman
17 1 Ohad Levy
git submodule init
18
git submodule update
19
</code></pre>
20
21
* 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 4 Ohad Levy
 git clone http://github.com/ohadlevy/foreman.git foreman
23
 and edit the .gitmodules (replace git:// with http:// and follow the previous instructions
24 3 Ohad Levy
25 1 Ohad Levy
h2. Initial setup
26
27
if you want to share the database with Puppets (storeconfig) edit config/database.yml and configure the *production* database to point to the same database, if not, you can use any other database rails support(MySQL, Sqlite etc)
28
29
to initialize the database schema type:
30
<code>RAILS_ENV=production rake db:migrate</code>
31
to start the built in web server:
32
<code>./script/server -e production</code>
33
34
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]].
35
36
Great - everything works! now learn what you can do by reading the [[FAQ]]
37
38
h2. Updates
39
40 4 Ohad Levy
If you would like to update to the latest version of the foreman, execute the following on the foreman directory
41 1 Ohad Levy
<pre><code>git pull
42
RAILS_ENV=production rake db:migrate
43
</code></pre>
44
45
and restart your web service.