Comment : installer le débogage distant
Mise à jour : novembre 2007
Cette rubrique s'applique à :
Édition |
Visual Basic |
C# |
C++ |
Web Developer |
|---|---|---|---|---|
Express |
.gif) |
|
|
|
Standard |
|
|
|
|
Pro et Team |
.gif) |
|
|
|
Légende du tableau :
|
Applicable |
|
Non applicable |
.gif) |
Commande ou commandes masquées par défaut. |
Pour activer le débogage distant, vous pouvez procéder comme suit :
Installer Remote Debugging Monitor (msvsmon.exe) sur l'ordinateur distant et le lancer lorsque vous commencez à déboguer, ou
Exécuter à distance Remote Debugging Monitor à partir d'un partage.
L'exécution de Remote Debugging Monitor à partir d'un partage de fichiers est la façon la plus facile d'activer le débogage distant. Visual Studio installe msvsmon.exe dans les répertoires suivants :
Chemin d'installation\Microsoft Visual Studio 8\Common7\IDE\Remote Debugger\x86
Chemin d'installation\Microsoft Visual Studio 8\Common7\IDE\Remote Debugger\x64
Chemin d'installation\Microsoft Visual Studio 8\Common7\IDE\Remote Debugger\ia64
Les composants IA-64 sont uniquement disponibles avec Visual Studio Team System.
Lorsque vous installez Visual Studio sur une plateforme 64 bits, les composants de débogage distant 64 bits et x86 sont installés. Lorsque vous installez Visual Studio sur une plateforme x86, les composants de débogage distant x86 sont installés par défaut. Les composants de débogage 64 bits sont installés si vous choisissez l'option correspondante lors de l'installation.
Lorsque vous installez Remote Debugging Monitor sur une plateforme x86, seuls les composants de débogage distant x86 sont installés. Aucune option ne permet d'installer les composants 64 bits.
En partageant le répertoire des composants de débogage distant sur l'ordinateur Visual Studio, vous pouvez exécuter msvsmon.exe sur l'ordinateur distant. Les fonctionnalités de débogueur suivantes ne fonctionnent pas lorsque Remote Debugging Monitor est exécuté à partir d'un partage :
Exécution pas à pas d'un service Web XML (L'attachement manuel est toujours possible.)
Débogage automatique d'une application Web ASP.NET. (Là encore, l'attachement manuel est toujours possible.)
Au lieu d'exécuter un partage, vous pouvez utiliser le CD du Débogueur distant Visual Studio 2005 pour installer les composants de débogage distant nécessaires sur l'ordinateur distant. Cette installation fournit l'accès à toutes les fonctionnalités de débogage distant. Lorsque vous installez le Débogueur distant sur une plateforme x86, seuls les composants de débogage distant x86 sont installés. Aucune option ne permet d'installer les composants 64 bits. Si vous l'installez sur une plateforme 64 bits, les composants x86 et 64 bits sont installés.
Certains scénarios de débogage exigent l'installation de composants supplémentaires.
Pour installer les composants de débogage distant
Le Débogueur distant est disponible sur le dernier disque de votre jeu d'installation de Visual Studio. Insérez ce disque sur l'ordinateur distant. Par exemple, si le jeu d'installation contient quatre disques, insérez le disque quatre dans l'ordinateur distant. Si vous avez un DVD au lieu d'un CD, insérez le DVD.
Dans l'Explorateur Windows, ouvrez le CD/DVD. Localisez le dossier Remote Debugger (sur le CD) ou vs/Remote Debugger (sur le DVD).
Dans le dossier Débogueur distant, ouvrez le sous-dossier qui correspond à votre plateforme (x86, x64 ou IA-64).
Démarrez la copie de rdbgsetup.exe située dans ce sous-dossier et suivez les instructions pour terminer l'installation.
Si vous préférez, vous pouvez installer les composants de débogage distant en copiant les fichiers manuellement. Consultez Composants de débogage distant pour obtenir la liste des composants requis et de leur emplacement d'installation. Visual Studio inclut des versions distinctes de Remote Debugging Monitor destinées aux plateformes 32 bits et 64 bits. Si vous utilisez rdbgsetup.exe, le programme d'installation des composants distants installe automatiquement la version correcte de Remote Debugging Monitor. Si vous copiez les fichiers manuellement, vous devez veiller à copier la version appropriée.
Après avoir installé les composants de débogage distant, vous devez vérifier que vous disposez des autorisations requises pour déboguer un programme sur l'ordinateur distant. Consultez Autorisations de débogage distant pour obtenir la liste des autorisations requises.
Configuration du Pare-feu Windows
Le Pare-feu Windows doit être configuré pour activer le débogage distant. Lors du premier débogage distant, Visual Studio exécute la configuration nécessaire sur l'ordinateur hôte Visual Studio. De même, lorsque vous exécutez Remote Debugging Monitor sur un ordinateur distant pour la première fois, Remote Debugging Monitor configure le Pare-feu Windows à cette fin.
Sous Windows XP, cette configuration est complètement transparente et automatique. Toutefois, sous Windows Vista, le nouveau modèle de sécurité vous impose d'accorder l'autorisation avant que le logiciel puisse configurer le pare-feu. Cette autorisation est accordée à l'aide de la boîte de dialogue Contrôle de compte d'utilisateur. Pour obtenir la description du nouveau modèle de sécurité et du contrôle d'accès d'utilisateur, consultez Modèle de sécurité de Windows Vista.
Lorsque Remote Debugging Monitor doit configurer le Pare-feu Windows sur l'ordinateur distant, la boîte de dialogue Contrôle d'accès d'utilisateur s'affiche sur l'ordinateur distant. Si l'ordinateur distant n'est pas visible, vous pouvez ne pas vous rendre compte que la boîte de dialogue Contrôle de compte d'utilisateur s'est affichée sur l'écran. Dans ce cas, vous pouvez penser par erreur que le débogage distant ne répond plus. En réalité, Remote Debugging Monitor attend simplement qu'un utilisateur accorde l'autorisation Contrôle de compte d'utilisateur sur l'ordinateur distant.
Pour éviter ce problème, vous pouvez préconfigurer le pare-feu sur l'ordinateur distant à l'aide de l'Assistant Configuration Débogueur distant.
Il est très peu probable que le Pare-feu Windows doive être configuré manuellement. Toutefois, si vous le configurez manuellement, consultez Comment : configurer manuellement le Pare-feu Windows XP pour le débogage distant ou Comment : configurer manuellement le Pare-feu Windows Vista pour le débogage distant.
Pour configurer le Pare-feu Windows à l'aide de l'Assistant Configuration Débogueur distant
Assurez-vous que les composants de débogage distant sont installés sur l'ordinateur.
Cliquez sur Démarrer, pointez sur Tous les programmes, Visual Studio 9.0, puis cliquez sur Assistant Configuration Débogueur distant Visual Studio.
Cliquez sur Démarrer, pointez sur Tous les programmes, Visual Studio 9.0, puis cliquez sur Débogueur distant.
Suivez les instructions de l'Assistant Configuration Débogueur distant.
Débogage du serveur Web
Pour activer le débogage du serveur Web sur Windows Vista ou Windows XP SP2
Pour activer le débogage du serveur Web sur Windows Vista ou sur Windows XP SP2, vous devez exécuter des étapes supplémentaires.
Pour Windows Vista, consultez Comment : activer le débogage du serveur Web sur Windows Vista.
Pour Windows XP SP2, consultez Comment : activer le débogage du serveur Web sur Windows XP SP2.
Démarrage du débogage distant
Pour démarrer le débogage distant
Assurez-vous que vous disposez des autorisations de débogage distant nécessaires sur l'ordinateur distant. Pour plus d'informations, consultez Autorisations de débogage distant.
Pour un débogage distant autre que SQL, assurez-vous d'exécuter Remote Debugging Monitor sur l'ordinateur distant. Pour plus d'informations, consultez Comment : exécuter Remote Debugging Monitor. Lors du débogage SQL, Remote Debugging Monitor se lance automatiquement pendant le débogage.
Lancez Visual Studio sur l'hôte du débogueur.
À l'aide de Visual Studio, attachez ou lancez le programme que vous souhaitez déboguer sur l'ordinateur distant. Pour plus d'informations, consultez Comment : attacher à un processus en cours d'exécution.
Voir aussi
Tâches
Erreurs de débogage distant et dépannage