@@ -1,62 +1,67 | |||||
1 | == Redmine installation |
|
1 | == Redmine installation | |
2 |
|
2 | |||
3 | Redmine - project management software |
|
3 | Redmine - project management software | |
4 | Copyright (C) 2006-2008 Jean-Philippe Lang |
|
4 | Copyright (C) 2006-2008 Jean-Philippe Lang | |
5 | http://www.redmine.org/ |
|
5 | http://www.redmine.org/ | |
6 |
|
6 | |||
7 |
|
7 | |||
8 | == Requirements |
|
8 | == Requirements | |
9 |
|
9 | |||
10 | * Ruby on Rails 2.1 |
|
10 | * Ruby on Rails 2.1 | |
11 | * A database: |
|
11 | * A database: | |
12 | * MySQL (tested with MySQL 5) |
|
12 | * MySQL (tested with MySQL 5) | |
13 | * PostgreSQL (tested with PostgreSQL 8.1) |
|
13 | * PostgreSQL (tested with PostgreSQL 8.1) | |
14 | * SQLite (tested with SQLite 3) |
|
14 | * SQLite (tested with SQLite 3) | |
15 |
|
15 | |||
16 | Optional: |
|
16 | Optional: | |
17 | * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) |
|
17 | * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) | |
18 | * RMagick (gantt export to png) |
|
18 | * RMagick (gantt export to png) | |
19 |
|
19 | |||
20 | == Installation |
|
20 | == Installation | |
21 |
|
21 | |||
22 | 1. Uncompress the program archive |
|
22 | 1. Uncompress the program archive | |
23 |
|
23 | |||
24 | 2. Create an empty database: "redmine" for example |
|
24 | 2. Create an empty database: "redmine" for example | |
25 |
|
25 | |||
26 | 3. Configure database parameters in config/database.yml |
|
26 | 3. Configure database parameters in config/database.yml | |
27 | for "production" environment (default database is MySQL) |
|
27 | for "production" environment (default database is MySQL) | |
28 |
|
28 | |||
29 | 4. Create the database structure. Under the application main directory: |
|
29 | 4. Create the database structure. Under the application main directory: | |
30 | rake db:migrate RAILS_ENV="production" |
|
30 | rake db:migrate RAILS_ENV="production" | |
31 | It will create tables and an administrator account. |
|
31 | It will create tables and an administrator account. | |
|
32 | ||||
|
33 | 5. Generate a session store secret | |||
|
34 | Redmine stores session data in cookies by default, which requires | |||
|
35 | a secret to be generated. Run: | |||
|
36 | rake config/initializers/session_store.rb | |||
32 |
|
37 | |||
33 |
|
|
38 | 6. Setting up permissions | |
34 | The user who runs Redmine must have write permission on the following |
|
39 | The user who runs Redmine must have write permission on the following | |
35 | subdirectories: files, log, tmp (create the last one if not present). |
|
40 | subdirectories: files, log, tmp (create the last one if not present). | |
36 |
|
41 | |||
37 | Assuming you run Redmine with a user named redmine: |
|
42 | Assuming you run Redmine with a user named redmine: | |
38 | mkdir tmp |
|
43 | mkdir tmp | |
39 | sudo chown -R redmine:redmine files log tmp |
|
44 | sudo chown -R redmine:redmine files log tmp | |
40 | sudo chmod -R 755 files log tmp |
|
45 | sudo chmod -R 755 files log tmp | |
41 |
|
46 | |||
42 |
|
|
47 | 7. Test the installation by running WEBrick web server: | |
43 | ruby script/server -e production |
|
48 | ruby script/server -e production | |
44 |
|
49 | |||
45 | Once WEBrick has started, point your browser to http://localhost:3000/ |
|
50 | Once WEBrick has started, point your browser to http://localhost:3000/ | |
46 | You should now see the application welcome page |
|
51 | You should now see the application welcome page | |
47 |
|
52 | |||
48 |
|
|
53 | 8. Use default administrator account to log in: | |
49 | login: admin |
|
54 | login: admin | |
50 | password: admin |
|
55 | password: admin | |
51 |
|
56 | |||
52 | Go to "Administration" to load the default configuration data (roles, |
|
57 | Go to "Administration" to load the default configuration data (roles, | |
53 | trackers, statuses, workflow) and adjust application settings |
|
58 | trackers, statuses, workflow) and adjust application settings | |
54 |
|
59 | |||
55 |
|
60 | |||
56 | == Email delivery Configuration |
|
61 | == Email delivery Configuration | |
57 |
|
62 | |||
58 | Copy config/email.yml.example to config/email.yml and edit this file |
|
63 | Copy config/email.yml.example to config/email.yml and edit this file | |
59 | to adjust your SMTP settings. |
|
64 | to adjust your SMTP settings. | |
60 | Don't forget to restart the application after any change to this file. |
|
65 | Don't forget to restart the application after any change to this file. | |
61 |
|
66 | |||
62 | Please do not enter your SMTP settings in environment.rb. |
|
67 | Please do not enter your SMTP settings in environment.rb. |
General Comments 0
You need to be logged in to leave comments.
Login now