(연관된 글이 2개 있습니다.)
신규 프로젝트는, 어찌 보면 정말 편한 작업입니다. ^^
모든 것을 새로 시작한다는 것은, 모든 것이 "임의 재량"으로 처리할 수 있다는 것이니까요.
하지만, 기존 프로젝트는 그렇지 못하죠.
소스 제어를 바꾸는 것만 해도, 기존 프로젝트는 그다지 자유롭지 않습니다.
왜냐하면,
- 소스 제어 간의 명시적인 변환 방법이 존재해야 하고,
- 변환 간에 충돌이 없어야 하며,
- 현재 팀 단위로 엮어져 있는 경우, 모든 팀원들의 소스 제어를 정상적으로 바꿔야 하는 데다,
; 이런 경우, 스스로 알아서 소스 제어를 바꿔주는 "착한" 팀원은 많지 않습니다. ^^
; 대개 팀장이 그 팀원 자리에 가서 이러이러하게 하라고 알려줘야 하지요.
; 팀장 대행으로 누군가를 시키면... 꼭 도중에 물어보러 옵니다. "어... 팀장님... 저 팀원 자리에서는 뭔가 잘 안 되는데요."
; 그럼, 팀장이라고 무슨 뾰족한 수가 있겠습니까... 찬찬히 살펴보고 문제 해결을 위한 여러 가지 시도를 해보고... 그러다 수정을 하게 되는 것이지요.
; 그런데... 그런 것을 팀장 대행은 하려 하지 않습니다. ^^
- 현재 진행 중인 프로젝트라면 더더욱 문제가 됩니다. (프로젝트 중요도에 따라서 신중하게 생각하고 결정해야 할 것입니다.)
이런저런 이유로, 사실 신기술을 처음 부터 사용하는 사람보다, 기존 기술을 신기술에 맞춰서 하는 경우가 드물어 질 수밖에 없을 텐데요.
저 역시, 이제서야 VSS 2005에서 TFS SourceControl로 마이그레이션을 해보게 되었습니다.
상세한 마이그레이션 작업은 MSDN 도움말에 잘 나와 있기 때문에 생략하고. ^^
저는 일의 순서만을 나열해 보겠습니다. 개인적으로도, 다음에 이 게시물을 보고 확인할 수 있도록. ^^
1. 우선, 현재의 VSS 2005의 데이터베이스를 백업합니다. 모든 개발자들이 체크인 및 최종 빌드를 완료하고, 해당 VSS DB를 폴더 통째로 다른 곳에 복사를 해 둡니다.
2. 이제, 마이그레이션을 진행할 VSS DB에 결함이 없는 지를 체크합니다. 이를 위해, VSS 2005에서는 "ANALYZE Utility"를 제공해 주고 있습니다. 구체적인 방법은 다음의 토픽을 참조하십시오.
Visual SourceSafe - ANALYZE Utility
; http://msdnwiki.microsoft.com/en-us/mtpswiki/ysxsfw4x.aspx
대강 내용을 정리해 보면, 아래와 같은 데요.
- Analyzes and repairs the complete database and generates verbose output:
C:\>analyze -C -D -F -V4 C:\VSS\Data
- Analyzes the database, but does not repair it, and creates a list of corrupted files in C:\Temp:
C:\>analyze -BC:\Temp C:\VSS\Data
Repairs any problems in the files listed in the Analyze.bad file generated by the preceding example:
C:\>analyze -F -C -D @C:\VSS\Data\Backup\Analyze.bad C:\VSS\Data
우선, "-B" 옵션을 이용해서 검사만 해봅니다. 만약 문제 보고가 심각하다면 해당 사항에 대해서 면밀히 검토를 해봐야 겠지만. 아마도 대부분 사소한 결함만이 있을 텐데, "-C -D -F -V4" 옵션으로 문제 수정을 해줍니다.
3. "테스트" 마이그레이션을 진행합니다. 자세한 사항은 다음의 토픽을 참조하십시오.
Visual Studio Team System - Walkthrough: Preparing to Migrate from Visual SourceSafe to Team Foundation
;
http://msdnwiki.microsoft.com/en-us/mtpswiki/ms181246.aspx
이 테스트를 진행하기 위해서는, 마이그레이션 대상 VSS DB를 지정하는 XML 파일을 만들어야 합니다. 대강 예제 XML 파일 - (일례로, settings.xml)은 다음과 같습니다.
<?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>
</SourceControlConverter>
"테스트" 마이그레이션은 다음과 같은 명령어를 입력하면 됩니다.
VSSConverter Analyze settings.xml
테스트 결과와 함께, 해당 VSS DB에 권한을 가진 사용자 계정에 대한 목록을 담은 usermap.xml 파일이 생성됩니다.
4. "Analyze" 옵션을 주어서 실행한 "VSSConverter.exe" 결과가 정상이면, 이제서야 실제적인 마이그레이션을 해볼 수가 있습니다. 역시 구제적인 작업은 다음의 토픽을 참조하십시오.
Visual Studio Team System
Walkthrough: Migrating from Visual SourceSafe to Team Foundation
; http://msdnwiki.microsoft.com/en-us/mtpswiki/ms181247.aspx
이 단계에서는 기존에 작성했던 settings.xml 파일과 "Analyze" 결과로 생성된 usermap.xml 파일을 약간 편집해야 합니다. settings.xml의 경우에는, 대상 TFS 서버에 대한 정보와 마이그레이션 중에 사용될 임시 SQL Server DB를 지정해 주어야 하고, usermap.xml은 더 이상 필요하지 않은 사용자 계정이 있거나, 대상 TFS 서버의 AD에 없는 계정이 있다면 적절하게 생성/삭제를 해줍니다.
아래의 XML 내용은 실제로 제가 사용했던 settings.xml입니다.
<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
<Source name="VSS">
<VSSDatabase name="D:\db\VSS"></VSSDatabase>
<UserMap name="D:\db\migration\UserMap.xml"></UserMap>
<SQL Server="sedona2"></SQL>
</Source>
<ProjectMap>
<Project Source="$/DxInfoViewerSolution" Destination="$/InfoScope"></Project>
</ProjectMap>
</ConverterSpecificSetting>
<Settings>
<TeamFoundationServer name="dxtfs" port="8080" protocol="http"></TeamFoundationServer>
</Settings>
</SourceControlConverter>
자, 이제 모든 준비가 끝났으니 다음과 같은 명령으로 마이그레이션을 진행합니다.
VSSConverter Migrate settings.xml
2007.01.19: 내용 추가
만약, 계정명이 바뀌었거나 없는 계정이라면?... 다음의 토픽을 참조.
How to handle VSSConverter UserMap.xml files for users who no longer exist
; http://blogs.msdn.com/roberthorvick/archive/2007/01/18/how-to-handle-vssconverter-usermap-xml-files-for-users-who-no-longer-exist.aspx
[연관 글]