Uaktualnienie programu Visual SourceSafe przy użyciu narzędzia wiersza polecenia VSSUpgrade

W większości przypadków należy używać Kreatora uaktualnienia usługi VSS zamiast narzędzia wiersza polecenia VssUpgrade do uaktualnienia danych Visual SourceSafe.Istnieją jednak kilku przypadków kiedy należy użyć narzędzia wiersza polecenia VssUpgrade do uaktualnienia do lokalnego Team Foundation server (TFS).

Aby uaktualnić danych Visual SourceSafe przy użyciu VSSUpgrade

1. Zrozumieć, jak to narzędzie konwertuje dane TFS i Visual SourceSafe mają znaczne różnice funkcjonalne.W efekcie narzędzia uaktualnienia Visual SourceSafe zmodyfikować niektórych rodzajów danych podczas uaktualniania systemu.

2. Przygotowanie do uaktualnienia przed rozpoczęciem procesu uaktualniania, ważne jest planowanie z wyprzedzeniem, a następnie przygotuj dane.

   Ważne
   Należy uruchomić narzędzie analizy Visual SourceSafe na repozytorium Visual SourceSafe, przed podjęciem dalszych działań.Zobacz kopii i przygotować bazę danych Visual SourceSafe.

3. Więcej informacji o unikatowych funkcjach VssUpgrade.Jeśli nie jest potrzebny żadnego z nich, a następnie należy użyć Kreatora uaktualnienia usługi VSS zamiast.

4. Analizowanie danych przed przystąpieniem do uaktualniania danych z programu Visual SourceSafe do Kontrola wersji programu Team Foundation, należy użyć polecenia Analizuj, aby ustalić, czy wszelkie problemy w danych wpłynie na wyniku uaktualnienia systemu.Ten proces generuje również pliku mapowania użytkownika, który jest wymagany do uaktualnienia danych.

5. Uaktualnić dane w celu uaktualnienia danych, należy określić, jak nazwy użytkowników są uaktualniane, Utwórz plik ustawień migracji, a następnie uruchom polecenie Migrate.

6. Zobacz i sprawdź wyniki i rozwiązać problemy w razie potrzeby

Funkcje VssUpgrade

Użyj VssUpgrade, aby uaktualnić i port danych do lokalnego zespołu projektu i:

• Uaktualnienia w ramach zautomatyzowanego podejścia, taki jak skrypt.

• Migracja wielu projektów Visual SourceSafe do projektu jeden zespół, przy użyciu struktury folderów, który jest określony przez użytkownika.

• Określ sposób konwertowania danych użytkownika, na przykład z Kim w programie Visual SourceSafe do EUROPE\KimT w programie TFS.

• Ignoruj etykiety w danych Visual SourceSafe.

• Wznowić proces po został przerwany podczas uaktualniania dużą ilość danych — na przykład z powodu błędu sieciowego.

Jeśli nie jest potrzebny dowolnej z tych funkcji, lub jeśli potrzebujesz uaktualnienia i port danych do zespołu projektu na Team Foundation Service, należy użyć Kreatora uaktualnienia usługi VSS zamiast VssUpgrade.

Analizowanie danych

Przed uaktualnieniem danych z programu Visual SourceSafe do kontroli wersji TFS musi najpierw użyć polecenia Analizuj, aby ustalić, czy wszelkie problemy w danych wpłynie na wyniku uaktualnienia systemu.To polecenie generuje również pliku mapowania użytkownika korzystającego z polecenia migracji do uaktualnienia danych.

Utwórz plik ustawień analizy

Przed uruchomieniem polecenia analizy, należy utworzyć plik ustawień analizy.W tym pliku możesz określić ścieżkę bazy danych Visual SourceSafe, który uaktualni i foldery, które chcesz uaktualnić.

Następujący kod XML przedstawiono przykładowy plik ustawień analizy.

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
     <Source name="VSS">
          <VSSDatabase name="c:\ourvss"></VSSDatabase>
          <UserMap name="c:\ourvss\migrate\Usermap.xml"></UserMap>
     </Source>
     <ProjectMap>
          <Project Source="$/Core"></Project>
          <Project Source="$/ProjectA"></Project>
          <Project Source="$/ProjectB"></Project>
     </ProjectMap>
