How to: Rename a Data-Tier Server

  • Article

You can rename your Team Foundation data-tier server. To do this, you must rename the computer itself and perform several other steps to reconfigure Team Foundation Server, Reporting Services, and Windows SharePoint Services.

Note

If you have configured Team Foundation Server Proxy for a single-server Team Foundation Server deployment, you must modify the proxy.config file by using the new name of the Team Foundation application-tier server as part of renaming your Team Foundation data-tier server. For more information, see Team Foundation Server Proxy and Source Control.

Note

This procedure works for both single-server Team Foundation Server configurations and for renaming the Team Foundation data-tier server in a dual-server Team Foundation Server deployment.

Required Permissions

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

To stop the services used by Team Foundation Server

  1. On the Team Foundation application-tier server, 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.

  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. On the Team Foundation application-tier server, 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. On the Team Foundation data-tier server, 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 data-tier server name

  1. On the Team Foundation application-tier server, click Start, click All Programs, click Accessories, and then click Command Prompt.

    The Command Prompt window opens.

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

  3. At the command prompt, run the TFSAdminUtil tool with the RenameDT option to connect to the data tier, as shown in the following example:

    TFSAdminUtil RenameDT newservername

  4. Close the Command Prompt window.

To update Team Foundation Server to use the new application-tier server name, if it is configured as a single server

  1. On the Team Foundation application-tier server, click Start, click All Programs, click Accessories, and then click Command Prompt.

    The Command Prompt window opens.

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

  3. Open the web.config file in any plain-text editor, such as Notepad.

  4. Replace the old Team Foundation data-tier server name with the new Team Foundation data-tier server name in the add key elements that define TfsNameURL and TFS Name, as shown in the following example.

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

  5. On the File menu, click Save.

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

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

  8. Open the TfsServerScheduler.exe.config in any plain-text editor, such as Notepad.

  9. Replace the old Team Foundation data-tier server name with the new Team Foundation data-tier server name in the add key element that defines TfsNameUrl. For example:

    <add key="TfsDomainUrl" value="https://newDataTierServerName:8080" />

    Note

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

  10. On the File menu, click Save.

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

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

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

  14. Replace the old Team Foundation data-tier server name with the new Team Foundation data-tier server name in the add key element that defines TfsNameUrl. For example:

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

  15. On the File menu, click Save.

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

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

  18. At the command line, 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 Team Foundation data-tier server is bound to the old Team Foundation application-tier server name. When you are prompted whether to continue, press Y to continue.

  19. Close the Command Prompt window.

In a single-server configuration, client users must connect to the newly renamed Team Foundation application-tier server if they were previously using the Team Foundation application-tier server under its old name. If client users were connected to the Team Foundation 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. On the Team Foundation application-tier server, click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.

    The Reporting Services Configuration Manager 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. Expand the Team Foundation application-tier computer node, and then expand the Application Pools node.

  4. Select the ReportServer application pool, and then click Start.

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

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

  7. 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.

  8. Select Database Setup, in the Server name, enter the new data-tier server name, and then click Apply.

  9. Select Server Status and then click Start.

  10. If Team Foundation Server is configured as a single server, select Windows Service Identity, change the Built-in Account selection to Local System, set the Built-in Account back to Local Service, and then click Apply.

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

  12. Open a browser and browse to https://applicationTierServerName/reports in the address bar.

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

    1. Change the Connection String to use the new Team Foundation data-tier server name, as shown in the following example.

      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.

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

    1. Change the Connection String to use the new Team Foundation data-tier server name, as shown in the following example.

      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.

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

To rebuild the data warehouse OLAP cube

  1. On the Team Foundation application-tier server, click Start, click All Programs, click Accessories, and then click Command Prompt.

    The Command Prompt window opens.

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

  3. Rebuild the warehouse Analysis Services database by typing the following command:

    setupwarehouse -o -s DataTierServerName -d TfsWarehouse -c warehouseschema.xml -ra TFSReportAccount -a TFSServiceAccount

  4. Close the Command Prompt window.

  5. On the Team Foundation data-tier server, click Start, click All Programs, click Microsoft SQL Server, and then click SQL Server Management Studio.

  6. Select Analysis Server for the Server type, select the data-tier server name, and then click Connect.

  7. Expand the Databases node to see the list of Analysis Services databases installed on the Team Foundation data-tier server.

  8. Right-click the TFSWarehouse database and then click Process.

  9. In the Process Database dialog box, click OK to process the warehouse.

  10. Click Close to close the Process Progress dialog box.

  11. On the File menu, click Exit to close SQL Server Management Studio.

To configure and start Windows SharePoint Services

  1. On the Team Foundation application-tier server, click Start, click Administrative Tools, and then click SharePoint Central Administration.

    The SharePoint Central Administration window opens.

  2. In the Server Configuration section, select Set configuration database server, type the new Team Foundation data-tier server name* *in the Database server field, select the Connect to existing configuration database, and then click OK.

  3. In the Server Configuration section, select Set default content database server, type the new Team Foundation data-tier server name, and then click OK.

  4. On the File menu, click Close to close the SharePoint Central Administration window.

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

    The Services window opens.

  6. Select SharePoint Timer Service, and then click Start.

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

If the old Team Foundation data-tier server name is still recognized in Active Directory, Windows SharePoint Services might not accept the new server name. If that occurs, wait for the old server name to be purged, and then repeat this procedure.

To start the remaining services used by Team Foundation Server

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

    The Services window opens.

  2. Click the TfsServerScheduler service, and then click Start.

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

  4. On the Team Foundation application-tier server, click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.

    The Internet Information Services (IIS) Manager window opens.

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

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

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

See Also

Tasks

How to: Rename an Application-Tier Server
How to: Connect a Different Application-Tier Server to the Data Tier

Other Resources

Managing Team Foundation Server Data-Tier Servers
TFSAdminUtil Command-Line Commands