연습: Visual SourceSafe에서 Team Foundation으로 마이그레이션

아티클
08/20/2008

업데이트: 2007년 11월

이 연습에서는 VSS 변환기 도구인 VSSConverter.exe를 사용하여 Visual SourceSafe에서 Team Foundation으로 마이그레이션하는 방법에 대해 설명합니다. 데이터베이스 마이그레이션을 준비하는 방법에 대한 자세한 내용은 연습: Visual SourceSafe에서 Team Foundation으로 마이그레이션 준비를 참조하십시오. 이 연습에서는 Team Foundation으로 마이그레이션할 수 있도록 SourceSafe 데이터베이스와 사용자 목록을 준비하는 방법에 대해 자세히 알고 마이그레이션 프로세스가 진행되는 과정을 깊이 있게 이해할 수 있습니다.

이 연습에서는 다음 작업을 수행합니다.

설정 파일을 수정하여 마이그레이션할 폴더를 지정합니다.
변환기를 실행하여 Visual SourceSafe에서 Team Foundation으로 소스를 마이그레이션하고 마이그레이션 보고서를 생성합니다.

사전 요구 사항

이 연습을 진행하려면 먼저 다음 작업을 수행해야 합니다.

연습: Visual SourceSafe에서 Team Foundation으로 마이그레이션 준비에서 설명하는 모든 단계를 수행합니다.
Team Foundation 버전 제어에서 Visual SourceSafe 폴더를 마이그레이션할 빈 폴더를 지정합니다. 대상 폴더가 없으면 변환기에서 이 폴더가 자동으로 생성됩니다. 단, 대상 폴더가 팀 프로젝트인 경우는 예외입니다. 대상 폴더는 유효한 팀 프로젝트이거나 유효한 팀 프로젝트의 하위 폴더여야 합니다. 자세한 내용은 방법: 팀 프로젝트 만들기를 참조하십시오.

또한 다음 사항을 준비해야 합니다.

Team Foundation Server 이름을 알아 둡니다.
변환기를 실행하려는 컴퓨터에 SQL Server Express를 설치해야 합니다.

Microsoft Visual Studio Team System을 설치하면 기본적으로 SQL Express가 설치됩니다.

변환기 도구를 사용하려면 SQLExpress 데이터베이스에 연결하는 데 필요한 관리 권한이 있어야 합니다.
VSSConverter를 실행하는 컴퓨터에 Visual SourceSafe 2005가 있어야 합니다.

필요한 권한

