mozdev.org

Bugxula    

resources:

Server-Side How To: Getting Bugxula Working with your own Bugzilla Installation

To use Bugxula with your own installation, you need to first publish some information about your installation at a specific place and in a specific format that Bugxula knows how to read and then point Bugxula at your installation.

The easiest way to publish that information about your installation is to upgrade your installation to the Bugzilla tip (f.e. via CVS commands) and then run the config.cgi script to generate the information like so:


wget -O/path/to/bugzilla/installation/localconfig.rdf 'http://my.installation.com/config.cgi?ctype=rdf'

Alternately, you can hand-write your own config file. To do this, use the following code, which shows the minimum information you have to publish (basically the products in your installation), as a template:


<?xml version="1.0"?>
<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
     xmlns:bz="http://www.bugzilla.org/rdf#">

<bz:installation about="http://bugzilla.mozilla.org/">
  <bz:products>
    <Seq>
        <li>
          <bz:product about="http://bugzilla.mozilla.org/product.cgi?name=Browser">
            <bz:name>Browser</bz:name>
          </bz:product>
        </li>
        <li>
          <bz:product about="http://bugzilla.mozilla.org/product.cgi?name=MailNews">
            <bz:name>MailNews</bz:name>
          </bz:product>
        </li>
    </Seq>
  </bz:products>
</bz:installation>

</RDF>

Make sure to call the file localconfig.rdf and put it into your Bugzilla installation root. Also make sure your web server is configured to serve RDF files as application/xml. For Apache, this means putting the line "application/xml rdf" in the mime.types file and restarting Apache.

Once you have that file on your installation, you need to point Bugxula at it. To do so, open the file called bugxula.rdf, which is located in your profile directory, and find a section of that file which looks something like this:


<RDF:Seq about="rdf:#$tC.X01">
  <RDF:li resource="http://bugscape.nscp.aoltw.net/"/>
  <RDF:li resource="http://bugzilla.mozilla.org/"/>
</RDF:Seq>
Or like this:

<bz:installations>
  <RDF:Seq>
    <RDF:li><bz:installation about="http://bugzilla.mozilla.org/" bz:name="mozilla.org" /></RDF:li>
    <RDF:li><bz:installation about="http://bugscape.nscp.aoltw.net/" bz:name="bugscape" /></RDF:li>
  </RDF:Seq>
</bz:installations>

If it looks like the former, make it look like this to add the installation:


<RDF:Seq about="rdf:#$tC.X01">
  <RDF:li resource="http://bugscape.nscp.aoltw.net/"/>
  <RDF:li resource="http://bugzilla.mozilla.org/"/>
  <RDF:li resource="http://my.installation.com/"/>
</RDF:Seq>
<bz:installation about="http://my.installation.com/" bz:name="myname" />

If it looks like the latter, make it look like this:


<bz:installations>
  <RDF:Seq>
    <RDF:li><bz:installation about="http://bugzilla.mozilla.org/" bz:name="mozilla.org" /></RDF:li>
    <RDF:li><bz:installation about="http://bugscape.nscp.aoltw.net/" bz:name="bugscape" /></RDF:li>
    <RDF:li><bz:installation about="http://my.installation.com/" bz:name="myname" /></RDF:li>
  </RDF:Seq>
</bz:installations>

One last point is that your Bugzilla installation needs to be able to generate bug lists as RDF. The code to do that went into Bugzilla about a year ago, so if your Bugzilla installation is newer than a year you should be set. To check, add "&format=rdf" to any buglist.cgi URL. If Bugzilla returns the data as RDF, then you are good to go.

Sorry it's so hard to get it working. I'm planning to make things easier in the future.

The bugxula project can be contacted through the mailing list or the member list.
Copyright © 2000-2017. All rights reserved. Terms of Use & Privacy Policy.