User:Malyacko/Bugzilla42Upgrade

Document refers to upgrading Bugzilla from 4.0.9 to 4.2.4, locally tested with WM changes available in Gerrit which might not necessaraily be in sync with what's on the server. At that time, no Labs instance was set up.

= Announcement = bugzilla.wikimedia.org will be unavailable due to maintenance work on Thursday, November 29th from 22:00 UTC until max. Friday November 30th 02:00 UTC (Thursday, November 29th 14:00 PST until max. 18:00 PST).
 * Set https://bugzilla.wikimedia.org/editparams.cgi?section=general#announcehtml_desc to

= Before running checksetup.pl = ./template/en/custom/global/site-navigation.html.tmpl ./template/en/custom/global/user-links.html.tmpl ./template/en/custom/global/search-links.html.tmpl
 * run the Sanity Check function from the Admin page
 * make sure that in extensions/Voting/ there is NO file called "disabled" otherwise we disable voting! (MUST run checksetup.pl afterwards in case of deleting that file!)
 * Reapply diff for bugzilla-4.0/Bugzilla/BugMail.pm to bugzilla-4.2/Bugzilla/BugMail.pm (see 43130.
 * I needed to run: /usr/bin/perl install-module.pl Math::Random::ISAAC
 * I ignored: "WARNING: You need to set the max_allowed_packet parameter in your MySQL configuration to at least 3276750. Currently it is set to 1048576. You can set this parameter in the [mysqld] section of your MySQL configuration file."
 * Due to https://bugzilla.mozilla.org/show_bug.cgi?id=736057 you MUST run find . -type f -name "*.tmpl" -exec replace 'FILTER url_quote' 'FILTER uri' -- {} \; in order to fix

= Test after upgrade =
 * Voting! If it does not work, we did not remove the "disabled" file in /extensions/Voting
 * Check if extension https://bugzilla.wikimedia.org/weekly-bug-summary.cgi?tops=10&days=7 works at all - see above.
 * Navigation > Help is broken in 4.2.4, links to non-existing /docs/en/html/bug_page.html . 4.0.9 links to /docs/en/html/index.html
 * /reports.cgi says "Unable to open the chart datafile /var/lib/bugzilla./data/mining/-All-" locally here, but might be because of missing data.
 * Ignore wikimedia/bugzilla/modifications/bugzilla-4.0/client/ (after having contacted Mark A. Hershberger).

= After all is done = Wikimedia Bugzilla was upgraded to a new software version on Dec 04th, 2012. If you find problems with Bugzilla itself please file a bug report.
 * Set announcehtml in Bugzilla to
 * Update Gerrit: Copy wikimedia/bugzilla/modifications/bugzilla-4.0 to "bugzilla-4.2"
 * Copy SiteMap from server into Gerrit so stuff is in sync
 * Close https://bugzilla.wikimedia.org/show_bug.cgi?id=33158