@@ -1,41 +1,41 | |||||
1 |
# Default setup is given for MySQL with ruby1. |
|
1 | # Default setup is given for MySQL with ruby1.9. If you're running Redmine | |
2 |
# with MySQL and ruby1. |
|
2 | # with MySQL and ruby1.8, replace the adapter name with `mysql`. | |
3 | # Examples for PostgreSQL and SQLite3 can be found at the end. |
|
3 | # Examples for PostgreSQL and SQLite3 can be found at the end. | |
4 |
|
4 | |||
5 | production: |
|
5 | production: | |
6 | adapter: mysql |
|
6 | adapter: mysql2 | |
7 | database: redmine |
|
7 | database: redmine | |
8 | host: localhost |
|
8 | host: localhost | |
9 | username: root |
|
9 | username: root | |
10 | password: "" |
|
10 | password: "" | |
11 | encoding: utf8 |
|
11 | encoding: utf8 | |
12 |
|
12 | |||
13 | development: |
|
13 | development: | |
14 | adapter: mysql |
|
14 | adapter: mysql2 | |
15 | database: redmine_development |
|
15 | database: redmine_development | |
16 | host: localhost |
|
16 | host: localhost | |
17 | username: root |
|
17 | username: root | |
18 | password: "" |
|
18 | password: "" | |
19 | encoding: utf8 |
|
19 | encoding: utf8 | |
20 |
|
20 | |||
21 | # Warning: The database defined as "test" will be erased and |
|
21 | # Warning: The database defined as "test" will be erased and | |
22 | # re-generated from your development database when you run "rake". |
|
22 | # re-generated from your development database when you run "rake". | |
23 | # Do not set this db to the same as development or production. |
|
23 | # Do not set this db to the same as development or production. | |
24 | test: |
|
24 | test: | |
25 | adapter: mysql |
|
25 | adapter: mysql2 | |
26 | database: redmine_test |
|
26 | database: redmine_test | |
27 | host: localhost |
|
27 | host: localhost | |
28 | username: root |
|
28 | username: root | |
29 | password: "" |
|
29 | password: "" | |
30 | encoding: utf8 |
|
30 | encoding: utf8 | |
31 |
|
31 | |||
32 | test_pgsql: |
|
32 | test_pgsql: | |
33 | adapter: postgresql |
|
33 | adapter: postgresql | |
34 | database: redmine_test |
|
34 | database: redmine_test | |
35 | host: localhost |
|
35 | host: localhost | |
36 | username: postgres |
|
36 | username: postgres | |
37 | password: "postgres" |
|
37 | password: "postgres" | |
38 |
|
38 | |||
39 | test_sqlite3: |
|
39 | test_sqlite3: | |
40 | adapter: sqlite3 |
|
40 | adapter: sqlite3 | |
41 | database: db/test.sqlite3 |
|
41 | database: db/test.sqlite3 |
@@ -1,99 +1,99 | |||||
1 | == Redmine installation |
|
1 | == Redmine installation | |
2 |
|
2 | |||
3 | Redmine - project management software |
|
3 | Redmine - project management software | |
4 | Copyright (C) 2006-2013 Jean-Philippe Lang |
|
4 | Copyright (C) 2006-2013 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 1.8.7, 1.9.2 or 1.9.3 |
|
10 | * Ruby 1.8.7, 1.9.2 or 1.9.3 | |
11 | * RubyGems |
|
11 | * RubyGems | |
12 | * Bundler >= 1.0.21 |
|
12 | * Bundler >= 1.0.21 | |
13 |
|
13 | |||
14 | * A database: |
|
14 | * A database: | |
15 | * MySQL (tested with MySQL 5.1) |
|
15 | * MySQL (tested with MySQL 5.1) | |
16 | * PostgreSQL (tested with PostgreSQL 9.1) |
|
16 | * PostgreSQL (tested with PostgreSQL 9.1) | |
17 | * SQLite3 (tested with SQLite 3.6) |
|
17 | * SQLite3 (tested with SQLite 3.6) | |
18 |
|
18 | |||
19 | Optional: |
|
19 | Optional: | |
20 | * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH) |
|
20 | * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH) | |
21 | * ImageMagick (to enable Gantt export to png images) |
|
21 | * ImageMagick (to enable Gantt export to png images) | |
22 |
|
22 | |||
23 | == Installation |
|
23 | == Installation | |
24 |
|
24 | |||
25 | 1. Uncompress the program archive |
|
25 | 1. Uncompress the program archive | |
26 |
|
26 | |||
27 | 2. Create an empty utf8 encoded database: "redmine" for example |
|
27 | 2. Create an empty utf8 encoded database: "redmine" for example | |
28 |
|
28 | |||
29 | 3. Configure the database parameters in config/database.yml |
|
29 | 3. Configure the database parameters in config/database.yml | |
30 |
for the "production" environment (default database is MySQL and ruby1. |
|
30 | for the "production" environment (default database is MySQL and ruby1.9) | |
31 |
|
31 | |||
32 |
If you're running Redmine with MySQL and ruby1. |
|
32 | If you're running Redmine with MySQL and ruby1.8, replace the adapter name | |
33 |
with `mysql |
|
33 | with `mysql` | |
34 |
|
34 | |||
35 | 4. Install the required gems by running: |
|
35 | 4. Install the required gems by running: | |
36 | bundle install --without development test |
|
36 | bundle install --without development test | |
37 |
|
37 | |||
38 | If ImageMagick is not installed on your system, you should skip the installation |
|
38 | If ImageMagick is not installed on your system, you should skip the installation | |
39 | of the rmagick gem using: |
|
39 | of the rmagick gem using: | |
40 | bundle install --without development test rmagick |
|
40 | bundle install --without development test rmagick | |
41 |
|
41 | |||
42 | If you need to load some gems that are not required by Redmine core (eg. fcgi), |
|
42 | If you need to load some gems that are not required by Redmine core (eg. fcgi), | |
43 | you can create a file named Gemfile.local at the root of your redmine directory. |
|
43 | you can create a file named Gemfile.local at the root of your redmine directory. | |
44 | It will be loaded automatically when running `bundle install`. |
|
44 | It will be loaded automatically when running `bundle install`. | |
45 |
|
45 | |||
46 | 5. Generate a session store secret |
|
46 | 5. Generate a session store secret | |
47 |
|
47 | |||
48 | Redmine stores session data in cookies by default, which requires |
|
48 | Redmine stores session data in cookies by default, which requires | |
49 | a secret to be generated. Under the application main directory run: |
|
49 | a secret to be generated. Under the application main directory run: | |
50 | rake generate_secret_token |
|
50 | rake generate_secret_token | |
51 |
|
51 | |||
52 | 6. Create the database structure |
|
52 | 6. Create the database structure | |
53 |
|
53 | |||
54 | Under the application main directory run: |
|
54 | Under the application main directory run: | |
55 | rake db:migrate RAILS_ENV="production" |
|
55 | rake db:migrate RAILS_ENV="production" | |
56 |
|
56 | |||
57 | It will create all the tables and an administrator account. |
|
57 | It will create all the tables and an administrator account. | |
58 |
|
58 | |||
59 | 7. Setting up permissions (Windows users have to skip this section) |
|
59 | 7. Setting up permissions (Windows users have to skip this section) | |
60 |
|
60 | |||
61 | The user who runs Redmine must have write permission on the following |
|
61 | The user who runs Redmine must have write permission on the following | |
62 | subdirectories: files, log, tmp & public/plugin_assets. |
|
62 | subdirectories: files, log, tmp & public/plugin_assets. | |
63 |
|
63 | |||
64 | Assuming you run Redmine with a user named "redmine": |
|
64 | Assuming you run Redmine with a user named "redmine": | |
65 | sudo chown -R redmine:redmine files log tmp public/plugin_assets |
|
65 | sudo chown -R redmine:redmine files log tmp public/plugin_assets | |
66 | sudo chmod -R 755 files log tmp public/plugin_assets |
|
66 | sudo chmod -R 755 files log tmp public/plugin_assets | |
67 |
|
67 | |||
68 | 8. Test the installation by running the WEBrick web server |
|
68 | 8. Test the installation by running the WEBrick web server | |
69 |
|
69 | |||
70 | Under the main application directory run: |
|
70 | Under the main application directory run: | |
71 | ruby script/rails server -e production |
|
71 | ruby script/rails server -e production | |
72 |
|
72 | |||
73 | Once WEBrick has started, point your browser to http://localhost:3000/ |
|
73 | Once WEBrick has started, point your browser to http://localhost:3000/ | |
74 | You should now see the application welcome page. |
|
74 | You should now see the application welcome page. | |
75 |
|
75 | |||
76 | 9. Use the default administrator account to log in: |
|
76 | 9. Use the default administrator account to log in: | |
77 | login: admin |
|
77 | login: admin | |
78 | password: admin |
|
78 | password: admin | |
79 |
|
79 | |||
80 | Go to "Administration" to load the default configuration data (roles, |
|
80 | Go to "Administration" to load the default configuration data (roles, | |
81 | trackers, statuses, workflow) and to adjust the application settings |
|
81 | trackers, statuses, workflow) and to adjust the application settings | |
82 |
|
82 | |||
83 | == SMTP server Configuration |
|
83 | == SMTP server Configuration | |
84 |
|
84 | |||
85 | Copy config/configuration.yml.example to config/configuration.yml and |
|
85 | Copy config/configuration.yml.example to config/configuration.yml and | |
86 | edit this file to adjust your SMTP settings. |
|
86 | edit this file to adjust your SMTP settings. | |
87 | Do not forget to restart the application after any change to this file. |
|
87 | Do not forget to restart the application after any change to this file. | |
88 |
|
88 | |||
89 | Please do not enter your SMTP settings in environment.rb. |
|
89 | Please do not enter your SMTP settings in environment.rb. | |
90 |
|
90 | |||
91 | == References |
|
91 | == References | |
92 |
|
92 | |||
93 | * http://www.redmine.org/wiki/redmine/RedmineInstall |
|
93 | * http://www.redmine.org/wiki/redmine/RedmineInstall | |
94 | * http://www.redmine.org/wiki/redmine/EmailConfiguration |
|
94 | * http://www.redmine.org/wiki/redmine/EmailConfiguration | |
95 | * http://www.redmine.org/wiki/redmine/RedmineSettings |
|
95 | * http://www.redmine.org/wiki/redmine/RedmineSettings | |
96 | * http://www.redmine.org/wiki/redmine/RedmineRepositories |
|
96 | * http://www.redmine.org/wiki/redmine/RedmineRepositories | |
97 | * http://www.redmine.org/wiki/redmine/RedmineReceivingEmails |
|
97 | * http://www.redmine.org/wiki/redmine/RedmineReceivingEmails | |
98 | * http://www.redmine.org/wiki/redmine/RedmineReminderEmails |
|
98 | * http://www.redmine.org/wiki/redmine/RedmineReminderEmails | |
99 | * http://www.redmine.org/wiki/redmine/RedmineLDAP |
|
99 | * http://www.redmine.org/wiki/redmine/RedmineLDAP |
General Comments 0
You need to be logged in to leave comments.
Login now