Comando RenameDT

Artículo
10/07/2008

Actualización: noviembre 2007

Utilice RenameDT para cambiar el nombre del servidor de nivel de datos para Team Foundation Server.

Nota importante:
Para que el comando RenameDT se ejecute correctamente, los siguientes grupos de aplicaciones y programas deben estar en ejecución.

Grupo de aplicaciones de Team Foundation Server (grupo de aplicaciones)
ReportServer (grupo de aplicaciones)

Nota:

El grupo de aplicaciones ReportServer se administra en Internet Information Services (IIS) para SQL Server 2005 pero no para SQL Server 2008.
SQL Server Reporting Services (programa)

Nota:
El grupo de aplicaciones ReportServer se administra en Internet Information Services (IIS) para SQL Server 2005 pero no para SQL Server 2008.

Permisos necesarios

Para utilizar el comando RenameDT, debe ser miembro del grupo Administradores de Team Foundation en el servidor de nivel de aplicación de Team Foundation y miembro del grupo sysadmin en SQL Server en el servidor de nivel de datos de Team Foundation. Para obtener más información, vea Permisos de Team Foundation Server.

Nota:
Incluso si ha iniciado sesión con credenciales administrativas, debe abrir un símbolo del sistema con privilegios elevados para realizar esta función en un servidor que ejecute Windows Server 2008. Para abrir un símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, visite el sitio web de Microsoft.

Incluso si ha iniciado sesión con credenciales administrativas, debe abrir un símbolo del sistema con privilegios elevados para realizar esta función en un servidor que ejecute Windows Server 2008. Para abrir un símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, visite el sitio web de Microsoft.

TFSAdminUtil RenameDT servername

Parámetros

Argumento	Descripción
servername	Especifica el nombre del equipo de nivel de datos de destino. El equipo puede identificarse por los siguientes tipos: Dirección IP La dirección IP debe tener el formato: aaa.bbb.ccc.ddd. Nombre del equipo No se permiten espacios ni caracteres especiales, como ";:<>*, sólo caracteres [A-Z \| 0-9 \| -], tampoco pueden tener sólo números y deben tener como máximo 15 caracteres para ASCII normal y un máximo de 7 caracteres para codificación de caracteres más extensos. Para obtener más información, vea Restricciones de nomenclatura para Team Foundation Server. Dirección de dominio Por ejemplo, miServidor.ubicación.miCompañía.com.

servername

Especifica el nombre del equipo de nivel de datos de destino. El equipo puede identificarse por los siguientes tipos:

Dirección IP

La dirección IP debe tener el formato: aaa.bbb.ccc.ddd.
Nombre del equipo

No se permiten espacios ni caracteres especiales, como ";:<>*, sólo caracteres [A-Z | 0-9 | -], tampoco pueden tener sólo números y deben tener como máximo 15 caracteres para ASCII normal y un máximo de 7 caracteres para codificación de caracteres más extensos. Para obtener más información, vea Restricciones de nomenclatura para Team Foundation Server.
Dirección de dominio

Por ejemplo, miServidor.ubicación.miCompañía.com.

Comentarios

Nota importante:
Es recomendable que realice una copia de seguridad de las bases de datos del servidor de nivel de datos de Team Foundation Server.

Las cadenas TFSNameUrl y TFS Name del archivo Web.config de servicios, ubicado en Unidad:\Archivos de programa\Microsoft Visual Studio 2008 Team Foundation Server\Web Services en el nivel de datos, deben hacer referencia al servidor de nivel de datos de Team Foundation Server actual. Si no es así, el comando RenameDT produce un error sin ningún mensaje o advertencia.

El nivel de aplicación de Team Foundation Server necesita el nombre exacto y la dirección del servidor de nivel de datos para poder tener acceso a él. El nombre y la dirección del nivel de datos están almacenados en varias ubicaciones en Team Foundation Server, tanto en la base de datos de nivel de aplicación como en la del nivel de datos. Allí donde sea necesario cambiar a un nuevo nivel de datos, el administrador debe asegurarse de que Team Foundation Server apunta a la dirección o nombre del nivel de datos.

El comando RenameDT de la utilidad TFSAdminUtil de la línea de comandos automatiza el proceso de cambio de nombre del nivel de datos mediante la actualización de Team Foundation Server para que apunte a una nueva dirección o nombre. El comando RenameDT también puede establecerse mediante secuencia de comandos para automatizar o programar el proceso de cambio de nombre del nivel de datos.

El comando RenameDT sólo puede ejecutarse en el nivel de aplicación porque busca el archivo web.config en el equipo en el que se está ejecutando. No dispone de funciones remotas, ni toma ningún otro parámetro para especificar el equipo de nivel de aplicación de destino.

Ejemplo de escenarios de uso

El administrador puede utilizar el comando RenameDT en varios escenarios. A continuación se muestra un ejemplo de los escenarios:

El administrador necesita realizar el mantenimiento periódico del nivel de datos y necesita que el nivel de datos esté desconectado, reemplazándolo por otro nivel de datos temporal para evitar el tiempo de inactividad.
El administrador ejecuta el comando RenameDT de la utilidad TFSAdminUtil de la línea de comandos, de modo que Team Foundation Server se conecte ahora al nuevo nivel de datos temporal. Una vez realizado el mantenimiento, el administrador ejecuta de nuevo la utilidad para volver al nivel de datos inicial.
El nivel de datos produjo un error y no funciona.
El administrador ejecuta el comando RenameDT para que Team Foundation Server apunte a un nuevo servidor de copia de seguridad.
El nivel de datos se actualiza al nuevo servidor.
El administrador ejecuta el comando RenameDT para que Team Foundation Server apunte a un nuevo servidor de nivel de datos.
Las nuevas directivas de operaciones establecen normativas específicas de nomenclatura de equipos a las que se tiene que ajustar el nivel de datos.
El administrador utiliza el comando RenameDT para renombrar el nivel de datos con un nombre más adecuado.
La organización o empresa ha crecido y necesita migrar de una solución de servidor único a una de servidor dual.
Después de configurar el nuevo nivel de datos independiente, el administrador ejecuta el comando RenameDT para que Team Foundation Server apunte al nuevo servidor.