Team Foundation Server 2008 インストール トラブルシュート集 (Part I)
さて、本日は書く、書くと言っていたけどアップしきれていなかった Team Foundation Server インストール時のトラブルシュート集です。
＜Team Foundation Server インストール時のトラブルシューティング＞ 下記では、Visual Studio Team System (VSTS) Team Foundation Server (TFS) のインストール時、また TFS インストール前にインストールを必要とする項目などにつき、問題が発生した際に活用できるソリューションを説明します。
※ 本番環境での問題が解決するか否かに関しては、事前に充分なテスト・検証を仮想環境などで実行することを強く推奨します。
TFS インストール時に最も多くユーザーが直面する問題は以下です。
- インストールの前提条件につき、一つ以上の項目を満たしていない (ステップをスキップしてしまった)
- 以前のバージョン (評価版など) インストールのコンポーネントがまだ一部残っている (新しいインストール時のコンフリクト)
- ネットワークの前提条件につき、必要なポートやコネクションはあるものの、セキュリティ レベルを強化し過ぎて TFS のインストールがうまくできない。
下記には、特定の症状と、その症状・障害の根本箇所をどのように修正するかにつきご説明します。
仮に、下記の情報が不十分であったり、どうしても問題が解消しない場合は、マイクロソフトのサポート サービスにご連絡いただくか、TFS を一度完全にアンインストールして、改めてインストールを繰り返し実行して下さい。
アンインストール方法については、(Team Foundation Server Installation Guide for Visual Studio Team System 2008 → URL) をご参照下さい。
① インストール ログ ファイル
デフォルトで、TFS インストール時のログ ファイルは以下の箇所でご確認いただけます。
ログ ファイル |
詳細 |
Drive:\Documents and Settings\SetupAccount\Local Settings\Temp\dd_install_vstf_at_90.txt |
アプリケーション層 (AT) の統合インストール ログ |
Drive:\Documents and Settings\SetupAccount\Local Settings\Temp\dd_install_vstf_tfc_90.txt |
Team Explorer インストール時の統合ログ |
Drive:\Documents and Settings\SetupAccount\Local Settings\Temp\VSMsiLog＜ランダム4桁数字＞.txt |
Team Foundation のコンポーネント インストールに関する詳細テキスト ログ。 インストール時のプログレス バーの画面になるタイミング毎に、新規で作成されます。 インストールの強制終了、フェールなど、プログレス バーの画面にたどりつく前にインストールが終了する場合には、ログ ファイルは生成されません。 |
![clip_image001[4]](https://msdntnarchive.blob.core.windows.net/media/TNBlogsFS/BlogFileStorage/blogs_msdn/tanishi/WindowsLiveWriter/TeamFoundationServer2008_CB06/clip_image001%5B4%5D.gif "clip_image001[4]"){kind=small}
以下、ログの見方について
dd_*.txt のファイルは統合ログ ファイルになっているので、ログ内の最新情報はファイルの後方にあります。
また、「ERRORLOG EVENT」を検索することにより、通常のエラー箇所は発見できます。
注意: ERRORLOG EVENT 前後の情報が必ずしもインストール時の問題とは限りません。
VSMsi*.txt のログ ファイルの日付を見て、最新のログであることを確認することを忘れずに！
このファイルについては、下から上にログ内容を見て行くようにして下さい。また、セットアップ ウィザード上に表記されたエラー メッセージなどをそのまま検索するのも、問題個所特定するのに有効的です。
Team Foundation Server インストール時のトラブルシューティング
下記には、最も多く寄せられる Team Foundation Server インストール時の問題について記載しています。
順番としては、上位から頻度の高いものから、リストしています。
また、これら問題は、Team Foundation Server のインストール ウィザードに表記されるエラーになります。
より詳細に問題点を特定するには、VSMsiLog ファイルからエラー番号のある個所まで行き、その直前に行われているコマンドやパラメーターの分析をして下さい。
Error 32000
Team Foundation Server の新規インストール、もしくは Visual Studio Team System 2008 Team Foundation Server へのアップグレードを試みている際に、以下のエラーが表示されることがあります:
Error 32000. The Commandline ‘[1]’ returned non-zero value: [2]
このエラーは、セットアップ プロセス中に失敗 (フェール) 箇所を特定できなかった場合に表示されてしまいます。この場合、最新の日付の VSMsiLog ファイルを確認してより詳細な情報を確認することをお勧めします。「戻り値 3」もしくは「Return value 3」と言う文を検索し、直前のコマンド・パラメーターを確認・分析します。
更に、動作的問題を特定するためには、コマンド プロンプト ([スタート ボタン] - [アクセサリ] - [コマンド プロンプト] や ”CMD" で開けます) にて、同じコマンドとパラメーターをたたいてみて下さい。
問題 |
解決策 |
SQL Server Reporting Services に関連する問題 |
Internet Information Services (IIS) マネージャを開き、Reporting Services と関連するバーチャル ディレクトリおよびアプリケーション プールを削除し、Team Foundation Server のインストールを再度実行してください。
|
ISO イメージの破損 (評価版で発生することが多かった) |
当たり前なことですが、新しい ISO イメージ ファイルをダウンロードもしくはコピーして、再度 Team Foundation Server のインストールを実行して下さい。 評価版のバーチャル イメージ (英語) は以下からダウンロードできます: |
ローカル管理者権限を持たないユーザーとしてインストールを開始してしまった |
ローカル コンピュータの「Administrators」グループに、ユーザーを追加するか、既に Administrators グループに含まれるユーザーとして再度インストールを実行する ＞＞ ローカル コンピュータの「Administrators」グループにユーザーを追加する方法 ＜＜
|
SQL Server の「sa」アカウントが、違う名前で登録されている ※ 「System Administration」の頭文字で「sa」になっています |
SQL Server のシステム管理者アカウント名を「sa」に変更し、Team Foundation Server のインストールを再度実行します。インストール後にアカウント名を元に戻しても大丈夫です。
|
Default Web Site にホスト ヘッダーが定義されていると表記される: ノンゼロ バリュー (-1) と "\Microsoft Shared\Web Server Extensions\60\Bin\Stsadm.exe" を含むエラーが表示される |
Default Web Site の定義情報を外し、再度 Team Foundation Server のインストールを実行する
|
Default Web Site が特定の IP に紐付られていると表記される: ノンゼロ バリュー -2130246810 がエラー メッセージに表示される |
Default Web Site の定義情報を外し、再度 Team Foundation Server のインストールを実行する
|
データベース上で、一つ以上のレポート用スキーマ ファイルが破損している |
弊社のサポート サービスにお問い合わせいただき、新しくスキーマ ファイルを入手のうえ、インストールを再度実行して下さい。 |
エラーの戻り値が -2130242250 または -1 であり、Windows SharePoint Services 2.0 のインストールに問題がある |
|
他、いろいろ |
信じ難いかも知れませんが、「再実行」のボタンをインストール ウィザード上で何度もクリックしていると、そのままインストールが問題なく進むことがあります (4回まで) |
Error 29112
Team Foundation Server インストール時に、以下のエラーがインストール ウィザード上に表示される:
Error 29112. Team Foundation Report Server Configuration: Either SQL Reporting Services is not properly configured, or the Reporting Services Web site could not be reached. Use the Reporting Services Configuration tool to confirm that SQL Reporting Services is configured properly and that the Reporting Service Web site can be reached, and then run the installation again. For more information, see the Team Foundation Installation Guide.
可能な問題と解決策を以下に紹介します:
問題 |
解決策 |
SQL Server Reporting Services の構成が正しく設定されていない |
Reporting Services の設定を修正し、再度 Team Foundation Server のインストールを実行して下さい ＞＞ Reporting Services の設定確認について ＜＜
|
IIS Manager のデフォルト アプリケーション プールが Network Service アカウントで稼働されていない |
ReportServer アプリケーション プールのアカウント構成を修正し、再度 Team Foundation Server のインストールを実行する |
戻り値 - 2147220956 ならびに名前空間が見つからないと MSI ログに表示されている。 IIS 5.0 Isolation モードが有効な可能性がある。 |
IIS 5.0 Isolation モードを無効化し、Team Foundation Server のインストールを再度実行して下さい
|
![clip_image002[1]](https://msdntnarchive.blob.core.windows.net/media/TNBlogsFS/BlogFileStorage/blogs_msdn/tanishi/WindowsLiveWriter/TeamFoundationServer2008_CB06/clip_image002%5B1%5D.gif "clip_image002[1]"){kind=small}
Error 29109
Team Foundation Server インストール時に、以下のエラーがインストール ウィザード上に表示される:
Error 29109. Team Foundation Report Server Configuration: SQL Reporting Services configuration encountered an unknown error. Verify that you have sufficient permissions to configure SQL Reporting Services, and try again.
可能な問題と解決策を以下にご紹介します:
問題 |
解決策 |
SQL Server Reporting Services のバーチャル ディレクトリの配置が間違っている。Reporting Services の後に SharePoint をインストールすると発生する問題です。 ※ インストール順番の問題 |
Reporting Services の構成を修正の上、再度 Team Foundation Server のインストールを実行して下さい
|
Reporting Service をホストしているサーバーが稼働していない |
|
Error 28806
Team Foundation Server インストール時に、以下のエラーがインストール ウィザード上に表示される:
Error 28806. An unexpected error occurred. Verify that SQL Server Reporting Services is installed and running on the Team Foundation app tier and that you have sufficient privileges to access it. For more information, see the setup log.
可能な問題と解決策を以下に紹介します:
問題 |
解決策 |
TFSService 以外のアカウントで SQL Server Reporting Services を稼働している |
Reporting Services が TFSServices アカウントを利用して稼働するように設定し、Team Foundation Server のインストールを再度実行して下さい
|
Error 29000
Team Foundation Server インストール時に、以下のエラーがインストール ウィザード上に表示される:
Error 29000. An unexpected error occurred. Verify that SQL Server Reporting Services is installed and running on the Team Foundation app tier and that you have sufficient privileges to access it. For more information, see the setup log.
可能な問題と解決策を以下に紹介します:
問題 |
解決策 |
SQL Server Analysis Services をホストするサーバーが稼働していないか、Reporting Services のサービス アカウントの権限が不充分である |
サーバーが稼働していない場合は、サーバーを再起動 サービス アカウントの権限が不充分な場合は、Reporting Services のサービス アカウントに必要な権限を与える
|
SQL Server FullText Search がインストール されていないか、稼働していない |
Services Manager にて SQL Server FullText Search を開始する インストールされていない場合は、Full Text Search をインストールし、Team Foundation Server のインストールを再度実行して下さい
|
Error 28805
Team Foundation Server インストール時に、以下のエラーがインストール ウィザード上に表示される:
Error 28805. The setup program cannot complete the request to the server that is running SQL Server Reporting Services. Verify that SQL Server Reporting Services is installed and running on the Team Foundation app tier and that you have sufficient permissions to access it. For more information, see the setup log.
可能な問題と解決策を以下に紹介します:
問題 |
解決策 |
SQL Server Reporting Services の権限・資格が Reporting Services のデータを作成するには不充分である |
Reporting Services の Credentials が Network Service を利用していることを確認し、再度インストールを実行してみて下さい。 手順や詳細については、以下のリンクをご覧下さい: 方法 : 別のデータ層サーバーに接続するように Reporting Services をリダイレクトする ページにて「Reporting Services のサービス アカウントの ID を更新する」の箇所をご確認ください 設定が終了後、改めて Team Foundation Server のインストールを実行します |
ウェブ サイトに証明書 (Certificate) がインストールされていて、それらを無視する設定になっていない |
Reporting Services の証明書設定を変更し、再度 Team Foundation Server のインストールを実行して下さい
|