X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=rt%2Fdocs%2FUPGRADING-4.0;h=766964f422f9c1a8e3744844f809c9219e89d668;hb=0ea23112cfa0d82738b0f08d60d90579721b7524;hp=ad8d87b5fd12990dd917dd75544a3eda77f1519f;hpb=06fb1346ff8076a84f743fa07de31852942e144f;p=freeside.git diff --git a/rt/docs/UPGRADING-4.0 b/rt/docs/UPGRADING-4.0 index ad8d87b5f..766964f42 100644 --- a/rt/docs/UPGRADING-4.0 +++ b/rt/docs/UPGRADING-4.0 @@ -24,10 +24,17 @@ following to remove the _Overlay files: find /opt/rt3/lib/ -type f -name '*_Overlay*' -delete RT has also changed how web deployment works; you will need to review -docs/web_deployment.pod for current instructions. The old `fastcgi_server`, -`webmux.pl`, and `mason_handler.*` files will not work with RT 4.0, and should -be removed to reduce confusion. +F for current instructions. The old +`fastcgi_server`, `webmux.pl`, and `mason_handler.*` files will not +work with RT 4.0, and should be removed to reduce confusion. +If you deploy RT with mod_perl, Apache will no longer start with C +set to `perl-script`. F 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 +etc/upgrade/4.0-customfield-checkbox-extension script to convert old data. =head2 RT_SiteConfig.pm @@ -122,6 +129,14 @@ database level. =back +=head2 Ticket content searches (full text search) + +Since 4.0.0, RT's ticket content search is disabled by default because of +performance issues when used without full text indexing. For details on how to +re-enable it with (or without) full text indexing, see +F. + + =head1 UPGRADING FROM 4.0.5 AND EARLIER @@ -148,3 +163,89 @@ the following Mason templates, this feature will not function correctly: share/html/Search/Elements/BuildFormatString share/html/Search/Elements/PickCFs share/html/Search/Elements/PickCriteria + +=head1 UPGRADING FROM 4.0.8 AND EARLIER + +=head2 Data upgrades + +Previously, the default lifecycle was stored in Queues.Lifecycle as +NULL. To simplify code, RT now stores the string 'default' to match the +name of the Lifecycle. + +The 3.9.2 upgrade step removed all enabled Personal Groups, but missed +any disabled groups. We catch and clean up the disabled Personal groups +during the 4.0.9 upgrade step. + +=head2 Javascript Changes + +If you have set a custom @JSFiles in RT_SiteConfig.pm, you will need to +amend this to include the new jquery.cookie.js file added to +RT_Config.pm. If you are using an extension that requires manually +tweaking @JSFiles, please contact the developer and ask them to use +RT->AddJavaScript in their extension to avoid these upgrade problems. + +If you have @JSFiles set in your RT_SiteConfig.pm but it appears to be +the same as RT_Config.pm (no local js files added) you can safely remove +the whole setting from RT_SiteConfig.pm and allow our default to be +used. + +=head1 UPGRADING FROM 4.0.11 AND EARLIER + +=head2 Data Upgrades + +Previous versions of RT allowed you to create Tickets with a Type of +'Ticket', 'Approval' or 'Reminder' instead of the correct 'ticket'. +Existing Types are updated in the database and the RT API now corrects +these types before insertion. + +Site-specific custom types (anything but ticket, reminder or approval) +are not affected by these changes. + +=head1 UPGRADING FROM 4.0.13 AND EARLIER + +=head2 Outgoing mail From: header + +The "Default" key of the C<$OverrideOutgoingMailFrom> config option now, +as previously documented, only applies when no ticket is involved. +Previously it was also used when a ticket was involved but the +associated queue had no specific correspond address. In such cases the +global correspond address is now used. + +The config option C<$SetOutgoingMailFrom> now accepts an email address +as a value which will act as a global default. This covers the simple +case of sending all bounces to a specific address, without the previous +solution of resorting to defining all queues in +$OverrideOutgoingMailFrom. Any definitions in the Override option +(including Default) still take precedence. See +L for more information. + +=head2 Reminder statuses + +New reminders are now created in the "reminder_on_open" status defined in your +lifecycles. For the default lifecycle, this means reminders will start as +"open" instead of "new". This change is for consistency when a completed +reminder is reopened at a later date. If you use custom lifecycles and added +further transition restrictions, you may need to adjust the L<"reminder_on_open" +setting|RT_Config/reminder_on_open> in your lifecycles. + +=head2 Bookmarks + +Previously, the list of Bookmarks on your homepage was unlimited (if you +had 100 bookmarked tickets, you would see a 100 item list on your RT at +a Glance). 'Bookmarked Tickets' now uses the same size limits as any +other search on your homepage. This can be customized using the 'Rows +per box' setting on your RT at a Glance configuration page. + +=head2 PostgreSQL 9.2 + +If you are upgrading an RT from 3.8 (or earlier) to 4.0 on PostgreSQL +9.2, you should make sure that you have installed DBD::Pg 2.19.3 or +higher. If you start your upgrade without installing a recent-enough +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/ + +Followed by re-running make upgrade-database and answering 3.9.8 when +prompted for which RT version you're upgrading from.