=head1 Upgrading RTIR

This document provides general instructions for upgrading
RTIR to the most recent version regardless of the version you
are currently using. In addition to these instructions, you should look
in the version-specific UPGRADING files provided in this distribution
for additional upgrade steps. Instructions for upgrading RT
are provided with the RT distribution.

RT and RTIR are commercially-supported software. If you need help
upgrading your RTIR instance or need other services related to RT
or RTIR, please get in touch with us at <sales@bestpractical.com>.

=head1 General Upgrade Instructions

=over

=item 1

B<VERY IMPORTANT!> Make a backup of your database.
These upgrade scripts often make changes to the database. If you don't
make a backup and something doesn't go as planned, you may
lose data.

=item 2

Upgrade your RT installation to RT 6.0.1 or newer following
its upgrade instructions. Make sure you follow all of the
steps and upgrade both the code and the database.

As noted in the RT documentation, it is recommended that you
use a fresh directory when upgrading to RT 6, like /opt/rt6,
rather than upgrading on top of your RT 5 installation.
A lot of files have been deleted and moved around in RTIR
so don't copy an old RTIR's files.

    RTIR 3.2 is only compatible with RT 4.2 releases.

    RTIR 4.0 is only compatible with RT 4.4 releases.

    RTIR 5.0 is only compatible with RT 5.0 releases.

    RTIR 6.0 is only compatible with RT 6.0 releases.

=item 3

Make another backup of the DB, so you can return to this step
if something goes wrong.

=item 4

Install the new version of RTIR. B<DO NOT> run C<make initdb>.

=item 5

Review all of the upgrade notes in docs/UPGRADING-*. If you were
coming from 2.6.1, you would read UPGRADING-2.6, UPGRADING-3.0, UPGRADING-3.2,
UPGRADING-4.0, UPGRADING-5.0, and UPGRADING-6.0.

=item 6

Update RTIR's database.

Type:

    make upgrade-database

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

Re-analyze and re-optimize your database tables.

When you have completed all of the upgrade steps, you will
likely need to update any optimizations you have done since the
underlying tables have probably changed.

=item 8

Test your upgraded RT. You should be able to start the server,
log in, use the RT web interface, create tickets, send email to
RT, receive mail from RT, etc.

=back

=cut
