Behandeln von häufigen Problemen im Zusammenhang mit Web Deploy

  • Artikel

Gilt für: Internetinformationsdienste

In diesem Artikel wird beschrieben, wie Sie häufige Probleme mit Web Deploy diagnostizieren und beheben, einschließlich häufiger Fehler, die bei der Veröffentlichung in Visual Studio 2010 auftreten.

Protokollierung

Wenn Probleme im Zusammenhang mit Web Deploy auftreten, gibt es verschiedene Protokollierungsoptionen, je nachdem, wo das Problem auftritt. Standardmäßig protokolliert Web Deploy im Ereignisprotokoll unter Anwendungen>Microsoft Web Deploy. Dies ist ein guter Ort, um auf dem Zielserver nach Fehlern zu suchen.

Wenn Sie das Problem nicht mithilfe des Ereignisprotokolls diagnostizieren können, finden Sie hier einige weitere Optionen:

  • Verwenden Sie Web Deploy MSI-Protokolle unter %programfiles%\IIS\Microsoft Web Deploy v3 , um Installationsprobleme zu diagnostizieren.
  • Wenn der Webverwaltungsdienst oder der Remote-Agent-Dienst nicht gestartet werden kann, lesen Sie die Fehlerdetails unter Ereignisanzeige (lokal)>Windows Logs>System for Service Control Manager.
  • Sie können die Ablaufverfolgung für den Webverwaltungsdienst weiter konfigurieren.

Fehlercodes

Für bestimmte häufige Fehlerfälle zeigt Web Deploy eine Meldung und einen Fehlercode an, die hilfreich sein können, um weitere Informationen zur Problembehandlung zu erhalten. Eine vollständige Liste der Fehlercodes finden Sie unter Web Deploy-Fehlercodes.

Hinweis

Je nachdem, wie Web Deploy aufgerufen wird, kann sich die Fehlermeldung unterscheiden. Microsoft WebMatrix zeigt beispielsweise benutzerdefinierte Fehlermeldungen anstelle von Fehlercodes an, während in der Befehlszeile immer Fehlercodes angezeigt werden, wenn diese protokolliert werden.

Installationsprobleme

1. Web Deploy konnte unter einem gültigen Betriebssystem nicht installiert werden

Symptome Das Betriebssystem ist korrekt, und die Version und Bitanzahl von Web Deploy sind korrekt, aber die Installation ist nicht erfolgreich.
Ursache Unbekannt
Korrektur/Problemumgehung Suchen Sie im Installationsprotokoll unter %programfiles%\IIS\Microsoft Web Deploy V3.

2. Web Deploy funktioniert nach einem Upgrade nicht

Symptome Web Deploy funktioniert nach einem Versionsupgrade nicht mehr.
Ursache Web Deploy startet Dienste nach einem Upgrade nicht neu.
Korrektur/Problemumgehung Wenn Sie eine vorhandene Installation von Web Deploy aktualisieren, stellen Sie sicher, dass Sie den Handler und die Agent-Dienste neu starten, indem Sie die folgenden Befehle an einer administrativen Eingabeaufforderung ausführen:
net stop msdepsvc
net start msdepsvc
net stop wmsvc
net start wmsvc

3. Web Deploy 32-Bit-Version konnte nicht auf 64-Bit-Hardware installiert werden

Symptome Screenshot des Dialogfelds
Ursache Der Versuch, die 32-Bit-Version auf einem 64-Bit-Betriebssystem zu installieren, ist eine Überprüfung innerhalb der Web Deploy-MSI, die fehlschlägt, da der WoW64-Modus nicht unterstützt wird.
Korrektur/Problemumgehung Installieren Sie dieselbe Version, die der Architektur Ihres Betriebssystems entspricht.

4. Die 64-Bit-Version von Web Deploy konnte nicht auf 32-Bit-Hardware installiert werden.

