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