Error is thrown when trying to connect to endpoint of type TFS 2015 from ALM Synchronizer

Document ID:KM02568091
Creation Date:29-Sep-2016
Modified Date:30-Sep-2016

Summary

An error is returned when creating/connectiong to TFS2015 type endpoint in ALM Synchronizer.

Error

The below error message is returned when trying to connect or add an endpoint of type Microsoft Team Fondation Server (TFS) 2015 from Application Lifecycle Management (ALM) synchronizer:

ERROR #1- adapter.CONNECTION_FAILURE : Failed to connect to endpoint of type TFS. Error: com.mercury.qc.gossip.exp.GossipServerException: server.RemoteExecService.UNHANDLED_EXCEPTION : Unknown exception type is caught: com.hp.qc.synchronizer.adapters.exceptions.FatalAdapterException: connect: disconnected Could not load file or assembly 'Microsoft.TeamFoundation.Client, Version=14.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. The system cannot find the file specified...

ERROR #2- server.RemoteExecService.UNHANDLED_EXCEPTION : Unknown exception type is caught: com.hp.qc.synchronizer.adapters.exceptions.FatalAdapterException: connect: disconnected Could not load file or assembly 'Microsoft.TeamFoundation.Client, Version=14.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. The system cannot find the file specified..

Due to the error the connection to the TFS endpoint is not possible and the creation of an ALM Synchronizer link will fail.

Cause

General prerequisite for working with TFS 2015 require copying of assembly files from TFS machine to ALM Syncronizer Server and registring them:

Prerequisite for TFS 2015: Install .NET Framework 4.5.
Before registering the TFS assembly file in the next step, perform the following:
o Navigate to C:\Program Files\Common Files\Microsoft Shared\Team Foundation
Server\14.0 on the machine where TFS 2015 is installed.
o Copy all files to C:\Program Files\HP\HP ALM Synchronizer\ adapters\net2015 on the
machine on which HP ALM Synchronizer server is installed.

Since TFS 2015 the assembly files are not under the specified location (C:\Program Files\Common Files\Microsoft Shared\Team Foundation Server\14.0).

Fix

Download TFS2015.ZIP , unzip the files and copy them under the specified location - C:\Program Files\HP\HP ALM Synchronizer\adapters\net2015 then perform the registration as per HP ALM Synchronizer Installation Guide.