Tutorial: Migrar de Visual SourceSafe a Team Foundation

  • Artículo

Actualización: noviembre 2007

En este tutorial se describe cómo migrar desde Visual SourceSafe a Team Foundation utilizando el convertidor de VSS, VSSConverter.exe. Para obtener información sobre cómo preparar la base de datos para la migración, vea Tutorial: Preparación para migrar de Visual SourceSafe a Team Foundation. El tutorial contiene información detallada sobre cómo preparar una base de datos y una lista de usuarios de SourceSafe para la migración a Team Foundation y comprender mejor el funcionamiento del proceso de migración.

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

  • Modificar el archivo de configuración para especificar las carpetas que se van a migrar.

  • Ejecutar el convertidor para migrar el código fuente de Visual SourceSafe a Team Foundation y generar un informe de migración.

Requisitos previos

Antes de intentar finalizar este tutorial:

  • Siga todos los pasos que se explican en Tutorial: Preparación para migrar de Visual SourceSafe a Team Foundation.

  • Identifique las carpetas vacías de Control de versiones de Team Foundation a las que desea migrar las carpetas de Visual SourceSafe. Si no existe la carpeta de destino, el convertidor la creará automáticamente. La única excepción se produce cuando la carpeta de destino es un proyecto de equipo. La carpeta de destino debe ser un proyecto de equipo válido o una subcarpeta de un proyecto de equipo válido. Para obtener más información, vea Cómo: Crear un proyecto de equipo.

Además, necesita:

  • Un nombre de Team Foundation Server.

  • Instalar SQL Server Express en el equipo donde piensa ejecutar el convertidor.

    De forma predeterminada, SQL Express se instala al instalar Microsoft Visual Studio Team System.

    Para conectarse a una base de datos de SQL Express y usar la herramienta de conversión debe tener permisos administrativos.

  • Visual SourceSafe 2005 en el equipo en el que ejecuta VSSConverter.

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). Además, debe ser miembro de la función de servidor sysadmin para SQL Express. De forma predeterminada, el usuario es miembro de la función de servidor sysadmin si es miembro del grupo de seguridad Administradores en el equipo donde se ha instalado SQL Express. Para obtener más información, vea "sysadmin" en el sitio web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=60405) en la documentación de SQL Server 2005.

Migrar las carpetas de proyecto de SourceSafe

Antes de seguir con la conversión real, personalice el archivo de configuración para que incluya las carpetas de destino de los proyectos de SourceSafe que especificó durante la preparación de la conversión. Para completar esta tarea debe seguir todos los pasos que se explican en Tutorial: Preparación para migrar de Visual SourceSafe a Team Foundation.

Para modificar el archivo de configuración para crear un archivo de migración

  1. Haga clic en Inicio, luego en Programas, elija Microsoft Visual Studio 2008, Visual Studio Tools y, a continuación, haga clic en Símbolo del sistema de Visual Studio 2008.

  2. En el símbolo del sistema, escriba cd %LetraDeUnidad%\VSS2TeamFoundation. Esta carpeta se creó al analizar la base de datos de Visual SourceSafe para la migración. Para obtener más información, vea Tutorial: Preparación para migrar de Visual SourceSafe a Team Foundation.

    Nota:

    Asegúrese de que la unidad del sistema dispone de espacio suficiente para almacenar el archivo de mayor tamaño que se está migrando.

  3. Guarde el archivo de configuración que creó para el análisis, settings.xml, con un nuevo nombre; por ejemplo, migration_settings.xml.

  4. En el símbolo del sistema, escriba notepad migration_settings.xml y presione ENTRAR.

    El archivo settings.xml que creó al analizar la base de datos para la migración se muestra en el Bloc de notas.

  5. Cambie el archivo de configuración de la manera siguiente.

    • En la sección <ProjectMap>, para cada carpeta de Visual SourceSafe que va a migrar, agregue las carpetas de destino de Control de versiones de Team Foundation. Utilice el formato siguiente, agregando la sección Destination como se muestra en el ejemplo siguiente.

      <Project Source="$/FolderA" Destination="$/Team_Project"></Project>

      Si desea migrar todo el contenido de la base de datos de Visual SourceSafe, inserte en su lugar el código XML siguiente:

      <Project Source="$/" Destination="$/Team_Project/"></Project>

    • En la sección <Settings>, agregue una sección <TeamFoundationServer> y especifique el nombre, puerto y protocolo del servidor de Team Foundation Server al que está migrando. Utilice el formato siguiente:

      <TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>

      Por ejemplo,

      <TeamFoundationServer name="AdventureWorks" port="8080" protocol="http"></TeamFoundationServer>
      Nota:

      Si tiene una base de datos de Visual SourceSafe de gran tamaño, es posible que se produzca un error durante la migración debido al límite de 4 GB de SQLExpress. Para resolver este error, establezca el convertidor de manera que utilice SQL Server agregando la línea siguiente: <SQL Server="nombre_servidor_SQL"></SQL>

  6. Quite <Output file="Analysis.xml"></Output> de la sección <Settings> o cambie el nombre del archivo de resultados a "migration_Analysis.xml".

    El archivo migration_settings.xml debe ser similar al siguiente:

    <?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
      <ConverterSpecificSetting>
            <Source name="VSS">
                  <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
                  <UserMap name="c:\Migrate\Usermap.xml"></UserMap>
            </Source>
            <ProjectMap>
                  <Project Source="$/FolderA" Destination="$/TeamProjectA"></Project>
                  <Project Source="$/FolderB" Destination ="$/TeamProjectB/ProjectB"></Project>
            </ProjectMap>
      </ConverterSpecificSetting>
      <Settings>
            <TeamFoundationServer name="server_name" port="port_number" protocol="protocol"></TeamFoundationServer>
      </Settings>
</SourceControlConverter>

    Asegúrese de sustituir el nombre de servidor en server name y un número de puerto real en port number.

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

Para ejecutar el convertidor

  1. Copie la base de datos de Visual SourceSafe en una carpeta local del equipo en el que desea ejecutar el análisis y la migración. Aunque puede migrar una base de datos de Visual SourceSafe a una carpeta compartida de un equipo remoto, la migración tardará mucho más tiempo en realizarse.

  2. Haga clic en Inicio, haga clic en Todos los programas, elija Microsoft Visual Studio, elija Visual Studio Tools y, a continuación, haga clic en Símbolo del sistema de Visual Studio.

  3. En el símbolo del sistema, escriba lo siguiente:

    VSSConverter Migrate migration_settings.xml

    Sugerencia:

    Utilice el modificador /? para ver las opciones de la línea de comandos disponibles.

  4. Escriba Y para confirmar la migración.

    La herramienta de conversión mostrará el estado de la migración. Al terminar el proceso de conversión, la herramienta guardará un informe de migración en el directorio actual. Para ver el archivo puede usar Internet Explorer.

  5. Cuando se le solicite, proporcione la contraseña para el usuario admin de Visual SourceSafe.

    Nota:

    VSSConverter no migra los enlaces del control de versiones de soluciones Visual Studio. Debe cambiar manualmente estos enlaces. Para obtener más información, consulte Cómo: Migrar enlaces del control de código fuente desde Visual SourceSafe.

Vea también

Tareas

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