Installing Agilo - Agile plugin over Trac

[If you are looking for instructions on installing Agilo over Trac, click here to skip to the instructions directly]

Finally a post on my current work in my new organization. :-) Its been running really busy with lot of things going on in parallel; but i must admit it, it feels lively after a long long time here and that's one reason you find me posting this entry at 2:30 past midnight (no.. i'm not working on project related stuff, but i find my enthusiasm back on finding new stuffs that can help my team and the organization perform better).

We, the newly formed engineering team here have decided to follow agile and scrum based processes in all our projects and the organization as whole. We recently installed Trac (a fantastic python based open source tool on one of our servers), but this provided very minimal UI for wiki, source code browsing, ticketing system and milestones tracking and had missing features like user management, ticket hours management, scrum features like (product backlogs, sprint based management and progress tracking). So we explored more and came across this nice plugin over Trac - called Agilo. Agilo is open source and provides some pro features in a licensed version with support. Well what we were looking for was pretty much available in the open source version so we went ahead with the same.

1. First install setuptools for python by running
   

   wget http://peak.telecommunity.com/dist/ez_setup.py

   
   

   python ez_setup.py



2. Install Trac. (need help? read here or here)


3. Install simplejson by issuing

   easy_install simplejson



4. At this step, its assumed that your trac is up and running :-) Download Agilo source code from here (you need to be logged in to download this) and untar it using
   

   tar xzvf agilo-source-latest.tar.gz

   
   Go to the source folder and issue
   

   easy_install [source-untarred-folder]



5. At this step, you need to enable this for your projects. Assuming that you've a project installed in /var/trac/project1, you need to add the following to your /var/trac/project1/conf/trac.ini
   

   
   [components]
   agilo.* = enabled
   agilo_common.* = enabled 
   

   
   


6. Do an upgrade on the project by issuing:
   

   
   trac-admin /var/trac/project1 upgrade 
   

   
   which should output something like below:
   

   
   Creating Product Backlog...
   Creating Sprint Backlog...
   Upgrade done. 
   

   
   This means your project has been upgraded to use Agilo on Trac. Restart your trac instance.


7. I wasn't successful in my first attempt because my simplejson installation wasn't proper for some reason, so i did a
   

   locate simplejson

   
   removed the simplejson egg and then did
   

   easy_install simplejson

   
   again. For me, the path of simplejson to be removed, was /usr/lib/python2.4/site-packages/simplejson-2.0.9-py2.4-linux-x86_64.egg

It was very satisfying to see the Agilo UI over Trac. We've already created a/cs for the entire organization (engineering, product management, analytics and support functions) and our CEO, CTO also have an a/c on the system. Everybody is excited about the new system :-)

[PS: if you still have problem, do post your issue here.]