Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

How to: Rename a Data-Tier Server

Updated: July 2010

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.

NoteNote:

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:

  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.

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.

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.

    NoteNote:

    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.

To restore and test Reporting Services

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)

      NoteNote:
      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 noteImportant 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.

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

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

    • SharePoint Timer Service or Windows SharePoint Services Timer

    Application tier

    • Visual Studio Team Foundation Server Task Scheduler Service

    • Microsoft Team Foundation Server Application Pool

To refresh the data cache on client computers

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.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft