How to: Rename a Data-Tier Server

To rename the data-tier server in a dual-server deployment of Visual Studio Team System Team Foundation Server, you must rename the server itself and perform several other steps. For example, you must reconfigure Team Foundation Server, SQL Server Reporting Services, and SharePoint Products and Technologies to use the server that you just renamed.

If you use Microsoft Project or Microsoft Excel to report data from Team Foundation, you must also recreate those files to use the server that you just renamed. For more information, see Team Foundation Server Reporting. If you have configured Team Foundation Server Proxy to use a single-server deployment and you rename the server for that deployment, you must modify the proxy.config file to use the new name of the server. For more information, see Managing Remote Connections to Team Foundation Server Proxy.

To rename a data-tier server in a dual-server deployment or the server in a single-server deployment, you must complete the procedures in the following sections in the sequence listed:

1. Stop Services that Team Foundation Server Uses

2. Rename the Data-Tier Server

3. Redirect and Test Reporting Services

4. Update the Application-Tier Server to Work with the Renamed Server

5. Restore Web Sites for Team Projects

6. Rebuild the Team System Cube

7. Restart Services

8. Refresh the Data Cache on Client Computers

Required Permissions

To perform this procedure, you must be a member of the Administrators security group and a member of the sysadmin group in SQL Server on the data-tier server. You must also be a member of the Team Foundation Administrators group on the application-tier server. For more information about permissions, see Team Foundation Server Permissions.

In addition to these permissions, you might need to address the following requirements on a computer that is running Windows Server 2008 or Windows Vista:

• To follow a command-line procedure, you might need to open an elevated Command Prompt by clicking Start, right-clicking Command Prompt, and clicking Run as Administrator.

• To follow a procedure that requires Internet Explorer, you might need to start it as an administrator by clicking Start, clicking All Programs, right-clicking Internet Explorer, and then clicking Run as administrator.

• To edit web.config files, you might need to start the text editor as an administrator by clicking Start, clicking All Programs, right-clicking the editor, and then clicking Run as administrator.

• To access Report Manager, reports, or Web sites for Reporting Services, you might need to add these sites to the list of trusted sites in Internet Explorer or start Internet Explorer as an administrator.

For more information, see the Microsoft Web site.

Stop Services That Team Foundation Server Uses

To stop services that Team Foundation Server uses

• Log on to the appropriate server, open Computer Manager, and stop the components in the following table in the order specified:

  Log on to the server that hosts this program	Stop this component
  SharePoint Products and Technologies	SharePoint Timer Service or Windows SharePoint Services Timer Default Web Site or Team Web site
  Application tier	Visual Studio Team Foundation Server Task Scheduler Service Microsoft Team Foundation Server Application Pool
  Reporting Services	SQL Server Reporting Services (TFSINSTANCE) ReportServer or ReportServer$InstanceName (application pool) Default Web Site or Report Manager Web site

  For more information, see How to: Stop and Start Services, Application Pools, and Web Sites.

Rename the Data-Tier Server

To rename the data-tier server

1. On the data-tier server, click Start, right-click My Computer or Computer, and then click Properties.

2. (For Windows Server 2008) Under Computer Name and domain group settings, click Change settings. 

   The System Properties dialog box opens.

3. On the Computer Name tab, click Change.

   The Computer Name/Domain Changes window opens.

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

5. Click OK to close the System Properties dialog box.

   A system message might appear and ask "You must restart this computer for the changes to take effect. Do you want to restart the computer?"

6. If the message appears, click Yes, and restart the computer.

   Note

   If you restart the server in a single-server deployment, wait for the server to restart, and then stop the services that Team Foundation Server uses.

Redirect and Test Reporting Services

To restore and test Reporting Services

• Log on to the server that hosts Reporting Services, and redirect it to connect to the databases on the renamed server.

  For more information, see How to: Redirect Reporting Services to Connect to a Different Data-Tier Server.

Update the Application-Tier Server to Work with the Renamed Server

To update the application-tier server to work with the renamed server

1. Log on to the appropriate server, open Computer Manager, and start the application pools and programs in the following table if they are not already started:

   Log on to the server that hosts this program	Start this component
   Application tier	Microsoft Team Foundation Server Application Pool
   Reporting Services	ReportServer or ReportServer$InstanceName (application pool) Note: You manage ReportServer for SQL Server 2005 but not for SQL Server 2008. SQL Server Reporting Services (TFSINSTANCE)

   For more information, see How to: Stop and Start Services, Application Pools, and Web Sites.

2. Open the Command Prompt window, change directories to %ProgramFiles%\Microsoft Visual Studio 2008 Team Foundation Server\Tools, and type the following command:

   TfsAdminUtil RenameDT newTeamFoundationDataTierServerName

   Important Note:
   For the RenameDT command to succeed, the application pools and programs in the previous step must be running. This requirement is new in Visual Studio Team System 2008 Team Foundation Server.

Restore Websites for Team Projects

To restore project sites to use the content database on the renamed server

• Log on to the server that hosts SharePoint Products and Technologies, and redirect it to use the databases on the renamed server.

  For more information, see How to: Redirect SharePoint Products and Technologies to Use a New Content Database and the following topics on the Microsoft website:

  • Rename a stand-alone server (Windows SharePoint Services)

  • Rename a stand-alone server (Office SharePoint Services)

Rebuild the Team System Cube

To rebuild the Team System cube

• Log on to the application-tier server, and rebuild the Team System cube.

  For more information, see How to: Rebuild the Team System Cube.

Restart Services

To restart services that Team Foundation Server uses

• Log on to the appropriate server, open Computer Manager, and start the components in the following table, in the order specified:

  Log on to the server that hosts this program	Start this component
  SharePoint Products and Technologies	SharePoint Timer Service or Windows SharePoint Services Timer
  Application tier	Visual Studio Team Foundation Server Task Scheduler Service Microsoft Team Foundation Server Application Pool

Refresh the Data Cache on Client Computers

To refresh the data cache on client computers

• Use the ClientService Web service to force client computers to update the cache for tracking work items the next time that the computers connect to Team Foundation Server.

  For more information, see How to: Refresh the Data Caches on Client Computers.

See Also

Tasks

How to: Stop and Start Services, Application Pools, and Web Sites

How to: Move Your Deployment of Team Foundation Server from One Hardware Configuration to Another

How to: Rename an Application-Tier Server

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

Other Resources

Managing Data-Tier Servers for Team Foundation Server

TFSAdminUtil Command-Line Commands

Change History