.NET REMOTE DEBUGGING

Yazılım süreçlerinin parçalarından birisi debug, bir diğeri de deployment. Genellikle deployment yapıldıktan sonra karşılaşılan hatalar, hata log’larına bakılarak giderilmeye çalışılır. Geçmişte, bu durum bir zorunluluktu, ancak günümüzde daha gelişmiş uygulama geliştirme arayüzleri sayesinde deploy edilmiş bir uygulamanın debug edilebilmesi mümkündür. Bu sayede, hata log’ları ile tespit edilemeyen bazı hata, ya da yanlış işleryişleri debug ederek bulabilmek mümkündür.

Bu makalede Visual Studio .Net ile bu güzel özelliğin nasıl kullanılabileceği anlatılmıştır.

SUNUCUNUN HAZIRLANMASI

Remote Debugging yapılabilmesi için öncelikle, yazılımın kurulduğu ve debug edilecek sunucunun (ya da PC’nin) hazırlanması gerekir.

Bunun için, ilk olarak “rdbgsetup_x64.exe” isimli programın sunucuya kurulması gerekir. Bu program, alttaki link’ten indirilebilir.

http://www.microsoft.com/en-us/download/details.aspx?id=475

Bu link’teki “Download” butonuna tıklandığında, istenen dosya tipinin seçildiği bir ekran açılacaktır. Bu ekrandan, işletim sisteminize uygun programı seçip indirebilirsiniz. 64 bit.işletim sistemleri için yukarıda adı verilen dosya indirilmelidir.

Gereken dosya indirildikten sonra sunucu üzerine kurulumu yapılır. Dosya çalıştırıldığında, alttaki ekran görüntüsü gelecektir. “Next” butonuna basılarak ilerlenir. Sonraki ekranda bulunan “Install” butonuna tıklanarak kurulum başlatılır.

Şekil 1

Kurulum tamamlandıktan sonra, şekil 2 ile gösterilen sayfa açılır. Bu sayfadaki “Finish” butonuna tıklandığında, şekil 3 ile gösterilen ve gerekli ayarları yapabilmenizi sağlayan bir ekran açılır (Remote Debugger Configuration Wizard). “Next” butonuna tıklanarak ilerlendiğinde, şekil 4 ile gösterilen ekran gelir.

Şekil 2

Şekil 3

Bu ekrandaki “Run the Visiual Studio 2010 Remote Debugger service” seçeneği işaretlenir. Bu senek işaretlendiğinde, “User name” ve “Password” isimli, iki alan açılır.

Şekil 4

                “User name” alanına, o sunucu üzerinde “Admin” yetkisi olan bir kullanıcı adı ve “Password” alanına da, o kullanıcının şifresi girilmelidir. Debug yapacak bilgisayarda “Admin” olan kullanıcı, sunucuya “Admin” olarak tanımlanmalı ve bu kullanıcının adı ve şifresi verilmelidir. Aksi durumda, yetki hatası alınacaktır. Sunucu üzerinde “Admin” yetkili kullanıcı tanımlama işlemi, Administrative Tools > Server Manager  sayfasından, Configuration > Local Users and Groups menüsünden yapılabilir.

                İlgili bilgiler girilip, “Next” butonuna tıklanarak devam edildiğinde, şekil 5 ile belirtilen alttaki ekran açılacaktır.

Şekil 5

Bu ekranda remote debug  için yetki durumu soran iki seçenek göreceksiniz. İlk seçenek işaretlenirse, debug işlemi herhangi bir bilgisayardan yapılabilir. İkinci seçenek işaretlendiğinde, sadece network içindeki bir bilgisayardan debug işlemi yapılabilir. Uygun bulduğunuz seçeneği işaretleyip, “Next” butonuna tıklayarak devam edin. Bundan sonra gelecek olan sayfadaki “Finish” butonuna tıklayarak konfigürasyonu tamamlayın.

Bu işlemlerden sonra sıra, sunucudaki remote debug özelliğini aktif etmeye geldi. Bu işlem için, şekil 6 ile verildiği gibi, ilgili “Remote Debugger”ı çalıştırın. Debugger’ı “Run as administrator” tıklayarak çalıştırmanız gerekir. Aksi durumda, bağlantı kuraraken bu konuda uyarı alırsınız ve bağlantı gerçekleşmez.

Şekil 6 [Start > All Programs > Microsoft Visual Studio 2010 > Visual Studio 2010 Remote Debugger (x64)]

Remote Debuger çalıştırıldığında, alltta şekil 7 ile verilen pencere açılacaktır.

Şekil 7

Sayfada yer alan ilk satırın sonunda “Waiting for new connections” yazmaktadır. Bu ibare, şuana kadar işlerin yolunda gittiğini ve Remote Debugger’ın bağlantı için hazır olduğunu gösterir.

Debug edilecek programın çalışır durumda olup olmadığını kontrol edin.

