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