Upgrade to 4.2.8
[usit-rt.git] / docs / incremental-export / README
1 To perform an incremental upgrade of your RT instance you will need to
2 perform the following steps on your production server.
3
4   Copy the rt-validator command from the current version of RT and run
5   it against your production RT instance. The output from --help will
6   show you how to run it in check and then in fix mode.
7
8   Turn off all access to RT (this usually involves stopping your web and mail servers).
9   Take a snapshot of the RT database.
10   Install Record_Local.pm into $RTHOME/lib/RT/.
11   Create the IncrementalRecords table using the schema file for your database.
12   Add Set($IncrementalExport, 1); to your RT_SiteConfig.pm
13   Bring your webserver back up.
14   Confirm that changes in RT (such as a ticket status change or reply)
15     result in records being added to IncrementalRecords.
16
17
18 Using the backup, upgrade on your new server to the latest release of RT.
19 Once this upgrade is complete, you should avoid making changes to it
20 until you import the incremental changes from production.
21
22 For additional information on the following steps, please review
23 rt-importer --help and rt-serializer --help
24
25 During your final cutover, you will bring down the production web and mail servers for the final time.
26 Run $RTHOME/sbin/rt-serializer --incremental
27 This will create a directory named $Organization:date
28 Once this has completed, you will copy this directory to the new server.
29 On the new server, run $RTHOME/sbin/rt-importer $Organization:date