Share via

Viewing Synchronization Engine Error Messages

  • Article

To help troubleshoot the integration of Visual Studio Team Foundation Server 2010 and Microsoft Project Server 2007 with Service Pack 2 (SP2) or Project Server 2010, you can display a list of recent synchronization errors. You can display the most recent errors that were logged for a team project collection by using the /GetSyncMessages option of the TFSAdmin ProjectServer command-line tool.

Note

For information about the synchronization process, see Overview of Team Foundation Server and Project Server Integration Features.

To use this tool, you open a Command Prompt window on a computer that is running Team Explorer and Service Pack 1 for Visual Studio 2010. You then run the tool from the following directory: Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE. For 64-bit machines, the tool is in Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Required Permissions

To use this command, your Administer Project Server integration permission must be set to Allow for the team project collection. 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 Assigning Permissions to Support Integration of Project Server and Team Foundation Server.

Note

Even if you log on with administrative permissions, you must open an elevated Command Prompt window to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt window, click Start, right-click Command Prompt, and then click Run as Administrator. For more information, see the following page on the Microsoft website: User Access Control.

Syntax

TfsAdmin ProjectServer /GetSyncMessages /collection:tpcUrl

Parameters

Parameter

Description

/collection: tpcUrl

Specifies the uniform resource locator (URL) of a team project collection. You specify the URI in the following format:

http://ServerName:Port/VirtualDirectoryName/CollectionName

If you do not specify a virtual directory, you specify the URI in the following format:

http://ServerName:Port/CollectionName

/? or help

Displays information about the command.

Back to top

Return Value

The /GetSyncMessages option displays a tab-delimited set of messages with their column headers. The following information appears for each message:

  • Date: Date when the message was logged.

  • Team Project Collection Name\Team Project Name: Names of the team project collection and the team project.

  • Project Name: Name of the enterprise project plan.

  • Message: Content of the message.

These messages are extracted from the synchronization job log. The /GetSyncMessages option truncates the messages that are much longer than average. When this truncation occurs, the following message appears:

There are additional errors that have been truncated from the log. These errors can be viewed in the event log for the application-tier server(s).

You can view the complete message by opening the event log for the corresponding application-tier server.

Back to top

Example

The following example retrieves the error messages that have been logged for Collection0, which is defined on the MyTFSServer application-tier server.

TfsAdmin ProjectServer /GetSyncMessages /collection:http://MyTFSServer:8080/tfs/Collection0

Tip

You can use standard command-line syntax to send the output to a file. For example, you can specify >c:\output.txt.

See Also

Concepts

Overview of Team Foundation Server and Project Server Integration Features

Managing Project Server Integration with TFSAdmin ProjectServer

Other Resources

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

Change History

Date

History

Reason

June 2011

Corrected information about the log from which the synchronization messages are extracted.

Content bug fix.