Mercurial > hg > soundsoftware-site
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 |