한 환경에서 다른 환경으로 Team Foundation Server 이동

도메인 이름을 변경하거나 작업 그룹에서 도메인으로 이동하는 경우 사용할 수 있는 가장 일반적인 환경 기반 이동 시나리오는 TFS 배포 도메인을 변경하는 것입니다.

중요

경우에 따라 TFS 배포와 해당 하드웨어의 도메인을 변경할 수 있습니다.하드웨어 변경은 복원 기반 이동이며, 두 이동 형식을 함께 사용할 수는 없습니다.먼저 하드웨어 이동을 완료한 다음 환경을 변경합니다.

또한 환경 이동 중 TFS에서 ID를 변경할 경우 충돌이나 문제가 발생할 수 있습니다.Identities 명령은 강력한 도구이지만 사용하는 데 제한이 있습니다.이동 계획 시 이 점을 고려해야 합니다.이동 작업을 성공적으로 완료하려면 다음 요구 사항을 이해해야 합니다.

  • TFS에 있는 사용자 계정은 제거하거나 다른 계정에 매핑할 수 없습니다.예를 들어 DomainA/UserA를 DomainB/UserB로 이동하는 경우 DomainB/UserB가 TFS에 없는 경우에만 Identities 명령을 사용하여 사용자를 마이그레이션할 수 있습니다.

  • 로컬 Administrators 그룹의 멤버는 자동으로 TFS에 추가되므로 도메인이나 환경을 변경하기 전에 해당 그룹에서 마이그레이션할 계정을 제거해야 합니다.

자세한 배경 정보를 보려면 여기로 이동하여 도구에 대한 제한을 포함하여 TFS에서 ID를 변경하는 방법에 대한 자세한 내용을 읽어 보십시오.

다음 섹션에서는 TFS 배포의 환경을 변경하는 단계를 살펴봅니다.

  1. 사용 권한 및 계정 확인

  2. TFS 서비스 중지

  3. 데이터 백업

  4. TFS를 새 도메인에 조인

  5. 새 환경에 맞게 SharePoint 제품 구성

  6. TFS 사용자 계정 및 서비스 계정 이동

  7. 보고 및 Analysis Services 구성

  8. TFS 서비스 다시 시작

사용 권한 및 계정 확인

TFS를 위한 환경을 성공적으로 변경하려면 로컬 컴퓨터에서 TFS뿐만 아니라 배포의 모든 소프트웨어가 이용하는 SQL Server, 보고, SharePoint 제품(배포에서 보고 또는 SharePoint를 사용하는 경우) 등의 소프트웨어 및 배포가 상호 운용되는 다른 소프트웨어(예: Project Server)에 대한 관리자여야 합니다. 그러나 로컬 Administrators 그룹의 모든 멤버는 자동으로 TFS에 포함되므로 계정을 마이그레이션할 때 문제가 발생할 수 있습니다. 따라서 환경 이동 중에는 마이그레이션하지 않을 계정을 사용해야 합니다. 이동만을 위한 특수 관리 계정을 추가하고 해당 계정을 사용하여 마이그레이션을 수행하는 것이 좋습니다.

관리자 수준의 권한을 확인하려면

  • 사용 중인 계정이 다음 그룹의 멤버인지 확인합니다.

    • 서버: Administrators(로컬 Administrators 그룹 또는 동등 수준 그룹)

    • TFS: Team Foundation Administrators 및 Admin Console Users

    • SQL Server: sysadmin

    • SharePoint 제품: Farm Administrators(TFS 배포가 SharePoint 제품과 통합되는 경우)

이러한 그룹 중 하나 이상의 멤버가 아닌 경우 지금 사용 권한을 얻으십시오.

필요한 모든 권한을 가진 계정을 사용 중인 경우에는 이동하려는 환경에서 충돌하는 이름 또는 그룹이 있는지 확인해야 합니다. 로컬 Administrators 그룹의 멤버인 계정은 마이그레이션할 수 없으므로 먼저 제거합니다.

로컬 Administrators 그룹에서 마이그레이션할 계정 제거

  • 로컬 Administrators 그룹을 열고 새로운 환경으로 마이그레이션할 계정을 제거합니다. 해당하는 다른 모든 그룹에 대해 이 단계를 반복합니다.

현재 TFS 환경의 ID 목록을 보고 새로운 환경에 충돌하는 그룹이나 개별 사용자 계정이 있는지 확인합니다.