Bu noktadan sonra sunucuda yapılması gereken işlemler tamamlanmış oluyor.

NOT: Sunucuda çalışan bir programın debug edilebilmesi için, programın “Debug” modda derlenmiş olması ve programın çalıştığı ilgili klasörlere “pdb” uzantılı dosyaların kopyalanmış olması gerekir.

REMOTE DEBUGGER İLE BAĞLANTI KURMA ve DEBUG İŞLEMİ

Debug etmek istediğiniz projeyi, debug yapılacak bilgisayarda açın.

Projenizi, altta açıklandığı şekilde, sunucuda çalışan programa “Attach” edin.

1. Altta, şekil 8 ile gösterildiği biçimde, Debug > Attach to process... menüsüne tıklayın.

Şekil 8

2. Altta, şekil 9 ile gösterilen sayfa ekrana gelecektir.

Şekil 9

Transport: Default olacak.

Qualifier: bu kısma debug edilecek sunucunun IP adresi, ya da şekilde görüldüğü gibi sunucu adı girilecektir. Bu alana IP adresi girilip “enter” tuşuna basıldığında, ya da “Refresh” butonuna tıklandığında, bu alanda sunucunun adı, bağlantı yapılan kullanıcı adı ile birlikte görüntülenecek ve “Available Process” listesi yenilenecektir. Bu durumda, sunucu tarafında açık durumda olan “Visual Studio Remote Debugging Monitor” penceresinde bulunan listeye, bağlantının kurulmuş olduğunu gösteren bir satır daha eklenecektir.

Şekil 10

3. “Available Process” listesinden ilgili process’i (sunucuda çalışan uygulamayı) bulun ve üzerine çift tıklayarak “Attach” işlemini tamamlayın. Bu noktadan sonra, istediğiniz yere “debug point” koyarak debug işlemini gerçekleştirebilirsiniz.

KARŞILAŞILABİLECEK MESAJ EKRANLARI

Firewall Mesajı (Elevated Privilages Required)

1. Remote Debug için bağlantı yapıldığı sırada, alttaki şekilde bir mesaj alırsanız (To continue debugging, the firewall needs to be configured. Configuring the firewall requires elevated privilages), bağlantı talebinizin firewall tarafından kesildiği anlamına gelir. Bu mesaj ile size, firewall üzerinde gereken ayarlamanın yapılmasını isteyip istemediğiniz sorulur. “Yes” butonuna tıklayarak devam edin.

Şekil 11

2. Yukarıdaki mesaja “Yes” deyip geçtikten sonra, altta şekil 11 ile gösterilen ekran (Configure Firewall for Remote Debugging - The Windows Firewall on this machine is currently blocking remote debugging. Remote debugging requires that the debugger be allowed to receive information from the network. Remote debugging also requires DCOM (TCP Port 135) and IPSEC (UDP 4500 / UDP 500) be unblocked) gelecektir.

Şekil 12

Bu ekrandaki ikinci veya üçüncü seçeneği işaretleyerek “OK” butonuna tıklayın. Bu şekilde, firewall bağlatıya izin verilecek şekilde ayarlanmış olur. Ancak dikkat edilmesi gereken bir konu da, TCP 135 ve UDP 4500 veya UDP 5000 portlarının firewall üzerinden açılmış olmasıdır.

Bağlantı Mesajları

1. Remote Debug için bağlantı yapıldığı sırada, alttaki şekilde bir mesaj alırsanız (Unable to connect to the Microsoft Visual Studio Remote Debugging Monitor named IP. The Microsoft Visual Studio Remote Debugging Monitor (MSVSMON.EXE) does not appear to be running on the remote computer. Please see Help for assistance), debug yapılacak sunucudaki “Remote Debugger”ı açıp açmadığınızı kontrol edin. Açmamışsanız, şekil 6 ile gösterildiği biçimde açın.

Şekil 13

SUNUCUDA AÇIK OLAN PROCESS İSİMLERİNİ ALMA

1. “Command Prompt”u altta şekil 14 ile gösterildiği biçimde açın.

Şekil 14

2. “Command Promt”u açtıktan sonra alttaki komutları yazın: Komutların yazılmış ve sonucu alınmış görüntüsü şekil 15 ile gösterilmiştir.

     - cd c:\Windows\System32\inetsrv

     - appcmd list wp

Şekil 15

Şekil 15’de de görüldüğü gibi, sunucuda çalışmakta olan “Worker Process”lerin numaraları listelenmiştir. Proje process’e attach edilirken açılan “Attach to Process” penceresinde bulunan “ID” numaraları, “Worker Process” numaralarıdır ve bu numar ile, projenizi hangi process’e attach edeceğinizi belirleyebilirsiniz.

Ayrıca, yukarıda “Command Promt”a yazılan komutlar ile yapılan işlem için bir “bat” dosyası hazırlamak isterseniz, yazmanız gereken örnek kod alttaki şekilde olacaktır.

Şekil 16