Symptome Screenshot: Dialogfeld
Ursache Der Versuch, die 64-Bit-Version auf einem 32-Bit-Betriebssystem zu installieren, ist eine Überprüfung innerhalb der MSI von Web Deploy, die fehlschlägt.
Korrektur/Problemumgehung Installieren Sie dieselbe Version, die der Architektur Ihres Betriebssystems entspricht.

5. Der URL-Namespace konnte aufgrund eines bereits vorhandenen Namespaces nicht registriert werden.

Symptome Web Deploy kann nicht installiert werden.
Ursache Der URL-Namespace, den Web Deploy während der Installation zu erstellen versucht, ist bereits registriert.
Korrektur/Problemumgehung – Entfernen Sie die in Konflikt stehende Registrierung.
– Ändern der Web Deploy-URL während der Installation
msiexec /i wdeploy.msi /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/.
Weitere Informationen zur URL-Anpassung finden Sie unter Anpassen und Schützen des Remotediensts.

Probleme mit dem Remote-Agent-Dienst

1. Microsoft.Web.Deployment.Dll konnte während des Starts nicht initialisiert werden

Symptome Der Remote-Agent-Dienst kann nicht gestartet werden.
Ursache msdepsvc.exe oder andere Dateien fehlen in %programfiles%\IIS\Microsoft Web Deploy v3.
Korrektur/Problemumgehung Installieren Sie das Produkt neu.

2. Der Remote-Agent-Dienst wurde nicht gestartet

