1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140
|
From dd4e7d0f705ba5173a61c7a674b3184a063b9c61 Mon Sep 17 00:00:00 2001
From: Andrew Ruthven <andrew@etc.gen.nz>
Date: Wed, 21 May 2025 20:38:16 +1200
Subject: Debianize UPGRADING-4.4
Forwarded: not-needed
Patch-Name: debianize_UPGRADING-4.4.diff
---
docs/UPGRADING-4.4 | 36 +++++++++++++++++++-----------------
1 file changed, 19 insertions(+), 17 deletions(-)
diff --git a/docs/UPGRADING-4.4 b/docs/UPGRADING-4.4
index 575d4543..a3e26c8c 100644
--- a/docs/UPGRADING-4.4
+++ b/docs/UPGRADING-4.4
@@ -22,7 +22,7 @@ L<RT::Authen::ExternalAuth::DBI> documentation.
Users of the existing
L<RT::Authen::ExternalAuth|https://metacpan.org/pod/RT::Authen::ExternalAuth>
extension should remove C<RT::Authen::ExternalAuth> from the plugins list.
-Please also remove F<local/plugins/RT-Authen-ExternalAuth> from your RT
+Please also remove F<RT-Authen-ExternalAuth> from your RT
installation.
=item *
@@ -33,9 +33,9 @@ has been moved into core RT.
Users of the existing LDAPImport extension should remove
C<RT::Extension::LDAPImport> from the plugins list. Please adjust any
cronjobs or external scripts which invoke
-F<local/plugins/RT-Extension-LDAPImport/bin/rtldapimport> to instead
-invoke F<sbin/rt-ldapimport>. Please also remove
-F<local/plugins/RT-Extension-LDAPImport> from your RT installation.
+F<rtldapimport> to instead
+invoke F</usr/sbin/rt-ldapimport-5>. Please also remove
+F<RT-Extension-LDAPImport> from your RT installation.
=item *
@@ -54,9 +54,9 @@ visible.
Users who are currently using the
L<RT::Extension::Assets|https://bestpractical.com/assets/> extension
should remove C<RT::Extension::Assets> from the plugin list and run the
-F<etc/upgrade/upgrade-assets> utility after completing all the other
+F</usr/share/request-tracker5/etc/upgrade/upgrade-assets> utility after completing all the other
upgrade steps from the F<README>. Please also remove
-F<local/plugins/RT-Extension-Assets> from your RT installation.
+F<RT-Extension-Assets> from your RT installation.
=item *
@@ -74,7 +74,7 @@ the main RT code and database upgrade steps successfully:
=item * Remove C<RT::Extension::SLA> from your plugin list in C<RT_SiteConfig.pm>
-=item * Run the upgrade script F<etc/upgrade/upgrade-sla>
+=item * Run the upgrade script F</usr/share/request-tracker5/etc/upgrade/upgrade-sla>
=item * Update the format of your C<%ServiceAgreements> configuration
@@ -89,7 +89,7 @@ If you have a Business Hours configuration, update your configuration
in C<RT_SiteConfig.pm> with the same changes as described above for
C<%ServiceAgreements>.
-=item * (Optional) Remove the directory F<local/plugins/RT-Extension-SLA>
+=item * (Optional) Remove the directory F<RT-Extension-SLA>
You can remove this directory and all of its contents from your RT
installation to uninstall the previous extension code
@@ -112,8 +112,8 @@ L<RT::Extension::ExternalStorage|https://metacpan.org/pod/RT::Extension::Externa
should remove it from the plugin list. Please adjust any cronjobs or external
scripts which invoke
F<local/plugins/RT-Extension-ExternalStorage/bin/extract-attachments>
-to instead invoke F<sbin/rt-externalize-attachments>. Please also remove
-F<local/plugins/RT-Extension-ExternalStorage> from your RT installation.
+to instead invoke F</usr/sbin/rt-externalize-attachments-5>. Please also remove
+F<RT-Extension-ExternalStorage> from your RT installation.
=item *
@@ -137,7 +137,7 @@ introduced in 4.4.2.
Users who are currently using
L<RT::Extension::ParentTimeWorked|https://metacpan.org/pod/RT::Extension::ParentTimeWorked>
should remove it from the plugin list. Please also remove
-F<local/plugins/RT-Extension-ParentTimeWorked> from your RT installation.
+F<RT-Extension-ParentTimeWorked> from your RT installation.
=item *
@@ -147,7 +147,7 @@ removed in favor of a built-in solution.
=item *
You can now split settings from F<RT_SiteConfig.pm> into separate files under
-an F<etc/RT_SiteConfig.d/> directory. All files ending in C<.pm> will be
+an F</etc/request-tracker5/RT_SiteConfig.d/> directory. All files ending in C<.pm> will be
parsed, in alphabetical order, after the main F<RT_SiteConfig.pm> is loaded.
You also no longer need the C<1;> at the end of site config files.
@@ -507,6 +507,8 @@ We now explicitly depend on the Pod::Select Perl module since it was removed
from the Perl core starting in 5.18. If you're on a recent version of Perl
you will most likely need to install this dependency.
+This is installed on Debian when installing the request-tracker5 package.
+
=item *
We now automatically enable ExternalAuth when the ExternalSettings config is
@@ -599,7 +601,7 @@ RT now has the functionality from
L<RT::Extension::AdminConditionsAndActions> built in. Users who are
currently using this extension should remove it from the plugin list.
Please also remove
-F<local/plugins/RT-Extension-AdminConditionsAndActions> from your RT
+F<RT-Extension-AdminConditionsAndActions> from your RT
installation.
=back
@@ -660,7 +662,7 @@ If you use groups in ticket roles, it's likely your CachedGroupMembers table
has a large number of now unnecessary records and these can hurt performance.
To delete these extra records run the following script:
- /opt/rt4/etc/upgrade/shrink-cgm-table
+ /usr/share/request-tracker5/etc/upgrade/shrink-cgm-table
Depending on how many records your system has, this may take a while to run.
After you run this, you may have significantly reduced the number of records
@@ -735,13 +737,13 @@ RT 4.4.6 and earlier use the Perl GraphViz module for interfacing with the graph
library for generating ticket link graphs. That module has been deprecated so
we have replaced it with the GraphViz2 module.
-Systems using C<--enable-graphviz> will be prompted to install the Perl
-GraphViz2 module when upgrading.
+This is installed on Debian when installing the request-tracker5 package.
=item * MySQL 8 now supported
Starting with RT 4.4.7, RT now supports MySQL 8. Note that as part of this upgrade
-you also need to update the module L<DBIx::SearchBuilder>.
+you also need to update the module L<DBIx::SearchBuilder>, which is provided by
+libdbix-searchbuilder-perl on Debian.
=back
|