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