Team Foundation Server Move Types

There are three supported move types for Team Foundation Server. The most common type is the restoration-based move, where a new installation of Team Foundation Server is configured on new hardware, and the data from your original Team Foundation Server deployment is restored to the new environment. A more simple type is the environment-based move, where an existing Team Foundation Server deployment is moved to a domain or to a workgroup. Finally, there is the single-server to dual-server move, where Team Foundation Server is moved from a single-server deployment to a dual-server deployment. This is a specific type of restore-based move.

Why Move Your Team Foundation Server Deployment?

There are many reasons why you might consider moving your existing Team Foundation Server deployment. The most common reasons are as follows:

  • To increase the capacity of your Team Foundation Server deployment by moving from a single-server deployment to a dual-server deployment.

  • To incorporate new hardware, either with the same server names or with different server names.

  • To move Team Foundation Server from a workgroup to an Active Directory domain.

  • To move Team Foundation Server from one domain to another domain.

Supported Move Types

Team Foundation Server supports three different move types. All three move types require many steps. You should read through the procedures for each move type carefully before you try to move your Team Foundation Server deployment.

  • Restore-based move   A new Team Foundation Server deployment is installed in the new environment. Backups of the original Team Foundation Server databases are restored to the new Team Foundation Server in the new environment. This move type is used to move to new hardware. For specific steps, see How to: Move Your Team Foundation Server from One Hardware Configuration to Another.

  • Environment-based move   An existing Team Foundation Server deployment is moved to a new environment by joining the Team Foundation Server computer to a domain, or by changing the domain to which the Team Foundation Server belongs. This move type does not involve changing hardware. For specific steps, see How to: Move Your Team Foundation Server from One Environment to Another.

  • Single-server to dual-server move   This is a specific type of restore-based move. A new Team Foundation data-tier server is installed on a new computer and the original single-server Team Foundation Server is converted into the Team Foundation application-tier server. Backups of the databases taken from the original single-server environment are restored to the new Team Foundation data-tier server in the dual-server environment. For specific steps, see How to: Move from a Single-Server to a Dual-Server Deployment.

Move Scenarios

You must decide which type of move best suits your business needs. Potential server move scenarios include the following:

  • Move a server from domain A to domain B   If you do not change the hardware, this is an environment-based move type. You might do this if you evaluated Team Foundation Server in a test domain and you want to move the server to a production domain. Moving servers might also involve moving or recreating user accounts, group accounts, and permissions from the original server.

  • Move a single server from a workgroup to a domain   This is an environment-based move type. You might do this if you deployed Team Foundation Server in a workgroup and then decided to implement an Active Directory domain. You can move local users from a workgroup to a domain if the same user account is in the domain, or if the user account exists as a local account on Team Foundation Server.

  • Replace the hardware in a Team Foundation Server deployment   This is a restore-based move type. You might do this if you had to replace the hardware on which you installed Team Foundation Server.

  • Expand the capacity of your single-server Team Foundation Server deployment   The move type for this is determined by whether you want to move your deployment to a faster server that has more capacity, or you want to move from a single-server deployment to a dual-server deployment. The former is a restore-based move, where the latter is a single-server to dual-server based move. You might do this if you experienced poor performance on your current Team Foundation Server deployment and needed more capacity for users, projects, and data.

Move Considerations

Moving your Team Foundation Server deployment requires careful planning and execution; for instance, combining a move from a Team Foundation Server single-server deployment to a Team Foundation Server dual-server deployment with a domain migration requires particular care.

Note

Moving a Team Foundation Server deployment is supported only for the release candidate (RC) and release to manufacturing (RTM) versions of Team Foundation Server. Moving a Team Foundation Server deployment is not supported for earlier versions of Team Foundation Server.

Considerations for Moving Your Team Foundation Server

If it is possible, keep the Team Foundation application-tier server name the same For environment-based moves and single-server to dual-server moves, keep the same name for the Team Foundation application-tier server if it is possible. Changing the Team Foundation application-tier server name adds the following complications:

  • Changing the Team Foundation application-tier server name requires that all Team Foundation clients must connect to a new server name.

  • All query-bound Microsoft Office documents will no longer work if the server name is changed. The documents are bound to the server for which they were created. This includes all the query bound Microsoft Office documents that are created automatically at project creation time in the project Documents node.

  • Any embedded links to documents will point to an unknown server name if the server name is changed.

Note

For restore-based move types, the Team Foundation application-tier server name must be changed.

Moving users and service accounts As part of the security model, Team Foundation Server stores Windows identities (local and domain groups and users) by their security identifiers (SIDs). The Team Foundation Group Security Service regularly synchronizes the information stored in the TFSIntegration database based on SIDs as the unique identifier for each user. Therefore, depending on your move type, the SIDs in the TFSIntegration database might not be valid after the move. This is true if:

  • Local accounts existed on the original Team Foundation Server. You must decide whether these accounts will be recreated as local accounts on the moved Team Foundation Server, or as domain accounts in the moved Team Foundation Server's new domain.

  • Domain accounts existed on the original Team Foundation Server, but you are moving Team Foundation Server to a domain that does not trust the original domain. You must decide whether these accounts will be re-created as local accounts on the moved Team Foundation Server, or as domain accounts in the moved Team Foundation Server's new domain.

To maintain the existing set of Team Foundation Server users and groups and their assigned permissions, Team Foundation Server ships a command-line tool (TfsAdminUtil). One of the TFSAdminUtil commands updates each entry in the TFSIntegration database that uses a SID for the user account to an entry present in the new domain if it finds one. For more information, see TFSAdminUtil Command-Line Commands.

Important

In order to successfully move Windows users and groups and their permissions with the TfsAdminUtil SID command, the users and groups must have the same account name in both the original Team Foundation Server environment and in the new domain. The tool does not let you define a mapping between account names for user moving purposes. It is also possible that as part of a move, the service accounts used by the original Team Foundation Server deployment will not be found in the moved Team Foundation Server deployment. To move the service account, you should use the TfsAdminUtil ChangeAccount command.

Prepare with a test run It is a good idea to test moving to a new environment with a test run exercise to help determine and troubleshoot any unforeseen issues. Your move scenarios and deployment environments might differ from those tested by Microsoft. Performing a test run will help you identify possible differences in the move steps that are particular to your deployment.

See Also

Tasks

How to: Move Your Team Foundation Server from One Hardware Configuration to Another
How to: Move Your Team Foundation Server from One Environment to Another
How to: Move from a Single-Server to a Dual-Server Deployment