How to: Rename an Application-Tier Server

  • Article

If it is necessary, you can rename your Team Foundation application-tier server. To do so, you must rename the computer itself, and perform several other steps to reconfigure Team Foundation Server, Reporting Services, and Windows SharePoint Services.

For single-server configurations, follow the procedures to rename a data-tier server in How to: Rename a Data-Tier Server.

Required Permissions

To perform this procedure, you must be a member of the Administrators group on the Team Foundation application-tier server. For more information about permissions, see Team Foundation Server Permissions.

To stop the services used by Team Foundation Server

  1. Click Start, click All Programs, click Microsoft SQL Server 2005, click Configuration Tools, and then click Reporting Services Configuration.

    The Reporting Services Configuration window opens, and the Report Server Installation Instance Selection dialog box opens.

  2. Make sure that the information in Machine Name and Instance Name are correct and then click Connect to connect to the server. Close the Report Server Installation Instance dialog box.

  3. Select Server Status and then click Stop.

  4. Click Exit to close the Reporting Services Configuration window.

  5. Click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.

    The Internet Information Services (IIS) Manager window opens.

  6. Expand the Team Foundation application-tier computer node and then expand the Web Sites node.

  7. Select the Default Web Site, and then click Stop.

  8. Expand the Team Foundation application-tier computer node, and then expand the Application Pools node.

  9. Select the ReportServer application pool, and then click Stop.

  10. Select the TFS AppPool application pool, and then click Stop.

  11. Click Exit to close the Internet Information Services (IIS) Manager window.

  12. On the File menu, click Exit to close the Internet Information Services (IIS) Manager window.

  13. On the Team Foundation application-tier server, click Start, click Administrative Tools, and then click Services.

    The Services window opens.

  14. Select the SharePoint Timer Service service, and then click Stop.

  15. Select the TfsServerScheduler service, and then click Stop.

  16. On the File menu, click Exit to close the Services Manager window.

To rename the computer

  1. Click Start, right-click My Computer, and then click Properties.

    The System Properties window opens.

  2. In the Computer Name tab, click Change.

    The Computer Name Changes window opens.

  3. In the Computer Name box, type the new computer name, and then click OK.

  4. Click Exit to close the System Properties window.

To update Team Foundation Server to use the new application-tier server name

  1. Click Start, click All Programs, click Accessories, and then click Command Prompt.

    The Command Prompt window opens.

  2. Open the Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Web Services folder by using the command line. For example:

    cd C:\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Web Services

  3. Open web.config in any plain-text editor, such as Notepad. For example:

    notepad web.config

  4. In the add key elements that define TfsNameURL and TFS Name, replace the old server name with the new server name, as shown in the following example.

    <!-- TFS name and Url information -->
<add key="TFSNameUrl" value="https://newServerName:8080" />
<add key="TFS Name" value="newServerName "/>

  5. On the File menu, click Save, and then close the plain-text editor.

  6. Open the Program Files\Microsoft Visual Studio 2005 Team Foundation Server\TfsServerScheduler folder by using the command line. For example:

    cd C:\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\TfsServerScheduler

  7. Open TfsServerScheduler.exe.config in any plain-text editor, such as Notepad. For example:

    notepad TfsServerScheduler.exe.config

  8. In the add key element that defines TfsDomainUrl, replace the old server name with the new server name. For example:

    <add key="TfsNameUrl" value="https://newServerName:8080" />

    Note

    The key name may be BisDomainURL instead of TfsNameURL. If so, change the key name to TfsNameURL.

  9. On the File menu, click Save, and then close the plain-text editor.

  10. Open a Command Prompt window and change directories to the drive**:\%ProgramFiles%\Microsoft Visual Studio 2005 Team Foundation Server\CoverAn** directory.

  11. Open the CoverAn.exe.config in any plain-text editor, such as Notepad.

  12. Replace the old server name with the new server name in the add key element that defines TfsNameUrl. For example:

    <add key="TfsNameUrl" value="https://newServerName:8080" />

  13. On the File menu, click Save.

  14. On the File menu, click Exit to close the plain-text editor.

  15. Open the Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Tools folder by using the command line. For example:

    cd C:\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Tools

  16. If the Team Foundation application-tier server is also the data-tier server, run the TFSAdminUtil tool with the RenameDT option to connect to the data tier. For example:

    TFSAdminUtil RenameDT newservername

  17. Run the TFSAdminUtil tool with the ActivateAT option to activate the Team Foundation application-tier server. For example:

    TFSAdminUtil ActivateAT

    Note

    There will be a warning that indicates that the data-tier server is bound to the old application-tier server name. When you are prompted whether to continue, press Y to continue.

  18. Close the Command Prompt window.

    Warning

    Client users must connect to the newly renamed application-tier server if they were previously using the application-tier server under its old name. If client users were connected to the application-tier server when the renaming procedure was performed, they may have to update their Team Foundation Server caches and run the devenv /resetuserdata command, or wait two hours before reconnecting.

