View source for Bugzilla REST API

== How I installed the Bugzilla:REST API==

There is an INSTALL file in the bzapi repository which you can try, but I had to make a few additional things the get everything to work. Here is what I did:

* Install packages:
<pre>
    apt-get install mercurial libapache2-mod-fastcgi
    perl -MCPAN -e "install BZ::Client"
    perl -MCPAN -e "install Array::Diff"
    perl -MCPAN -e "install Slurp"
    perl -MCPAN -e "install Moose"
    perl -MCPAN -e "install Test::More"
    perl -MCPAN -e "install Data::Walk"
    perl -MCPAN -e "install Class::MOP"
    perl -MCPAN -e "install Catalyst::Controller::REST" (include optional modules)
    perl -MCPAN -e "install Catalyst::Plugin::Log::Handler" (you may have to force install this)
</pre>

On line 83 of /usr/local/share/perl/5.10.0/Catalyst/Plugin/Log/Handler.pm (or whereever that module was installed), comment out the following:
<pre>
    $self->handler(Log::Handler->new(
#       minlevel => 0,
#       maxlevel => 7,
#       %$config,
    ));
</pre>

More packages:
<pre>
    perl -MCPAN -e "install Catalyst::Engine::HTTP"
    perl -MCPAN -e "install BZ::Client"
    perl -MCPAN -e "install SOAP::Lite"
    perl -MCPAN -e "install Catalyst::View::JSON"
    perl -MCPAN -e "install Text::CSV_XS"
    perl -MCPAN -e "install XML::Simple"
    perl -MCPAN -e "install Catalyst::Action"
    perl -MCPAN -e "install Class::C3::Adopt::NEXT"
    perl -MCPAN -e "install Catalyst::Action::RenderView"
</pre>

* Check out the repository
** hg clone http://hg.mozilla.org/webtools/bzapi bzapi 

* Apply the necessary [https://wiki.mozilla.org/Bugzilla:REST_API#Patches patches]

* Create a config file <bzapi_home>/bugzilla_api.conf. Make sure you edit the <URL_TO_BUGZILLA> 
<pre>
# Configuration file for Bugzilla HTTP API.
# Edit the configuration parameters in here and then copy it to be called
# "bugzilla_api.conf".

# URL of Bugzilla to proxy. Must include trailing slash.
# Make sure you get the protocol right; we don't currently handle the 301 
# redirects Bugzilla uses to switch to HTTPS.
bugzilla_url http://<URL_TO_BUGZILLA>

# Version of Bugzilla (major and minor only please, e.g. "3.4")
bugzilla_version 3.4.4

# Timezone in which the Bugzilla server is situated
# Please use a name from this list: 
# http://en.wikipedia.org/wiki/List_of_zoneinfo_time_zones
bugzilla_timezone America/Los_Angeles

# You may change the name of the file you want to log to
<Log::Handler>
  filename /var/log/bzapi.log
  fileopen 0
  mode     append
  newline  1
</Log::Handler>

# Whether to log back-end XML-RPC calls made via the BZ::Client library
log_xmlrpc 0

###############################################################################
# Don't change anything below this line.
###############################################################################
name Bugzilla::API

</pre>

* Try starting the server to make sure there are no errors. You can kill it if it starts successfully.
** perl -w <bzapi_home>/script/bugzilla_api_server.pl

* I added the following to my apache virtual host config file:
<pre>
        <Directory <bzapi_home>
                AddHandler cgi-script .cgi
                Options Indexes ExecCGI FollowSymLinks
                DirectoryIndex index.cgi
                AllowOverride Limit
        </Directory>
        FastCgiServer <bzapi_home>/script/bugzilla_api_fastcgi.pl -processes 3 -idle-timeout 180
        Alias /bzapi <bzapi_home>/script/bugzilla_api_fastcgi.pl/
</pre>

==Notes==
* [https://wiki.mozilla.org/Bugzilla:REST_API Documentation]
* [https://wiki.mozilla.org/Bugzilla:REST_API#Your_Own_Installation Installation instructions]