Tutorial: Preparación para migrar de Visual SourceSafe a Team Foundation

  • Artículo

Actualización: noviembre 2007

La herramienta de conversión de Team FoundationVisual SourceSafe transfiere archivos, carpetas, historiales de versiones e información del usuario de una base de datos de Visual SourceSafe a un servidor de Control de versiones de Team Foundation. Antes de mover archivos e información del historial a Team Foundation, debe analizar y realizar una copia de seguridad de la base de datos, proteger el mayor número de archivos posible y saber qué información no se puede transferir de Visual SourceSafe a Team Foundation.

En este tutorial se describe cómo preparar la base de datos de Visual SourceSafe para la conversión y cómo utilizar VSSConverter para planear con eficacia la migración real del código.

En este tutorial, llevará a cabo las tareas siguientes:

  • Hacer una copia de seguridad de la base de datos de Visual SourceSafe.

  • Identificar y resolver los problemas de integridad de los datos en la base de datos existente utilizando la herramienta de análisis de Visual SourceSafe.

  • Ejecutar la herramienta de conversión para identificar posibles orígenes de pérdida de datos.

  • Especificar las carpetas de Visual SourceSafe que se van a migrar.

  • Crear un archivo de asignación de usuarios para asignar usuarios de Visual SourceSafe a usuarios de Team Foundation.

Requisitos previos

Para completar este tutorial, debe tener instalado el siguiente software en el equipo en el que va a ejecutar VSSConverter.exe:

  • Team Explorer

  • Acceso al equipo con credenciales administrativas

  • SQL Server Express

    Nota:

    De forma predeterminada, SQL Server Express se instala durante la instalación de Visual Studio 2005 o Visual Studio 2008

  • Visual SourceSafe 2005 o una versión posterior

  • La base de datos de Visual SourceSafe que desea analizar. El formato de la base de datos debe ser el de la versión 6.0 o posterior. Debe ejecutar la herramienta de conversión en el mismo equipo que la base de datos de Visual SourceSafe para completar este tutorial.

    Además, necesita:

    • La contraseña del administrador para la base de datos de Visual SourceSafe que contiene los proyectos que desea analizar.

      Nota:

      Los demás usuarios no deben tener acceso a la base de datos de Visual SourceSafe durante el proceso de análisis. No bloquee la base de datos, ya que el bloqueo impide que la herramienta de conversión tenga acceso a la base de datos para la migración.

Permisos necesarios

Para realizar este tutorial, debe tener permisos administrativos para la base de datos de Visual SourceSafe que va a migrar. Para obtener más información, vea "How to: Assign Project Rights" en el sitio web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=99103).

Preparar la base de datos de Visual SourceSafe

Antes de transferir los archivos con control de código fuente de Visual SourceSafe a Microsoft Visual Studio Team System, complete las siguientes tareas en Visual SourceSafe.

  • Solicite a todos los usuarios de la base de datos que protejan sus archivos.

  • Cree una copia de seguridad de la base de datos de Visual SourceSafe que va a migrar. Para obtener más información, vea "Cómo realizar una copia de seguridad de base de datos de Visual SourceSafe" en el sitio web de Microsoft (https://go.microsoft.com/fwlink?linkid=51358).

  • Emplee la utilidad de análisis de Visual SourceSafe para localizar y solucionar los problemas de integridad de los datos en la base de datos. Para obtener más información sobre el uso de esta herramienta, vea "ANALYZE (Utilidad)" (https://go.microsoft.com/fwlink/?LinkId=99129) y "Cómo detectar y corregir errores de daño de base de datos en Visual SourceSafe" (https://go.microsoft.com/fwlink/?linkid=51357).

Analizar los proyectos

VSSConverter.exe es una utilidad de línea de comandos que requiere los siguientes datos de entrada:

  • Una ruta de acceso a la carpeta que contiene el archivo srcsafe.ini para la base de datos de Visual SourceSafe que se va a migrar.

  • Un archivo basado en XML que contiene la configuración.

  • VSSConverter.exe se encuentra en <raíz>:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE, pero se invoca desde el símbolo del sistema de Visual Studio.

En este tutorial se supone que la base de datos de Visual SourceSafe está en c:\VSSDatabase.

Una vez que haya decidido cuáles son los proyectos que desea analizar, cree un archivo para almacenar la configuración. Este archivo incluirá los proyectos que desea que analice la herramienta de conversión.

Para crear el archivo de configuración para el análisis

  1. Haga clic en Inicio, en Todos los programas, elija Microsoft Visual Studio 2008, Visual Studio Tools y haga clic en Símbolo del sistema de Visual Studio 2008.

  2. En el símbolo del sistema, escriba mkdir %LetraDeUnidad%\VSS2TeamFoundation, donde %LetraDeUnidad% es la unidad actual. Presione ENTRAR.

  3. En el símbolo del sistema, escriba cd %LetraDeUnidad%\VSS2TeamFoundation. Presione ENTRAR.

  4. Escriba notepad settings.xml y presione ENTRAR.

  5. Seleccione Sí para crear el archivo.

  6. Copie el siguiente código XML, donde $/FolderA y $/FolderB representan los nombres de las carpetas que contienen los proyectos que desea migrar.

    <?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
      <ConverterSpecificSetting>
            <Source name="VSS">
                  <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
            </Source>
            <ProjectMap>
            <Project Source="$/FolderA"></Project>
            <Project Source="$/FolderB"></Project>
            </ProjectMap>
      </ConverterSpecificSetting>
      <Settings>
       <Output file="Analysis.xml"></Output>
     </Settings>
</SourceControlConverter>
    Nota:

    Para migrar la base de datos entera, utilice <Project Source="$/"></Project>.

    En la etiqueta <VSSDatabase name>, escriba la ruta de acceso a la base de datos de Visual SourceSafe.

  7. Guarde los cambios y cierre el Bloc de notas.

A continuación, ejecute la herramienta de conversión desde el símbolo del sistema de Visual Studio para analizar el proyecto, como se muestra en los siguientes pasos.

El usuario que realiza el análisis debe ser un administrador del sistema de SQLExpress. De forma predeterminada, el usuario que instala Visual Studio recibirá los permisos necesarios para SQLExpress.

Una vez que disponga del archivo de configuración de la migración y de derechos de administrador del sistema, ya puede ejecutar la herramienta de conversión para analizar el proyecto.

Para analizar el proyecto con la herramienta de conversión

  1. En el símbolo del sistema de Visual Studio, escriba lo siguiente.

    VSSConverter Analyze settings.xml

  2. Cuando el sistema se lo pida, especifique la contraseña de administrador de Visual SourceSafe.

    La herramienta de conversión muestra el estado del análisis previo a la conversión. Cuando haya finalizado, generará un informe (VSSAnalysisReport.xml) y un archivo de asignaciones de usuarios (usermap.xml), y los guardará en el directorio actual. Puede utilizar el archivo de asignación de usuarios para asignar usuarios de Visual SourceSafe a usuarios de Team Foundation. Para obtener más información, consulte Cómo: Editar el archivo de asignación de usuarios de migración del control de código fuente.

Pasos siguientes

Ahora puede migrar la información de la base de datos de Visual SourceSafe en el servidor de Control de versiones de Team Foundation. Para obtener más información, vea Tutorial: Migrar de Visual SourceSafe a Team Foundation.

Vea también

Tareas

Tutorial: Migrar de Visual SourceSafe a Team Foundation

Cómo: Crear un archivo de configuración para la migración y el análisis del control de código fuente

Conceptos

Utilidad VSSConverter de la línea de comandos para Source Control Migration

Otros recursos

Documentación de Team Foundation