</ConverterSpecificSetting>
<Settings>
     <Output file="c:\ourvss\migrate\logs\ContosoVSSAnalyze.xml"></Output>
</Settings>
</SourceControlConverter>

Można skopiować z poprzedniego przykładu, wkleić go do własnego pliku ustawień Analizuj, a następnie zmodyfikuj go.Następujące informacje mogą pomóc w dostosowania w przykładzie do własnych potrzeb.

<? kodowanie xml > atrybut

<?xml encoding> Atrybut musi odpowiadać kodowania, który jest używany w pliku ustawień Analizuj.Na przykład, jeśli plik jest zapisywany w formacie Unicode <?xml encoding> tag jest następująca:

<?xml version="1.0" encoding="unicode">

< nazwa VSSDatabase > atrybut

W <VSSDatabase name> atrybut, należy określić ścieżkę folderu, który zawiera srcsafe.ini pliku dla kopii bazy danych Visual SourceSafe, uaktualniany. Na przykład:

<Source name="VSS">
   ...
   <VSSDatabase name="c:\ourvss"></VSSDatabase>
   ...
</Source>

Ścieżka nie może zawierać ciąg srcsafe.ini.Na przykład, następująca <VSSDatabase name> atrybut jest nieprawidłowy i spowoduje, że VssUpgrade polecenia nie powiedzie się:

<Source name="VSS">
   ...
   <VSSDatabase name="c:\ourvss\srcsafe.ini"></VSSDatabase>
   ...
</Source>

< nazwa UserMap > atrybut

Polecenie Analizuj zbiera i kompiluje danych o użytkownikach Visual SourceSafe i zapisuje go w pliku XML.Opcjonalnie można określić ścieżkę i nazwę pliku, w którym te dane przechowywane w <UserMap name> atrybut.Jeśli ten atrybut nie jest określony, polecenie Analizuj tworzy plik, który nazywa się UserMap.xml i umieszcza go w bieżącym katalogu.

<ProjectMap> sekcja

W <ProjectMap> sekcji, przechodząca przez każdy projekt Visual SourceSafe, który ma zostać uaktualniony w Source atrybut <Project> przedmiotu.

Aby uaktualnić wszystkie dane w bazie danych Visual SourceSafe, <ProjectMap> sekcji odpowiadają następującym przykładzie:

<ProjectMap>
   <Project Source="$/"></Project>
</ProjectMap>

Zamiast uaktualniać swoje pełne Visual SourceSafe bazy danych w tym samym czasie, można uaktualnić wybranych projektów w różnym czasie.

Porada
Ta opcja umożliwia unikanie zablokowania zespołu podczas uaktualniania, jeśli masz dużo danych do uaktualnienia.

Ścieżki w atrybutach źródła nie może nakładać się.Na przykład, następująca <ProjectMap> sekcja nie jest prawidłowy:

<ProjectMap>
   <Project Source="$/ProjectA"></Project>
   <Project Source="$/ProjectA/Controller"></Project>
</ProjectMap>

< plik wyjściowy > atrybut

W <Settings> sekcji w <Output file> atrybut, można określić ścieżkę i nazwę pliku, w którym raport analityczny do zapisania.Jeśli nie chcesz określać tej opcji, można pominąć <Output> tag.W takim przypadku konwerter zapisuje raport do pliku o nazwie VSSAnalysisReport.xml i umieszcza go w bieżącym katalogu.

<SQL> element

Należy określić bazę danych dla VssUpgrade do przechowywania danych tymczasowych przez dodanie <SQL> element, aby <Source> sekcja pliku ustawień Analizuj.Ten element używa następującej składni:<SQL Server="SQL_Server_name"></SQL>.

Na przykład, jeśli VssUpgrade są uruchomione na komputerze o nazwie FABRIKAM-2, aby użyć lokalnego wystąpienia programu SQL Server Express na tym samym komputerze:

<Source name="VSS">
   ...
   <SQL Server="fabrikam-2\sqlexpress"></SQL>
   ...
</Source>

Aby skierować konwertera, aby użyć programu SQL Server, na przykład serwer o nazwieFabrikamSQLServer

<Source name="VSS">
   ...
   <SQL Server="fabrikamsqlserver"></SQL>
   ...
</Source>

Uruchom polecenie Analizuj

1. Z systemu Windows Start, prowadzony polecenia jako administrator.

2. W Administrator: wiersz polecenia okna, wprowadź:

   VssUpgrade AnalyzeSettings.XML

   Zamień settings.xml z ścieżki i nazwy pliku ustawień Analizuj, który został utworzony.

3. Gdy zostanie wyświetlony monit, wpisz hasło administratora dla bazy danych Visual SourceSafe.Jeśli bazy danych nie ma hasła, naciśnij klawisz Enter.

VssUpgrade Wyświetla stan bieżących jako przychody polecenie Analizuj.Po zakończeniu procesu system podsumowanie wyników.Na przykład:

Analyze complete.
Analyzed 859 files and 941 folders.
Warnings 0 and Errors 0
Pre-migration report file: C:\VSS\migrate\VSSAnalysisReport.xml

Gdyby było żadnych ostrzeżeń i błędów, można znaleźć szczegółowe informacje o nich w ConverterErrors.txt i VSSUpgrade.log.

To polecenie Analizuj generuje:

• Raport, który można użyć, aby uzyskać szczegółowe informacje dotyczące ewentualnych problemów i zmian, które mogą powodować polecenie Migrate.

• Plik mapowania użytkownika (Usermap.xml), które służy do określania, jak zostaną przekonwertowane dane użytkownika podczas procesu uaktualniania.

Pliki te zostały omówione bardziej szczegółowo poniżej.

Przejrzyj i rozwiązania problemów znalezionych przez polecenia analizy

Raport analityczny zawiera informacje o problemach w swojej bazy danych Visual SourceSafe, który może powodować problemy podczas procesu uaktualniania.Spróbuj rozwiązać jako wiele z tych problemów jak to możliwe, aby zminimalizować problemy z procesu uaktualniania w sposób opisany w następnej sekcji.

Niektóre pliki są wyewidencjonowany

Raport zawiera listę plików, które zostały wyewidencjonowane.Proces uaktualniania nie zostaną zachowane informacje o realizacji transakcji.Spróbuj zapewniają, że wiele plików, jak to możliwe są sprawdzane przed uaktualnieniem.

Niektóre elementy mają problemy integralności danych

Raport zawiera listę elementów, których integralność danych został złamany.Narzędzie Visual SourceSafe ANALIZOWAĆ może być może w celu rozwiązania problemów tego rodzaju.Elementy, które nie mogą być naprawiane nie będą uaktualnione.Aby uzyskać więcej informacji, zobacz następujące strony w witrynie firmy Microsoft w sieci Web: ANALIZOWANIE Utility i jak Wykryj i napraw błędy uszkodzenia bazy danych w programie Visual SourceSafe.

Niektóre foldery w mapowane projektów zawierają historii, która jest nie uwzględnione w <ProjectMap> sekcja

Jeśli folder jest przenoszony z jednego projektu do drugiego w Visual SourceSafe bazy danych, historii ten folder znajduje się w oryginalnym i bieżące projekty.Aby uaktualnić takiego folderu ze wszystkimi jego historii, należy uaktualnić oryginalny i bieżące projekty.

Na przykład w przypadku uaktualniania Visual SourceSafe projektu projekcie 2.Ten projekt zawiera folder $/ projekcie 2/FeatureA, który został przeniesiony z projektu1 w pewnym momencie w swojej historii.

Jeśli Twój <ProjectMap> zawiera sekcja...	Na przykład...	Następnie...
Oba projekty.	<ProjectMap> <Project Source="$/Project1"></Project> <Project Source="$/Project2"></Project> </ProjectMap>	Folder jest wzbogacona o swojej pełnej historii.
Projekt, który pierwotnie zawierał folder, ale nie w projekcie, które obecnie go zawiera.	<ProjectMap> <Project Source="$/Project1"></Project> </ProjectMap>	Folder nie jest uaktualniony.
Projekt zawiera to obecnie folderu, ale nie od projektu, który początkowo zawierał.	<ProjectMap> <Project Source="$/Project2"></Project> </ProjectMap>	Folder jest uaktualniany wraz z jego historią, począwszy od, kiedy została ona przeniesiona do bieżącego projektu.Historia, które miały miejsce przed folder został przeniesiony do bieżącego projektu nie jest uaktualniony.