환경 이동 중 자동으로 마이그레이션되지 않는 계정 정보를 비롯하여 이동할 ID에 대한 테이블이나 마이그레이션 맵을 만들 수 있습니다.

ID 확인

  1. Team Foundation에 대한 응용 프로그램 계층 서버에서 관리자 권한으로 명령 프롬프트 창을 열고 %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools로 이동한 후 다음 명령을 실행하여 현재 시스템에 있는 ID를 확인합니다.

    TFSConfig Identities
    
  2. ID 목록이 표시됩니다. 이러한 사용자 및 그룹을 확인하여 TFS를 이동할 환경의 ID와 중복되거나 문제가 발생할 가능성이 없는지 확인한 후 잠재적 충돌을 완화하는 단계를 수행합니다.

TFS 서비스 중지

서비스를 중지하면 사용자가 이동 프로세스 중이나 후에 작업 항목을 변경하거나 원래 배포에 소스 코드를 체크 인 할 수 없습니다.

  1. TFS 응용 프로그램 계층 컴퓨터에서 명령 프롬프트 창을 열고 디렉터리를 Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools로 변경합니다.

  2. 다음 TFSServiceControl 명령을 입력합니다.

    TFSServiceControl quiesce

데이터베이스 및 SQL Server Reporting Services 암호화 키 백업

  1. TFS 관리 콘솔을 열고 예약된 백업 페이지에서 전체 백업을 수행합니다. 백업을 수행하면 백업 계획에서 백업에 대해 구성된 모든 항목이 백업되지만 이 백업은 계획에서 예약된 시간이 아니라 즉시 수행됩니다. 배포에서 보고를 사용하는 경우 이 백업 집합의 일부로 암호화 키를 백업할 수 있습니다.

    작업이 종료되는 동안 창을 닫을 수 있습니다.

    백업이 구성되어 있지 않은 경우 먼저 계획을 만들어야 전체 백업을 수행할 수 있습니다.

  2. 백업이 완료되면 저장 장치 또는 네트워크 공유에서 백업을 사용할 수 있고 새 하드웨어에서 이 백업에 액세스할 수 있는지 확인합니다.

TFS를 새 도메인에 조인

  1. 각 서버에서 컴퓨터 속성을 엽니다.

  2. 서버를 조인하려는 작업 그룹 또는 도메인으로 컴퓨터 설정을 변경합니다.

    이 컴퓨터를 도메인에 조인하는 데 필요한 권한이 있는 계정의 사용자 이름과 암호를 입력하라는 메시지가 나타나면 적절한 자격 증명을 제공합니다.

  3. 컴퓨터를 다시 시작하여 도메인 변경 사항을 적용합니다.

    참고

    컴퓨터를 다시 시작하면 서비스 또는 드라이버를 시작할 수 없다는 경고 메시지가 나타날 수 있습니다.다음 절차를 계속 진행합니다.

새 환경에 맞게 SharePoint 제품 구성

이전 환경과 트러스트 관계가 없는 환경으로 변경하려는 경우 해당 환경이 올바르게 작동하려면 먼저 SharePoint 제품를 구성해야 합니다. 디렉터리 서비스에서 가져온 사용자에 대한 정보는 SharePoint 사이트의 사용자 선택기 웹 컨트롤에서 사용할 수 있습니다. 사이트 관리자 및 다른 사용자는 권한을 할당할 때 사용자 선택기를 사용하여 사용자 및 그룹을 선택할 수 있습니다. 사용자에 대한 정보가 모든 사용자에 대한 트러스트 관계 없이 포리스트 또는 여러 포리스트에 배치된 경우 이 웹 컨트롤에서 모든 사용자 및 그룹을 사용할 수 있도록 보장하기 위해 추가 단계를 수행해야 할 수 있습니다.

