Bagikan melalui

Mengatur penelusuran kesalahan kernel jaringan KDNET secara otomatis

Alat Penelusuran Kesalahan untuk Windows mendukung penelusuran kesalahan kernel melalui jaringan. This article describes how to set up network debugging automatically by using the KDNET (kdnet.exe) setup tool.

The computer that runs the debugger is the host computer, and the computer being debugged is the target computer. The host computer must run Windows 7 or later, and the target computer must run Windows 8 or later.

Menentukan alamat IP komputer host

Gunakan langkah-langkah ini untuk menemukan alamat IP komputer host:

  1. Konfirmasikan bahwa PC target dan host terhubung ke hub jaringan atau beralih dengan kabel jaringan yang sesuai.

  2. On the host computer, open a command prompt and enter IPConfig to display the IP configuration.

  3. Dalam output perintah, temukan alamat IPv4 adaptor Ethernet untuk komputer, <Host-IP-Address>:

    ...
Ethernet adapter Ethernet:
...
IPv4 Address. . . . . . . . . . . : <Host-IP-Address>
...

    Alternatively, use Settings>Network & internet>Ethernet to gather the IPv4 address information.

  4. Catat alamat IPv4 adaptor jaringan yang ingin Anda gunakan untuk debugging.

Siapkan komputer host dan target

Gunakan utilitas KDNET untuk mengonfigurasi pengaturan debugger secara otomatis pada PC target dengan langkah-langkah ini.

Note

Prosedur ini mengasumsikan komputasi host dan target menjalankan Windows versi 64-bit. Jika konfigurasi Anda berbeda, pendekatan terbaik adalah menjalankan "bitness" alat yang sama pada host yang berjalan pada target. Misalnya, jika target menjalankan Windows 32-bit, jalankan versi 32-bit debugger pada host. Untuk informasi selengkapnya, lihat Memilih Alat Debugging 32-bit atau 64-bit.

  1. Konfirmasikan Windows Debugging Tools terinstal pada komputer host. Untuk informasi tentang mengunduh dan menginstal alat, lihat Alat Penelusuran Kesalahan untuk Windows.

  2. Locate the kdnet.exe and VerifiedNICList.xml files on the host computer. Secara default, file terletak di folder C:\Program Files (x86)\Windows Kits\10\Debuggers\x64 .

  3. Salin dua file di komputer host ke berbagi jaringan atau drive jempol sehingga tersedia untuk komputer target.

  4. On the target computer, create a C:\KDNET folder, and copy the kdnet.exe and VerifiedNICList.xml files to the folder.

    Important

    Before you use kdnet.exe to change boot information, you might need to temporarily suspend Windows security features on the test PC, such as BitLocker and Secure Boot. Setelah Anda selesai menguji, gunakan kembali fitur keamanan. Pastikan untuk mengelola PC pengujian dengan tepat saat fitur keamanan dinonaktifkan.

  5. Pada komputer target, buka jendela prompt perintah dengan hak administrator. Masukkan perintah berikut untuk memverifikasi komputer target memiliki adaptor jaringan yang didukung:

    C:\KDNET>kdnet.exe
Network debugging is supported on the following NICs:
busparams=1.0.0, Broadcom NetXtreme Gigabit Ethernet, Plugged in.  
This Microsoft hypervisor supports using KDNET in guest VMs.

    After the output from the KDNET (kdnet.exe) command shows the network adapter supported on the target, you can proceed.

  6. Masukkan perintah berikut untuk mengatur alamat IP sistem host dan buat kunci koneksi unik.

    • Untuk nilainya <Host-Computer-IP-Address> , gunakan alamat IP atau nama sistem host.
    • Untuk nilainya <Debug-Port> , masukkan alamat port unik untuk setiap pasangan target/host yang bekerja sama dengan Anda, dalam rentang 50000-50039 yang direkomendasikan.
    C:\KDNET>kdnet.exe <Host-Computer-IP-Address> 

Enabling network debugging on Intel(R) 82577LM Gigabit Network Connection.
Key=2steg4fzbj2sz.23418vzkd4ko3.1g34ou07z4pev.1sp3yo9yz874p

  7. Save the key value returned by the KDNET command in a notepad .txt file.

Sambungkan WinDbg ke target untuk debugging kernel

Sambungkan WinDbg ke komputer target untuk penelusuran kesalahan kernel dengan mengikuti langkah-langkah berikut:

  1. On the host computer, open WinDbg, and select File>Kernel Debug.

  2. In the Kernel Debugging dialog, select the Net tab.

  3. Paste the port number and key from the notepad.txt file into the tab fields, and select OK.

You can also start the WinDbg session from the command line by using the windbg.exe command and the values you saved in the notepad.txt file.

windbg.exe -k -d net:port=<Debug-Port>,key=<KDNET-Key>

Nilainya <Debug-Port> adalah port yang Anda pilih sebelumnya. Nilainya <KDNET-Key> adalah kunci yang dikembalikan oleh KDNET. Parameter opsional -d memungkinkan pembobolan awal. Untuk informasi selengkapnya, lihat opsi baris perintah WinDbg.

Saat Anda memulai koneksi, WinDbg mungkin meminta Anda untuk mengizinkan akses ke port melalui firewall:

Cuplikan layar Pemberitahuan Keamanan Windows dengan pilihan untuk mengizinkan akses ke ketiga jenis jaringan.

In the message dialog, select each checkbox to enable access for all three network types, and select Allow access.

Pada titik ini, debugger menunggu target tersambung kembali dan menunjukkan kemajuan di jendela perintah debugger:

Microsoft (R) Windows Debugger Version 1.0.1908.30002 AMD64
Copyright (c) Microsoft Corporation. All rights reserved.

Using NET for debugging
Opened WinSock 2.0
Waiting to reconnect...

Menghidupkan ulang PC yang menjadi target

Ketika debugger menampilkan "Menunggu untuk menyambungkan kembali..." pesan, reboot komputer target.

Salah satu cara untuk menghidupkan ulang PC adalah dengan menjalankan perintah berikut dalam prompt perintah sebagai administrator:

shutdown -r -t 0

Setelah PC target dimulai ulang, debugger akan terhubung secara otomatis.

Troubleshoot issues

Jika Anda mengalami masalah saat membuat koneksi port atau memulai sesi debug, tinjau tips pemecahan masalah berikut.

Perbolehkan aplikasi penelusuran kesalahan melalui firewall

Di sisi host, tempat debugger berjalan, semua jenis jaringan harus diaktifkan untuk memungkinkan debugger berkomunikasi dengan target melalui firewall.

Use the Windows Control Panel to allow access through the firewall.

  1. Open Control Panel>System and Security and select the appropriate Allow an app through Windows Firewall options:

    • WinDbg: In the list of applications, locate the WinDbg engine process (TCP) (all) option.

    • WinDbg (Classic): In the list of applications, locate the Windows GUI Symbolic Debugger and Windows Kernel Debugger options.

  2. Select the checkboxes to allow all debugging applications through all three network types.

  3. Select OK to save the firewall changes, and then restart the debugger.

    Cuplikan layar konfigurasi firewall Panel Kontrol yang menampilkan aplikasi Windows GUI Symbolic Debugger dan Windows Kernel Debugger dengan ketiga jenis jaringan diaktifkan.

Menggunakan ping untuk menguji konektivitas

Jika waktu debugger habis dan tidak tersambung, gunakan ping perintah pada PC target untuk memverifikasi konektivitas:

C:\>Ping <HostComputerIPAddress>

Pilih port untuk penelusuran kesalahan jaringan

Jika waktu debugger habis dan tidak tersambung, mungkin karena nomor port default 50000 sudah digunakan atau diblokir.

Anda dapat memilih nomor port apa pun antara 49152 dan 65535, inklusif. Rentang yang direkomendasikan adalah 50000 hingga 50039. Port yang Anda pilih terbuka untuk akses eksklusif oleh debugger yang berjalan di komputer host.

Kebijakan jaringan perusahaan mungkin membatasi rentang nomor port yang tersedia untuk penelusuran kesalahan jaringan. Untuk menentukan apakah kebijakan perusahaan Anda membatasi rentang port untuk penelusuran kesalahan jaringan, tanyakan kepada administrator jaringan Anda.

Menemukan adaptor jaringan yang didukung

Jika Anda melihat Penelusuran kesalahan Jaringan tidak didukung pada salah satu NIC dalam pesan komputer ini saat Anda menjalankan KDNET, adaptor jaringan tidak didukung.

Komputer host dapat menggunakan adaptor jaringan apa pun, tetapi komputer target harus menggunakan adaptor jaringan yang didukung oleh Alat Penelusuran Kesalahan untuk Windows. Untuk daftar adaptor jaringan yang didukung, lihat artikel berikut ini:

Mengaktifkan jenis debugging lainnya.

Pembaruan Windows 10 Oktober 2020 (20H2) dan yang lebih baru mendukung empat jenis penelusuran kesalahan:

KDNET option Debugging type Perintah set yang setara More information
b Bootmgr debugging bcdedit /bootdebug {bootmgr} on BCDEdit /bootdebug
w Winload debugging bcdedit /bootdebug on BCDEdit /bootdebug
k Kernel debugging bcdedit /debug on Mulai menggunakan WinDbg (mode kernel)
h Hypervisor debugging bcdedit /set hypervisordebug on BCDEdit /hypervisorsettings

Berikut adalah detail tentang bekerja dengan jenis penelusuran kesalahan:

  • Anda dapat menentukan kombinasi jenis debug apa pun.
  • Jika Anda tidak menentukan jenis debug, sistem akan mengaktifkan penelusuran kesalahan kernel.
  • Jika Anda mengaktifkan debugging hypervisor dan kernel, port hypervisor diatur ke <Debug-Port> + 1.

Contoh: Mengaktifkan debugging bootmgr, kernel, dan winload

Contoh berikut menggunakan - bkw opsi untuk mengaktifkan debugging bootmgr, kernel, dan winload:

C:\>kdnet.exe <HostComputerIPAddress> <YourDebugPort> -bkw

Enabling network debugging on Intel(R) 82577LM Gigabit Network Connection.
Key=2steg4fzbj2sz.23418vzkd4ko3.1g34ou07z4pev.1sp3yo9yz874p

Tentukan parameter bus

Jika KDNET tidak dapat secara otomatis menentukan parameter bus untuk transportasi Anda, Anda dapat menentukan parameter pada baris perintah dengan /busparams opsi :

kdnet.exe /busparams [b.d.f] [host] [port] [-[b][h][k][w]]

Bagian b.d.f menentukan parameter bus untuk dikonfigurasi perangkat.

Use Device Manager on the target computer to determine the PCI bus number (b), the device number (d), and the function number (f) of the adapter you want to use for debugging. These values are available in the General tab under the Location setting.

For example:

C:\>kdnet.exe /busparams 0.29.7 <Host-Computer-IP-Address> <Debug-Port> -bkw
  • Last updated on