Aby uzyskać więcej informacji o <ProjectMap> sekcji pliku ustawień, zobacz <ProjectMap> Sekcja wcześniej w tym temacie.

Niektóre nazwy etykiety nie są obsługiwane przez kontrolę wersji Team Foundation

Raport zawiera listę nazw etykiet, które zmienią się, gdy są one uaktualniane, ponieważ zawierają znaki, których nie obsługuje TFS kontroli wersji.Zobacz Ograniczenia nazewnictwa w Team Foundation.

Uaktualnić dane

Po uruchomieniu polecenia analizy są prawie gotowe do uaktualnienia danych.Przed uruchomieniem polecenia migracji, należy utworzyć plik ustawień.Opcjonalnie można określić, jak nazwy użytkowników są uaktualniane.

Określ, jak nazwy użytkowników są uaktualniane.

Można kontrolować, jak informacje o użytkowniku jest uaktualniany z Visual Source Safe do kontroli wersji TFS.W szczególności można określić nazwę użytkownika, co polecenie Migrate należy skojarzyć z każdego zestawu zmian w historii każdego elementu w programie TFS kontroli wersji.W tym celu edycji pliku mapowania użytkownika, który został utworzony po uruchomieniu polecenia analizy, jak wyjaśniono wcześniej w tym temacie.

Plik mapowania użytkownika jest opcjonalne.Jeżeli pominięto <UserMap name> atrybut z Analizuj plik ustawień każdego zestawu zmian jest zbudowany w następujący sposób:

• Pole użytkownika jest ustawiona na nazwę konta, na którym uruchomiono VssUpgrade.

• Nazwa użytkownika, który te czynności wykonał w bazie danych Visual SourceSafe jest przechowywana w polu komentarz.

Przykład pliku mapowania użytkownika

Po uruchomieniu polecenia analizy danych o użytkownikach Visual SourceSafe kompiluje i przechowuje je w pliku XML.Plik ten zawiera listę każdego użytkownika Visual SourceSafe, który kiedykolwiek wykonał operację kontroli wersji w projekty Visual SourceSafe, które w przypadku uaktualniania.

W poniższym przykładzie przedstawiono plik mapowania użytkownika, który został utworzony przez polecenie Analizuj.

<?xml version="1.0" encoding="utf-8"?>
<UserMappings>
   <UserMap From="Admin" To=""></UserMap>
   <UserMap From="Guest" To=""></UserMap> 
   <UserMap From="Kim" To=""></UserMap>
   <UserMap From="Satomi" To=""></UserMap>
   <UserMap From="Mark" To=""></UserMap>
</UserMappings>

Można określić To atrybut none, niektóre lub wszystkie UserMap elementów w pliku mapowania użytkownika.Na przykład można zmodyfikować poprzedniego przykładu, w następujący sposób:

<?xml version="1.0" encoding="utf-8"?>
<UserMappings>
   <UserMap From="Admin" To="NORTHAMERICA\KenM"></UserMap>
   <UserMap From="Guest" To="Test1"></UserMap> 
   <UserMap From="Kim" To="EUROPE\KimT"></UserMap>
   <UserMap From="Satomi" To="ASIA\SatomiH"></UserMap>
   <UserMap From="Mark" To=""></UserMap>
</UserMappings>

Należy zauważyć, że w poprzednim przykładzie, Guest jest mapowany na Test1, a domena nie zostanie określona.W takich przypadkach VssUpgrade zakłada, że konto należy do domeny domyślnej.

Jeśli nie określisz <UserMap To> atrybut każdego zestawu zmian jest zbudowany w następujący sposób:

• Pole użytkownika jest ustawiona na nazwę tego konta, z którego uruchomiono VssUpgrade.

• Nazwa użytkownika, który wykonał akcję w swojej Visual SourceSafe baza danych jest przechowywana w polu komentarz.

• Jeśli określisz <UserMap To> atrybut i wartość jest prawidłowym użytkownikiem na Twój Team Foundation Server, pole użytkownika jest ustawiona na nazwę tego konta.Jeśli wartość nie jest prawidłowym użytkownikiem na Twój Team Foundation Server, VssUpgrade zostanie zwrócony komunikat o błędzie i zakończyć proces uaktualniania.

