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.
Note
You can also use the procedures in this topic to rename the server in a single-server deployment of Team Foundation Server.
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:
Stop Services that Team Foundation Server Uses
Rename the Data-Tier Server
Redirect and Test Reporting Services
Update the Application-Tier Server to Work with the Renamed Server
Restore Web Sites for Team Projects
Rebuild the Team System Cube
Restart Services
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
On the data-tier server, click Start, right-click My Computer or Computer, and then click Properties.
(For Windows Server 2008) Under Computer Name and domain group settings, click Change settings.
The System Properties dialog box opens.
On the Computer Name tab, click Change.
The Computer Name/Domain Changes window opens.
In the Computer Name box, type the new name, and then click OK.
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?"
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
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)
.gif "Note")
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.
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
.gif "Important note")
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:
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
Date |
History |
Reason |
|---|---|---|
July 2010 |
Added links to more information about how to rename the server that is running SharePoint Products and Technologies. |
Customer feedback. |