Verifying the Synchronization Process for Team Foundation Server and Project Server Integration

If you suspect that the data in Visual Studio Team Foundation Server 2010 and Project Server is not synchronizing as you expect, you can review the following checklist to verify or troubleshoot operations.

• Resolve post-installation and configuration issues. If you configure the two server products but synchronization does not start as you expect, you can review the following configuration elements:

  • Verify that all prerequisite software and cumulative updates have been installed. For more information, see Prerequisite Software.

  • (Project Server 2010 only) Verify that the SharePoint Configuration Wizard has been run after any cumulative updates have been installed. For more information, see Post-Installation Procedures to Support Integration with Project Server 2010.

  • Verify that all required permissions have been assigned. For more information, see Permissions Required to Configure Integration and Support Data Synchronization.

  • (Project Server 2007 only) Verify that the firewall is turned off.

• Verify the health of the synchronization engine: If synchronization had been performing as you expect before a problem occurred, you can perform the following procedures:

  • Check synchronization messages. By using the /GetSyncMessages option of the TFSAdmin ProjectServer command-line tool, you can display the errors that were logged most recently for a team project collection. For more information, see Viewing Synchronization Engine Error Messages.

  • Review how fields get updated. If you find that one or more fields are not being updated as you expect, review the information in Understanding How Updates to Specific Fields Are Managed. In particular, you may discover why a field is not being updated even though no synchronization messages are being logged. The data type of the field, the OnConflict attribute for mapping fields, and the task hierarchy affect how the synchronization engine updates specific fields.

  • Review the synchronization process. You can manage the integration of the two server products more effectively if you understand how the synchronization engine manages the flow of data between them. The engine synchronizes data in three ways. It captures and updates task-related and resource-related data in both server products while respecting the ownership of data by the project manager in the project plan. For more information, see Overview of the Synchronization Process for Team Foundation Server and Project Server Integration.

  • Check known issues and workarounds. If an error appears, you can determine whether you have encountered a known issue and whether a workaround has been identified. For more information, see Known Issues and Workarounds to Support Team Foundation Server and Project Server Integration.

  • Verify that the Team Foundation Background Job Agent is running. For more information, see View Team Foundation Server Services.

If you have reviewed these suggestions and you still suspect a problem, visit the following forum on the Microsoft website: Team Foundation Server and Project Server Integration.

See Also

Concepts

Administering the Integration of Team Foundation Server and Project Server

Other Resources

Known Issues and Workarounds to Support Team Foundation Server and Project Server Integration