Team Foundation Server 관리 문제 해결

아티클
08/20/2008

업데이트: 2007년 11월

Team Foundation Server 관리에는 Team Foundation Server에서의 사용자 및 그룹 추가 및 관리, Team Foundation Server 권한 관리, Team Foundation Server, SharePoint 제품과 기술 및 SQL Reporting Services 간의 권한 관리, 작업 그룹 및 도메인 환경에서의 Team Foundation Server 관리가 포함됩니다. 다음은 가장 일반적인 관리 문제와 그에 대한 해결 방법입니다.

여기에 나와 있는 정보를 검토한 후에도 문제를 해결할 수 없으면 Visual Studio Team System Team Foundation Server와 관련된 Microsoft Technical Forums를 참조하십시오. 이러한 포럼은 다양한 문제 해결 항목에 대해 검색 가능한 스레드를 제공하고 사용자의 질문에 신속하게 응답할 수 있도록 모니터링됩니다.

팀 프로젝트 포털에 액세스할 수 없는 경우
보고서에 액세스할 수 없는 경우
사용자 또는 그룹을 추가할 수 없는 경우
추가한 사용자 또는 그룹이 Team Foundation Server에 표시되지 않는 경우
추가한 사용자 또는 그룹이 Team Foundation Server에 액세스할 수 없는 경우
사용자 또는 그룹의 변경된 사용 권한이 Team Foundation Server에 제대로 적용되지 않는 경우
Team Foundation Server 그룹의 변경된 멤버 자격이 즉시 적용되지 않는 경우
전자 메일 알림 경고의 제목 줄 누락

관리 문제 해결

Team Foundation Server에서 사용자, 그룹, 권한 및 환경 관련 문제를 해결하려는 경우에는 이벤트 로그 메시지에서 오류를 확인하십시오. 이벤트 로그를 보려면 시작, 관리 도구를 차례로 클릭한 다음 이벤트 뷰어를 클릭합니다. Team Foundation Server 이벤트는 응용 프로그램 이벤트 로그에 기록되며, 개별 이벤트를 두 번 클릭하면 각 이벤트에 대한 추가 정보를 볼 수 있습니다. Active Directory 및 로컬 시스템 이벤트는 보안 이벤트 로그에 기록되며, 서비스 계정 및 서비스 이벤트는 시스템 이벤트 로그에 기록됩니다.

성능이 크게 저하된 경우에는 먼저 Team Foundation Server 하드웨어 및 소프트웨어가 최소 요구 사항을 충족하는지 확인한 다음 성능 카운터를 확인해야 합니다. 성능 카운터를 확인하는 방법에 대한 자세한 내용은 방법: Team Foundation Server 성능 카운터 보기를 참조하십시오.

팀 프로젝트 포털에 액세스할 수 없는 경우

증상: 팀 프로젝트 포털에 액세스하면 오류 메시지가 나타납니다.

가능한 원인

프로젝트 포털 URL을 직접 입력한 경우 URL을 잘못 입력했을 수 있습니다. 팀 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 프로젝트 포털 표시를 클릭합니다.
Team Foundation 응용 프로그램 계층 서버에서 IIS(인터넷 정보 서비스)가 중지되었을 수 있습니다. IIS가 실행되고 있는지 확인하려면 Team Foundation 응용 프로그램 계층 서버에서 시작, 관리 도구, 인터넷 정보 서비스를 차례로 클릭한 다음 서버가 중지되었는지 확인합니다. 자세한 내용은 방법: 서비스, 응용 프로그램 풀, 웹 사이트 중지 및 시작을 참조하십시오.
Microsoft Team Foundation Server 응용 프로그램 풀이 중지되었을 수 있습니다. 인터넷 정보 서비스 관리자를 열고 응용 프로그램 풀이 실행되고 있는지 확인합니다.
SharePoint 제품과 기술에 대한 적절한 권한이 없을 수 있습니다. Team Foundation Server에 사용자나 그룹을 추가하는 경우에는 Windows SharePoint 제품과 기술 및 SQL Reporting Services에도 사용자와 그룹을 추가해야 합니다. 자세한 내용은 권한 관리를 참조하십시오.
사용 중인 팀 탐색기 버전이 Microsoft Visual Studio 2005 Team Foundation Server에 포함된 버전입니다. Team Foundation Server가 Windows SharePoint Services 3.0을 사용하도록 구성된 경우 원래 버전의 팀 탐색기 및 Visual Studio Team System 2008 Team Foundation Server에 알려진 문제가 발생합니다. Microsoft 지원 서비스에서 핫픽스를 가져오거나 팀 탐색기를 Visual Studio Team System 2008로 업그레이드할 수 있습니다. 자세한 내용은 팀 탐색기에 대한 버전 호환성 및 Team Foundation Server 버전 호환성을 참조하십시오.

