Updated the INSTALL and UPGRADING documents for the 1.0 release.

Contributed by Mischa The Evil

git-svn-id: svn+ssh://rubyforge.org/var/svn/redmine/trunk@3848 e93f8b46-1217-0410-a6f0-8f06a7374b81

1 files changed, 44 insertions, 16 deletions

diff --git a/doc/UPGRADING b/doc/UPGRADING
index a9b81d177..87f169c9d 100644
--- a/doc/UPGRADING
+++ b/doc/UPGRADING
@@ -1,4 +1,4 @@
-== Redmine upgrade procedure
+== Redmine upgrade
 
 Redmine - project management software
 Copyright (C) 2006-2010  Jean-Philippe Lang
@@ -8,26 +8,54 @@ http://www.redmine.org/
 == Upgrading
 
 1. Uncompress the program archive in a new directory
-   
+
 2. Copy your database settings (RAILS_ROOT/config/database.yml)
-   and SMTP settings (RAILS_ROOT/config/email.yml)
-   into the new config directory
-   DO NOT REPLACE OR EDIT ANY OTHER FILES.
+   and SMTP settings (RAILS_ROOT/config/email.yml) into the new
+   config directory
+
+3. Copy the RAILS_ROOT/files directory content into your new installation
+   This directory contains all the attached files.
 
-3. Generate a session store secret
+4. Copy the folders of the installed plugins and themes into new installation
+
+5. Generate a session store secret
+   
    Redmine stores session data in cookies by default, which requires
-   a secret to be generated. Run:
-   rake generate_session_store
-      
-4. Migrate your database (please make a backup before doing this):
-   rake db:migrate RAILS_ENV="production"
+   a secret to be generated. Under the new application directory run:
+     rake generate_session_store
+   
+   DO NOT REPLACE OR EDIT ANY OTHER FILES.
 
-5. Copy the RAILS_ROOT/files directory content into your new installation
-   This directory contains all the attached files
+6. Migrate your database
+
+   If you are upgrading to Rails 2.3.5 as part of this migration, you
+   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"
+   
+7. Clean up
+   
+   Clear the cache and the existing sessions by running:
+     rake tmp:cache:clear
+     rake tmp:sessions:clear
+
+8. Restart the application server (e.g. mongrel, thin, passenger)
+
+9. Finally go to "Administration -> Roles & permissions" to check/set permissions
+   for new features, if any
 
 == Notes
 
-1. Rails 2.3.5 is required for version 0.9.
+* Rails 2.3.5 is required for versions 0.9.x and 1.0.x.
+
+== References
 
-2. When upgrading your code with svn update, don't forget to clear
-   the application cache (RAILS_ROOT/tmp/cache) before restarting.
+* http://www.redmine.org/wiki/redmine/RedmineUpgrade