comparison .svn/pristine/d0/d04e674c0740817a528515c15ffb33465b7523c4.svn-base @ 1295:622f24f53b42 redmine-2.3

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