Mover una instancia de Team Foundation Server de un entorno a otro

Artículo
06/09/2015

El escenario de movimiento basado en el entorno más habitual consiste en cambiar el dominio de la implementación de TFS, ya sea cambiar el nombre de dominio o pasar de un grupo de trabajo a un dominio.

Importante

En algunas situaciones, puede que desee cambiar el dominio de una implementación de TFS, así como su hardware.Cambiar el hardware es un movimiento basado en la restauración y nunca deben combinarse ambos tipos de movimiento.Complete primero el movimiento de hardware y después cambie el entorno.

Asimismo, cambiar identidades en TFS como parte de un movimiento de entorno es el aspecto que suele causar más conflictos o problemas.El Identities (Comando) es una herramienta eficaz, pero tiene ciertas limitaciones.Infórmese sobre ella como parte de la planeación del movimiento.Para garantizar un movimiento correcto, asegúrese de que entiende los requisitos siguientes:

Una vez que una cuenta de usuario está presente en TFS, no puede quitarse ni se le puede asignar otra cuenta.Por ejemplo, si mueve DominioA/UsuarioA a DominioB/UsuarioB, el comando Identities solo funcionaría para migrar el usuario en caso de que DominioB/UsuarioB aún no esté presente en TFS.
Dado que los miembros del grupo local Administradores se agregan automáticamente a TFS, asegúrese de quitar cualquier cuenta que desee migrar de ese grupo antes de cambiar el dominio o el entorno.

Para obtener información general adicional, vaya aquí para ver una descripción detallada de cómo funcionan los cambios de identidad en TFS, incluidas las limitaciones de la herramienta.

Recorreremos los pasos necesarios para cambiar el entorno de la implementación de TFS en las siguientes secciones:

Comprobar permisos y cuentas
Detener los servicios de TFS
Realizar copias de seguridad de los datos
Unir TFS a su nuevo dominio
Configurar Productos de SharePoint para el nuevo entorno
Mover cuentas de usuario y de servicio de TFS
Configurar Reporting y Analysis Services
Reiniciar los servicios de TFS

Comprobar permisos y cuentas

Para cambiar correctamente el entorno para TFS, tendrá que ser administrador del equipo local, así como de TFS y de todo el software del que dependa la implementación: SQL Server, informes, Productos de SharePoint (si la implementación usa informes o SharePoint), así como de cualquier otro software con el que la implementación interopere, como Project Server. Sin embargo, todos los miembros del grupo local Administradores se incluyen automáticamente en TFS, lo que puede causar problemas al intentar migrar cuentas. Por consiguiente, debe usar una cuenta que no piense migrar como parte del movimiento de entorno. Considere agregar una cuenta administrativa especial solo para el movimiento y usar esa cuenta para realizar la migración.

Para comprobar los permisos de nivel de administrador

Asegúrese de que la cuenta que usa es miembro de los grupos siguientes:
- Servidores: Administradores (grupo Administradores local o equivalente)
- TFS: Administradores de Team Foundation y Usuarios de la consola de administración
- SQL Server: sysadmin
- Productos de SharePoint: Administradores del conjunto de servidores (si la implementación de TFS se integra con Productos de SharePoint)

Si no es miembro de uno o más de estos grupos, obtenga los permisos correspondientes ahora.

Ahora que está seguro de estar usando una cuenta que tiene todos los permisos necesarios, es el momento de iniciar la comprobación de las cuentas para ver si existen conflictos con nombres o grupos del entorno al que se moverá. Ya sabemos que las cuentas que son miembros del grupo local Administradores no se pueden migrar, por lo tanto se quitarán primero.

Quitar las cuentas que se van a migrar del grupo local Administradores

Abra el grupo local Administradores y quite cualquier cuenta que desee migrar al nuevo entorno. Repita este paso para cualquier otro grupo que pueda verse afectado.

Ahora compruebe la lista de identidades del entorno de TFS actual y busque posibles problemas con las cuentas de usuario individuales o de grupos que puedan existir en el nuevo entorno.

Sugerencia

Considere la posibilidad de crear una tabla o un mapa de migración de las identidades que se van a mover como parte del movimiento de entorno, incluyendo detalles de qué cuentas quizás no puedan migrarse automáticamente.

Comprobar identidades

En el servidor de capa de aplicación de Team Foundation, abra una ventana de símbolo del sistema con permisos administrativos, navegue a %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools y ejecute el comando siguiente para ver las identidades que se encuentran actualmente en el sistema:
```
TFSConfig Identities
```
Se mostrará una lista de identidades. Compruebe estos usuarios y grupos para asegurarse de que no haya posibles duplicados o problemas con identidades en el entorno al que va a mover TFS y tome las medidas necesarias para mitigar los conflictos potenciales.

Detener los servicios de TFS

Detener los servicios ayuda a garantizar que los usuarios no puedan realizar cambios en los elementos de trabajo o proteger el código fuente de la implementación original durante o después del proceso de mover.

