Résoudre les problèmes courants liés à Web Deploy

S’applique à : Internet Information Services

Cet article explique comment diagnostiquer et résoudre les problèmes courants liés à Web Deploy, notamment les erreurs courantes observées lors de la publication à partir de Visual Studio 2010.

Journalisation

Lorsque vous rencontrez des problèmes liés à Web Deploy, il existe plusieurs options de journalisation en fonction de l’endroit où le problème se produit. Par défaut, Web Deploy enregistre dans le journal des événements sous Applications>Microsoft Web Deploy. C’est l’endroit idéal pour commencer à rechercher des erreurs sur le serveur de destination.

Si vous ne pouvez pas diagnostiquer le problème à l’aide du journal des événements, voici d’autres options :

• Utilisez les journaux MSI Web Deploy situés sous %programfiles%\IIS\Microsoft Web Deploy v3 pour diagnostiquer les problèmes d’installation.
• Si le service de gestion web ou le service d’agent distant ne parvient pas à démarrer, consultez les détails de l’erreur en accédant à observateur d'événements (local)>Systèmede journaux> Windows pour le Gestionnaire de contrôle de service.
• Vous pouvez configurer davantage le suivi pour le service de gestion web.

Codes d’erreur

Pour certains cas d’erreur courants, Web Deploy affiche un message et un code d’erreur qui peuvent être utiles pour obtenir plus d’informations pour résoudre un problème. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur Web Deploy.

Remarque

Le message d’erreur peut être différent selon la façon dont Web Deploy est appelé. Par exemple, Microsoft WebMatrix choisit d’afficher des messages d’erreur personnalisés plutôt que des codes d’erreur, tandis que la ligne de commande affiche toujours les codes d’erreur s’ils sont enregistrés.

Problèmes d’installation

1. Impossible d’installer Web Deploy sur un système d’exploitation valide

Symptômes	Le système d’exploitation est correct et la version et le nombre de bits de Web Deploy sont corrects, mais l’installation n’aboutit pas.
Cause	Inconnu
Correctif/solution de contournement	Examinez le journal d’installation, situé dans %programfiles%\IIS\Microsoft Web Deploy V3.

2. Web Deploy ne fonctionne pas après une mise à niveau

Symptômes	Web Deploy ne fonctionne pas après une mise à niveau de version.
Cause	Web Deploy ne redémarre pas les services après une mise à niveau.
Correctif/solution de contournement	Si vous mettez à niveau une installation existante de Web Deploy, veillez à redémarrer le gestionnaire et les services d’agent en exécutant les commandes suivantes à l’invite de commandes d’administration : net stop msdepsvc net start msdepsvc net stop wmsvc net start wmsvc

3. Impossible d’installer la version 32 bits de Web Deploy sur du matériel 64 bits

Symptômes
Cause	La tentative d’installation 32 bits sur un système d’exploitation 64 bits est une case activée à l’intérieur de l’msi web Deploy qui échoue, car elle ne prend pas en charge le mode WoW64.
Correctif/solution de contournement	Installez la même version que celle qui correspond à l’architecture de votre système d’exploitation.

4. Impossible d’installer la version 64 bits de Web Deploy sur du matériel 32 bits

Symptômes
Cause	La tentative d’installation 64 bits sur le système d’exploitation 32 bits est une case activée à l’intérieur du MSI de Web Deploy qui échoue.
Correctif/solution de contournement	Installez la même version que celle qui correspond à l’architecture de votre système d’exploitation.

5. Impossible d’inscrire l’espace de noms d’URL en raison d’un espace de noms préexistant

Symptômes	Impossible d’installer Web Deploy.
Cause	L’espace de noms URL que Web Deploy tente de créer pendant l’installation est déjà inscrit.
Correctif/solution de contournement	- Supprimez l’inscription en conflit. - Modifier l’URL de déploiement web lors de l’installation msiexec /i wdeploy.msi /passive ADDLOCAL=ALL LISTENURL=http://+:8080/MSDEPLOY2/. Pour plus d’informations sur la personnalisation de l’URL, consultez Personnalisation et sécurisation du service distant.

Problèmes liés au service de l’agent distant

1. Impossible d’initialiser Microsoft.Web.Deployment.Dll au démarrage

Symptômes	Le service d’agent distant ne parvient pas à démarrer.
Cause	msdepsvc.exe ou d’autres fichiers sont manquants dans %programfiles%\IIS\Microsoft Web Deploy v3.
Correctif/solution de contournement	Réinstallez le produit.

2. Le service d’agent distant n’est pas démarré

