comparison doc/INSTALL @ 1298:4f746d8966dd redmine_2.3_integration

Merge from redmine-2.3 branch to create new branch redmine-2.3-integration
author Chris Cannam
date Fri, 14 Jun 2013 09:28:30 +0100
parents 622f24f53b42
children e248c7af89ec
comparison
equal deleted inserted replaced
1297:0a574315af3e 1298:4f746d8966dd
1 == Redmine installation 1 == Redmine installation
2 2
3 Redmine - project management software 3 Redmine - project management software
4 Copyright (C) 2006-2012 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, 1.9.3 or 2.0.0
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.7)
18 * SQLServer (tested with SQLServer 2012)
18 19
19 Optional: 20 Optional:
20 * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH) 21 * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH)
21 * ImageMagick (to enable Gantt export to png images) 22 * ImageMagick (to enable Gantt export to png images)
22 23
23 == Installation 24 == Installation
24 25
25 1. Uncompress the program archive 26 1. Uncompress the program archive
26 27
27 2. Install the required gems by running: 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 If you're running Redmine with MySQL and ruby1.8, replace the adapter name
34 with `mysql`
35
36 4. Install the required gems by running:
28 bundle install --without development test 37 bundle install --without development test
29 38
30 If ImageMagick is not installed on your system, you should skip the installation 39 If ImageMagick is not installed on your system, you should skip the installation
31 of the rmagick gem using: 40 of the rmagick gem using:
32 bundle install --without development test rmagick 41 bundle install --without development test rmagick
33 42
43 Only the gems that are needed by the adapters you've specified in your database
44 configuration file are actually installed (eg. if your config/database.yml
45 uses the 'mysql2' adapter, then only the mysql2 gem will be installed). Don't
46 forget to re-run `bundle install` when you change config/database.yml for using
47 other database adapters.
48
34 If you need to load some gems that are not required by Redmine core (eg. fcgi), 49 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. 50 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`. 51 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 52
46 5. Generate a session store secret 53 5. Generate a session store secret
47 54
48 Redmine stores session data in cookies by default, which requires 55 Redmine stores session data in cookies by default, which requires
49 a secret to be generated. Under the application main directory run: 56 a secret to be generated. Under the application main directory run: