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