##// END OF EJS Templates
jro_apps » redmine
RSS
Updated the INSTALL and UPGRADING documents for the 1.0 release....
Eric Davis -
r3734:6807d070da90
parent child
Show More
Side by Side Unified
Context file:
r3734:6807d070da90 Loading diff...:
Show file before | Show file after | Hide comments
@@ -12,14 +12,21 http://www.redmine.org/
12 * Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with
12 * Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with
13 the appropriate Rails version)
13 the appropriate Rails version)
14
14
15 * Rack 1.0.1
16
17 * RubyGems 1.3.1
18
19 * Rake 0.8.3
20
15 * A database:
21 * A database:
16 * MySQL (tested with MySQL 5)
22 * MySQL (tested with MySQL 5)
17 * PostgreSQL (tested with PostgreSQL 8.1)
23 * PostgreSQL (tested with PostgreSQL 8.1)
18 * SQLite (tested with SQLite 3)
24 * SQLite (tested with SQLite 3)
19
25
20 Optional:
26 Optional:
21 * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
27 * SCM binaries (e.g. svn), for repository browsing (must be available in PATH)
22 * RMagick (gantt export to png)
28 * RMagick (to enable Gantt export to png images)
29 * Ruby OpenID Library >= version 2 (to enable OpenID support)
23
30
24 == Installation
31 == Installation
25
32
@@ -27,45 +34,62 Optional:
27
34
28 2. Create an empty database: "redmine" for example
35 2. Create an empty database: "redmine" for example
29
36
30 3. Configure database parameters in config/database.yml
37 3. Configure the database parameters in config/database.yml
31 for "production" environment (default database is MySQL)
38 for the "production" environment (default database is MySQL)
32
39
33 4. Generate a session store secret
40 4. Generate a session store secret
41
34 Redmine stores session data in cookies by default, which requires
42 Redmine stores session data in cookies by default, which requires
35 a secret to be generated. Run:
43 a secret to be generated. Under the application main directory run:
36 rake generate_session_store
44 rake generate_session_store
37
45
38 5. Create the database structure. Under the application main directory:
46 5. Create the database structure
47
48 Under the application main directory run:
39 rake db:migrate RAILS_ENV="production"
49 rake db:migrate RAILS_ENV="production"
40 It will create tables and an administrator account.
41
50
42 6. Setting up permissions
51 It will create all the tables and an administrator account.
52
53 6. Setting up permissions (Windows users have to skip this section)
54
43 The user who runs Redmine must have write permission on the following
55 The user who runs Redmine must have write permission on the following
44 subdirectories: files, log, tmp (create the last one if not present).
56 subdirectories: files, log, tmp & public/plugin_assets (create the last
57 two if they are not yet present).
58
59 Assuming you run Redmine with a user named "redmine":
60 mkdir tmp public/plugin_assets
61 sudo chown -R redmine:redmine files log tmp public/plugin_assets
62 sudo chmod -R 755 files log tmp public/plugin_assets
45
63
46 Assuming you run Redmine with a user named redmine:
64 7. Test the installation by running the WEBrick web server
47 mkdir tmp
48 sudo chown -R redmine:redmine files log tmp
49 sudo chmod -R 755 files log tmp
50
65
51 7. Test the installation by running WEBrick web server:
66 Under the main application directory run:
52 ruby script/server -e production
67 ruby script/server -e production
53
68
54 Once WEBrick has started, point your browser to http://localhost:3000/
69 Once WEBrick has started, point your browser to http://localhost:3000/
55 You should now see the application welcome page
70 You should now see the application welcome page.
56
71
57 8. Use default administrator account to log in:
72 8. Use the default administrator account to log in:
58 login: admin
73 login: admin
59 password: admin
74 password: admin
60
75
61 Go to "Administration" to load the default configuration data (roles,
76 Go to "Administration" to load the default configuration data (roles,
62 trackers, statuses, workflow) and adjust application settings
77 trackers, statuses, workflow) and to adjust the application settings
63
64
78
65 == Email delivery Configuration
79 == SMTP server Configuration
66
80
67 Copy config/email.yml.example to config/email.yml and edit this file
81 Copy config/email.yml.example to config/email.yml and edit this file
68 to adjust your SMTP settings.
82 to adjust your SMTP settings.
69 Don't forget to restart the application after any change to this file.
83 Do not forget to restart the application after any change to this file.
70
84
71 Please do not enter your SMTP settings in environment.rb.
85 Please do not enter your SMTP settings in environment.rb.
86
87 == References
88
89 * http://www.redmine.org/wiki/redmine/RedmineInstall
90 * http://www.redmine.org/wiki/redmine/EmailConfiguration
91 * http://www.redmine.org/wiki/redmine/RedmineSettings
92 * http://www.redmine.org/wiki/redmine/RedmineRepositories
93 * http://www.redmine.org/wiki/redmine/RedmineReceivingEmails
94 * http://www.redmine.org/wiki/redmine/RedmineReminderEmails
95 * http://www.redmine.org/wiki/redmine/RedmineLDAP
Show file before | Show file after | Hide comments
@@ -1,4 +1,4
1 == Redmine upgrade procedure
1 == Redmine upgrade
2
2
3 Redmine - project management software
3 Redmine - project management software
4 Copyright (C) 2006-2010 Jean-Philippe Lang
4 Copyright (C) 2006-2010 Jean-Philippe Lang
@@ -10,24 +10,52 http://www.redmine.org/
10 1. Uncompress the program archive in a new directory
10 1. Uncompress the program archive in a new directory
11
11
12 2. 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) into the new
14 into the new config directory
14 config directory
15 DO NOT REPLACE OR EDIT ANY OTHER FILES.
15
16 3. Copy the RAILS_ROOT/files directory content into your new installation
17 This directory contains all the attached files.
18
19 4. Copy the folders of the installed plugins and themes into new installation
20
21 5. Generate a session store secret
16
22
17 3. Generate a session store secret
18 Redmine stores session data in cookies by default, which requires
23 Redmine stores session data in cookies by default, which requires
19 a secret to be generated. Run:
24 a secret to be generated. Under the new application directory run:
20 rake generate_session_store
25 rake generate_session_store
21
26
22 4. Migrate your database (please make a backup before doing this):
27 DO NOT REPLACE OR EDIT ANY OTHER FILES.
28
29 6. Migrate your database
30
31 If you are upgrading to Rails 2.3.5 as part of this migration, you
32 need to upgrade the plugin migrations before running the plugin migrations
33 using:
34 rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
35
36 Please make a backup before doing this! Under the new application
37 directory run:
23 rake db:migrate RAILS_ENV="production"
38 rake db:migrate RAILS_ENV="production"
24
39
25 5. Copy the RAILS_ROOT/files directory content into your new installation
40 If you have installed any plugins, you should also run their database
26 This directory contains all the attached files
41 migrations using:
42 rake db:migrate_plugins RAILS_ENV="production"
43
44 7. Clean up
45
46 Clear the cache and the existing sessions by running:
47 rake tmp:cache:clear
48 rake tmp:sessions:clear
49
50 8. Restart the application server (e.g. mongrel, thin, passenger)
51
52 9. Finally go to "Administration -> Roles & permissions" to check/set permissions
53 for new features, if any
27
54
28 == Notes
55 == Notes
29
56
30 1. Rails 2.3.5 is required for version 0.9.
57 * Rails 2.3.5 is required for versions 0.9.x and 1.0.x.
58
59 == References
31
60
32 2. When upgrading your code with svn update, don't forget to clear
61 * http://www.redmine.org/wiki/redmine/RedmineUpgrade
33 the application cache (RAILS_ROOT/tmp/cache) before restarting.
General Comments 0
You need to be logged in to leave comments. Login now