[Rt-commit] r6163 - rtir/branches/2.0-TESTING

[ruz at bestpractical.com]

Author: ruz
Date: Wed Oct  4 19:00:13 2006
New Revision: 6163

Modified:
   rtir/branches/2.0-TESTING/UPGRADING

Log:
* update UPGRADING instruction according to the latest changes

Modified: rtir/branches/2.0-TESTING/UPGRADING
==============================================================================
--- rtir/branches/2.0-TESTING/UPGRADING	(original)
+++ rtir/branches/2.0-TESTING/UPGRADING	Wed Oct  4 19:00:13 2006
@@ -1,18 +1,22 @@
 General upgrade instructions
 ============================
 
-1) Follow specialized upgrade instructions in the sections below
+0) Make a backup of the database.
 
-2) Install the new version of RTIR. (DO NOT RUN "make initdb")
+1) Upgrade to the RT 3.7 following its upgrade instructions.
 
-3) Update RTIR's database.
+2) Install or upgrade RTFM.
+
+3) Install the new version of RTIR. (DO NOT RUN "make initdb")
+
+4) Update RTIR's database.
     
-   Type:
+    Type:
 
         ls etc/upgrade
 
     For each item in that directory whose name is greater than
-    your previously installed RT version, run:
+    your previously installed RTIR version, run:
     
         /opt/rt3/sbin/rt-setup-database --dba <dba> \
             --prompt-for-dba-password --action schema \
@@ -21,11 +25,14 @@
             --prompt-for-dba-password --action insert \
             --datadir etc/upgrade/<version>
 
+    After each step follow additional instructions below.
 
-Follow instructions from previous "upgrading from" sections at
-the end of this document if they apply to your installation.
+    For example if you had RTIR 1.1.1 then you should run
+    above commands for etc/upgrade/1.1.3 datadir, check
+    instructions under "Applying changes from etc/upgrade/1.1.3"
+    section below, then do the same with 1.9.0 dir and greater.
 
-Upgrading from RTIR 1.1.5
+Applying changes from upgrade/1.9.0
 -------------------------
 
 1) The LaunchMessage template in the Investigations queue
@@ -33,76 +40,38 @@
 This upgrade step is automated, but may fail if you've changed
 the LaunchMessage template.
 
-2) In the Blocks queue an Autoreply template is adde. This is
-replacement the NewMessage template. Automated step doesn't delete
+2) In the Blocks queue an Autoreply template has been added. This is
+replacement for the NewMessage template. Automated step doesn't delete
 old template, you have to check that the new template suites your
 needs and may be copy customizations from the old one, then delete
 the NewMessage template.
 
-3) A new template has been added - 'BlockRemoved' in the Blocks
+3) The new 'BlockRemoved' template has been added in the Blocks
 queue. Check its content.
 
 4) NotifyOnLaunch and NotifyOnCreate scrips have been deleted in
 the Implementations and the Blocks queues respectively. You have to
 use the default RT's Autoreply scrip instead or create autoreply
-scrips in these queues.
+scrips in these queues if global one is diabled.
 
-Upgrading from RTIR 1.1.3
+Applying changes from upgrade/1.1.3
 -------------------------
 
-1) Delete the following Scrips (go to Configuration / Queues / <Queue
-Name> / Scrips):
-
-In the Incidents Queue:
-  SetStartsDate
-  SetRTIRState
-  ResolveAllChildren
-  FixOwnership
-
-In the Incident Reports Queue:
-  DetectUserResponse 
-  SetDue             
-  SetStarts          
-  UnsetDue           
-  SetDueReopen       
-  SetHowReported     
-  SetRTIRState       
-  FixOwnership       
-  ReopenIncident
-
-In the Investigations Queue:
-  NotifyOnLaunch
-  DetectUserResponse
-  SetStarts
-  SetDue
-  UnsetDue
-  SetDueReopen
-  SetRTIRState
-  FixOwnership
-  ReopenIncident
-
-In the Blocks Queue:
-  NotifyOnCreate
-  DetectUserResponse
-  SetStarts
-  SetDue
-  UnsetDue
-  UnsetDue
-  SetDueReopen
-  SetRTIRState
-  FixOwnership
-  ReopenIncident
-
-2) Run the etc/upgrade/upgrade.pl script.
+No special steps required, just run upgrade scripts. Everything
+is automated. At this step we install several new actions,
+conditions and scrips that had been introduced in the RTIR 1.1.3.
+Also, we change action of the 'SetDueReopen' scrips.
 
-This script updates Due Dates on all incidents and set to the most
-recent due date of the children. 
-
-Upgrading from RTIR 1.1.2:
---------------------------
+Applying changes from upgrade/1.1.1
+-------------------------
 
-1) Delete the "SetDueReopen" scrip from the Incident Reports,
-   Investigations, and Blocks queues.
+1) At these step we switch from 'UserDefined' actions and conditions
+   to modules, so all code would be in the lib directory. If you changed
+   the code of the scrips then you have to port changes.
+
+2) Run the etc/upgrade/upgrade.pl script. This script updates Due Dates
+   on active incidents and set to the most recent due date of the active
+   children.
 
 Upgrading from RTIR 1.0.0:
 --------------------------