File:  [mozdev] / bugxula / www / server.html
Revision 1.3: download - view: text, annotated - select for diffs - revision graph
Wed May 14 22:08:28 2003 UTC (14 years, 5 months ago) by myk
Branches: MAIN
CVS tags: HEAD
another minor formatting fix

<h2>Server-Side How To: Getting Bugxula Working with your own Bugzilla Installation</h2>

<p>
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.
</p>

<p>
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:
</p>

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

<p>
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:
</p>

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

&lt;bz:installation about="http://bugzilla.mozilla.org/"&gt;
  &lt;bz:products&gt;
    &lt;Seq&gt;
        &lt;li&gt;
          &lt;bz:product about="http://bugzilla.mozilla.org/product.cgi?name=Browser"&gt;
            &lt;bz:name&gt;Browser&lt;/bz:name&gt;
          &lt;/bz:product&gt;
        &lt;/li&gt;
        &lt;li&gt;
          &lt;bz:product about="http://bugzilla.mozilla.org/product.cgi?name=MailNews"&gt;
            &lt;bz:name&gt;MailNews&lt;/bz:name&gt;
          &lt;/bz:product&gt;
        &lt;/li&gt;
    &lt;/Seq&gt;
  &lt;/bz:products&gt;
&lt;/bz:installation&gt;

&lt;/RDF&gt;
</code></pre>

<p>
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.
</p>

<p>
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:
</p>

<pre><code>
&lt;RDF:Seq about="rdf:#$tC.X01"&gt;
  &lt;RDF:li resource="http://bugscape.nscp.aoltw.net/"/&gt;
  &lt;RDF:li resource="http://bugzilla.mozilla.org/"/&gt;
&lt;/RDF:Seq&gt;
</code></pre>

Or like this:

<pre><code>
&lt;bz:installations&gt;
  &lt;RDF:Seq&gt;
    &lt;RDF:li&gt;&lt;bz:installation about="http://bugzilla.mozilla.org/" bz:name="mozilla.org" /&gt;&lt;/RDF:li&gt;
    &lt;RDF:li&gt;&lt;bz:installation about="http://bugscape.nscp.aoltw.net/" bz:name="bugscape" /&gt;&lt;/RDF:li&gt;
  &lt;/RDF:Seq&gt;
&lt;/bz:installations&gt;
</code></pre>

<p>
If it looks like the former, make it look like this to add the installation:
</p>

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

<p>
If it looks like the latter, make it look like this:
</p>

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

<p>
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 "&amp;format=rdf" to any buglist.cgi URL.  If 
Bugzilla returns the data as RDF, then you are good to go.
</p>

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>