Résoudre les problèmes courants liés au déploiement web
Article
S’applique à : Internet Information Services
Cet article explique comment diagnostiquer et résoudre les problèmes courants liés au déploiement web, y compris les erreurs courantes observées lors de la publication à partir de Visual Studio 2010.
Logging
Lorsque vous rencontrez des problèmes liés au déploiement web, il existe plusieurs options de journalisation en fonction de l’endroit où se produit le problème. Par défaut, web Deploy enregistre les journaux d’activité dans le journal des événements sous Applications>Microsoft Web Deploy. C’est un 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 à l’Observateur d’événements (local)>Système de journaux> Windows pour Service Control Manager.
Pour certains cas d’erreur courants, Web Deploy affiche un message et un code d’erreur qui peut être utile pour obtenir plus d’informations pour résoudre un problème. Pour obtenir la liste complète des codes d’erreur, consultez les codes d’erreur Web Deploy.
Note
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 au lieu de 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 bit du déploiement web sont corrects, mais l’installation ne réussit pas.
Cause racine
Inconnu
Correctif/solution de contournement
Recherchez le journal d’installation, situé dans %programfiles%\IIS\Microsoft Web Deploy V3.
2. Le déploiement web ne fonctionne pas après une mise à niveau
Symptômes
Web Deploy ne fonctionne pas après une mise à niveau de version.
Cause racine
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 web Deploy 32 bits version sur du matériel 64 bits
Symptômes
Cause racine
Essayer d’installer le système d’exploitation 32 bits sur 64 bits est une vérification à l’intérieur de l’instance MSI web Deploy qui échoue, car elle ne prend pas en charge le mode WoW64.
Correctif/solution de contournement
Installez la même version qui correspond à l'architecture de votre système d'exploitation.
4. Impossible d’installer web Deploy 64 bits version sur du matériel 32 bits
Symptômes
Cause racine
Essayer d'installer le système d'exploitation 64 bits sur 32 bits est une vérification de MSI de Web Deploy qui échouera.
Correctif/solution de contournement
Installez la même version 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 racine
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 des 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 pendant le démarrage
Symptômes
Le service d’agent distant ne parvient pas à démarrer.
Cause racine
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 a démarré sur l'ordinateur cible. ---> System.Net.WebException : le serveur distant a retourné une erreur : (404) Introuvable.
Cause racine
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’écoute pas ou n’est pas 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 a 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 a refusé activement DestinationServer:80
Cause racine
HTTP n’écoute pas.
Correctif/solution de contournement
Vérifiez que le trafic HTTP est autorisé au 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 demande à l'URL de l'Agent distant « http://DestinationServer/ ». ---> System.Net.WebException : le serveur distant a retourné une erreur : (405) Méthode non autorisée.
Cause racine
La demande a été récupérée par Internet Information Services (IIS) elle-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 qu'administrateur
Symptômes
Microsoft.Web.Deployment.DeploymentException : impossible de terminer la demande à l'URL de l'Agent distant « http://DestinationServer/msdeployAgentService ». >--- ; System.Net.WebException : Le serveur distant a retourné une erreur : (401) Non autorisé.
Cause racine
Le service d'Agent distant nécessite que l'appelant soit membre du groupe Administrateurs ou d'un compte de domaine ajouté au groupe Administrateurs. Un administrateur local qui n’est pas le compte intégré ne fonctionnera 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 administratives.
6. Le service d'Agent distant se bloque pendant son exécution
Symptômes
Le service peut cesser de répondre pendant une longue période, jusqu’à plusieurs heures.
Cause racine
Inconnu.
Correctif/solution de contournement
Arrêtez l’opération et tentez de la répéter.
7. Le client et le serveur ne sont pas compatibles (incompatibilité de version)
Symptômes
Timestamp=24638007621418 MsDepSvc.exe Error: 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 racine
Certaines versions ne fonctionnent pas ensemble. Web Deploy les empêche donc de travailler ensemble. Il est généralement fait pour bloquer l’exploitation des versions préliminaires avec les versions publiées.
Correctif/solution de contournement
Mettre en correspondance les versions.
8. Le service d’agent distant n’a pas pu démarrer l’écoute sur l’URL
Symptômes
Le service d’agent distant n’a pas pu démarrer l’écoute sur l’URL «{0} ». Vérifiez que l’URL n’est pas utilisée.
Cause racine
Indique généralement un conflit d'URL.
Correctif/solution de contournement
Essayez de réinstaller si vous voulez l'URL par défaut ou de définir une URL personnalisée comme indiqué dans la documentation. Pour plus d'informations sur la personnalisation des 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 racine
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 du gestionnaire de déploiement
Symptômes
Impossible d’effectuer une opération avec le 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 racine
Un utilisateur non administrateur a essayé d'effectuer une action soumise à restriction avec un fournisseur. Cette action indique généralement qu’une règle de délégation correspondante n’a pas é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 lors de la tentative de publication à 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.
