Installation instructions » History » Version 6
Ohad Levy, 09/11/2009 09:19 AM
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 | 5 | Rama Krishna | <pre> |
23 | git clone http://github.com/ohadlevy/foreman.git foreman |
||
24 | cd foreman |
||
25 | sed -i 's/git:\/\//http:\/\//g' .gitmodules |
||
26 | git submodule init |
||
27 | git submodule update |
||
28 | </pre> |
||
29 | |||
30 | 3 | Ohad Levy | |
31 | 1 | Ohad Levy | h2. Initial setup |
32 | |||
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 | 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 | |||
38 | 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 | |||
40 | In both cases, please use the *production* settings. |
||
41 | |||
42 | 1 | Ohad Levy | to initialize the database schema type: |
43 | <code>RAILS_ENV=production rake db:migrate</code> |
||
44 | 6 | Ohad Levy | |
45 | h3. Import Data from Puppet |
||
46 | |||
47 | At this point, you might want to go through the [[FAQ]] to see how can you import your data into Foreman. |
||
48 | |||
49 | h3. Start The Web Server |
||
50 | |||
51 | Start the built in web server by typing: |
||
52 | 1 | Ohad Levy | <code>./script/server -e production</code> |
53 | |||
54 | 6 | Ohad Levy | and point your browser to http://foreman:3000 |
55 | |||
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 | |||
58 | |||
59 | 6 | Ohad Levy | h2. Future Updates |
60 | 1 | Ohad Levy | |
61 | If you would like to update to the latest version of the foreman, execute the following on the foreman directory |
||
62 | <pre><code>git pull |
||
63 | 6 | Ohad Levy | git submodule init |
64 | git submodule update |
||
65 | 1 | Ohad Levy | RAILS_ENV=production rake db:migrate |
66 | </code></pre> |
||
67 | |||
68 | and restart your web service. |