| @@ -1,62 +1,67 | |||
|
|
1 | 1 | == Redmine installation |
|
|
2 | 2 | |
|
|
3 | 3 | Redmine - project management software |
|
|
4 | 4 | Copyright (C) 2006-2008 Jean-Philippe Lang |
|
|
5 | 5 | http://www.redmine.org/ |
|
|
6 | 6 | |
|
|
7 | 7 | |
|
|
8 | 8 | == Requirements |
|
|
9 | 9 | |
|
|
10 | 10 | * Ruby on Rails 2.1 |
|
|
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 | ||
|
|
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 | 39 | The user who runs Redmine must have write permission on the following |
|
|
35 | 40 | subdirectories: files, log, tmp (create the last one if not present). |
|
|
36 | 41 | |
|
|
37 | 42 | Assuming you run Redmine with a user named redmine: |
|
|
38 | 43 | mkdir tmp |
|
|
39 | 44 | sudo chown -R redmine:redmine files log tmp |
|
|
40 | 45 | sudo chmod -R 755 files log tmp |
|
|
41 | 46 | |
|
|
42 |
|
|
|
|
47 | 7. Test the installation by running WEBrick web server: | |
|
|
43 | 48 | ruby script/server -e production |
|
|
44 | 49 | |
|
|
45 | 50 | Once WEBrick has started, point your browser to http://localhost:3000/ |
|
|
46 | 51 | You should now see the application welcome page |
|
|
47 | 52 | |
|
|
48 |
|
|
|
|
53 | 8. Use default administrator account to log in: | |
|
|
49 | 54 | login: admin |
|
|
50 | 55 | password: admin |
|
|
51 | 56 | |
|
|
52 | 57 | Go to "Administration" to load the default configuration data (roles, |
|
|
53 | 58 | trackers, statuses, workflow) and adjust application settings |
|
|
54 | 59 | |
|
|
55 | 60 | |
|
|
56 | 61 | == Email delivery Configuration |
|
|
57 | 62 | |
|
|
58 | 63 | Copy config/email.yml.example to config/email.yml and edit this file |
|
|
59 | 64 | to adjust your SMTP settings. |
|
|
60 | 65 | Don't forget to restart the application after any change to this file. |
|
|
61 | 66 | |
|
|
62 | 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