| @@ -1,66 +1,71 | |||
|
|
1 | 1 | == redMine installation |
|
|
2 | 2 | |
|
|
3 | 3 | redMine - project management software |
|
|
4 | 4 | Copyright (C) 2006 Jean-Philippe Lang |
|
|
5 | 5 | http://redmine.org/ |
|
|
6 | 6 | |
|
|
7 | 7 | |
|
|
8 | 8 | == Requirements |
|
|
9 | 9 | |
|
|
10 | 10 | * Ruby on Rails 1.1 |
|
|
11 | 11 | * Iconv |
|
|
12 | 12 | * Net::LDAP for Ruby (for LDAP authentication) |
|
|
13 | 13 | * a database (see compatibility below) |
|
|
14 | 14 | * (recommended) Apache/Lighttpd with FCGI support |
|
|
15 | 15 | |
|
|
16 | 16 | Supported databases: |
|
|
17 | 17 | |
|
|
18 | 18 | * MySQL (tested with MySQL 5) |
|
|
19 | 19 | * PostgreSQL (tested with PostgreSQL 8.1) |
|
|
20 | 20 | * Oracle (tested with Oracle 10g) |
|
|
21 | 21 | * SQL Server (tested with SQL Server 2005) |
|
|
22 | 22 | * SQLite (tested with SQLite 3) |
|
|
23 | 23 | |
|
|
24 | 24 | == Upgrade |
|
|
25 | 25 | |
|
|
26 | 26 | Due to major database changes, there is no migration support from beta 0.2.0. |
|
|
27 | 27 | Next releases (0.3.0+) will be provided with upgrade support. |
|
|
28 | 28 | |
|
|
29 | 29 | |
|
|
30 | 30 | == Installation |
|
|
31 | 31 | |
|
|
32 | 32 | 1. Uncompress program archive: |
|
|
33 | 33 | tar zxvf <filename> |
|
|
34 | 34 | |
|
|
35 | 35 | 2. Create an empty database: "redmine" for example |
|
|
36 | 36 | |
|
|
37 | 37 | 3. Configure database parameters in config/database.yml |
|
|
38 | 38 | for "production" environment (default database is MySQL) |
|
|
39 | 39 | |
|
|
40 | 40 | 4. Create the database structure. Under application main directory: |
|
|
41 | 41 | rake migrate RAILS_ENV="production" |
|
|
42 | 42 | It will create tables and default configuration data |
|
|
43 | 43 | |
|
|
44 | 5. Test the installation by running WEBrick web server: | |
|
|
44 | 5. Insert default configuration data in database: | |
|
|
45 | rake load_default_data RAILS_ENV="production" | |
|
|
46 | This step is optional, as you can define your own configuration | |
|
|
47 | (roles, trackers, statuses, workflows, enumerations) from sratch | |
|
|
48 | ||
|
|
49 | 6. Test the installation by running WEBrick web server: | |
|
|
45 | 50 | ruby script/server -e production |
|
|
46 | 51 | |
|
|
47 | 52 | Once WEBrick has started, point your browser to http://localhost:3000/ |
|
|
48 | 53 | You should now see the application welcome page |
|
|
49 | 54 | |
|
|
50 |
|
|
|
|
55 | 7. Use default administrator account to log in: | |
|
|
51 | 56 | login: admin |
|
|
52 | 57 | password: admin |
|
|
53 | 58 | |
|
|
54 |
|
|
|
|
59 | 8. Setup Apache or Lighttpd with fastcgi for best performance. | |
|
|
55 | 60 | |
|
|
56 | 61 | |
|
|
57 | 62 | == Configuration |
|
|
58 | 63 | |
|
|
59 | 64 | A sample configuration file is provided: "config/config_custom.example.rb" |
|
|
60 | 65 | Rename it to config_custom.rb and edit parameters. |
|
|
61 | 66 | Don't forget to restart the application after any change. |
|
|
62 | 67 | |
|
|
63 | 68 | |
|
|
64 | 69 | config.action_mailer.server_settings: SMTP server configuration |
|
|
65 | 70 | config.action_mailer.perform_deliveries: set to false to disable mail delivering |
|
|
66 | 71 | |
General Comments 0
You need to be logged in to leave comments.
Login now