Visual Studio kullanarak uzaktaki bir IIS (Internet Information Services) sunucusunda çalışan bir uygulamayı debug etmek bazen zorlayıcı olabilir. Ancak doğru adımları uygularsanız, Remote Debugging işlemini sorunsuz bir şekilde gerçekleştirebilirsiniz.
Bu makalede, uzak bir IIS sunucusunda çalışan uygulamayı debug etmenin temel adımlarını anlatacağız.
1. Uzak Sunucuya Remote Debugger Kurulumu
Öncelikle, Remote Debugging Tools‘u sunucuya kurmalısınız.
1.1. Remote Debugging Tools’ü İndirme
🔗 İndirme bağlantısı:
👉 https://visualstudio.microsoft.com/downloads/#remote-tools
- Visual Studio sürümünüze uygun olanı indirin.
- Sunucu 64-bit ise,
vs_remotetools.exe (x64)
sürümünü yükleyin.
1.2. Remote Debugging Tools’ü Çalıştırma
msvsmon.exe
uygulamasını çalıştırın.- Açılan pencerede “No Authentication” modunu seçin (isteğe bağlı).
- Remote Debugging’i başlatın.
2. Güvenlik Duvarı ve Ağ Ayarlarını Yapılandırma
Remote Debugging için TCP 4022 portunun açık olması gerekmektedir.
Windows Güvenlik Duvarında İzin Verme (İngilizce Sistem için)
- Windows Defender Firewall’ı Açın:
Win + R
→firewall.cpl
→ Enter
- Advanced settings (Gelişmiş Ayarlar) sekmesine gidin.
- Inbound Rules (Gelen Kurallar) → New Rule… (Yeni Kural…)
- “Program” veya “Port” seçeneğini seçin:
- “Program” seçeneğinde
msvsmon.exe
dosyasına izin verin. - “Port” seçeneğini seçerek 4022 numaralı porta izin verin.
- “Program” seçeneğinde
- Allow the Connection (Bağlantıya İzin Ver) seçeneğini işaretleyin ve kuralı kaydedin.
3. Visual Studio ile Uzak IIS Üzerinde Debugging Yapma
3.1. IIS Sürecine (Process) Bağlanma
- Visual Studio’yu açın.
- Debug → Attach to Process… (
Ctrl + Alt + P
) - “Qualifier” kutusuna uzak sunucu IP adresini yazın: makefileKopyalaDüzenle
<Sunucu_IP_Adresi>:4022
Örneğin: makefileKopyalaDüzenle192.168.1.100:4022
- IIS Sürecini (w3wp.exe) seçin ve bağlanın.
- Listede
w3wp.exe
yoksa, “Show processes from all users” seçeneğini işaretleyin.
- Listede
4. Breakpoint ve Debugging Ayarları
✅ Breakpoints (Kesme Noktaları) ekleyin.
✅ PDB dosyalarının sunucuya uygun şekilde yüklendiğini kontrol edin.
✅ Kodunuzun debug edilebilir olduğundan emin olun.
Breakpoints çalışmıyorsa:
- Release modunda debugging yapıyor olabilirsiniz.
- Proje ayarlarından Debug moduna geçin ve kod optimizasyonlarını kapatın.
5. Sorun Giderme
✅ Bağlantı Sorunları:
- IP adresini doğru yazdığınızdan emin olun.
- Firewall ve ağ ayarlarını kontrol edin.
✅ Uzak Sunucuda Remote Debugging Çalışıyor mu?
msvsmon.exe
aracı açık olmalı.- Visual Studio ile aynı versiyona sahip olmalı.
✅ Hata Ayıklama Sembolleri (PDB Dosyaları) Doğru mu?
- Visual Studio’da → Project Properties (Proje Ayarları) açın.
- Build sekmesine gidin → Advanced butonuna tıklayın.
- Debug Info (Hata Ayıklama Bilgisi) → Full olarak değiştirin.
- Projeyi yeniden derleyip debugging yapmayı deneyin.