Installing FogBugz the Debian way

Yeah, proprietary software is bad, but let's at least install it the Debian way. The following walkthrough assumes Debian lenny.

• Install some prerequisites:

  $ sudo apt-get install mysql-server-5.0 apache2-mpm-prefork libapache2-mod-php5 php5-mysql php5-curl php-pear mono-gmcs php5-imap curl dh-make-php dpkg-dev fakeroot build-essential cdbs php-http-request php-mail php-net-smtp php-db php-auth php-mail-mimedecode
  

• Download and extract FogBugz:

  $ cp ~/Downloads/fogbugz-setup-php-6.1.44.tar.gz .
  $ tar xvfz fogbugz-setup-php-6.1.44.tar.gz
  $ cd fogbugz
  

• If you do not wish to install FogBugz to /opt/fogbugz, modify INSTALL_DIR at the top of install.sh to point to your intended target (e.g. /srv/bugs.example.com).

• Create Debian packages of the missing PEAR libraries. For some reason, the php-mail-mime package in lenny is not recognised by FogBugz's install.sh, so we create a replacement.

#!/bin/sh
set -e
for PEAR_PKG in Auth_SASL HTTP_Client Mail_Mime XML_Tree
do
        PKG_TEMP=$(mktemp -d)
        cd ${PKG_TEMP}
        pear download ${PEAR_PKG}
        dh-make-pear ${PEAR_PKG}*.tgz
        cd */
        dpkg-buildpackage -uc -us -rfakeroot
        sudo dpkg -i ../*.deb
        rm -rf ${PKG_TEMP}
done

• Run ./install.sh. You should see something like:

$ sudo ./install.sh
/***************************************\
*            FogBugz 6 Setup
\***************************************/

--    Checking for required tools
 +      found mono 1.9.1
[..]

• FogBugz will offer to mangle your Apache configuration. Choose no and run the following, replacing /srv/bugs.example.com where appropriate:

  $ sudo ln -s /srv/bugs.example.com/Accessories/fogbugz.conf /etc/apache2/sites-available/fogbugz
  $ sudo a2ensite fogbugz
  

• FogBugz will then offer to mangle your PHP configuration. Choose yes; but move the last handful of lines from (e.g. /etc/php5/apache2) into /etc/conf.d/fogbugz.ini.

• After restarting Apache, you should be able to visit http://bugs.example.com/fogbugz/install1.php to continue installation.

• On first run, FogBugz will "warn" about the lack of missing eAccelerator, a PHP JIT. Unfortunately, whilst eAccelerator is "open-source", useful distribution of it is illegal. Alternatives available in lenny would include php-apc and php-xcache, but I found eAccelerator to be more effective.

You can subscribe to new posts via email or RSS.