배포에서 SharePoint 제품을 사용하지 않는 경우, 새 배포에 이전 환경에 대한 양방향 트러스트가 있는 경우, SharePoint 웹 응용 프로그램에 대한 오류가 Team Foundation의 관리 콘솔에 표시되지 않는 경우 이 절차를 건너 뜁니다.

  1. Team Foundation Server 배포를 지원하는 SharePoint 팜에 속하는 모든 서버에서 관리자 권한으로 명령 프롬프트 창을 열고 디렉터리를 %programfiles%\Common Files\Microsoft Shared\Web Server Extensions\15\BIN으로 변경합니다.

  2. 다음 명령을 입력합니다. 여기서 Key는 SharePoint 제품의 배포에 사용하려는 암호화 키입니다.

    stsadm.exe -o setapppassword -password Key

    참고

    이 키는 포리스트 또는 도메인에 액세스하는 데 사용되는 계정의 암호를 암호화하기 위해 사용되는 암호화 문자열입니다.암호화 문자열은 팜의 각 서버에서 동일해야 하지만 각 팜에 대해 고유한 문자열을 사용해야 합니다.

  3. 다음 명령을 입력합니다. 여기서 domain:DNSName은 대상 포리스트 또는 도메인 및 해당 DNS 이름이고, user,password는 대상 포리스트 또는 도메인에 대한 액세스 권한이 있는 계정의 사용자 이름 및 암호이고, WebApp은 Team Foundation Server 배포를 지원하는 웹 응용 프로그램의 이름입니다.

    stsadm.exe -o setproperty -pn peoplepicker-searchadforests -pv domain:DnsName**,user,**password **-url http://**WebApp

  4. 다음 명령을 입력합니다. 여기서 URL은 팀 프로젝트 컬렉션을 지원하는 사이트 컬렉션의 URL이고, Port는 해당 사이트 컬렉션에 할당된 포트 번호이고, UserName은 해당 사이트 컬렉션의 소유자로 사용되는 계정의 사용자 이름입니다.

    **stsadm.exe -o siteowner -url http://URL:**Port -ownerlogin UserName

  5. Team Foundation Server의 배포에 사용되는 각 사이트 컬렉션에 대해 이전 단계를 반복합니다.

TFS 사용자 계정 및 서비스 계정 이동

이 항목의 시작 부분에서 언급했듯이 계정을 이동할 때 많은 문제가 발생할 수 있으며 특히 신중한 계획 없이 사용자를 마이그레이션하는 경우 더욱 그렇습니다. TFS에 동일한 계정이 이미 존재하는 경우에는 TFSConfig Identities 명령으로 계정을 마이그레이션할 수 없습니다.

계정 이름이 두 도메인에서 동일하고 도메인 이름만 다른 경우에는 TFSConfig Identities의 일괄 처리 모드를 사용하여 모든 ID를 한 번에 변경할 수 있습니다. 그렇지 않은 경우 개별적으로 ID를 변경하고 아래 설명에 따라 다른 대상 계정 이름을 지정해야 합니다.

  1. Team Foundation의 응용 프로그램 계층 서버에서 관리자 권한을 사용하여 명령 프롬프트 창을 열고 %ProgramFiles%\Microsoft Visual Studio 12.0 Team Foundation Server\Tools로 이동한 후 다음 명령을 실행하여 서비스 계정의 SID(서비스 ID)를 새로운 도메인으로 변경합니다.

    TFSConfig identities /change /fromdomain:OldComputerorDomainName /todomain:NewDomainName /account:OldTFSServiceAccount /toaccount:NewTFSServiceAccount
    

    경고

    서비스 계정이 Network Service와 같이 시스템 계정인 경우에는 새 환경에 동일한 이름의 시스템 계정이 존재하기 때문에 직접 마이그레이션할 수 없습니다.2단계 변경 작업을 수행해야 합니다.Identities 명령의 예제를 참조하십시오.

  2. 새 환경에서 동일한 이름을 가진 모든 계정을 마이그레이션하려면 다음 명령을 입력합니다.

    TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName
    

    이렇게 하면 계정이 일괄 처리됩니다.

  3. 새 도메인에 환경 간에 이름이 변경된 ID가 하나 이상 있으면 이러한 ID의 SID를 수동으로 업데이트해야 합니다. 예를 들어 Christie Church의 사용자 계정이 이전 환경에서는 Fabrikam\CChurch이었지만 새 환경에서는 NewFabrikam\ChristieC로 변경된 경우 SID를 수동으로 업데이트해야 합니다. 이러한 작업이 필요한 모든 계정에 대해 다음 명령을 입력합니다.

    TFSConfig Identities /change /fromdomain:OldDomainName /todomain:NewDomainName /account:OldAccountName /toaccount:NewAccountName
    
  4. 이제 다음 명령을 실행하여 서비스 계정을 업데이트합니다.

    TFSConfig Accounts /change /AccountType:ApplicationTier /account:AccountName /password:Password
    
  5. 배포에서 보고를 사용하는 경우 다음 명령을 실행하여 보고에 사용되는 데이터 소스 계정을 업데이트합니다.

    TFSConfig Accounts /change /AccountType:ReportingDataSource /account:AccountName /password:Password
    
  6. 배포에서 Team Foundation Server 프록시를 사용하는 경우 다음 명령을 실행하여 프록시에 사용되는 서비스 계정을 업데이트합니다.

    TFSConfig Accounts /change /AccountType:Proxy /account:AccountName /password:Password
    

    참고

    신뢰할 수 없는 도메인으로 이동하는 경우 팀, 프로젝트, 컬렉션 및 Team Foundation Server 자체에 사용자 및 그룹을 수동으로 추가해야 할 수도 있습니다.자세한 내용은 팀 프로젝트에 사용자 추가, 팀 프로젝트 컬렉션에 대한 관리자 권한 설정Team Foundation Server에서 관리자 권한 설정을 참조하십시오.

  7. 배포가 Project Server와 통합되는 경우 추가 단계를 수행하여 작동하는 데 필요한 권한으로 서비스 계정을 구성해야 할 수도 있습니다. 자세한 내용은 TFS와 Project Server 통합을 지원하기 위한 권한 할당TFS와 Project Server 통합 구성을 참조하십시오.