이 연습을 수행하려면 마이그레이션할 Visual SourceSafe 데이터베이스에 대한 관리 권한이 있어야 합니다. 자세한 내용은 Microsoft 웹 사이트(https://go.microsoft.com/fwlink/?LinkId=99103)의 "How to: Assign Project Rights"를 참조하십시오. 또한 SQL Express에 대해 sysadmin 서버 역할의 멤버여야 합니다. 기본적으로 SQL Express가 설치된 컴퓨터에서 Administrators 보안 그룹의 멤버는 sysadmin 서버 역할의 멤버이기도 합니다. 자세한 내용은 Microsoft 웹 사이트(https://go.microsoft.com/fwlink/?LinkId=60405)의 SQL Server 2005 설명서에서 "sysadmin"을 참조하십시오.

SourceSafe 프로젝트 폴더 마이그레이션

실제 변환 작업을 진행하려면 먼저 변환을 준비할 때 지정한 SourceSafe 프로젝트에 대한 대상 폴더가 포함되도록 설정 파일을 사용자 지정해야 합니다. 이 작업을 수행하려면 연습: Visual SourceSafe에서 Team Foundation으로 마이그레이션 준비에서 설명하는 모든 단계를 마쳐야 합니다.

설정 파일을 수정하여 마이그레이션 파일을 만들려면

시작, 프로그램을 클릭하고 Microsoft Visual Studio 2008, Visual Studio Tools를 차례로 가리킨 다음 Visual Studio 2008 명령 프롬프트를 클릭합니다.
명령 프롬프트에 cd %DriveLetter%\VSS2TeamFoundation을 입력합니다. 이 폴더는 Visual SourceSafe 데이터베이스를 마이그레이션하려고 분석할 때 이미 만들어졌습니다. 자세한 내용은 연습: Visual SourceSafe에서 Team Foundation으로 마이그레이션 준비를 참조하십시오.

참고:

마이그레이션 대상 중 가장 큰 파일을 저장하기에 충분한 공간이 시스템 드라이브에 확보되어 있는지 확인합니다.
분석을 위해 만든 설정 파일 settings.xml을 migration_settings.xml 같은 새 이름으로 저장합니다.
명령 프롬프트에 notepad migration_settings.xml을 입력하고 Enter 키를 누릅니다.

데이터베이스를 마이그레이션하려고 분석할 때 만들어진 settings.xml 파일이 메모장에 표시됩니다.

참고:
마이그레이션 대상 중 가장 큰 파일을 저장하기에 충분한 공간이 시스템 드라이브에 확보되어 있는지 확인합니다.

설정 파일을 다음과 같이 변경합니다.

<ProjectMap> 섹션에서 마이그레이션할 각 Visual SourceSafe 폴더마다 Team Foundation 버전 제어의 대상 폴더를 추가합니다. 다음 형식을 사용하여 아래 예제에서와 같이 Destination 섹션을 추가합니다.
```
<Project Source="$/FolderA" Destination="$/Team_Project"></Project>
```
Visual SourceSafe 데이터베이스의 모든 항목을 마이그레이션하려면 다음과 같은 XML을 대신 삽입합니다.
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```

<Settings> 섹션에서 <TeamFoundationServer> 섹션을 추가하고 마이그레이션할 Team Foundation Server의 이름, 포트 및 프로토콜을 지정합니다. 다음 형식을 사용합니다.

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

예를 들면 다음과 같습니다.

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

참고:
Visual SourceSafe 데이터베이스의 크기가 큰 경우 SQLExpress의 4GB 제한 때문에 마이그레이션에 실패할 수도 있습니다. 이 문제를 해결하려면 <SQL Server="SQL_Server_name"></SQL> 줄을 추가하여 컨버터에서 SQLServer를 사용하도록 설정합니다.

<Settings> 섹션에서 <Output file="Analysis.xml"></Output>을 제거하거나 출력 파일 이름을 "migration_Analysis.xml"로 변경합니다.

migration_settings.xml 파일은 다음과 같습니다.

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

server name은 사용 중인 서버 이름으로, port number는 실제 포트 번호로 바꾸어야 합니다.

변경 내용을 저장하고 메모장을 닫습니다.

변환기를 실행하려면

분석과 마이그레이션을 실행하려는 컴퓨터의 로컬 폴더로 Visual SourceSafe 데이터베이스를 복사합니다. 원격 컴퓨터의 공유 폴더에서 Visual SourceSafe 데이터베이스를 마이그레이션할 수도 있지만 이렇게 하면 마이그레이션을 마치는 데 시간이 훨씬 더 오래 걸립니다.
시작, 모든 프로그램을 차례로 클릭하고 Microsoft Visual Studio, Visual Studio Tools를 가리킨 다음 Visual Studio 명령 프롬프트를 클릭합니다.
명령 프롬프트에 다음과 같이 입력합니다.

VSSConverter Migrate migration_settings.xml

팁:

/? 스위치를 사용하면 사용 가능한 명령줄 옵션을 볼 수 있습니다.
Y를 입력하여 마이그레이션을 수행하도록 확인합니다.

변환기 도구에 마이그레이션 상태가 표시됩니다. 변환 프로세스가 끝나면 마이그레이션 보고서가 현재 디렉터리에 저장됩니다. Internet Explorer를 사용하여 파일에 있는 자세한 정보를 볼 수 있습니다.

팁:
/? 스위치를 사용하면 사용 가능한 명령줄 옵션을 볼 수 있습니다.

메시지가 나타나면 Visual SourceSafe 관리 사용자의 암호를 입력합니다.

참고:
VSSConverter에서는 Visual Studio 솔루션의 버전 제어 바인딩을 마이그레이션하지 않습니다. 따라서 이러한 바인딩은 수동으로 변경해야 합니다. 자세한 내용은 방법: Visual SourceSafe에서 소스 제어 바인딩 마이그레이션을 참조하십시오.

참고 항목

Share via