보고서에 액세스할 수 없는 경우

증상: 팀 탐색기에서 보고서를 열거나 액세스하면 오류 메시지가 나타납니다.

가능한 원인

SQL Reporting Services에 대한 적절한 권한이 없을 수 있습니다. Team Foundation Server에 사용자나 그룹을 추가하는 경우에는 SharePoint 제품과 기술 및 SQL Reporting Services에도 사용자와 그룹을 추가해야 합니다. 자세한 내용은 권한 관리 및 Team Foundation 보고 문제 해결을 참조하십시오.
Team Foundation 응용 프로그램 계층 서버에서 IIS가 중지되었을 수 있습니다. IIS가 실행되고 있는지 확인하려면 Team Foundation 응용 프로그램 계층 서버에서 시작, 관리 도구, 인터넷 정보 서비스를 차례로 클릭한 다음 서버가 중지되었는지 확인합니다. 자세한 내용은 방법: 서비스, 응용 프로그램 풀, 웹 사이트 중지 및 시작을 참조하십시오.

참고:

SQL Server 2008을 사용하는 배포의 경우에는 SQL Reporting Services가 IIS와 별개로 작동합니다.
IIS에서 SQL Reporting Services 응용 프로그램 풀이 중지되었을 수 있습니다. IIS에서 Reporting Services 응용 프로그램 풀이 실행되고 있는지 확인합니다.

참고:
SQL Server 2008을 사용하는 배포의 경우에는 SQL Reporting Services가 IIS와 별개로 작동합니다.

Team Foundation Server에 사용자 또는 그룹을 추가할 수 없는 경우

증상: 도메인 사용자 또는 그룹이 Windows 사용자 또는 그룹 대화 상자에 표시되지 않습니다.

가능한 원인

Team Foundation Server를 배포한 도메인에서 신뢰하지 않는 도메인에 사용자 또는 그룹이 속해 있습니다. 두 도메인 사이에 신뢰 관계를 구성하거나, 신뢰할 수 없는 도메인의 사용자 또는 그룹을 추가할 때 TFSSecurity 명령줄 도구를 사용합니다. 자세한 내용은 Team Foundation Server의 트러스트 및 포리스트 고려 사항 및 TFSSecurity 명령줄 유틸리티 명령을 참조하십시오.

추가한 사용자 또는 그룹이 Team Foundation Server에 표시되지 않는 경우

증상: 최근에 사용자 또는 그룹을 추가한 서버나 프로젝트에 해당 사용자 또는 그룹이 표시되지 않습니다.

가능한 원인

Team Foundation Server에 사용자 또는 그룹을 제대로 추가하려면 적어도 하나의 사용 권한을 허용 또는 거부로 설정해야 합니다. 사용자 또는 그룹을 추가한 후 하나 이상의 사용 권한을 허용 또는 거부로 설정하지 않고 모든 사용 권한을 설정되지 않은 상태로 두면 해당 사용자 또는 그룹이 Team Foundation Server에 추가되지 않고 오류 메시지나 경고가 표시되지 않습니다. 자세한 내용은 사용자 및 그룹 관리 및 Team Foundation Server 권한을 참조하십시오.

