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.
.gif) 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 | |
Application tier | |
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
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 | |
Reporting Services | |
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: |
|---|
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 Web Sites for Team Projects
To restore project sites to use the content database on the renamed server
Rebuild the Team System Cube
To rebuild the Team System cube
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 | |
Application tier | |
Refresh the Data Cache on Client Computers
To refresh the data cache on client computers
Tasks
Other Resources