Symptome Microsoft.Web.Deployment.DeploymentAgentUnavailableException: Remote-Agent (URL http://DestinationServer/msdeployagentservice) konnte nicht kontaktiert werden. Stellen Sie sicher, dass der Remote-Agent-Dienst auf dem Zielcomputer installiert und gestartet ist. >--- System.Net.WebException: Der Remoteserver hat einen Fehler zurückgegeben: (404) Nicht gefunden.
Ursache Der Remote-Agent-Dienst wurde nicht gestartet.
Korrektur/Problemumgehung Starten Sie den Dienst: net start msdepsvc.

3. Herstellen einer Verbindung mit einem Server, auf dem HTTP nicht lauscht oder nicht zulässig ist

Symptome Microsoft.Web.Deployment.DeploymentAgentUnavailableException: Remote-Agent (URL http://DestinationServer/msdeployagentservice) konnte nicht kontaktiert werden. Stellen Sie sicher, dass der Remote-Agent-Dienst auf dem Zielcomputer installiert und gestartet ist. >--- System.Net.WebException: Verbindung mit dem Remoteserver nicht möglich ---> System.Net.Sockets.SocketException: Es konnte keine Verbindung hergestellt werden, da der Zielcomputer sie aktiv abgelehnt hat DestinationServer:80
Ursache HTTP lauscht nicht.
Korrektur/Problemumgehung Stellen Sie sicher, dass HTTP-Datenverkehr für den Remote-Agent-Dienst zulässig ist.

4. Versuch, eine Verbindung mit einem Server herzustellen, mit dem Fehler "Methode nicht zulässig"

Symptome Microsoft.Web.Deployment.DeploymentException: Die Anforderung an die Remote-Agent-URL "http://DestinationServer/" konnte nicht abgeschlossen werden. >--- System.Net.WebException: Der Remoteserver hat einen Fehler zurückgegeben: (405) Methode nicht zulässig.
Ursache Die Anforderung wurde von Internetinformationsdienste (IIS) selbst anstelle von MS Deploy aufgenommen, da der Pfad zu msdepsvc.exe fehlt.
Korrektur/Problemumgehung Ändern Sie die URL so, dass sie enthält /MSDeployAgentService.

5. Zugriff auf den Remote-Agent-Dienst als Nicht-Administrator

Symptome Microsoft.Web.Deployment.DeploymentException: Die Anforderung an die Remote-Agent-URL "http://DestinationServer/msdeployAgentService" konnte nicht abgeschlossen werden. >---; System.Net.WebException: Der Remoteserver hat einen Fehler zurückgegeben: (401) Nicht autorisiert.
Ursache Der Remote-Agent-Dienst erfordert, dass der Aufrufer Mitglied der Gruppe Administratoren oder aus einem Domänenkonto ist, das der Gruppe Administratoren hinzugefügt wurde. Ein lokaler Administrator, der nicht das integrierte Konto ist, funktioniert aufgrund eines Fehlers in Web Deploy 2.0 nicht mit dem Remote-Agent-Dienst.
Korrektur/Problemumgehung Geben Sie Administratoranmeldeinformationen an.

6. Remote-Agent-Dienst hängt während des Betriebs

Symptome Der Dienst reagiert möglicherweise für einen längeren Zeitraum bis zu mehreren Stunden nicht mehr.
Ursache Unbekannt.
Korrektur/Problemumgehung Beenden Sie den Vorgang, und versuchen Sie, ihn zu wiederholen.

7. Client und Server sind nicht kompatibel (Versionskonflikt)

Symptome Timestamp=24638007621418 MsDepSvc.exe Fehler: 0 : Fehler. Die Ausnahmedetails sind wie folgt: Microsoft.Web.Deployment.DeploymentClientServerException: Client und Server sind nicht kompatibel. Die niedrigste vom Client unterstützte Version ist "7.1.538.0". Die höchste vom Server unterstützte Version ist "7.1.537.0".
Ursache Einige Versionen funktionieren nicht zusammen, sodass Web Deploy die Zusammenarbeit blockiert. Dies wird in der Regel durchgeführt, um zu verhindern, dass Vorabversionen mit veröffentlichten Versionen ausgeführt werden.
Korrektur/Problemumgehung Übereinstimmung mit den Versionen.

8. Der Remote-Agent-Dienst konnte nicht mit dem Lauschen an der URL beginnen

Symptome Der Remote-Agent-Dienst konnte nicht beginnen, an der URL ""{0} zu lauschen. Stellen Sie sicher, dass die URL nicht verwendet wird.
Ursache Weist in der Regel auf einen URL-Konflikt hin.
Korrektur/Problemumgehung Versuchen Sie, die Standard-URL neu zu installieren, oder legen Sie eine benutzerdefinierte URL fest, wie in der Dokumentation angegeben. Weitere Informationen zur URL-Anpassung finden Sie unter Anpassen und Schützen des Remotediensts.

Probleme mit dem Webverwaltungsdienst

1. Der Webverwaltungsdienst wurde nicht gestartet

Symptome Der Webverwaltungsdienst wurde nicht gestartet.
Ursache Unbekannt. Der Dienst sollte standardmäßig gestartet werden.
Korrektur/Problemumgehung Starten Sie den Webverwaltungsdienst: Net Start WMSVC.

2. Nicht autorisiert: Benutzer nicht durch Bereitstellungshandlerregeln autorisiert

Symptome Ein Vorgang mit dem angegebenen ProviderName <> konnte beim Herstellen einer Verbindung mit dem Webverwaltungsdienst nicht abgeschlossen werden. Dies kann auftreten, wenn der Serveradministrator den Benutzer nicht für diesen Vorgang autorisiert hat.
Ursache Ein Benutzer ohne Administratorrechte hat versucht, eine eingeschränkte Aktion mit einem Anbieter auszuführen. Diese Aktion gibt in der Regel an, dass keine übereinstimmende Delegierungsregel gefunden wurde. Entweder der Benutzername, der Anbieter, der Vorgang oder der Anbieterpfad ist falsch.
Korrektur/Problemumgehung Die Problemumgehung besteht darin, die Delegierungsregel zu korrigieren oder eine zu erstellen. Weitere Informationen zu Delegierungsregeln finden Sie unter Konfigurieren des Webbereitstellungshandlers.

Fehler beim Veröffentlichen aus Visual Studio

Weitere Informationen zur Behandlung häufiger Fehler, die beim Veröffentlichen von Visual Studio auf einem Server auftreten können, der nicht ordnungsgemäß über Web Deploy konfiguriert wurde, finden Sie unter Problembehandlung bei Web Deploy-Problemen mit Visual Studio.