summaryrefslogtreecommitdiff
path: root/rt/docs/UPGRADING-4.0
diff options
context:
space:
mode:
Diffstat (limited to 'rt/docs/UPGRADING-4.0')
-rw-r--r--rt/docs/UPGRADING-4.020
1 files changed, 8 insertions, 12 deletions
diff --git a/rt/docs/UPGRADING-4.0 b/rt/docs/UPGRADING-4.0
index 766964f42..0a3249c3f 100644
--- a/rt/docs/UPGRADING-4.0
+++ b/rt/docs/UPGRADING-4.0
@@ -1,5 +1,8 @@
=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
@@ -34,7 +37,8 @@ new configuration.
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
@@ -60,7 +64,7 @@ the new schema.
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
@@ -73,7 +77,7 @@ spectacularly. Do *not* run this except on a fresh upgrade of RT.
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.
@@ -84,14 +88,6 @@ to RT4.
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 *
@@ -245,7 +241,7 @@ version of DBD::Pg RT will stop the upgrade during the 3.9.8 step and
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.