How to manually upgrade TFS project Template after upgrading from TFS 2010 to TFS 2015

This topic applies only to team projects hosted on an on-premises Team Foundation Server (TFS).

When the Configure Features wizard can't update your team project, it's because your team project was created from a process template other than those TFS provides, or you've customized your team project in ways that conflict with its ability to apply the updates. You may receive a message like below on clicking on Backlog, Task board work items through TFS web access.

"This feature cannot be used until you configure it for this team project."

After a TFS upgrade, you’ll want to use the new features that were installed. Some of these features might require updates to your team project. The Configure Features wizard is the easiest way to make this happen.

Run the Configure Features wizard

1. From the web portal home page, open the administration context.

If you're not a team project administrator, get added, only project administrators or TFS administrators can run the wizard.

2. If you see a Configure Features link, run the wizard.

Note: If Portfolio Backlogs shows as not configured, then the wizard will add the Feature and Epic WIT and categories to the team project and modify the process configuration to support portfolio backlogs. However, if it shows as previously configured (will be skipped), the wizard won't add the Epic WIT and portfolio backlog. To add he Epic portfolio backlog, you'll need to add it manually

The features listed depend on the TFS version of software installed. To get the latest features, upgrade your server to the latest version.

If Test Plan and Test Suite are not configured, you'll need to manually import the WIT definition and migrate data

If you don't see the Configure Features link, you can start using the new features as they're already enabled.

3. If you receive a message similar to the one shown below, you can configure your team project. If more than one process template is available, accept the recommended version.

If the dialog box doesn't contain a Configure option, then you’ll need to apply manually

4. In most cases, the wizard will configure all the new features and you'll receive a success message.

Occasionally, the wizard will partially update your team project and return error messages that require resolution. Make a note of the errors that you receive and perform manual updates to resolve each error

Apply updates manually

When the wizard can't update a team project, it returns a message indicating that there are no process templates available to support the update.

When this occurs, you’ll need to perform some manual updates according to one of the following options:

If your team project is based on a process template other than those that TFS provides, update the customized process template used to create the team project, and then run the Configure Features wizard. TFS process templates correspond to Scrum, Agile, and CMMI as described here.

Get the latest version of the most compatible process template

The quickest way to make many of these updates is to copy definition files from the latest process template and import them to your team project.

1. Open the same version of Visual Studio or Team Explorer as the on-premises TFS that you connect to. For example, if you connect to a TFS 2015 instance, you must connect from Visual Studio 2015 or Team Explorer 2015.

You can always download a free version of Team Explorer from the Visual Studio download site.

If you aren’t a member of the Project Collection Administrators group, get added as one.

2. Open the Process Template Manager from the Team, Team Project Collection Settings menu.

You’ll see a list of each process template that has been uploaded to the team project collection.

The Upload, Download, Make Default, and Delete buttons are disabled when you don’t have the necessary permissions to manage process templates.

3. Download the process template to a local computer, select a folder where the process template will be downloaded.

Choose the process that corresponds to the one you used previously to create your team project. For example, if you're updating a team project based on the Scrum process template, then select Scrum. Note that all version numbers have been removed from the process templates. If you don't see Agile, CMMI, or Scrum, then you need to update TFS.You can determine which process template to select based on the work item types defined for your existing team project.

Use TFS Team Project Manager to import WITs

Download Team project manager from the following site. And run team project manager on the Visual Studio 2015 machine. https://teamprojectmanager.codeplex.com/

Open Team Project Manager, add the project for which you need to update the process template. Click on the “add “on the left panel under “team projects”.

· In the middle panel of the Team Project manager Click on “work item configuration” then click on “work item types”.

· Then click on “add” button and browse to the folder of the latest scrum template that you downloaded earlier.

· Browse to pathà Scrum\WorkItem Tracking\TypeDefinitions. Here you will find all work item types. Select them all and click on “import” button to import them into the select project.

That’s all now. Again go the web portal home page, open the administration context.

1. If you're not a team project administrator, get added, only project administrators or TFS administrators can run the wizard.

2. If you see a Configure Features link, run the wizard.

3. If you receive a message similar to the one shown below, you can configure your team project. If more than one process template is available, accept the recommended version.