Bugzilla.wikimedia.org

From Wikitech
(Difference between revisions)
Jump to: navigation, search
(→‎Hardware)
Line 19: Line 19:
 
** With custom templates and tweaks
 
** With custom templates and tweaks
  
−
== Upgrade from 3.0.8 to 3.4.4 ==
+
== Upgrade from 3.6.0 to 4.0 ==
−
''These are the steps [http://office.wikimedia.org/wiki/User:Priyanka pdhanda] used to upgrade her test machine. If you encounter problems or the instructions are incorrect, contact her.''
+
''Note: This was tested on http://project2.wikimedia.org/bugzilla4 with the following software''
−
* Test Machine Software
+
* ''Ubuntu 8.04.4''
−
** Ubuntu 8.04.3
+
* ''Mysql 5.0.51a''
−
** Mysql 5.0.51a
+
* ''Apache2''
−
** Apache2
+
* ''Perl v5.8.8''
−
** Perl v5.8.8
+
''Back up the database and the data directory in case anything goes wrong''
  
−
* Back up the existing Bugzilla 3.0.8 MySQL database
+
* Download and extract [http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.0.tar.gz Bugzilla 4.0] .
−
* Back up the entire Bugzilla 3.0.8 install directory and move it out of the way (we're going to re install the new version)
+
* Make the following Apache config changes
−
** We're are going to need the <bugzilla_home>/localconfig and <bugzilla_home>/data/params files for the new insatall
+
: [http://www.bugzilla.org/releases/4.0/release-notes.html#v40_upgrading Apache Config Changes]
−
* Start with an ''apt-get upgrade''
+
*Copy the following from the old Bugzilla installation
−
* Upgrade CPAN to the latest version using ''sudo perl -MCPAN -e 'install Bundle::CPAN'''
+
: localconfig
−
* Download and extract [http://www.bugzilla.org/download/#v34 Bugzilla 3.4.4]
+
: data/
−
* Download our custom skin and templates from [TBD]
+
* Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/skins/contrib/Wikimedia into skins/contrib/Wikimedia
−
* Copy the <old_bugzilla>/localconfig file into <Bugzilla3.4.4_home>/localconfig
+
* Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/template/en/custom into template/en/custom
−
* Copy the <old_bugzilla>/data/params file into <Bugzilla3.4.4_home>/data/params
+
* Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/extensions/Wikimedia into extensions/Wikimedia
−
* Add our custom skins and templates
+
* Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/extensions/WeeklyReport into extensions/WeeklyReport
−
<pre>
+
** ln -s extensions/WeeklyReport/component-report.cgi component-report.cgi
−
          cd <Bugzilla3.4.4_home>
+
** ln -s extensions/WeeklyReport/weekly-bug-summary.cgi weekly-bug-summary.cgi
−
          mkdir skins/custom
+
* Run ('''this is where the database migration will happen so be sure you are ready'''):
−
          cp -r skins/standard/* skins/custom/
+
: perl checksetup.pl
−
          mkdir template/en/custom
+
After this Bugzilla should be up and running with the classic skin
−
          cp -r template/en/default/* template/en/custom/
+
<br/><br/>
−
          tar xvzf <download_location>/bugzilla_3-4-4_vector.tgz
+
* Now change the following settings:
−
</pre>
+
** Administration->Default Preferences->Bugzilla's general appearance (skin) = Wikimedia
−
* Run the ''<Bugzilla3.4.4_home>/checksetup.pl'' script which will do the database migration and fix all your directory permissions. This may take a while.
+
** Administration->Default Preferences->Position of the Additional Comments box = After other comments
−
* The part of the checksetup script that we're interested in is the missing Perl Modules. It will look something like this
+
−
<pre>
+
−
        COMMANDS TO INSTALL REQUIRED MODULES (You *must* run all these commands
+
−
and then re-run checksetup.pl):
+
−
 
+
−
            /usr/bin/perl install-module.pl DateTime::TimeZone
+
−
            /usr/bin/perl install-module.pl Email::Send
+
−
            /usr/bin/perl install-module.pl Email::MIME
+
−
            /usr/bin/perl install-module.pl Email::MIME::Encodings
+
−
            /usr/bin/perl install-module.pl Email::MIME::Modifier
+
−
</pre>
+
−
I installed the modules using CPAN instead
+
−
<pre>
+
−
          perl -MCPAN -e shell
+
−
          install DateTime::TimeZone
+
−
          <repeat for each module listed above>
+
−
</pre>
+
−
* Run the checksetup script again to make sure everything is in order
+
  
 
== REST API ==
 
== REST API ==

Revision as of 20:38, 24 March 2011

Our Bugzilla installation is at https://bugzilla.wikimedia.org/, with attachments hosted at http://bug-attachment.wikimedia.org/ . The attachment domain only allows downloading of attachments.

Contents

Hardware

Related services

Software

  • Apache+Perl
  • MySQL
  • Bugzilla
    • With custom templates and tweaks

Upgrade from 3.6.0 to 4.0

Note: This was tested on http://project2.wikimedia.org/bugzilla4 with the following software

  • Ubuntu 8.04.4
  • Mysql 5.0.51a
  • Apache2
  • Perl v5.8.8

Back up the database and the data directory in case anything goes wrong

  • Download and extract Bugzilla 4.0 .
  • Make the following Apache config changes
Apache Config Changes
  • Copy the following from the old Bugzilla installation
localconfig
data/
  • Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/skins/contrib/Wikimedia into skins/contrib/Wikimedia
  • Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/template/en/custom into template/en/custom
  • Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/extensions/Wikimedia into extensions/Wikimedia
  • Checkout svn.wikimedia.org/svnroot/mediawiki/trunk/tools/bugzilla/bugzilla-4.0/extensions/WeeklyReport into extensions/WeeklyReport
    • ln -s extensions/WeeklyReport/component-report.cgi component-report.cgi
    • ln -s extensions/WeeklyReport/weekly-bug-summary.cgi weekly-bug-summary.cgi
  • Run (this is where the database migration will happen so be sure you are ready):
perl checksetup.pl

After this Bugzilla should be up and running with the classic skin

  • Now change the following settings:
    • Administration->Default Preferences->Bugzilla's general appearance (skin) = Wikimedia
    • Administration->Default Preferences->Position of the Additional Comments box = After other comments

REST API

Installation instructions

How to recover in a hurry

Its a good thing we backed up out database and Bugzilla 3.0.8 home directory as part of the upgrade

  • Move the backed up Bugzilla back to its original location
  • Restore the MySQL database from the backup dump
  • Run the checksetup.pl script

Notes

  • Switched to SSL 2008-02

Patches

Retrieved from "http://wikitech-old.wikimedia.org/index.php?title=Bugzilla.wikimedia.org&oldid=32981"
Personal tools
Namespaces

Variants
Actions
Navigation
Ops documentation
Wiki
Toolbox