Symptômes	Microsoft.Web.Deployment.DeploymentAgentUnavailableException : L’agent distant (URL http://DestinationServer/msdeployagentservice) n’a pas pu être contacté. Vérifiez que le service d’agent distant est installé et démarré sur l’ordinateur cible. >--- System.Net.WebException : le serveur distant a renvoyé une erreur : (404) Introuvable.
Cause	Le service d’agent distant n’est pas démarré.
Correctif/solution de contournement	Démarrez le service : net start msdepsvc.

3. Tentative de connexion à un serveur où HTTP n’est pas à l’écoute ou autorisé

Symptômes	Microsoft.Web.Deployment.DeploymentAgentUnavailableException : L’agent distant (URL http://DestinationServer/msdeployagentservice) n’a pas pu être contacté. Vérifiez que le service d’agent distant est installé et démarré sur l’ordinateur cible. >--- System.Net.WebException : Impossible de se connecter au serveur distant ---> System.Net.Sockets.SocketException : aucune connexion n’a pu être établie, car la machine cible lui a refusé activement DestinationServer :80
Cause	HTTP n’écoute pas.
Correctif/solution de contournement	Assurez-vous que le trafic HTTP est autorisé vers le service d’agent distant.

4. Tentative de connexion à un serveur avec l’erreur Méthode non autorisée

Symptômes	Microsoft.Web.Deployment.DeploymentException : impossible de terminer la requête à l’URL de l’agent distant « ».http://DestinationServer/ >--- System.Net.WebException : le serveur distant a renvoyé une erreur : (405) Méthode non autorisée.
Cause	La requête a été récupérée par Internet Information Services (IIS) lui-même au lieu de MS Deploy, car le chemin d’accès àmsdepsvc.exe est manquant.
Correctif/solution de contournement	Modifiez l’URL pour inclure /MSDeployAgentService.

5. Tentative d’accès au service d’agent distant en tant que non-administrateur

Symptômes	Microsoft.Web.Deployment.DeploymentException : impossible de terminer la requête à l’URL de l’agent distant « ».http://DestinationServer/msdeployAgentService >--- ; System.Net.WebException : le serveur distant a renvoyé une erreur : (401) Non autorisé.
Cause	Le service Agent distant nécessite que l’appelant soit membre du groupe Administrateurs ou d’un compte de domaine qui a été ajouté au groupe Administrateurs. Un administrateur local qui n’est pas le compte intégré ne fonctionne pas avec le service d’agent distant en raison d’un bogue dans Web Deploy 2.0.
Correctif/solution de contournement	Fournissez des informations d’identification d’administration.

6. Le service d’agent distant se bloque pendant l’opération

Symptômes	Le service peut cesser de répondre pendant une longue période, jusqu’à plusieurs heures.
Cause	Inconnu.
Correctif/solution de contournement	Arrêtez l’opération et essayez de la répéter.

7. Le client et le serveur ne sont pas compatibles (incompatibilité de version)

Symptômes	Timestamp=24638007621418 MsDepSvc.exe Erreur : 0 : Une erreur s’est produite. Les détails de l’exception sont les suivants : Microsoft.Web.Deployment.DeploymentClientServerException : le client et le serveur ne sont pas compatibles. La version la plus basse prise en charge par le client est « 7.1.538.0 ». La version la plus élevée prise en charge par le serveur est « 7.1.537.0 ».
Cause	Certaines versions ne fonctionnent pas ensemble. Web Deploy les empêche donc de travailler ensemble. Elle est généralement effectuée pour empêcher les versions préliminaires de fonctionner avec les versions publiées.
Correctif/solution de contournement	Correspond aux versions.

8. Le service d’agent à distance n’a pas pu démarrer l’écoute sur l’URL

Symptômes	Le service d’agent distant n’a pas pu commencer à écouter sur l’URL «{0} ». Assurez-vous que l’URL n’est pas en cours d’utilisation.
Cause	Indique généralement un conflit d’URL.
Correctif/solution de contournement	Essayez de réinstaller si vous souhaitez utiliser l’URL par défaut ou définir une URL personnalisée comme spécifié dans la documentation. Pour plus d’informations sur la personnalisation de l’URL, consultez Personnalisation et sécurisation du service distant.

Problèmes liés au service de gestion web

1. Le service de gestion web n’est pas démarré

Symptômes	Le service de gestion web n’est pas démarré.
Cause	Inconnu. Le service doit être démarré par défaut.
Correctif/solution de contournement	Démarrez le service de gestion web : Net Start WMSVC.

2. Non autorisé : utilisateur non autorisé par les règles de gestionnaire de déploiement

Symptômes	Impossible d’effectuer une opération avec le fournisseur <ProviderName> spécifié lors de la connexion à l’aide du service de gestion web. Cela peut se produire si l’administrateur du serveur n’a pas autorisé l’utilisateur pour cette opération.
Cause	Un utilisateur non administrateur a tenté d’effectuer une action restreinte avec un fournisseur. Cette action indique généralement qu’aucune règle de délégation correspondante n’a été trouvée. Le nom d’utilisateur, le fournisseur, l’opération ou le chemin du fournisseur est incorrect.
Correctif/solution de contournement	La solution de contournement consiste à corriger la règle de délégation ou à en créer une. Pour plus d’informations sur les règles de délégation, consultez Configurer le gestionnaire de déploiement web.

Erreurs lors de la publication à partir de Visual Studio

Pour plus d’informations sur la résolution des erreurs courantes que vous pouvez rencontrer lorsque vous essayez de publier à partir de Visual Studio sur un serveur qui n’a pas été correctement configuré via Web Deploy, consultez Résolution des problèmes de déploiement web avec Visual Studio.