=head1 UPGRADING FROM BEFORE 4.0.0
+See F<devel/docs/UPGRADING-4.0> for internals changes relevant to
+extension writers. The following is tailored to RT administrators:
+
=head2 Common issues
RT now defaults to a database name of rt4 and an installation root of
RT::Extension::CustomField::Checkbox has been integrated into core, so you
MUST uninstall it before upgrading. In addition, you must run
-etc/upgrade/4.0-customfield-checkbox-extension script to convert old data.
+/opt/rt4/etc/upgrade/4.0-customfield-checkbox-extension script to convert old
+data.
=head2 RT_SiteConfig.pm
RT4 now includes an Articles functionality, merged from RTFM. You should not
install and enable the RT::FM plugin separately on RT 4. If you have existing
-data in RTFM, you can use the etc/upgrade/upgrade-articles script to upgrade
+data in RTFM, you can use the /opt/rt4/etc/upgrade/upgrade-articles script to upgrade
that data.
When running normal upgrade scripts, RT will warn if it finds existing RTFM
You can run this as
- etc/upgrade/upgrade-articles
+ /opt/rt4/etc/upgrade/upgrade-articles
It will ouput a lot of data about what it is changing. You should review this
for errors.
You must also remove RT::FM from your @Plugins line in RT_SiteConfig.pm.
-
-=head2 Removals and updates
-
-The deprecated classes RT::Action::Generic, RT::Condition::Generic and
-RT::Search::Generic have been removed, but you shouldn't have been using them
-anyway. You should have been using RT::Action, RT::Condition and RT::Search,
-respectively.
-
=over
=item *
remind you to upgrade DBD::Pg. If this happens, you can re-start your
upgrade by running:
- ./sbin/rt-setup-database --action insert --datadir etc/upgrade/3.9.8/
+ /opt/rt4/sbin/rt-setup-database --action insert --datadir etc/upgrade/3.9.8/
Followed by re-running make upgrade-database and answering 3.9.8 when
prompted for which RT version you're upgrading from.