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.
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.
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.
