DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Mercurial (cf424d6d4bb6)

VCS Links

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
Here are some rough installation notes.

Bugzilla
--------

Your Bugzilla will need the extension installed. See:
https://wiki.mozilla.org/Bugzilla:REST_API#Extension_.28or_Patches.29

Once you have installed it, run checksetup.pl to make sure everything is OK, and all the necessary modules are installed.

Ubuntu
------

apt-get install libcatalyst-perl libcatalyst-modules-perl libmoose-perl apache2 libapache2-mod-fastcgi mercurial liblog-handler-perl

# perl -MCPAN -e "install BZ::Client"
# perl -MCPAN -e "install Moose"
# perl -MCPAN -e "install Test::More"
# perl -MCPAN -e "install Catalyst::Controller::REST" (inc. optional modules)
(I had to force install on my test box, but not on my personal machine.)
# perl -MCPAN -e "install Catalyst::Plugin::Log::Handler"

* Ubuntu 9.04

# perl -MCPAN -e "install Array::Diff"
# perl -MCPAN -e "install Slurp"
# perl -MCPAN -e "install Data::Walk"

* Ubuntu 9.10

apt-get install libarray-diff-perl libcatalyst-action-rest-perl libdata-walk-perl

BzAPI
-----

(These instructions are for deployment of version 0.2; change the tag for a higher version number.)

# cd /var/www
# hg clone http://hg.mozilla.org/webtools/bzapi 0.2

Copy bugzilla_api.conf.sample to bugzilla_api.conf and edit the appropriate parameters to tell the API about your Bugzilla.

Check all Perl modules required are installed by trying to start the test server:
# cd 0.2
# scripts/bugzilla_api_server.pl

Enable the SSL mod for Apache:
# a2enmod ssl

In /etc/apache2/sites-enabled/bzapi, inside standard VirtualHost tags cloned from "default", you need lines something like the following:

  FastCgiServer /var/www/0.2/script/bugzilla_api_fastcgi.pl -processes 10 -idle-timeout 180
  Alias /0.2 /var/www/0.2/script/bugzilla_api_fastcgi.pl/

Same in bzapi-ssl, cloned from "default-ssl". You need the Alias line but not the FastCgiServer line.

If you have a cert, you'll need to edit that file to point to it. Otherwise, generate one using
make-ssl-cert /usr/share/ssl-cert/ssleay.cnf /root/snake-oil.crt
This is your SSLCertificateFile in the config file (you don't need an SSLCertificateKeyFile).

Restart apache:
# apache2ctl restart

Logging Problems
----------------

If you have problems with logging errors, or your server dying with errors in Log::Handler, make sure you have the latest version of Log::Handler (>= 0.66) and Catalyst::Plugin::Log::Handler (>= 0.8).

Windows
-------

A correspondent writes:

"To install on Windows I followed the same steps I did in the Ubuntu
installation. Executed the server and installed the requested Perl packages."