Web 配置に関連する一般的な問題のトラブルシューティング

適用対象: インターネット インフォメーション サービス

この記事では、Visual Studio 2010 からの発行時に発生する一般的なエラーなど、Web 配置に関する一般的な問題を診断して修正する方法について説明します。

ログ記録

Web 配置に関連する問題が発生した場合、問題の発生場所に応じて、いくつかのログ オプションがあります。 既定では、[アプリケーション]の [Microsoft Web Deploy] の下にあるイベント ログにログをデプロイします>。 移行先サーバーでエラーを探し始めるのに最適な場所です。

イベント ログを使用して問題を診断できない場合は、他のいくつかのオプションを次に示します。

• インストールの問題を診断するには、 %programfiles%\IIS\Microsoft Web Deploy v3 の下にある Web Deploy MSI ログを使用します。
• Web 管理サービスまたはリモート エージェント サービスの起動に失敗した場合は、サービス コントロール マネージャー用のイベント ビューアー (ローカル)>Windows ログ>システムに移動して、エラーの詳細を確認してください。
• Web Management Service のトレースをさらに構成できます。

エラー コード

特定の一般的なエラー ケースの場合、Web 配置には、問題のトラブルシューティングに役立つ可能性のあるメッセージとエラー コードが表示されます。 エラー コードの完全な一覧については、「 Web 配置エラー コード」を参照してください。

注:

Web Deploy の呼び出し方法によっては、エラー メッセージが異なる場合があります。 たとえば、Microsoft WebMatrix はエラー コードではなくカスタム エラー メッセージを表示することを選択しますが、コマンド ラインではログに記録されている場合は常にエラー コードが表示されます。

インストールの問題

1. 有効な OS に Web Deploy をインストールできませんでした

現象	オペレーティング システム (OS) は正しく、Web Deploy のバージョンとビット数は正しいですが、インストールは成功しません。
根本原因	不明
修正/回避策	%programfiles%\IIS\Microsoft Web Deploy V3 にあるインストール ログを確認します。

2. アップグレード後に Web 配置が機能しない

現象	バージョンのアップグレード後、Web Deploy は機能しません。
根本原因	Web Deploy は、アップグレード後にサービスを再起動しません。
修正/回避策	Web Deploy の既存のインストールをアップグレードする場合は、管理コマンド プロンプトで次のコマンドを実行して、ハンドラーサービスとエージェント サービスを再起動してください。 net stop msdepsvc net start msdepsvc net stop wmsvc net start wmsvc

3. 64 ビット ハードウェアに Web Deploy 32 ビット バージョンをインストールできませんでした

現象
根本原因	64 ビット OS に 32 ビットをインストールすることは、WoW64 モードをサポートしていないため失敗する Web Deploy MSI 内のチェックです。
修正/回避策	OS のアーキテクチャと一致する同じバージョンをインストールします。

4. 32 ビット ハードウェアに Web Deploy 64 ビット バージョンをインストールできませんでした

現象
根本原因	32 ビット OS に 64 ビットをインストールしようとすると、Web Deploy の MSI 内のチェックが失敗します。
修正/回避策	OS のアーキテクチャと一致する同じバージョンをインストールします。

5. 既存の名前空間が原因で URL 名前空間を登録できませんでした

現象	Web Deploy をインストールできません。
根本原因	Web Deploy がインストール中に作成しようとする URL 名前空間は既に登録されています。
修正/回避策	- 競合する登録を削除します。 - インストール中に Web 配置 URL を変更する msiexec /i wdeploy.msi /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/. URL のカスタマイズの詳細については、「 リモート サービスのカスタマイズとセキュリティ保護」を参照してください。

リモート エージェント サービスの問題

1. 起動時に Microsoft.Web.Deployment.Dll を初期化できませんでした

現象	リモート エージェント サービスの起動に失敗します。
根本原因	%programfiles%\IIS\Microsoft Web Deploy v3 には、msdepsvc.exe またはその他のファイルがありません。
修正/回避策	製品を再インストールします。

2. リモート エージェント サービスが開始されていません

