Procedura dettagliata: preparazione alla migrazione da Visual SourceSafe a Team Foundation
Aggiornamento: novembre 2007
Lo strumento di conversione Visual SourceSafe di Team Foundation consente di trasferire file, cartelle, cronologia delle versioni e informazioni sull'utente da un database di Visual SourceSafe a un server di Controllo della versione di Team Foundation. Prima di spostare file e informazioni cronologiche in Team Foundation, è necessario esaminare ed eseguire una copia di backup del database, archiviare il maggior numero di file possibile e determinare quali informazioni non possono essere trasferite da Visual SourceSafe a Team Foundation.
In questa procedura dettagliata viene descritto come preparare il database di Visual SourceSafe per la conversione e come utilizzare VSSConverter per pianificare in modo efficace la migrazione effettiva del codice sorgente.
Nel corso di questa procedura dettagliata si completeranno le seguenti attività:
Back up del database di Visual SourceSafe in uso.
Identificazione e risoluzione dei problemi relativi all'integrità dei dati nel database esistente utilizzando lo strumento Analyze di Visual SourceSafe.
Esecuzione dello strumento di conversione per identificare le potenziali cause di perdita delle informazioni.
Specifica delle cartelle di Visual SourceSafe di cui eseguire la migrazione.
Creazione di un file di mapping utenti per eseguire il mapping degli utenti di Visual SourceSafe con gli utenti di Team Foundation.
Prerequisiti
Per completare questa procedura è necessario che nel computer in cui si intende eseguire VSSConverter.exe sia installato il seguente software:
Team Explorer
Accesso al computer con credenziali amministrative
SQL Server Express
.gif "Nota")
Nota:Per impostazione predefinita, SQL Server Express viene installato durante l'installazione di Visual Studio 2005 o Visual Studio 2008
Visual SourceSafe 2005 o versioni successive
Il database di Visual SourceSafe da analizzare. Il formato del database deve essere versione 6.0 o successiva. Per completare questa procedura dettagliata, è necessario eseguire la conversione nello stesso computer del database di Visual SourceSafe.
È inoltre necessario:
La password dell'amministratore per il database di Visual SourceSafe contenente i progetti da analizzare.
Nota:Gli altri utenti non devono accedere al database di Visual SourceSafe durante il processo di analisi. Non bloccare il database dal momento che una simile situazione impedisce l'accesso del convertitore al database per la migrazione.
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" sul sito Web Microsoft all'indirizzo https://go.microsoft.com/fwlink/?LinkId=99103 (informazioni in lingua inglese).
Preparazione del database di Visual SourceSafe
Prima di trasferire i file inclusi nel controllo del codice sorgente da Visual SourceSafe a Microsoft Visual Studio Team System, completare le attività riportate di seguito in Visual SourceSafe.
Richiedere l'archiviazione dei file a tutti gli utenti del database.
Creare una copia di backup del database di Visual SourceSafe di cui eseguire la migrazione. Per ulteriori informazioni, vedere "How To Back Up a Visual SourceSafe Database" nel sito web Microsoft (https://go.microsoft.com/fwlink?linkid=51358) (informazioni in lingua inglese).
Utilizzare l'utilità Analyze di Visual SourceSafe per individuare e risolvere i problemi relativi all'integrità dei dati nel database. Per ulteriori informazioni sull'utilizzo dello strumento, vedere "Utilità ANALYZE" (https://msdn2.microsoft.com/it-it/library/ysxsfw4x(VS.80).aspx) e "How to: Detect and Fix Database Corruption Errors in Visual SourceSafe" (https://go.microsoft.com/fwlink/?linkid=51357) (informazioni in lingua inglese).
Analisi dei progetti
VSSConverter.exe è uno strumento della riga di comando per il quale sono richiesti gli input riportati di seguito:
Percorso della cartella in cui è contenuto il file srcsafe.ini per il database di Visual SourceSafe in fase di migrazione.
File basato su XML contenente le impostazioni.
VSSConverter.exe è archiviato in <directory principale>:\Program Files\Microsoft Visual Studio 9.0 \Common7\IDE, ma è richiamato dal prompt dei comandi di Visual Studio.
In questa procedura dettagliata si presuppone che il percorso del database di Visual SourceSafe in uso sia c:\VSSDatabase.
Dopo avere stabilito i progetti da analizzare, creare un file in cui inserire le impostazioni. In questo file vengono elencati i progetti da analizzare mediante il convertitore.
Per creare il file di impostazioni per l'analisi
Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2008, Visual Studio Tools, quindi Prompt dei comandi di Visual Studio 2008.
Al prompt dei comandi digitare mkdir %LetteraUnità%\VSS2TeamFoundation, dove %LetteraUnità% è l'unità corrente. Premere INVIO.
Al prompt dei comandi digitare cd %LetteraUnità%\VSS2TeamFoundation. Premere INVIO.
Digitare notepad settings.xml, quindi premere INVIO.
Scegliere Sì per creare il file.
Copiare l'XML riportato di seguito, in cui $/FolderA e $/FolderB rappresentano i nomi delle cartelle contenenti i progetti di cui eseguire la migrazione.
<?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:Per eseguire la migrazione di tutto il database, utilizzare <Project Source="$/"></Project>.
Per il tag < VSSDatabase name> immettere il percorso al database Visual SourceSafe.
Salvare le modifiche e chiudere il Blocco note.
Successivamente, eseguire lo strumento di conversione dal prompt dei comandi di Visual Studio per analizzare il progetto, come illustrato nei passaggi riportati di seguito.
L'analisi deve essere eseguita da un amministratore di sistema per SQLExpress. Per impostazione predefinita, all'utente che installa Visual Studio vengono assegnati i privilegi necessari per SQLExpress.
Una volta ottenuto il file delle impostazioni di migrazione e i diritti di amministratore di sistema, sarà possibile eseguire lo strumento di conversione per analizzare il progetto.
Per analizzare il progetto con il convertitore
Al prompt dei comandi di Visual Studio, digitare il comando seguente:
VSSConverter Analyze settings.xml
Quando richiesta, specificare la password di amministratore di Visual SourceSafe.
Nello strumento di conversione viene visualizzato lo stato dell'analisi di preconversione. Al termine, viene generato un report (VSSAnalysisReport.xml) e un file di mapping utenti (usermap.xml) ed entrambi vengono salvati nella directory corrente. È possibile utilizzare il file di mapping per eseguire il mapping tra gli utenti di Visual SourceSafe e quelli di Team Foundation. Per ulteriori informazioni, vedere Procedura: modificare il file di mapping utenti per la migrazione del controllo del codice sorgente.
Passaggi successivi
È ora possibile eseguire la migrazione delle informazioni nel database di Visual SourceSafe all'interno del server di Controllo della versione di Team Foundation. Per ulteriori informazioni, vedere la classe Procedura dettagliata: migrazione da Visual SourceSafe a Team Foundation.
Vedere anche
Attività
Procedura dettagliata: migrazione da Visual SourceSafe a Team Foundation
Concetti
Utilità da riga di comando VSSConverter per la migrazione dei controlli del codice sorgente