Update an Existing Installation and Version Compatibility

  • Article

You should follow the guidelines in this topic when you update an existing deployment to Visual Studio Team Foundation Server 2012. Updating a deployment requires upgrading the instances of Team Foundation Server, Microsoft Project Server, and Visual Studio clients.

For administration purposes, you should upgrade the Visual Studio clients that you use for administration to the same software version as that running Team Foundation Server and Project Server. While clients running Visual Studio 2008 or Visual Studio 2010 are compatible with the updated deployment for the purposes of data synchronization, clients that will run the TFSAdmin ProjectServer commands must be at the same version level.

To locate the most recent version of the software for integrating Team Foundation Server and Project Server, see System and Setup Requirements to Support Integration of Team Foundation Server and Project Server.

In this topic

  • Recommended update sequence

  • Changes introduced in the latest version of Visual Studio and TFS Extensions for Project Server

Note

To ask a question of the community, see the following forum on the Microsoft website: Team Foundation Server and Project Server Integration.

Required Permissions

To perform the procedures in this topic, your Administer Project Server integration permission for the team project collection must be set to Allow. Also, the service account for Team Foundation Server must be granted the necessary permissions to interact with the instance of Project Web Access or Project Web App (PWA) that will participate in data synchronization. For more information, see Assign Permissions to Support Integration of Project Server and Team Foundation Server.

To update an existing deployment to the latest version of Visual Studio Team Foundation Server, perform the following actions.

Note

You do not need to unmap or unregister any mapped or registered components prior to upgrading the software.

  • Upgrade Team Foundation Server according to the instructions provided in the Installation Guide: Upgrade Team Foundation Server.

    Important

    Upgrading to Visual Studio Team Foundation Server 2012 requires 64-bit machines. Also, to install Team Foundation Server Extensions for Project Server requires that Project Server is installed on 64-bit machines.

  • Uninstall the Team Foundation Server and Project Server Integration Feature Pack from Project Server.

  • Install the Team Foundation Server Extensions for Project Server according to the instructions provided in the Installation Guide: Install Team Foundation Server Extensions for Project Server.

    Install the extensions on each machine that will participate in data synchronization according to the following versions:

    • Each application-tier server that hosts Project Server 2007.

    • Each web-tier and application-tier server that hosts Project Server 2010.

  • Upgrade any clients that you will use to run TfsAdmin ProjectServer commands to Visual Studio 2012.

Back to top

Changes introduced in the latest version of Visual Studio and TFS Extensions for Project Server

Visual Studio Team Foundation Server 2012 and Team Foundation Server Extensions for Project Server introduce the following changes:

  • As part of upgrading an instance of Team Foundation Server or deploying a new installation based on Visual Studio Team Foundation Server 2012, a new transform is introduced in the mapping of fields between Team Foundation Server and Project Server. The new transform is applied to the Remaining Work and Completed Work fields. When the synchronization engine detects a hierarchy under a work item that is synchronized with Project Server, it performs a roll-up for the work and assignments to send to Project Server. However, with the transformType set to ClearValueIfParent, the synchronization engine clears the work fields on the parent work item to avoid incorrect data in reports. For more information, see Field Mapping XML Element Reference.

Back to top

See Also

Concepts

Administrate the Integration of Team Foundation Server and Project Server

Other Resources

Enable Data Flow Between Team Foundation Server and Microsoft Project Server