En el equipo de capa de aplicación de TFS, abra una ventana de símbolo del sistema y cambie al directorio Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools.
Escriba el siguiente comando TFSServiceControl:

TFSServiceControl quiesce

Realizar copias de seguridad de las bases de datos y de la clave de cifrado de SQL Server Reporting Services

Abra la consola de administración para TFS y en la página Copias de seguridad programadas haga una copia de seguridad completa. La copia de seguridad realizará una copia de todos los valores configurados para esta en el plan de copia de seguridad, pero lo hará inmediatamente, no según la hora programada en el plan. Si la implementación usa informes, puede realizar copias de seguridad de la clave de cifrado como parte de este conjunto de copias de seguridad.

(Si no tiene copias de seguridad configuradas, tendrá que crear un plan para poder realizar una copia de seguridad completa).
Una vez completada la copia de seguridad, compruebe que esté disponible en el dispositivo de almacenamiento o el recurso compartido de red y que puede tener acceso a ella desde el nuevo hardware.

Unir TFS a su nuevo dominio

En cada servidor, abra las propiedades del equipo.
Cambie la configuración del equipo al dominio o grupo de trabajo al que desea unir el servidor.

Si se le pide que proporcione el nombre de usuario y la contraseña de una cuenta con permisos para unir este equipo al dominio, especifique las credenciales correspondientes.
Reinicie el equipo para que el cambio de dominio surta efecto.

Nota

Después de reiniciar el equipo, puede que aparezca una advertencia que le indique que no se pudieron iniciar determinados servicios o controladores.Continúe con el procedimiento siguiente.

Configurar Productos de SharePoint para el nuevo entorno

Si está cambiando el entorno a uno donde no haya ninguna confianza con el entorno anterior, quizás tenga que configurar Productos de SharePoint para que funcione correctamente. La información sobre los usuarios importados de los servicios de directorio está disponible en los sitios de SharePoint desde el control web Selector de personas. Los administradores de sitios y otros usuarios utilizan el Selector de personas para seleccionar personas y grupos al asignar permisos. Cuando la información sobre los usuarios se encuentra en varios bosques o en un bosque sin una relación de confianza para todos los usuarios, podrían ser necesarios unos pasos adicionales para asegurarse de que todas las personas y grupos estén disponibles desde este control web.

Omita este procedimiento si no está utilizando Productos de SharePoint en su implementación, si el nuevo entorno tiene una confianza bidireccional con el entorno anterior o si no aparece ningún error en la aplicación web de SharePoint en la consola de administración de Team Foundation.

En cada uno de los servidores que forma parte de la granja de servidores de SharePoint compatible con su implementación de Team Foundation Server, abra una ventana de símbolo del sistema con permisos administrativos y cambie al directorio %programfiles%\Archivos comunes\Microsoft Shared\Web Server Extensions\15\BIN.
Escriba el siguiente comando, donde Key es la clave de cifrado que desea usar en su implementación de Productos de SharePoint:

stsadm.exe -o setapppassword -password Key

Nota

Esta clave es una cadena de cifrado que se utiliza para cifrar la contraseña de la cuenta que se emplea para tener acceso al bosque o al dominio.La cadena de cifrado debe ser la misma para cada servidor de la granja, pero se debe utilizar una cadena única para cada granja.
Escriba el siguiente comando, donde domain:DNSName es el bosque o el dominio de destino y su nombre DNS, user,password es el nombre de usuario y la contraseña de una cuenta con acceso al bosque o al dominio de destino y WebApp es el nombre de la aplicación web que admite su implementación de Team Foundation Server:

stsadm.exe -o setproperty -pn peoplepicker-searchadforests -pv domain:DnsName**,user,**password **-url http://**WebApp
Escriba el comando siguiente, donde URL es la dirección URL de una colección de sitios que admite una colección de proyectos de equipo, Port es el número de puerto asignado a esa colección de sitios y UserName es el nombre de usuario de la cuenta que actuará como propietario de esa colección de sitios:

**stsadm.exe -o siteowner -url http://URL:**Port -ownerlogin UserName
Repita el paso anterior para cada colección de sitios que su implementación de Team Foundation Server utilice.

Mover cuentas de usuario y de servicio de TFS

Como se ha mencionado al principio de este tema, mover cuentas se traduce en una mayor probabilidad de encontrar dificultades, especialmente si no ha planeado cuidadosamente la migración de usuario. El comando TFSConfig Identities no puede migrar ninguna cuenta a otra que ya exista en TFS.

Si los nombres de cuenta son iguales en ambos dominios y la única diferencia es el nombre de dominio, puede usar el modo por lotes de TFSConfig Identities para cambiar todas las identidades a la vez. De lo contrario, debe cambiar las identidades individualmente y especificar otro nombre de cuenta de destino, tal y como se detalla a continuación.

En el servidor de capa de aplicación de Team Foundation, abra una ventana de símbolo del sistema con permisos administrativos, navegue a %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools y ejecute el comando siguiente para cambiar los identificadores de servicio (SID) para la cuenta de servicio al nuevo dominio:
```
TFSConfig identities /change /fromdomain:OldComputerorDomainName /todomain:NewDomainName /account:OldTFSServiceAccount /toaccount:NewTFSServiceAccount
```
Advertencia

