[Rt-commit] [rtir] 05/05: Trim upgrading docs

Kevin Falcone falcone at bestpractical.com
Wed Jul 3 20:19:54 EDT 2013


This is an automated email from the git hooks/post-receive script.

falcone pushed a commit to branch 2.9-trunk
in repository rtir.

commit b4c1fdaf25a9333be12e4bac8d920d1e08f4cca1
Author: Kevin Falcone <falcone at bestpractical.com>
Date:   Wed Jul 3 20:19:14 2013 -0400

    Trim upgrading docs
    
    Point to docs/UPGRADING-* and point people at make upgrade-database
    rather than having them run rt-setup-database manually.
---
 docs/UPGRADING | 45 +++++++++++----------------------------------
 1 file changed, 11 insertions(+), 34 deletions(-)

diff --git a/docs/UPGRADING b/docs/UPGRADING
index 2a665a8..ea3eafb 100644
--- a/docs/UPGRADING
+++ b/docs/UPGRADING
@@ -51,46 +51,23 @@ Install the new version of RTIR. B<DO NOT> run C<make initdb>.
 
 =item 6
 
-Update RTIR's database.
-
-Type:
-
-    ls etc/upgrade
-
-For each item in that directory whose name is greater than
-your previously installed RTIR version (a later version),
-you must run upgrade commands.
-
-Each step is described below and may have additional instructions.
-Read them before running upgrade commands.
+Review all of the upgrade notes in docs/UPGRADING-*. If you were
+coming from 2.4.1, you would read UPGRADING-2.4, UPGRADING-2.6 and
+UPGRADING-3.0.
 
-For example, if you had RTIR 1.1.1 then you should read the
-instructions under L<UPGRADING-2.4/"Applying Changes from upgrade/1.1.3">,
-run the commands, then do the same with 1.9.0 directory
-and greater until you have run all of the commands.
-
-Note that even if there is no etc/upgrade/<some version>
-directory for a particular version, you must still read the
-instructions for all remaining versions greater than or
-equal to the version you're upgrading from. Some upgrades
-may require manual changes or describe important changes in
-RTIR you should be aware of. Missing a set of upgrade
-instructions can result in strange behavior that can be very hard
-to diagnose.
+=item 7
 
-If the upgrade directory has any C<schema> files, run:
+Update RTIR's database.
 
-    /opt/rt4/sbin/rt-setup-database --dba <dba> \
-        --prompt-for-dba-password --action schema \
-        --datadir etc/upgrade/<version>
+Type:
 
-If the upgrade directory has a file named C<content> then run:
+    make upgrade-database
 
-    /opt/rt4/sbin/rt-setup-database --dba <dba> \
-        --prompt-for-dba-password --action insert \
-        --datadir etc/upgrade/<version>
+Answer the prompt for which version of RTIR you are upgrading from. RT
+will then confirm the upgrades that it is going to apply and will run
+them in sequence.
 
-=item 7
+=item 8
 
 Re-analyze and re-optimize your database tables.
 

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.


More information about the Rt-commit mailing list