Utwórz plik ustawień migracji

Plik ustawień migracji umożliwia określenie danych Visual SourceSafe, co chcesz uaktualnić i kontrolować kilka aspektów, jak chcesz ją uaktualnić.Najprostszym sposobem utworzenia tego pliku jest skopiowanie pliku, który został utworzony w Utwórz plik ustawień analizy wcześniej w tym temacie.Następnie dodasz więcej danych do pliku, aby mógł być używany przez polecenie migracji.

Pliki ustawień migracji można znaleźć w poniższym przykładzie.

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
     <Source name="VSS">
          <VSSDatabase name="c:\ourvss"></VSSDatabase>
          <UserMap name="c:\ourvss\migrate\Usermap.xml"></UserMap>
     </Source>
     <ProjectMap>
          <Project Source="$/Core" Destination="$/CoreTeamProject"></Project>
          <Project Source="$/ProjectA" Destination="$/ClientTeamProject/ProjectA"></Project>
          <Project Source="$/ProjectB" Destination="$/ClientTeamProject/ProjectB"></Project>
     </ProjectMap>
</ConverterSpecificSetting>
<Settings>
     <TeamFoundationServer name="My_Server" port="8080" protocol="http" collection="tfs/DefaultCollection"></TeamFoundationServer>
     <Output file="c:\ourvss\migrate\logs\ContosoVSSMigrate.xml"></Output>
</Settings>
</SourceControlConverter>

Następujące informacje mogą pomóc w zmodyfikować plik ustawień migracji, aby określić, jak polecenie Migrate uaktualni Twoje dane.

<ProjectMap>

Dla każdego <Project> element w <ProjectMap> sekcji pliku ustawień migracji zapewnić Destination atrybut, aby określić ścieżkę do lokalizacji na Twój Team Foundation Server, na którym chcesz dokonać aktualizacji projektu w bazie danych Visual SourceSafe (określonego w Source atrybut).

Na przykład chcesz uaktualnić zawartość ProjectA w bazie danych Visual SourceSafe do ProjectA w katalogu głównym projektu zespołu, który nazywa się Client.

<ProjectMap>
   <Project Source="$/ProjectA" Destination="$/ClientTeamProject/ProjectA"></Project>
</ProjectMap>

Dla wartości w atrybucie docelowym było ważne muszą być spełnione następujące warunki:

• Zespół projektu w Destination atrybutu (w poprzednim przykładzie zespołu projektu jest ClientTeamProject) już musi znajdować się w Kolekcja projektów zespołu, przed rozpoczęciem procesu uaktualniania.

• Ścieżka w Destination atrybutu <Project> element nie może nakładać się ścieżkę w Destination atrybut wszelkich innych <Project> elementy.Na przykład, następująca <ProjectMap> sekcja nie jest prawidłowy:

  <ProjectMap>
     <Project Source="$/ProjectA" Destination="$/ClientTeamProjectA/"></Project>
     <Project Source="$/ProjectB" Destination="$/ClientTeamProjectA/ProjectB"></Project>
  </ProjectMap>
  

[!UWAGA]

Jeśli folder, w Destination atrybut zawiera wszystkie elementy, a jeśli ścieżka do żadnego przedmiotu Visual Source Safe pokrywa się ze ścieżką kontroli wersji do dowolnego z tych elementów, proces uaktualniania zakończy się niepowodzeniem.

<TeamFoundationServer> Tag

W <Settings> sekcji, dodać <TeamFoundationServer> tag i określić nazwę, port, protokół i ścieżkę do Kolekcja projektów zespołu na Twój Team Foundation Server przy użyciu następującego formatu:

<TeamFoundationServer name="ServerName" port="PortNumber" protocol="http" collection="path/collection name></TeamFoundationServer>

< migracji etykieta = "false" / > Tag

Jeśli baza danych Visual SourceSafe zawiera wiele etykiet, które są stosowane do wielu plików, może zostać przedłużony procesu uaktualniania.Jeśli zespół nie potrzebuje tych danych, można skonfigurować w VssUpgrade, aby zignorować etykiet przez dodanie <Label migrate="false" /> znacznika <Settings> sekcji.

< plik wyjściowy > atrybut

