UPGRADING
69 lines
| 2.3 KiB
| text/plain
|
TextLexer
/ doc / UPGRADING
Eric Davis
|
r3734 | == Redmine upgrade | ||
Jean-Philippe Lang
|
r870 | |||
| Redmine - project management software | ||||
|
Jean-Philippe Lang
|
r8784 | Copyright (C) 2006-2012 Jean-Philippe Lang | ||
|
Jean-Philippe Lang
|
r870 | http://www.redmine.org/ | ||
|
Jean-Philippe Lang
|
r1269 | == Upgrading | ||
|
Jean-Philippe Lang
|
r870 | |||
| 1. Uncompress the program archive in a new directory | ||||
|
Eric Davis
|
r3734 | |||
|
Jean-Philippe Lang
|
r3179 | 2. Copy your database settings (RAILS_ROOT/config/database.yml) | ||
|
Jean-Philippe Lang
|
r4632 | and your configuration file (RAILS_ROOT/config/configuration.yml) | ||
| into the new config directory | ||||
| Note: before Redmine 1.2, SMTP configuration was stored in | ||||
| config/email.yml. It should now be stored in config/configuration.yml. | ||||
|
Eric Davis
|
r3734 | |||
| 3. Copy the RAILS_ROOT/files directory content into your new installation | ||||
| This directory contains all the attached files. | ||||
|
Jean-Philippe Lang
|
r870 | |||
|
Eric Davis
|
r3734 | 4. Copy the folders of the installed plugins and themes into new installation | ||
|
Jean-Philippe Lang
|
r9494 | Plugins must be stored in the [redmine_root]/plugins directory | ||
| Themes must be stored in the [redmine_root]/public/themes directory | ||||
| WARNING: plugins from your previous Redmine version may not be compatible | ||||
| with the Redmine version you're upgrading to. | ||||
|
Eric Davis
|
r3734 | |||
|
Jean-Philippe Lang
|
r8784 | 5. Install the required gems by running: | ||
| bundle install --without development test | ||||
| If ImageMagick is not installed on your system, you should skip the installation | ||||
| of the rmagick gem using: | ||||
| bundle install --without development test rmagick | ||||
| 6. Generate a session store secret | ||||
|
Eric Davis
|
r3734 | |||
|
Jean-Philippe Lang
|
r3179 | Redmine stores session data in cookies by default, which requires | ||
|
Eric Davis
|
r3734 | a secret to be generated. Under the new application directory run: | ||
|
Jean-Philippe Lang
|
r9494 | rake generate_secret_token | ||
|
Eric Davis
|
r3734 | |||
| DO NOT REPLACE OR EDIT ANY OTHER FILES. | ||||
|
Jean-Philippe Lang
|
r3341 | |||
|
Jean-Philippe Lang
|
r8784 | 7. Migrate your database | ||
|
Eric Davis
|
r3734 | |||
|
Jean-Philippe Lang
|
r7729 | If you are upgrading to Rails 2.3.14 as part of this migration, you | ||
|
Eric Davis
|
r3734 | need to upgrade the plugin migrations before running the plugin migrations | ||
| using: | ||||
| rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production" | ||||
| Please make a backup before doing this! Under the new application | ||||
| directory run: | ||||
| rake db:migrate RAILS_ENV="production" | ||||
| If you have installed any plugins, you should also run their database | ||||
| migrations using: | ||||
| rake db:migrate_plugins RAILS_ENV="production" | ||||
|
Jean-Philippe Lang
|
r8784 | 8. Clear the cache and the existing sessions by running: | ||
|
Eric Davis
|
r3734 | rake tmp:cache:clear | ||
| rake tmp:sessions:clear | ||||
|
Jean-Philippe Lang
|
r8784 | 9. Restart the application server (e.g. mongrel, thin, passenger) | ||
|
Jean-Philippe Lang
|
r870 | |||
|
Jean-Philippe Lang
|
r8784 | 10. Finally go to "Administration -> Roles & permissions" to check/set permissions | ||
| for new features, if any | ||||
|
Eric Davis
|
r3734 | |||
| == References | ||||
|
Jean-Philippe Lang
|
r870 | |||
|
Eric Davis
|
r3734 | * http://www.redmine.org/wiki/redmine/RedmineUpgrade | ||