추가한 사용자 또는 그룹이 Team Foundation Server에 액세스할 수 없는 경우

증상: 최근에 추가한 사용자 또는 그룹이 Team Foundation Server 작업 항목, 소스 코드, 프로젝트 포털 또는 보고서에 액세스할 수 없습니다.

참고:
사용자 또는 그룹을 프로젝트 또는 서버에 추가하는 대신 Team Foundation Server 그룹에 추가하는 것이 좋습니다. 자세한 내용은 사용자 및 그룹 관리를 참조하십시오.

가능한 원인

Team Foundation Server가 두 대 이상 있는 환경에서는 모든 프로젝트에 대해 사용 권한이 없는 Team Foundation Server에 사용자가 액세스하려고 할 수 있습니다. 사용자가 액세스하려는 Team Foundation Server가 프로젝트에 맞는 서버여야 합니다.
Team Foundation Server에 액세스하는 데 필요한 신뢰 관계가 설정되지 않은 서로 다른 도메인 또는 작업 그룹에 사용자나 그룹이 속해 있을 수 있습니다. 자세한 내용은 Active Directory 도메인에서 Team Foundation Server 관리 및 작업 그룹에서 Team Foundation Server 관리를 참조하십시오.
Administer Shelvesets 권한만 허용 또는 거부로 설정된 사용자 또는 그룹을 추가했습니다. 이 권한과 관련하여, 사용자 또는 그룹을 추가할 때 이 사용 권한만 허용으로 설정하면 해당 사용자 또는 그룹이 Team Foundation Valid Users 그룹에 제대로 추가되지 않아 Team Foundation Server에 액세스할 수 없다는 문제가 이미 알려져 있습니다. 사용자 또는 그룹이 Team Foundation Valid Users 멤버 목록에 표시되는지 확인하고, 사용자 또는 그룹을 추가할 때는 Administer Shelvesets 이외의 다른 사용 권한도 허용 또는 거부로 설정해야 합니다. 자세한 내용은 사용자 및 그룹 관리, 방법: 기존 사용자 보기 및 Team Foundation Server 권한을 참조하십시오.
SharePoint 제품과 기술 또는 SQL Reporting Services에 대한 적절한 권한이 없을 수 있습니다. Team Foundation Server에 사용자나 그룹을 추가하는 경우에는 SharePoint 제품과 기술 및 SQL Reporting Services에도 사용자와 그룹을 추가해야 합니다. 자세한 내용은 권한 관리를 참조하십시오.
소스 제어 문제의 경우 사용자 또는 그룹이 올바르게 구성되지 않은 Team Foundation Server 프록시를 사용할 수 있습니다. Team Foundation Server 프록시 또는 Team Foundation Server 프록시의 서비스 계정에 변경 내용이 있는 경우에는 프록시와 서버에 이러한 변경 내용이 모두 반영되도록 구성해야 합니다. 자세한 내용은 방법: Team Foundation Server Proxy의 캐시 보안 구성, Team Foundation Server 보안 아키텍처 및 Team Foundation Server 프록시 문제 해결를 참조하십시오.

사용자 또는 그룹의 변경된 사용 권한이 Team Foundation Server에 제대로 적용되지 않는 경우

증상: 기존 사용자 또는 그룹의 사용 권한을 변경할 필요가 있어 사용 권한을 변경한 직후 확인하면 사용자 또는 그룹의 기능이 사용 권한을 변경하기 전과 동일한 것으로 나타납니다.

가능한 원인

사용 권한을 변경할 경우, 특히 Team Foundation 데이터 계층 서버와 응용 프로그램 계층 서버 사이에 네트워크 대기 시간이 길면 Team Foundation Server에서 변경 사항이 동기화되는 데 1-2분 정도 소요됩니다. 몇 분 정도 기다린 후 작업을 다시 시도합니다. 자세한 내용은 Team Foundation Server 권한 및 Team Foundation Server 보안 아키텍처를 참조하십시오.