Si la cuenta de servicio era una cuenta del sistema como Network Service, no puede migrar directamente la cuenta de servicio al existir una cuenta del sistema con el mismo nombre en el nuevo entorno.Tendrá que realizar un cambio del proceso en dos etapas.Consulte el ejemplo de Identities (Comando).
Para migrar todas las cuentas que tengan el mismo nombre en el nuevo entorno, escriba el comando siguiente:
```
TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName
```
Este procesará las cuentas por lotes.
Si el nuevo dominio contiene una o más identidades cuyo nombre cambia entre los entornos, tendrá que actualizar manualmente los SID de cada una de esas identidades. Por ejemplo, si la cuenta de usuario de Christie Church era Fabrikam\CChurch en el entorno anterior, pero es NewFabrikam/ChristieC en el nuevo entorno, tendría que actualizar manualmente su SID. Para cada cuenta con este requisito, escriba el comando siguiente:
```
TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName /account:OldAccountName /toaccount:NewAccountName
```

Ahora, ejecute el siguiente comando para actualizar la cuenta de servicio:

TFSConfig Accounts /change /AccountType:ApplicationTier /account:AccountName /password:Password

Si la implementación usa informes, ejecute el siguiente comando para actualizar la cuenta de origen de datos usada para crear informes:
```
TFSConfig Accounts /change /AccountType:ReportingDataSource /account:AccountName /password:Password
```
Si la implementación usa el proxy de Team Foundation Server, ejecute el siguiente comando para actualizar la cuenta de servicio usada para el proxy:
```
TFSConfig Accounts /change /AccountType:Proxy /account:AccountName /password:Password
```
Nota

Si va a cambiar a un dominio que no es de confianza, puede que también necesite agregar manualmente usuarios y grupos a los equipos, proyectos, colecciones y al propio Team Foundation Server.Para obtener más información, vea Agregar usuarios a proyectos de equipo, Establecer permisos de administrador para colecciones de proyectos de equipo y Establecer permisos de administrador para Team Foundation Server.
Si la implementación se integra con Project Server, es posible que necesite realizar unos pasos adicionales para configurar las cuentas de servicio con los permisos necesarios para su funcionamiento. Para obtener más información, vea Asignar permisos para la integración de TFS y Project Server y Configurar la integración de TFS y Project Server.

Configurar Reporting y Analysis Services

Puede omitir este procedimiento si no está utilizando informes como parte de su implementación.

Si cambió el nombre de un servidor de informes como parte de este tipo de movimiento, debe redirigir Team Foundation Server al servidor de informes en su nueva ubicación. También debe reiniciar el almacén de datos y recompilar manualmente la base de datos de Analysis Services.

Abra la consola de administración para Team Foundation, vaya al nodo Informes y edite la configuración.
Cambie los valores de las tres pestañas para que incluyan el nuevo nombre del servidor. Asegúrese de proporcionar la información correcta de la cuenta de origen de datos en el nuevo entorno.
Elija Iniciar trabajos para reiniciar la generación de informes.
Elija Iniciar recompilación para recompilar el almacén.

Configurar copias de seguridad

Si el nombre de recurso compartido de red o el dispositivo de almacenamiento se modificó con el cambio de nombre de dominio, tendrá que actualizar el plan de copias de seguridad programadas para apuntar a esos recursos cuyo nombre se cambió.

En la consola de administración, vaya al nodo Copias de seguridad programadas y vuelva a configurar las copias de seguridad programadas para realizar copia de seguridad de las bases de datos de TFS en el nuevo servidor. Para obtener más información, vea Configurar un plan y una programación de copia de seguridad.

Reiniciar los servicios de TFS

Ahora que ha actualizado TFS con toda la información del nuevo entorno, reinicie los servicios.

En el equipo de capa de aplicación de TFS, abra una ventana de símbolo del sistema con permisos administrativos y cambie al directorio Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools.
Escriba el siguiente comando TFSServiceControl:

TFSServiceControl unquiesce

Preguntas y respuestas

P: Deseo cambiar el servidor o los servidores físicos para la implementación, no los dominios.¿Puedo hacerlo?

R: Sí. Esto se denomina movimiento basado en hardware y los pasos se pueden encontrar aquí. No debe intentar combinar un movimiento basado en el entorno con un movimiento basado en hardware. Complete primero el movimiento de hardware y después cambie el entorno.

P: Tengo una implementación que se integra con Project Server.¿Hay que realizar pasos adicionales para conseguir que funcione con TFS después de moverlo?

R: Sí, después de completar el movimiento de entorno deberá usar el comando TFSAdmin ProjectServer /RegisterPWA con las opciones /tfs, /force y /pwa para volver a registrar TFS con Project Server. Puede leer más sobre la integración de TFS con Project Server aquí.

Compartir a través de