Condividi tramite

Procedura dettagliata: migrazione da Visual SourceSafe a Team Foundation

  • Articolo

Aggiornamento: novembre 2007

In questa procedura dettagliata viene descritto come eseguire la migrazione da Visual SourceSafe a Team Foundation utilizzando il convertitore VSS, VSSConverter.exe. Per informazioni su come preparare una database per la migrazione, vedere Procedura dettagliata: preparazione alla migrazione da Visual SourceSafe a Team Foundation. Nella procedura dettagliata sono disponibili informazioni esaurienti sulla preparazione di un elenco utenti e un database SourceSafe per la migrazione a Team Foundation. Queste informazioni consentono inoltre di comprendere meglio i passaggi di un processo di migrazione.

Nel corso di questa procedura dettagliata, l'utente completerà le seguenti attività:

  • Modificare il file delle impostazioni per specificare le cartelle di cui effettuare la migrazione.

  • Eseguire il convertitore per effettuare la migrazione del codice sorgente da Visual SourceSafe a Team Foundation e generare un report di migrazione.

Prerequisiti

Prima di completare questa procedura dettagliata:

  • Eseguire tutti passaggi come descritto in Procedura dettagliata: preparazione alla migrazione da Visual SourceSafe a Team Foundation.

  • Individuare le cartelle vuote in Controllo della versione di Team Foundation in cui si desidera effettuare la migrazione delle cartelle di Visual SourceSafe. Se la cartella di destinazione non esiste, verrà automaticamente creata dal convertitore. La sola eccezione si verifica nel caso in cui la cartella di destinazione è un progetto Team. La cartella di destinazione sarà un progetto Team valido o una sottocartella di un progetto Team valido. Per ulteriori informazioni, vedere la classe Procedura: creare un progetto Team.

È inoltre necessario:

  • Nome di Team Foundation Server.

  • Installare SQL Server Express nel computer in cui si prevede di eseguire il convertitore.

    SQL Express viene installato per impostazione predefinita insieme a Microsoft Visual Studio Team System.

    Per utilizzare lo strumento di conversione, è necessario disporre di autorizzazioni amministrative per la connessione a un database di SQLExpress.

  • Visual SourceSafe 2005 in un computer su cui è in esecuzione VSSConverter.

Autorizzazioni necessarie

Per eseguire questa procedura, è necessario disporre di autorizzazioni amministrative per il database Visual SourceSafe di cui si eseguirà la migrazione. Per ulteriori informazioni, vedere "How to: Assign Project Rights" (in lingua inglese) sul sito Web Microsoft all'indirizzo: https://go.microsoft.com/fwlink/?LinkId=99103. È inoltre necessario essere un membro del ruolo del server sysadmin per SQL Express. Per impostazione predefinita, si è un membro del ruolo del server sysadmin se si è un membro del gruppo di sicurezza Amministratori nel computer in cui è installato SQL Express. Per ulteriori informazioni, vedere "sysadmin" sul sito Web Microsoft (https://go.microsoft.com/fwlink/?LinkId=60405) nella documentazione in linea di SQL Server 2005 (informazioni in lingua inglese).

Migrazione delle cartelle di progetto di SourceSafe

Prima di procedere alla vera e propria conversione, personalizzare il file delle impostazioni in modo da includere le cartelle di destinazione per i progetti di SourceSafe specificati durante la preparazione alla conversione. Per completare questa attività, è necessario eseguire tutti i passaggi come descritto in Procedura dettagliata: preparazione alla migrazione da Visual SourceSafe a Team Foundation.

Per modificare il file delle impostazioni e creare un file di migrazione

  1. Fare clic sul pulsante Start, scegliere Programmi, Microsoft Visual Studio 2008, Visual Studio Tools, quindi Prompt dei comandi di Visual Studio 2008.

  2. Al prompt dei comandi digitare cd %LetteraUnità%\VSS2TeamFoundation. Questa cartella viene creata durante l'analisi del database di Visual SourceSafe per la migrazione. Per ulteriori informazioni, vedere Procedura dettagliata: preparazione alla migrazione da Visual SourceSafe a Team Foundation.

    Nota:

    Verificare che sull'unità di sistema sia disponibile spazio sufficiente per contenere la maggiore dimensione del file durante la migrazione.

  3. Salvare il file delle impostazioni creato per l'analisi, settings.xml, con un nuovo nome, ad esempio migration_settings.xml.

  4. Al prompt dei comandi digitare notepad migration_settings.xml, quindi premere INVIO.

    Il file settings.xml creato durante l'analisi del database per la migrazione viene visualizzato in Blocco note.

  5. Modificare il file delle impostazioni come segue.

    • Nella sezione <ProjectMap>, per ogni cartella di Visual SourceSafe di cui si esegue la migrazione, aggiungere le cartelle di destinazione in Controllo della versione di Team Foundation. Utilizzare il seguente formato, aggiungendo la sezione Destination come illustrato nel seguente esempio.

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

      Per migrare tutti i dati del database di Visual SourceSafe, inserire invece il seguente codice XML.

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

    • Nella sezione <Settings> aggiungere una sezione <TeamFoundationServer> e specificare il nome, la porta e il protocollo per il server Team Foundation Server di destinazione per la migrazione Utilizzare il seguente formato.

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

      Esempio:

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

      Se il database di Visual SourceSafe è di grandi dimensioni, la migrazione potrebbe avere esito negativo a causa del limite di 4 GB di SQLExpress. Per risolvere questo problema, impostare il convertitore in modo da utilizzare SQLServer anziché aggiungere la riga seguente: <SQL Server="nome_SQL_Server"></SQL>

  6. Rimuovere <Output file="Analysis.xml"></Output> dalla sezione <Settings o rinominare il file di output "migration_Analysis.xml".

    Il file migration_settings.xml deve assomigliare agli elementi seguenti:

    <?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>

    Assicurarsi di sostituire il nome del server per server name e un numero di porta effettivo per port number.

  7. Salvare le modifiche e chiudere il Blocco note.

Per eseguire il convertitore

  1. Copiare il database di Visual SourceSafe in una cartella locale nel computer sul quale si desidera eseguire l'analisi e la migrazione. Sebbene sia possibile eseguire la migrazione di un database di Visual SourceSafe in una cartella condivisa in un computer remoto, il processo sarà più lento.

  2. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio, quindi Visual Studio Tools e infine fare clic su Prompt dei comandi di Visual Studio.

  3. Al prompt dei comandi digitare quanto segue.

    VSSConverter Migrate migration_settings.xml

    Suggerimento:

    Utilizzare l'opzione /? per visualizzare le opzioni della riga di comando disponibili.

  4. Digitare Y per confermare la migrazione.

    Nello strumento di conversione viene visualizzato lo stato della migrazione. Al termine del processo di conversione, viene salvato un report sulla migrazione nella directory corrente. Per visualizzare il file per ulteriori informazioni, è possibile utilizzare Internet Explorer.

  5. Quando richiesto specificare la password per l'utente Admin di Visual SourceSafe.

    Nota:

    VSSConverter non esegue la migrazione delle associazioni di controllo della versione per le soluzioni Visual Studio. È necessario modificare manualmente queste associazioni. Per ulteriori informazioni, vedere Procedura: eseguire la migrazione delle associazioni del controllo del codice sorgente da Visual SourceSafe.

Vedere anche

Attività

Procedura: creare un file di impostazioni per l'analisi e la migrazione del controllo del codice sorgente

Concetti

Utilità da riga di comando VSSConverter per la migrazione dei controlli del codice sorgente

Altre risorse

Team Foundation - Documentazione