In this post I will describe how to install the free and powerful IT / development management tool The Bug Genie on Hyper-V 2008 R2 VM (or similar hypervisors) with guest OS Ubuntu 12.04 LTS and LDAP / Active Directory authentification.
First, create a new virtual machine in the environment of your choice, e.g. with a 50 GB HDD. In Hyper-V, you can leave all settings by default.
Download Ubuntu (Server Edition recommended).
Install Ubuntu on your new VM (“insert” the .iso File in the virtual drive, power on the VM and follow the setup instructions). Choose OpenSSH server to be enabled.
Log in (locally or remote).
Run “sudo -s” and enter your root password.
apt-get install php5
apt-get install phpmyadmin
apt-get install postfix
Note the password which you chose for phpMyAdmin and the root DB user.
Look for the TBG zip file download path.
(You can also download the file via your browser and then transfer it to your VM via WinSCP etc.)
Make sure index.php is now under /var/www/thebuggenie. If you got another subfolder “thebuggenie”, move the files 1 directory upwards.
chown -R www-data /var/www
Open http://[name_or_IP_of_your_VM]/phpmyadmin, log in with root credentials. Create a new database, e.g. “tbg” and a user, set a password and full permissions to your new DB.
Open http://[name_or_IP_of_your_VM/thebuggenie and fill in the DB data fields etc. The setup process is quite simple.
Even if the TBG setup does not show any errors, you might want mod_rewrite to be enabled:
Then we have to modify the default apache settings:
Set every “AllowOverride” line to “All”, then restart Apache:
service apache2 restart
Bugfix for IE and TBG version 188.8.131.52: Open /var/www/core/templates/layout.php and add the following line, e.g. at line 8:
<meta http-equiv=”X-UA-Compatible” content=”IE=9″>
Now you can open the Web GUI of The Bug Genie and everything should work.
LDAP / AD integration
Open your TBG web interface with Admin credentials. Go to the configuration area -> Modules -> Install new modules. You should find the LDAP module there and enable and configure it. The screenshot shows the common settings for Active Directory.
Make sure you have your AD Domain Administrator credentials! You have to log in now with these credentials into TBG to have admin permissions.