W <Settings> sekcji w <Output file> atrybut, można określić ścieżkę i pliku, którym ma być zapisany raport o uaktualnieniu.Jeśli atrybut zostanie pominięta, konwerter zapisuje raport w pliku o nazwie VSSMigrationReport.xml i umieszcza go w bieżącym katalogu.

Uruchom polecenie migracji

1. Z systemu Windows Start, prowadzony polecenia jako administrator.

2. W Administrator: wiersz polecenia okna, wprowadź:

   VssUpgrade MigrateSettings.XML

   Zamień settings.xml z ścieżki i nazwy pliku ustawień migracji, który został utworzony.

   Polecenie Migrate wyświetla każdy projekt, który jest uaktualniana Twój Visual SourceSafe bazy danych i każdego folderu, do którego zostaną uaktualnione dane na serwerze dla Kontrola wersji programu Team Foundation.

3. Gdy zostanie wyświetlony monit, wpisz hasło administratora dla bazy danych Visual SourceSafe.Jeśli bazy danych nie ma hasła, naciśnij klawisz Enter.

4. System zawiera podsumowanie to działanie procesu uaktualniania i prosi o potwierdzenie, że chcesz kontynuować.Na przykład:

   This will start migration with following inputs:
   
   SourceSafe Folders -> Team Foundation Server Folders
   
   $/ -> $/Sequence2
   
   Full history migration of VSS Database: c:\vss
   
   Team Foundation Server: http://fabrikam-4:8080/tfs/DefaultCollection
   Migration Settings File: migrate_settings.xml
   Migration Report: C:\VSS\migrate\VSSMigrationReport.xml
   
   Depending on the VSS database size, migration may take few hours to complete.
   Please verify all inputs are correct and confirm.
   Start migration (Y/N)?
   

   Naciśnij Y aby kontynuować.

VssUpgrade Wyświetla stan bieżących jako przychody polecenia migracji.Po zakończeniu procesu system podsumowanie wyników.Na przykład:

Verification of pinned versions: 0 file(s) added, 0 file(s) edited and 86 file(s) label updated
Verification of latest tip versions: No change was required (No fixes required. All latest tip versions were migrated successfully)

Started: Creating label "Pinned_Latest".
Finished: Creating label "Pinned_Latest".

Migration complete.
Migrated 6397 Actions
Warnings 7 and Errors 0
Post migration report file: C:\VSS\migrate\VSSMigrationReport.xml

Gdyby było żadnych ostrzeżeń i błędów, można znaleźć szczegółowe informacje o nich w ConverterErrors.txt i VSSUpgrade.log.

Polecenie Migrate generuje raport, który można użyć, aby uzyskać szczegółowe informacje dotyczące ewentualnych problemów i zmian, które mogą być przyczyną polecenie Migrate.Zobacz Wykonywanie czynności następujących po uaktualnieniu programu Visual SourceSafe.

Wznowić proces przy użyciu aktualizacji przyrostowych

W przypadku przerwania procesu uaktualniania z jakiegoś powodu można wznowić proces jako przyrostowe uaktualnienie od punktu, w którym proces zakończył się.Przyrostowe uaktualnienie może być przydatne, jeśli proces uaktualniania nie powiodła się z powodu błędu lub problemów z siecią.Podczas uaktualniania przyrostowe konwerter uaktualni tylko dane, które nie została uaktualniona w poprzednich sesjach.

Aby rozpocząć uaktualnianie przyrostowe, należy wykonać kroki opisane w uruchomić polecenie Migrate.Gdy polecenie Migrate pyta, czy chcesz dokonać migracji przyrostowe, naciśnij klawisz Y.

Ograniczenia przyrostowej aktualizacji

Przyrostowe uaktualnienie nie powiedzie się, jeśli nie spełnia następujące ograniczenia:

• W bazie danych Visual SourceSafe, użytkownik nie musiał wykonywać niszczenia, przeczyścić, archiwizować lub przywrócenia działania.

• Nie można zmienić <ProjectMap> sekcja pliku ustawień migracji.

• Na Twój Team Foundation Server, należy nie zmodyfikować wszystkie foldery (lub treści w folderach), które są określone w <ProjectMap> sekcja pliku ustawień migracji.

Następny krok

Zobacz i sprawdź wyniki i rozwiązać problemy w razie potrzeby