Account confirmers, Anti-spam team, Confirmed users, Bureaucrats and Sysops emeriti
4,925
edits
No edit summary |
|||
| Line 103: | Line 103: | ||
If you want to install the API proxy on your own machine for your own Bugzilla, you will need: | If you want to install the API proxy on your own machine for your own Bugzilla, you will need: | ||
* the latest stable 3.4.x | * the <b>latest</b> stable 3.4.x, 3.6.x or 4.0.x point release of Bugzilla (many features will not work on 3.2); and | ||
* to be using UTF-8 (this is the default on new installations) | * to be using UTF-8 (this is the default on new installations); and | ||
* | * to have the necessary optional modules for XML-RPC (e.g. Test::Taint). | ||
Then, install a copy of the API software - it does not have to be on the same machine. See the INSTALL file in the repository for some installation hints; feel free to send me tips from your experience. | Then, install a copy of the API software - it does not have to be on the same machine. See the INSTALL file in the repository for some installation hints; feel free to send me tips from your experience. | ||
| Line 113: | Line 113: | ||
hg clone http://hg.mozilla.org/webtools/bzapi bzapi | hg clone http://hg.mozilla.org/webtools/bzapi bzapi | ||
===Patches=== | ===Extension (or Patches)=== | ||
Even the latest stable release of Bugzilla requires a little modification to work properly with the BzAPI. Unfortunately, it is not possible to support all the necessary functionality without some changes to Bugzilla itself, which the Bugzilla team have declined to take. | Even the latest stable release of Bugzilla requires a little modification to work properly with the BzAPI. Unfortunately, it is not possible to support all the necessary functionality without some changes to Bugzilla itself, which the Bugzilla team have declined to take. | ||
So, for Bugzilla 3.6 and above, there is a Bugzilla Extension which adds the necessary functionality. Find it in <tt>$BZAPI_HOME/extension</tt>; copy the <tt>BzAPI</tt> directory from there into <tt>$BUGZILLA_HOME/extensions</tt>. | |||
If you are | If you are on 3.4 or below, you need a patch and a template. These are shipped in the BzAPI distribution, in the <tt>patches</tt> directory, from version 0.8 onwards. See the INSTALL file for details. | ||
Also, if you are using non-ASCII characters at all, you need to patch the BZ::Client module, which has an encoding bug. The patch for that is also in the <tt>patches</tt> directory. | |||