Project

General

Profile

Installation instructions » History » Version 5

Rama Krishna, 09/11/2009 06:14 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 1 Ohad Levy
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)
34 1 Ohad Levy
35 1 Ohad Levy
to initialize the database schema type:
36 1 Ohad Levy
<code>RAILS_ENV=production rake db:migrate</code>
37 1 Ohad Levy
to start the built in web server:
38 1 Ohad Levy
<code>./script/server -e production</code>
39 1 Ohad Levy
40 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]].
41 1 Ohad Levy
42 1 Ohad Levy
Great - everything works! now learn what you can do by reading the [[FAQ]]
43 1 Ohad Levy
44 1 Ohad Levy
h2. Updates
45 1 Ohad Levy
46 4 Ohad Levy
If you would like to update to the latest version of the foreman, execute the following on the foreman directory
47 1 Ohad Levy
<pre><code>git pull
48 1 Ohad Levy
RAILS_ENV=production rake db:migrate
49 1 Ohad Levy
</code></pre>
50 1 Ohad Levy
51 1 Ohad Levy
and restart your web service.