Agilo: a SCRUM tool # agile #scrum

After reading Scrum and XP from the Trenches I was interested in tools to help me implement SCRUM into my projects. Firstly I looked at what the author recommended. In a blog article he advised visiting userStories for inspiration. This in turn led me to Agilo. I downloaded the appliance and tried it out.

At first I was happy, it was an integration of Trac, which I know quite well as a developer, although not as an admin. Which lead me to the first issue, documentation… In projects documentation is one of the easiest things do do wrong, once such case is to not Test the documentation. This is a SCRUM requirement for the software and should also be for the documentation. Luckily I was experience enough with Trac and Apache that I could quickly discover what the issue was.

This is what I needed to do, in the form of a simple script, to add a new project:

#!/bin/sh

PROJECT=$1

cd /var/lib/trac/

# Make Trac
sudo trac-admin $((PROJECT)) initenv
sudo trac-admin /var/lib/trac/$((PROJECT))/ upgrade
sudo trac-admin /var/lib/trac/$((PROJECT)) permission add admin TRAC_ADMIN
sudo chown -R www-data:www-data $((PROJECT))

# Deploy FCGI
sudo trac-admin deploy /tmp/deploy
sudo mv /tmp/deploy/* /var/lib/trac/crypto-disk/
sudo rm -rf /tmp/deploy

# Make SVN
sudo mkdir /var/lib/svn/$((PROJECT))
sudo chmod -R www-data:www-data /var/lib/svn/$((PROJECT))/
svnadmin create /var/lib/svn/$((PROJECT))/
sudo chown -R www-data:www-data /var/lib/svn/$((PROJECT))/

cat <<EOF
        <LocationMatch /$((PROJECT))/login>
                AuthType Basic
                AuthName "Agilo for Scrum"
                AuthUserFile /var/lib/trac/users.passwd
                Require valid-user
        </LocationMatch>
        <Location /$((PROJECT))/svn>
                DAV svn
                SVNPath /var/lib/svn/$((PROJECT))
                AuthType Basic
                AuthName "Subversion Repository"
                AuthUserFile /var/lib/trac/users.passwd
                AuthzSVNAccessFile /var/lib/svn/$((PROJECT))/conf/authz
                Require valid-user
        </Location>
EOF

This last piece of data needs to be inserted into the /etc/apache2/sites-enabled/000-default/, or what ever the default Apache config file is for your Agilo site is for your installation. And then restart Apache