After upgrading your TFS 2008 instance to TFS 2010, some features of SfTS version 2 projects will stop working. The SfTS v2 event service (that controls work remaining roll ups) and project reports are not compatible with the TFS 2010 infrastructure. Unfortunately, the reports cannot be saved, but it is possible to restore the event service functionality using a customised SfTS v3 event service solution. Here’s how to do it.
How to restore the SfTS v2 event service.
- Uninstall SfTS v2.
Note: Only relevant for severs that have had in-place TFS 2010 upgrades.
- Download the replacement Event Service source.
Download from: Services2008.zip
- Extract the services zip on to your TFS AT.
Unzip the contents of the “Services2008.zip” file to “c:\Program Files\ScrumforTeamSystem”.
- Create a new web application for the service.
Site: Team Foundation Server
Alias: ScrumforTeamSystem2008
Application Pool: Microsoft Team Foundation Server Application Pool
Physical Path: c:\Program Files\ScrumforTeamSystem\Services2008
- Create a new work item changed event subscription in TFS.
The “Services2008.zip” also contains a PowerShell script that creates the required work item changed event subscription. To execute the script:
- Launch an elevated command prompt on the TFS AT:
Press: [Windows Key]
Type: cmd
Press: [Ctrl] + [Shift] + [Return]
- (If required) Enable PowerShell script execution:
powershell set-executionpolicy remotesigned
- Execute the script:
powershell "c:\Program Files\ScrumforTeamSystem\Subscribe.ps1"
- When promoted, enter the team project collection name and press [Return]:
You should now have a working event service for your migrated SfTS version 2 project.
Creating new Version 2 projects in TFS 2010.
Another issue you may run into after a TFS2010 upgrade is that you can no-longer create new SfTS v2 projects. The project creation process fails at the report creation step:
Exception Message: The item '/TfsReportDS' cannot be found. (type ReportingServiceException)
To fix this issue, you should remove the report specifications from the process template definition.
- Use the Visual Studio Team Explorer panel to download the SfTS v2 process template.
Right click on the project collection name and select “Team Project Collection Settings \ Process Template Manager” from the context menu.
Download: Agile Software Development with Scrum - v2.2.14216.001
- Edit the report task configuration file as shown below.
File location: [Export Folder]\Agile Software Development with Scrum - v2.2.14216.001\Reports\reports.xml
<?xml version="1.0" encoding="utf-8"?>
<tasks>
<task id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created.">
<dependencies />
<taskXml>
<ReportingServices>
<site />
</ReportingServices>
</taskXml>
</task>
<task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project site created.">
<dependencies>
<dependency taskId="Site" />
</dependencies>
<taskXml>
<ReportingServices>
<!--
<reports>
... Excluded for clarity
</reports>
-->
</ReportingServices>
</taskXml>
</task>
</tasks>
- Finally, use the Process Template Manager to upload the altered template.
Select the downloaded template folder root and agree to overwrite the template.
You should now be able to create new SfTS v2 projects in your upgraded TFS 2010 environment.
Regards,
Crispin Parker,
Senior Practice Consultant,
EMC Consulting.