##// END OF EJS Templates
Set ruby1.9 as default for the database configuration example....
Jean-Philippe Lang -
r10974:1188789e1553
parent child
Show More
@@ -1,41 +1,41
1 # Default setup is given for MySQL with ruby1.8. If you're running Redmine
1 # Default setup is given for MySQL with ruby1.9. If you're running Redmine
2 # with MySQL and ruby1.9, replace the adapter name with `mysql2`.
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.8)
30 for the "production" environment (default database is MySQL and ruby1.9)
31
31
32 If you're running Redmine with MySQL and ruby1.9, replace the adapter name
32 If you're running Redmine with MySQL and ruby1.8, replace the adapter name
33 with `mysql2`
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