To start and configure Reporting Services

  1. Click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.

    The Internet Information Services (IIS) Manager window opens.

  2. Expand the Team Foundation application-tier computer node, and then expand the Application Pools node.

  3. Select the ReportServer application pool and then click Start.

  4. Expand the Web Sites node, select Default Web Site, and then click Start.

  5. Click Exit to close the Internet Information Services (IIS) Manager window.

  6. Click Start, click All Programs, click Microsoft SQL Server 2005, click Configuration Tools, and then click Reporting Services Configuration.

    The Reporting Services Configuration Manager window opens, and the Report Server Installation Instance Selection dialog box opens.

  7. Make sure that the Machine Name and Instance Name are correct, click Connect to connect to the server, and then close the Report Server Installation Instance dialog box.

  8. In Reporting Services Configuration, select Server Status, and then click Start.

  9. Click Exit to close the Reporting Services Configuration window.

  10. Open a browser window, and then type https://newSerOverName/reports in the address bar.

  11. On the SQL Server Reporting Services home page, click TfsOlapReportDS.

    1. Verify that the correct connection information appears in Connection String.

      The string should include the name of the data-tier server and the initial catalog should be TfsWarehouse.

      Data source= DataTierServerName ;initial catalog=TfsWarehouse

    2. Select Credential stored securely in the report server.

    3. Enter the account name (including domain if applicable) and password for services account specified for the Reporting Services service account (referred to as TFSReports).

      Note

      If you do not know which service account you need, use SQL Server Management Studio to check which account belongs to the TfsWarehouseDataReader role in the TfsWarehouse database.

    4. Select Use as windows credentials when connecting to the data source, and then click Apply.

    5. Click Home in the upper-left corner to return to the SQL Server Reporting Services home page.

  12. On the SQL Server Reporting Services home page, click TfsReportDS.

    1. Make sure Connection String contains the new name for the data-tier server.

      Data source= DataTierServerName**;initial catalog=TfsWarehouse**

    2. Select Credential stored securely in the report server.

    3. Enter the account name (including domain if applicable) and password for the Reporting Services service account (referred to as TFSReports).

    4. Select Use as windows credentials when connecting to the data source, and then click Apply.

  13. On the File menu, click Close to close the browser.

To start the remaining services used by Team Foundation Server

  1. Click Start, click Administrative Tools, and then click Services.

    The Services window opens.

  2. Select the SharePoint Timer Service service, and then click Start.

  3. Select the TfsServerScheduler service and then click Start.

  4. On the File menu, click Exit to close the Services window.

  5. Click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.

    The Internet Information Services (IIS) Manager window opens.

  6. Expand the Team Foundation application-tier server node and then expand the Application Pools node.

  7. Select the TFS AppPool application pool, and then click Start.

  8. On the File menu, click Exit to close the Internet Information Services (IIS) Manager window.

See Also

Tasks

How to: Rename a Data-Tier Server

Concepts

Managing Team Foundation Server Application-Tier Servers

Other Resources

TFSAdminUtil Command-Line Commands