Team Foundation Server 그룹의 변경된 멤버 자격이 즉시 적용되지 않는 경우

증상: 관리자가 Team Foundation Server 그룹에서 사용자를 추가하거나 제거하는 경우 그룹에서 사용자가 추가 또는 제거된 직후 확인하면 해당 사용자가 그룹 멤버 자격의 변경으로 인해 아무런 영향을 받지 않은 것으로 나타납니다.

가능한 원인

그룹 멤버 자격을 변경한 경우, 특히 Team Foundation 데이터 계층 서버와 응용 프로그램 계층 서버 사이 그리고 Active Directory 보안 그룹을 사용할 경우에는 보안 그룹이 있는 도메인 컨트롤러와 Team Foundation Server 사이에 네트워크 대기 시간이 길면 Team Foundation Server에서 멤버 자격 변경 사항이 동기화되는 데 1-2분 정도 소요됩니다.
- 몇 분 정도 기다린 후 작업을 다시 시도합니다.
- Active Directory 배포 환경에서는 gpupdate 명령줄 도구와 /force 매개 변수를 함께 사용하여 Active Directory 보안 그룹을 강제로 업데이트할 수 있습니다.
- Active Directory 보안 그룹을 사용하면서 이들 그룹의 멤버 자격을 정기적으로 변경하는 경우에는 Active Directory와 더 자주 동기화되도록 Team Foundation Server를 구성할 수 있습니다. 기본적으로 Active Directory 동기화는 1시간마다 수행됩니다. web.config 파일을 변경하여 IdenityUpdatePeriod 섹션에 appSettings 키를 추가하는 방법으로 이 빈도를 높일 수 있습니다. appSettings에 원하는 빈도 값을 설정할 수 있으며, 기본값은 1시간(1:0:0)입니다.
- 자세한 내용은 Microsoft 웹 사이트, 방법: Team Foundation Server 구성 요소의 구성 설정 변경, Team Foundation Server 권한 및 Team Foundation Server 보안 아키텍처에서 "gpupdate"를 참조하십시오.

전자 메일 알림 경고의 제목 줄 누락

증상: 전자 메일 경고의 제목 줄이 비어 있습니다.

가능한 원인

다음 세 개의 어셈블리가 로드되지 않았습니다.
- Microsoft.TeamFoundation.Build.Server.EventFilter.dll
- Microsoft.TeamFoundation.VersionControl.Server.EventFilter.dll
- Microsoft.TeamFoundation.VersionControl.WorkItemTracking.Server.EventFilter.dll
이러한 어셈블리는 Team Foundation Server 서비스 웹 응용 프로그램이 시작될 때 로드되며, IIS(인터넷 정보 서비스) 관리자를 사용하여 웹 서비스의 ASP.NET 구성 설정을 변경할 때는 로드되지 않습니다. 이 방식을 사용하면 해당하는 Web.Config 파일의 configuration 요소에 특성이 추가됩니다.

예를 들어 Services Web.Config 파일에는 구성이 변경되기 전에 다음 항목이 들어 있습니다.
```
<configuration>

</configuration>
```
IIS 관리자를 사용하여 구성을 변경한 후에 Services Web.Config 파일에 다음 항목이 들어 있습니다.
```
<configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">

</configuration>
```
문제를 해결하려면 편집기나 메모장을 사용하여 네임스페이스 특성을 제거합니다. 이러한 변경 작업을 수행한 후 iisreset을 실행할 필요는 없습니다.

전자 메일 알림을 구성하는 방법에 대한 자세한 내용은 방법: 서비스 Web.Config 파일에서 SMTP 서버 및 전자 메일 알림 설정 구성을 참조하십시오.