Team Foundation Server 管理のトラブルシューティング

更新 : 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 の MSDN フォーラムを参照してください。これらのフォーラムは、さまざまなトラブルシューティング トピックについて検索可能なスレッドを提供するだけでなく、質問にすばやい回答を提供できるように監視されています。

• ユーザーがチーム プロジェクト ポータルにアクセスできない

• ユーザーがレポートにアクセスできない

• ユーザーまたはグループを追加できない

• 追加したユーザーまたはグループが 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: Internet Information Services) が停止している可能性があります。IIS が実行中かどうかを確認するには、Team Foundation アプリケーション層サーバーで、[スタート] ボタンをクリックし、[管理ツール] をクリックします。次に、[インターネット インフォメーション サービス] をクリックし、サーバーが停止しているかどうかを確認します。詳細については、「方法 : サービス、アプリケーション プール、または Web サイトを停止および開始する」を参照してください。

• 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 Support Services から修正プログラムを入手するか、チーム エクスプローラ を Visual Studio Team System 2008 にアップグレードすることができます。詳細については、「チーム エクスプローラのバージョンの互換性」および「Team Foundation Server のバージョン間の互換性」を参照してください。

ユーザーがレポートにアクセスできない

現象 :   チーム エクスプローラでレポートを開くときやレポートにアクセスするときにエラーが発生します。

原因 :

• SQL Reporting Services の適切なアクセス許可を持っていない可能性があります。Team Foundation Server にユーザーまたはグループを追加する場合は、SharePoint 製品とテクノロジ および SQL Reporting Services にもユーザーとグループを追加する必要があります。詳細については、「アクセス許可の管理」および「Team Foundation のレポート作成に関するトラブルシューティング」を参照してください。

• IIS が Team Foundation アプリケーション層サーバーで停止している可能性があります。インターネット インフォメーション サービス (IIS) が実行中かどうかを確認するには、Team Foundation アプリケーション層サーバーで、[スタート] ボタンをクリックし、[管理ツール] をクリックします。次に、[インターネット インフォメーション サービス] をクリックし、サーバーが停止しているかどうかをチェックします。詳細については、「方法 : サービス、アプリケーション プール、または Web サイトを停止および開始する」を参照してください。

  メモ :
  SQL Server 2008 を使用する配置では、SQL Reporting Services は IIS から独立して動作します。

• IIS で、SQL Reporting Services 用のアプリケーション プールが停止している可能性があります。IIS で、Reporting Services アプリケーション プールが実行中であることを確認します。

Team Foundation Server にユーザーまたはグループを追加できない

現象 :   [Windows ユーザーまたはグループ] ダイアログ ボックスにドメイン ユーザーまたはグループが表示されません。

原因 :

• ユーザーまたはグループの属しているドメインが、Team Foundation Server を配置したドメインから信頼されていません。2 つのドメイン間に信頼を構成できます。または、TFSSecurity コマンド ライン ツールを使用して、信頼関係のないドメインからユーザーまたはグループを追加できます。詳細については、「Team Foundation Server の信頼とフォレストに関する考慮事項」および「TFSSecurity コマンド ライン ユーティリティのコマンド」を参照してください。

追加したユーザーまたはグループが Team Foundation Server で表示されない

現象 :   サーバーまたはプロジェクトに最近追加したユーザーまたはグループが表示されません。

原因 :

• ユーザーまたはグループを Team Foundation Server に正しく追加するには、少なくとも 1 つのアクセス許可を [許可] または [拒否] に設定する必要があります。ユーザーまたはグループを追加しても、[許可] または [拒否] に設定したアクセス許可が 1 つもない場合 (つまり、すべてのアクセス許可が未設定の場合)、そのユーザーまたはグループは 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 の管理」を参照してください。

• 追加したユーザーまたはグループで、[シェルブセットの管理] のアクセス許可だけが [許可] または [拒否] に設定されています。このアクセス許可には既知の問題があります。このアクセス許可だけを [許可] に設定したユーザーまたはグループを追加した場合、そのユーザーまたはグループは Team Foundation 有効ユーザー グループに正常に追加されず、結果として Team Foundation Server にアクセスできなくなります。問題のユーザーまたはグループが Team Foundation 有効ユーザーのメンバの一覧に表示されていることを確認してください。ユーザーまたはグループを追加するときは、[シェルブセットの管理] 以外のアクセス許可にも [許可] または [拒否] を設定してください。詳細については、「ユーザーおよびグループの管理」、「方法 : 既存のユーザーを表示する」、および「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 Proxy のトラブルシューティング」を参照してください。

