Merge branch 'master' of git.freeside.biz:/home/git/freeside

[freeside.git] / rt / docs / UPGRADING-4.0

diff --git a/rt/docs/UPGRADING-4.0 b/rt/docs/UPGRADING-4.0
index 63dd2ee..0a3249c 100644 (file)
--- a/rt/docs/UPGRADING-4.0
+++ b/rt/docs/UPGRADING-4.0
@@ -1,5 +1,8 @@
 =head1 UPGRADING FROM BEFORE 4.0.0
 
 =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
 =head2 Common issues
 
 RT now defaults to a database name of rt4 and an installation root of


@@ -32,6 +35,10 @@ If you deploy RT with mod_perl, Apache will no longer start with C<SetHandler>
 set to `perl-script`. F<docs/web_deployment.pod> contains the
 new configuration.
 
 set to `perl-script`. F<docs/web_deployment.pod> contains the
 new configuration.
 

+RT::Extension::CustomField::Checkbox has been integrated into core, so you
+MUST uninstall it before upgrading. In addition, you must run
+/opt/rt4/etc/upgrade/4.0-customfield-checkbox-extension script to convert old
+data.

 
 =head2 RT_SiteConfig.pm
 
 
 =head2 RT_SiteConfig.pm
 


@@ -57,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
 
 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
 that data.
 
 When running normal upgrade scripts, RT will warn if it finds existing RTFM


@@ -70,7 +77,7 @@ spectacularly.  Do *not* run this except on a fresh upgrade of RT.
 
 You can run this as
 
 
 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.
 
 It will ouput a lot of data about what it is changing.  You should review this
 for errors.


@@ -81,14 +88,6 @@ to RT4.
 
 You must also remove RT::FM from your @Plugins line in RT_SiteConfig.pm.
 
 
 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 *
 =over
 
 =item *


@@ -242,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:
 
 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.
 
 Followed by re-running make upgrade-database and answering 3.9.8 when
 prompted for which RT version you're upgrading from.