##// END OF EJS Templates
jro_apps » redmine
RSS
Updated doc....
Jean-Philippe Lang -
r3179:486f70549402
parent child
Show More
Side by Side Unified
Context file:
r3179:486f70549402 Loading diff...:
Show file before | Show file after | Hide comments
@@ -1,67 +1,67
1 == Redmine installation
1 == Redmine installation
2
2
3 Redmine - project management software
3 Redmine - project management software
4 Copyright (C) 2006-2008 Jean-Philippe Lang
4 Copyright (C) 2006-2010 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 on Rails 2.2.2
10 * Ruby on Rails 2.3.5
11 * A database:
11 * A database:
12 * MySQL (tested with MySQL 5)
12 * MySQL (tested with MySQL 5)
13 * PostgreSQL (tested with PostgreSQL 8.1)
13 * PostgreSQL (tested with PostgreSQL 8.1)
14 * SQLite (tested with SQLite 3)
14 * SQLite (tested with SQLite 3)
15
15
16 Optional:
16 Optional:
17 * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
17 * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
18 * RMagick (gantt export to png)
18 * RMagick (gantt export to png)
19
19
20 == Installation
20 == Installation
21
21
22 1. Uncompress the program archive
22 1. Uncompress the program archive
23
23
24 2. Create an empty database: "redmine" for example
24 2. Create an empty database: "redmine" for example
25
25
26 3. Configure database parameters in config/database.yml
26 3. Configure database parameters in config/database.yml
27 for "production" environment (default database is MySQL)
27 for "production" environment (default database is MySQL)
28
28
29 4. Create the database structure. Under the application main directory:
29 4. Create the database structure. Under the application main directory:
30 rake db:migrate RAILS_ENV="production"
30 rake db:migrate RAILS_ENV="production"
31 It will create tables and an administrator account.
31 It will create tables and an administrator account.
32
32
33 5. Generate a session store secret
33 5. Generate a session store secret
34 Redmine stores session data in cookies by default, which requires
34 Redmine stores session data in cookies by default, which requires
35 a secret to be generated. Run:
35 a secret to be generated. Run:
36 rake config/initializers/session_store.rb
36 rake config/initializers/session_store.rb
37
37
38 6. Setting up permissions
38 6. Setting up permissions
39 The user who runs Redmine must have write permission on the following
39 The user who runs Redmine must have write permission on the following
40 subdirectories: files, log, tmp (create the last one if not present).
40 subdirectories: files, log, tmp (create the last one if not present).
41
41
42 Assuming you run Redmine with a user named redmine:
42 Assuming you run Redmine with a user named redmine:
43 mkdir tmp
43 mkdir tmp
44 sudo chown -R redmine:redmine files log tmp
44 sudo chown -R redmine:redmine files log tmp
45 sudo chmod -R 755 files log tmp
45 sudo chmod -R 755 files log tmp
46
46
47 7. Test the installation by running WEBrick web server:
47 7. Test the installation by running WEBrick web server:
48 ruby script/server -e production
48 ruby script/server -e production
49
49
50 Once WEBrick has started, point your browser to http://localhost:3000/
50 Once WEBrick has started, point your browser to http://localhost:3000/
51 You should now see the application welcome page
51 You should now see the application welcome page
52
52
53 8. Use default administrator account to log in:
53 8. Use default administrator account to log in:
54 login: admin
54 login: admin
55 password: admin
55 password: admin
56
56
57 Go to "Administration" to load the default configuration data (roles,
57 Go to "Administration" to load the default configuration data (roles,
58 trackers, statuses, workflow) and adjust application settings
58 trackers, statuses, workflow) and adjust application settings
59
59
60
60
61 == Email delivery Configuration
61 == Email delivery Configuration
62
62
63 Copy config/email.yml.example to config/email.yml and edit this file
63 Copy config/email.yml.example to config/email.yml and edit this file
64 to adjust your SMTP settings.
64 to adjust your SMTP settings.
65 Don't forget to restart the application after any change to this file.
65 Don't forget to restart the application after any change to this file.
66
66
67 Please do not enter your SMTP settings in environment.rb.
67 Please do not enter your SMTP settings in environment.rb.
Show file before | Show file after | Hide comments
@@ -1,28 +1,33
1 == Redmine upgrade procedure
1 == Redmine upgrade procedure
2
2
3 Redmine - project management software
3 Redmine - project management software
4 Copyright (C) 2006-2008 Jean-Philippe Lang
4 Copyright (C) 2006-2010 Jean-Philippe Lang
5 http://www.redmine.org/
5 http://www.redmine.org/
6
6
7
7
8 == Upgrading
8 == Upgrading
9
9
10 1. Uncompress the program archive in a new directory
10 1. Uncompress the program archive in a new directory
11
11
12 3. Copy your database settings (RAILS_ROOT/config/database.yml)
12 2. Copy your database settings (RAILS_ROOT/config/database.yml)
13 and SMTP settings (RAILS_ROOT/config/email.yml)
13 and SMTP settings (RAILS_ROOT/config/email.yml)
14 into the new config directory
14 into the new config directory
15 DO NOT REPLACE ANY OTHERS FILES.
15
16
16 4. Migrate your database (please make a backup before doing this):
17 3. Migrate your database (please make a backup before doing this):
17 rake db:migrate RAILS_ENV="production"
18 rake db:migrate RAILS_ENV="production"
18
19
19 5. Copy the RAILS_ROOT/files directory content into your new installation
20 4. Copy the RAILS_ROOT/files directory content into your new installation
20 This directory contains all the attached files
21 This directory contains all the attached files
21
22
23 5. Generate a session store secret
24 Redmine stores session data in cookies by default, which requires
25 a secret to be generated. Run:
26 rake config/initializers/session_store.rb
22
27
23 == Notes
28 == Notes
24
29
25 1. Rails 2.1.2 is required for version 0.8.
30 1. Rails 2.3.5 is required for version 0.9.
26
31
27 2. When upgrading your code with svn update, don't forget to clear
32 2. When upgrading your code with svn update, don't forget to clear
28 the application cache (RAILS_ROOT/tmp/cache) before restarting.
33 the application cache (RAILS_ROOT/tmp/cache) before restarting.
General Comments 0
You need to be logged in to leave comments. Login now