ユーザーまたはグループに対して変更したアクセス許可が Team Foundation Server で機能しない

現象 :   既存のユーザーまたはグループのアクセス許可を変更する必要が生じました。アクセス許可を変更した直後、ユーザーまたはグループの機能がアクセス許可の変更前と同じように見えます。

原因 :

• アクセス許可に加えた変更が Team Foundation Server 全体で同期されるまでには、数分間を要することがあります。特に、Team Foundation のデータ層サーバーとアプリケーション層サーバーの間のネットワークの待機時間が大きい場合は、この傾向が強くなります。数分間待ってから、操作をやり直します。詳細については、「Team Foundation Server のアクセス許可」および「Team Foundation Server のセキュリティのアーキテクチャ」を参照してください。

Team Foundation Server のグループのメンバシップに加えた変更が直ちに有効にならない

現象 :   管理者が Team Foundation Server グループに対してユーザーの追加または削除を行います。ユーザーがグループに追加または削除された直後、ユーザーのグループ メンバシップに変更が反映されていないように見えます。

原因 :

• グループ メンバシップに加えた変更が Team Foundation Server 全体で同期されるまでには、数分間を要することがあります。特に、Team Foundation のデータ層サーバーとアプリケーション層サーバーの間のネットワークの待機時間が大きい場合や、Active Directory セキュリティ グループを使用していて、セキュリティ グループが存在するドメイン コントローラと Team Foundation Server の間のネットワークの待機時間が大きい場合は、この傾向が強くなります。

  • 数分間待ってから、操作をやり直します。

  • Active Directory の配置では、/force パラメータを指定した gpupdate コマンド ライン ツールを使用して、Active Directory セキュリティ グループを強制的に更新できます。

  • Active Directory セキュリティ グループを使用していて、これらのグループのメンバシップに変更を加えることが多い場合は、Active Directory との同期の頻度を増やすように Team Foundation Server を構成できます。既定では、Active Directory の同期は 1 時間おきに行われます。web.config ファイルを変更し、IdenityUpdatePeriod セクションに appSettings キーを追加すると、この頻度を増やすことができます。appSettings の値を適切な頻度に設定します。既定値は 1 時間 (1:0:0) です。

  • 詳細については、Microsoft Web サイトの「gpupdate」、「方法 : Team Foundation Server コンポーネントの構成設定を変更する」、「Team Foundation Server のアクセス許可」、および「Team Foundation Server のセキュリティのアーキテクチャ」を参照してください。

電子メール通知による警告に件名がない

現象 :   電子メールの警告の件名が空白です。

原因 :

• 次の 3 つのアセンブリが読み込まれていません。

  • Microsoft.TeamFoundation.Build.Server.EventFilter.dll

  • Microsoft.TeamFoundation.VersionControl.Server.EventFilter.dll

  • Microsoft.TeamFoundation.VersionControl.WorkItemTracking.Server.EventFilter.dll

  Team Foundation Server のサービス Web アプリケーションでは、アプリケーションの起動時にこれらのアセンブリを読み込みます。これらのアセンブリは、Web サービスの ASP.NET 構成設定がインターネット インフォメーション サービス (IIS) マネージャを使用して変更されている場合は読み込まれません。この場合、対応する Web.Config ファイルの configuration 要素に属性が追加されます。

  たとえば、構成の変更前は、サービスの Web.Config ファイルには次のエントリが含まれています。

  <configuration>
  <!-- Team Foundation/Web application values -->
  </configuration>
  

  IIS マネージャを使用して構成を変更した後、サービスの Web.Config ファイルには次のエントリが含まれます。

  <configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
  <!-- settings -->
  </configuration>
  

  問題を解決するには、エディタまたはメモ帳を使用して、名前空間属性を削除します。この変更後に iisreset を実行する必要はありません。

  電子メール通知の構成の詳細については、「方法 : サービスの Web.Config ファイルで SMTP サーバーおよび電子メール通知の設定を構成する」を参照してください。

参照

処理手順

Team Foundation Server のアクセス許可とセキュリティのトラブルシューティング

Team Foundation Server パフォーマンス カウンタのトラブルシューティング

Team Foundation Server コマンド ライン ツールのトラブルシューティング

Team Foundation Server Proxy のトラブルシューティング

新しいチーム プロジェクト ウィザードのトラブルシューティング

Team Foundation のレポート作成に関するトラブルシューティング

概念

データ ウェアハウスのトラブルシューティング