TFS 2017: TF255356 error during installation

I ran across an error recently during an in-place upgrade to Team Foundation Server 2017 from TFS 2015 Update 3.

During the upgrade, the Configure step would fail with the following detailed message:

TF255356: The following error occurred when configuring the Team Foundation databases: TF400711: Error occurred while executing servicing step ‘Install Inherited Service Definitions’ for component InstallInheritedDefinitionsOnPrem during StartInstallHostUpdates: TF246054: A service definition has already been registered with the specified service type and identifier. Service type: (null). Identifier: (null).. For more information, see the configuration log.

Digging into the install.log, a few other errors caught my attention:

[Info @23:56:32.065] Executing step: ‘Install Inherited Service Definitions’ Location.InstallInheritedDefinitions (239 of 842)
[Error @23:56:32.724] TF246054: A service definition has already been registered with the specified service type and identifier. Service type: (null). Identifier: (null).
[Info @23:56:32.725] Microsoft.TeamFoundation.Framework.Server.InvalidServiceDefinitionException: TF246054: A service definition has already been registered with the specified service type and identifier. Service type: (null). Identifier: (null).

Exception Message: TF400711: Error occurred while executing servicing step ‘Install Inherited Service Definitions’ for component InstallInheritedDefinitionsOnPrem during StartInstallHostUpdates: TF246054: A service definition has already been registered with the specified service type and identifier. Service type: (null). Identifier: (null). (type TeamFoundationServicingException)

To resolve this issue, back up your TFS database and try the following:

  • Connect to your TFS Configuration database
  • Run: SELECT * from tbl_ToolType
  • If you see two “WorkItemTracking” entries in the Type field, rename one (we only want one WorkItemTracking in the list)
    • UPDATE tbl_ToolType
      SET Type = ‘WorkItemTracking2’
      WHERE Id = 2

 

This has been identified as a bug, so hopefully we’ll see a fix in an upcoming TFS update!

1 thought on “TFS 2017: TF255356 error during installation”

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.