TFS 2010: Rename a server – Part 6: the TeamFoundation Server server

TFS 2010: Rename a server – Part 6: the TeamFoundation Server server

Posts in this series:

In this fifth post we will see what to do to rename the TeamFoundation Server server tfs.demo.local to tfs1.demo.local and make our service work again :)

TeamFoundation Server

First you need to rename the server :)

We can then reconfigure the Application Tier using the administration console:

  1. Start the admin console.
  2. Select the Application Tier node and click the Change URLs link:
    01 - Change URLs
  3. In the dialog window, update the Notification URL field with the new TFS server address:
    02 - Change URLs
  4. Click the OK button.

If you prefer to use command line tools, you can use the TfsConfig:

  1. Open a command prompt.
  2. Run the following command to update the notification url in TFS:
    "%programfiles%\Microsoft Team Foundation Server 2010\Tools\tfsconfig" settings /notificationurl:http://tfs1:8080/tfs

That’s it for the Application Tier part. We must now reconnect the TFS Sharepoint extensions.


On the Sharepoint server we will reconfigure the TFS extensions for Sharepoint by using the TFS administration console:

  1. Start the admin console.
  2. Select the Extensions for Sharepoint Products node and click the Modify access link:
    03 - Modify Extensions for Sharepoint
  3. In the dialog window, update the URL for Team Foundation Server field with the new address:
    04 - Modify Extensions for Sharepoint
  4. Click OK.

That’s all for Sharepoint but now you must update it’s content.

Office Documents

If you have Excel or Project files in your Sharepoint document library that use the Team Explorer add-in to connect to TFS, you will need to update those files. Here is what to do for all your Team Projects using the Agile process template:

  1. Open the Product Planning document for editing:
    05 - Update Excel Workbooks
  2. In the Team tab, click on Configure and select Server Connection :
    06 - Update Excel Workbooks
  3. In the dialog window, click on Servers to add the server using it’s new URL.
  4. When the connection is create, select the server and the correct Team Project :
    08 - Update Excel Workbooks
  5. Click on Connect.
  6. Redo steps 2 to 4 for every document. (yes this can be long… :))

Your documents are now reconnected. Note that you must also update the Visual Studio connection but i think everyone knows how to do this :)


The last component to update is the build service. For this we must use the TFS admin console:

  1. On the build server, start the admin console.
  2. Select the Build Configuration node and click the Properties link:
    10 - BuildService
  3. In the dialog window, if the service is started you must first stop it using the stop to make changes link:
    11 - BuildService
  4. You can now update the Connect to Team Project Collection (outgoing) field with the new url:
    12 - BuildService
  5. Click Start to restart the build service.
If you do not want to use the admin console, there is no command line but you can make the update directly in the registry:
  1. Open the registry editor (regedit).
  2. Go to HKLM\SOFTWARE\Microsoft\VisualStudio\10.0\TeamFoundation\Build\ServiceHost.
  3. Update the ApplicationServerUrl value with the new URL.
  4. Restart the build service.

Your installion is back online using the new TFS server name. LNext time will rename the TeamBuild server.

Carpe Diem.

Leave a Reply