現象	Microsoft.Web.Deployment.DeploymentAgentUnavailableException: リモート エージェント (URL http://DestinationServer/msdeployagentservice) に接続できませんでした。 リモート エージェント サービスがターゲット コンピューターにインストールされ、起動されていることを確認します。 >--- System.Net.WebException: リモート サーバーからエラー (404) が見つかりませんでした。
根本原因	リモート エージェント サービスが開始されていません。
修正/回避策	サービスを開始します。 net start msdepsvc

3. HTTP がリッスンまたは許可されていないサーバーに接続しようとしています

現象	Microsoft.Web.Deployment.DeploymentAgentUnavailableException: リモート エージェント (URL http://DestinationServer/msdeployagentservice) に接続できませんでした。 リモート エージェント サービスがターゲット コンピューターにインストールされ、起動されていることを確認します。 >--- System.Net.WebException: System.Net.Sockets.SocketException --->リモート サーバーに接続できません:ターゲット コンピューターが DestinationServer:80 をアクティブに拒否したため、接続できませんでした
根本原因	HTTP がリッスンしていません。
修正/回避策	リモート エージェント サービスへの HTTP トラフィックが許可されていることを確認します。

4. メソッドが許可されていないエラーを使用してサーバーに接続しようとしています

現象	Microsoft.Web.Deployment.DeploymentException: リモート エージェント URL ''http://DestinationServer/ への要求を完了できませんでした。 >--- System.Net.WebException: リモート サーバーからエラーが返されました: (405) メソッドが許可されていません。
根本原因	要求は、 msdepsvc.exeへのパス がないため、MS Deploy ではなくインターネット インフォメーション サービス (IIS) 自体によって取得されました。
修正/回避策	を含むように /MSDeployAgentServiceURL を変更します。

5. 管理者以外としてリモート エージェント サービスにアクセスしようとしています

現象	Microsoft.Web.Deployment.DeploymentException: リモート エージェント URL ''http://DestinationServer/msdeployAgentService への要求を完了できませんでした。 >---。System.Net.WebException: リモート サーバーからエラー (401) 未承認が返されました。
根本原因	リモート エージェント サービスでは、呼び出し元が Administrators グループのメンバーであるか、Administrators グループに追加されたドメイン アカウントからである必要があります。 組み込みアカウントではないローカル管理者は、Web Deploy 2.0 のバグのため、リモート エージェント サービスでは動作しません。
修正/回避策	管理資格情報を指定します。

6. 操作中にリモート エージェント サービスがハングする

現象	サービスの応答が長時間 (最大数時間) 停止する場合があります。
根本原因	不明。
修正/回避策	操作を停止し、繰り返し試行します。

7. クライアントとサーバーに互換性がない (バージョンの不一致)

現象	Timestamp=24638007621418 MsDepSvc.exe エラー: 0 : エラーが発生しました。 例外の詳細は次のとおりです。Microsoft.Web.Deployment.DeploymentClientServerException: クライアントとサーバーは互換性がありません。 クライアントでサポートされている最も低いバージョンは '7.1.538.0' です。 サーバーでサポートされている最高バージョンは '7.1.537.0' です。
根本原因	一部のバージョンは連携しないため、Web 配置によって連携がブロックされます。 通常、リリース前のバージョンがリリースされたバージョンで動作することをブロックするために行われます。
修正/回避策	バージョンと一致します。

8. リモート エージェント サービスが URL のリッスンを開始できませんでした

現象	リモート エージェント サービスが URL ''{0} でリッスンを開始できませんでした。 URL が使用されていないことを確認します。
根本原因	通常、URL の競合を示します。
修正/回避策	既定の URL が必要な場合は再インストールするか、ドキュメントで指定したカスタム URL を設定してみてください。 URL のカスタマイズの詳細については、「 リモート サービスのカスタマイズとセキュリティ保護」を参照してください。

Web Management Service の問題

1. Web 管理サービスが開始されていません

現象	Web 管理サービスが開始されていません。
根本原因	不明。 サービスは既定で開始する必要があります。
修正/回避策	Web Management Service サービスを開始します。 Net Start WMSVC

2. 承認されていません: デプロイ ハンドラールールによって承認されていないユーザー

現象	Web 管理サービスを使用して接続するときに、指定したプロバイダー <ProviderName> で操作を完了できませんでした。 これは、サーバー管理者がこの操作に対してユーザーを承認していない場合に発生する可能性があります。
根本原因	管理者以外のユーザーが、プロバイダーに対して制限付きアクションを実行しようとしました。 通常、このアクションは、一致する委任ルールが見つからなかったことを示します。 ユーザー名、プロバイダー、操作、またはプロバイダー パスが間違っています。
修正/回避策	回避策は、委任ルールを修正するか、作成することです。 委任規則の詳細については、「 Web 配置ハンドラーの構成」を参照してください。

Visual Studio から発行するときのエラー

Web 配置を使用して正しく構成されていないサーバーに Visual Studio から発行しようとしたときに発生する可能性がある一般的なエラーのトラブルシューティングの詳細については、「 Visual Studio での Web 配置の問題のトラブルシューティング」を参照してください。