Penelusuran Kesalahan Jarak Jauh Menggunakan WinDbg

Penelusuran kesalahan jarak jauh melibatkan dua debugger yang berjalan di dua lokasi berbeda. Debugger yang melakukan debugging disebut server debugging. Debugger kedua, yang disebut klien penelusuran kesalahan, mengontrol sesi penelusuran kesalahan dari lokasi jarak jauh. Untuk membuat sesi jarak jauh, Anda harus menyiapkan server penelusuran kesalahan terlebih dahulu lalu mengaktifkan klien penelusuran kesalahan.

Kode yang sedang di-debug bisa berjalan pada komputer yang sama yang menjalankan server debugging, atau bisa berjalan di komputer terpisah. Jika server penelusuran kesalahan melakukan penelusuran kesalahan mode pengguna, maka proses yang sedang di-debug dapat berjalan pada komputer yang sama dengan server penelusuran kesalahan. Jika server penelusuran kesalahan melakukan penelusuran kesalahan mode kernel, kode yang di-debug biasanya akan berjalan pada komputer target terpisah.

Diagram berikut mengilustrasikan sesi jarak jauh di mana server debugging, berjalan di komputer host, melakukan debugging kode mode kernel yang berjalan pada komputer target terpisah.

Ada beberapa protokol transportasi yang dapat Anda gunakan untuk koneksi penelusuran kesalahan jarak jauh: TCP, NPIPE, SPIPE, SSL, dan COM Port. Misalkan Anda telah memilih untuk menggunakan TCP sebagai protokol dan Anda telah memilih untuk menggunakan WinDbg sebagai klien debugging dan server debugging. Anda dapat menggunakan prosedur berikut untuk membuat sesi debugging mode kernel jarak jauh:

1. Di komputer host, buka WinDbg dan buat sesi debugging mode kernel dengan komputer target. (Lihat Penelusuran Kesalahan Kernel-Mode Langsung Menggunakan WinDbg (Klasik).)

2. Hentian dengan memilih Putuskan dari menu Debug atau dengan menekan CTRL-Break.

3. Di Jendela Perintah Debugger, masukkan perintah berikut.

   .server tcp:port=5005

   Catatan Nomor port 5005 bersifat arbitrer. Nomor port adalah pilihan Anda.

4. WinDbg akan merespons dengan output yang mirip dengan yang berikut ini.

   Server started.  Client can connect with any of these command lines
   0: <debugger> -remote tcp:Port=5005,Server=YourHostComputer
   

5. Di komputer jarak jauh, buka WinDbg, dan pilih Sambungkan ke Sesi Jarak Jauh dari menu File .

6. Di bawah String Koneksi, masukkan string berikut.

   tcp:Port=5005,Server=YourHostComputer

   di mana YourHostComputer adalah nama komputer host Anda, yang menjalankan server debugging.

   PilihOK.

Menggunakan Baris Perintah

Sebagai alternatif untuk prosedur yang diberikan di bagian sebelumnya, Anda dapat menyiapkan sesi penelusuran kesalahan jarak jauh di baris perintah. Misalkan Anda disiapkan untuk membuat sesi debugging mode kernel, antara komputer host dan komputer target, melalui kabel 1394 pada saluran 32. Anda dapat menggunakan prosedur berikut untuk membuat sesi penelusuran kesalahan jarak jauh:

1. Di komputer host, masukkan perintah berikut di jendela Prompt Perintah.

   windbg -server tcp:port=5005 -k 1394:channel=32

2. Di komputer jarak jauh, masukkan perintah berikut ini di jendela Prompt Perintah.

   windbg -remote tcp:Port=5005,Server=YourHostComputer

   di mana YourHostComputer adalah nama komputer host Anda, yang menjalankan server debugging.

Informasi Tambahan

Ada banyak cara untuk membuat penelusuran kesalahan jarak jauh selain yang ditunjukkan dalam topik ini. Untuk informasi lengkap tentang menyiapkan server penelusuran kesalahan di Jendela Perintah WinDbg Debugger, lihat .server (Buat Server Debugging). Untuk informasi lengkap tentang meluncurkan WinDbg (dan membuat debugging jarak jauh) di baris perintah, lihat Opsi winDbg Command-Line.