[Rt-commit] r14098 - rtfm/trunk

[falcone at bestpractical.com]

Author: falcone
Date: Mon Jul 14 18:39:43 2008
New Revision: 14098

Modified:
   rtfm/trunk/   (props changed)
   rtfm/trunk/UPGRADING

Log:
 r35576 at ketch:  falcone | 2008-07-14 17:24:38 -0400
 * add notes on upgrading from 2.1, including notes on how
   to handle the ALTER TABLE commands


Modified: rtfm/trunk/UPGRADING
==============================================================================
--- rtfm/trunk/UPGRADING	(original)
+++ rtfm/trunk/UPGRADING	Mon Jul 14 18:39:43 2008
@@ -6,12 +6,59 @@
 installation instructions which will overwrite
 existing RTFM code with the 2.4 version.
 
+Do not run the make initdb command
+
 It is recommended that you make a backup of your
 /opt/rt3 directory in case there are problems
 
 After installing 2.4, stop and start your web
 server, clearing your mason cache if necesary.
 
+Upgrade Instructions from 2.1.x
+-----------------------------------------------------
+
+1) perl Makefile.PL
+
+2) make install
+
+4) Type "ls etc/upgrade"; For each item in that directory whose name
+   is greater than your previously installed RTFM version, run:
+
+            /opt/rt3/sbin/rt-setup-database --action schema \
+                --datadir etc/upgrade/<version>
+            /opt/rt3/sbin/rt-setup-database --action acl \
+                --datadir etc/upgrade/<version>
+            /opt/rt3/sbin/rt-setup-database --action insert \
+                 --datadir etc/upgrade/<version>
+
+   For the 2.2.0RC2 updates and 2.1.30 updates you may need to
+   run these as a superuser because they issue ALTER TABLE statements.
+
+   You can do this by adding the --dba root --prompt-for-dba-password
+   flags, like so:
+
+            /opt/rt3/sbin/rt-setup-database --action schema \
+                --dba root --prompt-for-dba-password \
+                --datadir etc/upgrade/<version>
+            /opt/rt3/sbin/rt-setup-database --action acl \
+                --dba root --prompt-for-dba-password \
+                --datadir etc/upgrade/<version>
+            /opt/rt3/sbin/rt-setup-database --action insert \
+                --dba root --prompt-for-dba-password \
+                 --datadir etc/upgrade/<version>
+
+5) If you are running 3.8, you need to enable RTFM in your 
+   RT_SiteConfig.pm file.  You can do this by adding the following
+   line:
+
+   Set(@Plugins,qw(RT::FM));
+
+6) clear your mason cache.  This is most often accomplished with
+   rm -rf /opt/rt3/var/mason_data/*
+
+7) stop and start your web server
+
+
 Upgrade instructions (From any  2.0.x release):
 -----------------------------------------------------