VSS 변환기 문제 해결
업데이트: 2007년 11월
이 단원에는 VSS 변환기를 사용하여 Microsoft Visual SourceSafe 2005에서 Team Foundation 버전 제어로 마이그레이션할 때 발생할 수 있는 일반적인 문제에 대한 문제 해결 정보가 포함되어 있습니다.
단원 내용
디스크 공간 제한
잘못된 버전의 Ssapi.dll 등록
VSS 손상 및 IVSS 문제 때문에 파일 및 폴더 버전이 마이그레이션되지 않음
VSS 변환기가 일부 Visual SourceSafe 시나리오를 지원하지 않음
마이그레이션 도중 Team Foundation 데이터 계층의 디스크 공간 부족
VSS 변환기가 중지됨
VSS 변환기를 실행하는 사용자의 암호가 만료됨
마이그레이션된 솔루션 파일 열기 오류 메시지
디스크 공간 제한
VSS 변환기가 실행되고 있는 컴퓨터에 디스크 공간이 없거나 부족한 경우 다음 오류가 표시됩니다.
VSS Error: Disk out of space
해결 방법
마이그레이션 동안 VSS 변환기는 시스템 드라이브의 로컬 폴더에 파일을 다운로드한 다음 Team Foundation으로 업로드합니다. 또한 VSS 변환기가 SQL Express에 로그 파일, 보고서 파일 및 메타 데이터를 저장할 디스크 공간이 필요합니다.
디스크 공간이 부족한 경우 Ctrl+C를 눌러 마이그레이션을 중지할 수 있습니다. 증분 마이그레이션 기능을 사용하여 중지된 지점에서부터 마이그레이션을 다시 시작할 수 있습니다. 그러나 마이그레이션을 다시 시작하기 전에 시스템 드라이브에서 추가 디스크 공간을 만들어야 합니다.
사용할 수 있는 디스크 공간이 없는 경우 크기가 0인 상태로 파일이 마이그레이션됩니다. 이 경우 Ctrl+C를 눌러 마이그레이션을 중지하고 디스크 공간을 확보한 후 마이그레이션을 다시 시작해야 합니다.
마이그레이션을 실행하는 드라이브에서 10GB의 사용 가능한 디스크 공간을 유지하는 것이 좋습니다.
잘못된 버전의 Ssapi.dll 등록
잘못된 버전의 ssapi.dll이 등록된 경우 다음 오류와 함께 VSS 변환기가 종료됩니다.
Unable to cast COM object of type 'Microsoft.VisualStudio.SourceSafe.Interop.VSSDatabaseClass' to interface type 'Microsoft.VisualStudio.SourceSafe.Interop.IVSSDatabase'. This operation failed because the QueryInterface call on the COM component for the interface with IID '{2A0DE0EE-2E9F-11D0-9236-00AA00A1EB95}' failed with HRESULT: 0x80004002 (No such interface supported (Exception from HRESULT: 0x80004002 (E_NOINTERFACE))). Unhandled exception caught.
또한 Microsoft Visual SourceSafe 2005가 설치되어 있는 경우에도 "VSS 변환기를 사용하려면 Microsoft Visual SourceSafe 2005 이상이 필요합니다." 또는 "Microsoft Visual SourceSafe 2005가 설치되어 있지 않습니다."라는 내용의 오류 메시지가 나타날 수 있습니다.
해결 방법
VSS 변환기를 사용하려면 마이그레이션을 수행하려는 컴퓨터에 Microsoft Visual SourceSafe 2005 이상이 설치되어 있어야 합니다. Microsoft Visual SourceSafe 2005 외에 이전 버전의 Visual SourceSafe가 설치되어 있는 경우에도 이 문제가 발생할 수 있습니다. Microsoft Visual SourceSafe 2005에 포함된 ssapi.dll 대신 이전 버전의 ssapi.dll이 등록되어 있는 경우 이 문제가 발생합니다. 이 문제를 해결하려면 이전 버전의 Visual SourceSafe와 Microsoft Visual SourceSafe 2005를 제거하고 Microsoft Visual SourceSafe 2005만 다시 설치합니다.
VSS 손상 및 IVSS 문제 때문에 파일 및 폴더 버전이 마이그레이션되지 않음
Visual SourceSafe 손상 및 IVSS 문제 때문에 파일 및 폴더 버전이 마이그레이션되지 않는 경우 보고서 파일에 많은 수의 오류와 데이터 손실 경고가 나타납니다. 이것은 다음 오류 중 하나 또는 둘 모두가 발생했기 때문입니다.
Visual SourceSafe의 팁 버전이 Team Foundation의 팁 버전과 일치하지 않습니다.
Visual SourceSafe의 레이블에 연결된 파일 및 폴더 버전이 Team Foundation의 파일 및 폴더 버전과 정확히 일치하지 않습니다.
해결 방법
Visual SourceSafe를 오래 사용하면 손상되기 쉽습니다. 이러한 손상 때문에 VSS 변환기가 파일 및 폴더의 일부 버전을 마이그레이션하지 못하게 됩니다. VSS 변환기는 IVSS API를 사용하여 Visual SourceSafe 데이터베이스에 액세스하지만 Visual SourceSafe UI 및 명령줄에서는 IVSS를 사용하지 않습니다. Visual SourceSafe 버전을 UI나 명령줄을 통해서는 검색할 수 있지만 IVSS를 통해서는 검색할 수 없는 경우가 간혹 있습니다. 이와 같은 파일 및 폴더 버전의 마이그레이션은 실패합니다.
마이그레이션을 성공적으로 수행한 후에는 WinDiff 도구와 같은 파일 비교 유틸리티를 사용하여 Visual SourceSafe에 있는 최신 버전의 파일 및 폴더와 Team Foundation 버전 제어에 있는 마이그레이션된 최신 버전의 파일 및 폴더를 비교해야 합니다. 파일 및 폴더 버전 간에 차이가 있는 경우 최신 버전을 수동으로 마이그레이션하십시오.
.gif "참고")
참고:마이그레이션을 수행한 후에는 Visual SourceSafe의 레이블에 연결된 파일 및 폴더의 버전과 Team Foundation 버전 제어에 있는 파일 및 폴더의 버전을 일치시킬 수 있는 방법이 없습니다.
VSS 변환기가 일부 Visual SourceSafe 시나리오를 지원하지 않음
VSS 변환기가 Visual SourceSafe의 일부 시나리오나 작업 시퀀스를 지원하지 않습니다. 팁이나 레이블이 일치하지 않는 경우 보고서 파일에 많은 오류가 나타날 수도 있고 전혀 나타나지 않을 수도 있습니다. 마이그레이션된 파일과 폴더를 검사할 때 다음과 같은 상황이 발생할 수 있습니다.
Visual SourceSafe의 팁 버전이 Team Foundation 버전 제어의 최신 버전과 일치하지 않습니다.
Visual SourceSafe의 레이블에 연결된 파일 및 폴더 버전이 Team Foundation 버전 제어의 파일 및 폴더 버전과 정확히 일치하지 않습니다.
파일 및 폴더가 잘못된 이름으로 마이그레이션됩니다.
다음과 같은 몇 가지 Visual SourceSafe 시나리오는 VSS 변환기에서 지원하지 않습니다.
파일 또는 폴더가 여러 번 이름이 바뀌고 이동된 경우
동일하거나 다른 Visual SourceSafe 데이터베이스의 다른 폴더로 보관된 폴더가 복원된 경우
표준 시간대 때문에 문제가 발생할 수 있습니다. VSS 변환기에서 해결할 수 있는 표준 시간대 문제도 있지만 해결할 수 없는 문제도 있습니다. 표준 시간대 문제에 대한 자세한 내용은 Microsoft 기술 자료 문서 "BUG: Using SourceSafe in Multiple Time Zones"(https://go.microsoft.com/fwlink/?LinkId=59976)를 참조하십시오.
해결 방법
마이그레이션을 성공적으로 수행한 후에는 WinDiff 도구와 같은 파일 비교 유틸리티를 사용하여 Visual SourceSafe에 있는 최신 버전의 파일 및 폴더와 Team Foundation 버전 제어에 있는 마이그레이션된 최신 버전의 파일 및 폴더를 비교해야 합니다. 파일 및 폴더 버전 간에 차이가 있는 경우 최신 버전을 수동으로 마이그레이션하십시오.
| 참고: |
|---|
마이그레이션을 수행한 후에는 Visual SourceSafe의 레이블에 연결된 파일 및 폴더의 버전과 Team Foundation 버전 제어에 있는 파일 및 폴더의 버전을 일치시킬 수 있는 방법이 없습니다. |
마이그레이션 도중 Team Foundation 데이터 계층의 디스크 공간 부족
마이그레이션 도중에 Team Foundation 데이터 계층의 디스크 공간이 부족해지면 콘솔에 다음 오류가 반복적으로 표시됩니다.
Team Foundation 마이그레이션 오류: SQL 오류 xxxx 디스크 공간이 부족합니다.
Team Foundation이 응답하지 않습니다. 다시 시도하고 있습니다.
Team Foundation 마이그레이션 오류: SQL 오류 xxxx 트랜잭션 로그가 가득 찼습니다. TF30042: 데이터베이스가 꽉 찼습니다. Team Foundation Server 관리자에게 문의하십시오.
해결 방법
소스 제어 데이터는 Team Foundation의 데이터 계층에 저장됩니다. VSS 변환기는 몇 시간이나 몇 일 동안 수 개월이나 수 년간의 기록을 마이그레이션하므로 데이터 계층의 디스크 공간이 부족해지는 경우가 있습니다.
증분 마이그레이션 기능을 사용하여 중지된 지점에서부터 마이그레이션을 다시 시작할 수 있습니다. 자세한 내용은 방법: Team Foundation으로 증분 마이그레이션을 참조하십시오. 그러나 마이그레이션을 다시 시작하기 전에 데이터 계층에서 추가 디스크 공간을 만들어야 합니다.
트랜잭션 로그가 꽉 차면 내용을 삭제하여 정리해야 합니다.
.gif "중요")
중요:트랜잭션 로그를 정리하려면 먼저 백업하십시오.
VSS 변환기가 중지됨
VSS 변환기가 실행되고 있는 컴퓨터가 전원 오류, 보안 업데이트 등의 이유로 다시 시작되거나 충돌이 발생하여 VSS 변환기가 중지될 수 있습니다.
해결 방법
증분 마이그레이션 기능을 사용하여 중지된 지점에서부터 마이그레이션을 다시 시작할 수 있습니다. 자세한 내용은 방법: Team Foundation으로 증분 마이그레이션을 참조하십시오. 그러나 VSS 변환기 오류가 일시적인 것인지 지속적인 것인지 확인해야 합니다. 지속적인 문제인 경우 Visual SourceSafe에서 오류를 발생시키는 요소의 기록을 수동으로 수정해야 합니다.
VSS 변환기를 실행하는 사용자의 암호가 만료됨
사용자 암호가 만료되면 "Team Foundation에서 응답하지 않습니다. 다시 시도하고 있습니다."라는 내용의 메시지가 반복적으로 표시됩니다. 또한 무단 액세스에 대한 SoapException이나 사용 권한 거부 오류가 로그 파일에 나열됩니다.
해결 방법
VSS 변환기를 실행하는 사용자 ID의 암호가 만료된 경우 Ctrl+C를 눌러 마이그레이션을 중지합니다. 로그오프한 후 새 암호로 다시 로그인합니다. 증분 마이그레이션 기능을 사용하여 중지된 지점에서부터 마이그레이션을 다시 시작할 수 있습니다. 자세한 내용은 방법: Team Foundation으로 증분 마이그레이션을 참조하십시오.
마이그레이션된 솔루션 파일 열기 오류 메시지
마이그레이션된 파일의 소스 제어 바인딩이 업데이트되지 않은 경우 사용자가 Visual SourceSafe 데이터베이스에 바인딩된 솔루션 파일을 열려고 하면 오류 메시지가 표시됩니다.
해결 방법
VSS 변환기는 솔루션 파일의 소스 제어 바인딩 정보를 변경하지 않습니다. 따라서 솔루션 파일은 여전히 Team Foundation의 Visual SourceSafe에 바인딩되어 있습니다.
이 문제를 해결하려면 소스 제어 바인딩을 Visual SourceSafe에서 Team Foundation 버전 제어로 마이그레이션해야 합니다. 자세한 내용은 방법: Visual SourceSafe에서 소스 제어 바인딩 마이그레이션을 참조하십시오.
| 참고: |
|---|
일시적인 네트워크 문제나 Team Foundation Server가 다운된 경우에도 솔루션 파일 열기 문제가 발생할 수 있습니다. |
참고 항목
작업
연습: Visual SourceSafe에서 Team Foundation으로 마이그레이션