Trac-Agile plugin: Agilo

Note the added depth to the process hierarchy by the addition of the Agile Sprint and Agile Story.

Agilo also supports Agile story points, burn down charts, etc. For more information see the Agilo for Trac web site

[Potential Pitfall]: Agilo renames some Trac databse schema items thus breaking many of Trac's plug-ins like trac-mastertickets-plugin and trac-peerreview-plugin.

• Trac-Subversion
  or
• Trac-Git

• python-setuptools

• Download Agilo: http://www.agilofortrac.com/en/download/licensed/binary_agilo-PRO-py2.6.egg.zip
• Unzip: unzip binary_agilo-PRO-py2.6.egg.zip
  This results in file: binary_agilo-1.3.6.2_PRO-py2.6.egg
• Install: /usr/bin/easy_install --record agilo-log.txt binary_agilo-1.3.6.2_PRO-py2.6.egg

• rm /usr/bin/agilo_svn_hook_commit.py
• rm /usr/bin/create_agilo_project.py
• rm -Rf /usr/lib/python2.6/site-packages/binary_agilo-1.3.6.2_PRO-py2.6.egg/

• Download agilo_source.tar.gz
• Unpack: tar xzf agilo_source.tar.gz
• cd agilo-0.9.6.2/
• Install: python setup.py install

• rm /usr/bin/agilo_svn_hook_commit.py
• rm /usr/bin/create_agilo_project.py
• rm /usr/bin/agilo_sqlite2pg.py
• rm -Rf /usr/lib/python2.6/site-packages/agilo-0.9.6.2-py2.6.egg/

• Add the following so that trac recognizes the new Agilo component:
  File: /srv/trac/projectx/conf/trac.ini

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

  Licesed versions have finer grained controls (commented out here)
• Update Trac with the new Agilo features and the exteded database schema:
  • trac-admin /srv/trac/projectx upgrade
  • trac-admin /srv/trac/projectx wiki upgrade

Error

TracError: The Trac Environment needs to be upgraded.

• Upgrade Trac with enhancements: trac-admin /srv/trac/projectx upgrade
• Allow web server access: chown -R apache.apache /srv/trac/projectx
• Restart web server: service httpd restart

The first time you access Trac after the Agilo plugin has been added, the response will be slow as the system has allot of first operation tasks including the upgrade of the configuration and population of default values. The Trac configuration file will also be updated to include:

[agilo-backlogs]
...

[agilo-links]
...

[agilo-types]
...

[ticket-custom]
...

[trac]
...
permission_policies = AgiloPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy

...

[inherit]
plugins_dir =
templates_dir = /usr/lib/python2.6/site-packages/binary_agilo-1.3.6.2_PRO-py2.6.egg/agilo/templates

...

The Trac permissions schema is extended. I use the following script to add project admin personel:

#!/bin/bash
# See https://dev.agile42.com/agilo-help/admin/Permissions
trac-admin /srv/trac/projectx permission add $1 TRAC_ADMIN
trac-admin /srv/trac/projectx permission add $1 AGILO_BACKLOG_VIEW
trac-admin /srv/trac/projectx permission add $1 AGILO_BACKLOG_EDIT
trac-admin /srv/trac/projectx permission add $1 AGILO_CONFIRM_COMMITMENT
trac-admin /srv/trac/projectx permission add $1 AGILO_CONTINGENT_ADD_TIME
trac-admin /srv/trac/projectx permission add $1 AGILO_CONTINGENT_ADMIN
trac-admin /srv/trac/projectx permission add $1 AGILO_CREATE_BUG
trac-admin /srv/trac/projectx permission add $1 AGILO_CREATE_REQUIREMENT
trac-admin /srv/trac/projectx permission add $1 AGILO_CREATE_STORY
trac-admin /srv/trac/projectx permission add $1 AGILO_CREATE_TASK
trac-admin /srv/trac/projectx permission add $1 AGILO_DASHBOARD_VIEW
trac-admin /srv/trac/projectx permission add $1 AGILO_LINK_EDIT
trac-admin /srv/trac/projectx permission add $1 AGILO_SAVE_REMAINING_TIME
trac-admin /srv/trac/projectx permission add $1 AGILO_SPRINT_ADMIN
trac-admin /srv/trac/projectx permission add $1 AGILO_SPRINT_EDIT
trac-admin /srv/trac/projectx permission add $1 AGILO_SPRINT_VIEW
trac-admin /srv/trac/projectx permission add $1 AGILO_TEAM_CAPACITY_EDIT
trac-admin /srv/trac/projectx permission add $1 AGILO_TEAM_VIEW
trac-admin /srv/trac/projectx permission add $1 AGILO_TICKET_EDIT
trac-admin /srv/trac/projectx permission add $1 AGILO_TICKET_EDIT_PAGE_ACCESS

Milestones are first generated on the "Roadmap" page. Each milestone has the button "Add new sprint".

Select Left column nav link "New User Story". Choose a sprint to link to when creating the story.
Select a story + Edit + Modify (to alter the story) + "Create a new referenced 'Task'" (will generate a task associated with the story)

Trac tickets can be associated later using Story + Edit + enter the Reference #tracnum of the Trac task to associate it with the story.

Programmer capacity: Programmers can allocate vacation time to show actual availability (capacity)

After Milestones, Sprints and Stories have been entered, the burndown chart can be plotted.

• New Requirements: http://localhost/trac/projectx/newticket?type=requirement
• New Task: http://localhost/trac/projectx/newticket?type=task
• New Story: http://localhost/trac/projectx/newticket?type=story
• New Bug: http://localhost/trac/projectx/newticket?type=bug
• Product Backlog: http://localhost/trac/projectx/backlog/Product%20Backlog

• Trac home page
• Agilo for Trac home page
• YoLinux.com Subversion and Trac tutorial - lots of Trac administration information. Hosting multiple Trac projects, etc.
• YoLinux.com Git and Trac tutorial - installation and configuration
• YoLinux.com Trac wiki markup
• YoLinux.com Jenkins tutorial - continuous integration

Books:

	Defect Tracking Tools Product Comparison Guide: Large Enterprise Edition TiPS-IT Ziff Davis Media Digital PDF Download
	Defect Tracking Tools Product Comparison Guide: Small / Mid Enterprise Edition TiPS-IT Ziff Davis Media Digital PDF Download

   

Advertisements