보고 및 Analysis Services 구성

보고 기능을 배포의 일부로 사용하지 않는 경우 이 절차를 건너뛸 수 있습니다.

이 유형의 이동을 수행하는 중 보고서 서버 이름을 변경한 경우 Team Foundation Server를 새로운 위치로 보고서 서버로 리디렉션해야 합니다. 또한 웨어하우스를 다시 시작하고 Analysis Services의 데이터베이스를 수동으로 다시 빌드해야 합니다.

  1. Team Foundation용 관리 콘솔을 열고 보고 노드로 이동한 다음 설정을 편집합니다.

    보고서가 아직도 이전 서버를 가리키고 있음

  2. 서버의 새 이름이 포함되도록 3개의 탭 모두에서 값을 변경합니다. 새 환경에서 데이터 소스 계정에 대한 올바른 정보를 제공하고 있는지 확인하십시오.

    탭 3개의 정보가 모두 정확한지 확인

  3. 작업 시작을 선택하여 보고를 다시 시작합니다.

  4. 다시 빌드 시작을 선택하여 웨어하우스를 다시 빌드합니다.

백업 구성

도메인 이름 변경으로 네트워크 공유 이름 또는 저장 장치가 변경된 경우 이렇게 이름이 변경된 리소스를 가리키도록 예약된 백업 계획을 업데이트해야 합니다.

  • 관리 콘솔에서 예약된 백업 노드로 이동한 다음 새로운 서버의 TFS 데이터베이스를 백업하도록 예약된 백업을 다시 구성합니다. 자세한 내용은 백업 일정 및 계획 구성을 참조하십시오.

TFS 서비스 다시 시작

TFS에서 새 환경에 대한 모든 정보가 업데이트되었으므로 서비스를 다시 시작합니다.

  1. TFS 응용 프로그램 계층 컴퓨터에서 관리자 권한으로 명령 프롬프트 창을 열고 디렉터리를 Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools로 변경합니다.

  2. 다음 TFSServiceControl 명령을 입력합니다.

    TFSServiceControl unquiesce

Q & A

Q: 도메인이 아닌 배포의 물리적 서버를 변경하려고 합니다.가능합니까?

A: 예. 이러한 이동을 하드웨어 기반 이동이라고 하며 작업 방법은 여기를 참조하십시오. 환경 기반 이동을 하드웨어 기반 이동과 함께 사용하지 않도록 해야 합니다. 먼저 하드웨어 이동을 완료한 다음 환경을 변경합니다.

Q: 프로젝트 서버와 통합하는 배포가 있습니다.이동한 TFS로 작업하려면 추가 단계를 수행해야 합니까?

A: 예. 환경 이동을 완료한 후 TFSAdmin ProjectServer /RegisterPWA 명령을 /tfs, /force/pwa 옵션과 함께 사용하여 Project Server에 TFS를 다시 등록해야 합니다. TFS와 Project Server 통합에 대한 자세한 내용은 여기를 참조하십시오.