Menyiapkan Penelusuran Kesalahan Jaringan Komputer Virtual - KDNET
Topik ini menjelaskan cara mengonfigurasi koneksi debugging kernel ke komputer virtual (VM) Hyper-V.
Penyiapan Komputer Virtual Hyper-V
Untuk men-debug Komputer Virtual (VM) Hyper-V Gen 2, selesaikan langkah-langkah berikut.
1. Buat VM dengan Windows terinstal
Untuk informasi tentang cara membuat VM, lihat Membuat Komputer Virtual dengan Hyper-V.
2. Tentukan sakelar virtual eksternal
Untuk berkomunikasi dengan VM, sakelar jaringan eksternal virtual dapat digunakan. Untuk informasi tentang cara membuat sakelar jaringan eksternal, lihat Membuat jaringan virtual.
Ketika sakelar jaringan eksternal dikonfigurasi, opsi berikut harus diatur.
| Opsi | Value |
|---|---|
| Jenis Koneksi | Jaringan Eksternal |
| Izinkan sistem operasi pengelolaan berbagi adapter jaringan ini | Diaktifkan |
| VLAN ID | Nonaktif |
3. Nonaktifkan Boot Aman
Untuk memungkinkan utilitas kdnet memperbarui pengaturan boot BCDEdit, nonaktifkan boot aman untuk sementara pada komputer virtual dengan mengikuti langkah-langkah ini.
Muat manajer Hyper-V dan pilih properti untuk VM Anda.
Pilih Pengaturan keamanan .
Batal centang kotak Aktifkan Boot Aman.
Pilih OK untuk menyimpan pengaturan.
Anda dapat mengaktifkan kembali Boot Aman setelah selesai menelusuri kesalahan dan menonaktifkan penelusuran kesalahan kernel pada VM target.
4. Instal Alat Debugging untuk Windows
Alat penelusuran kesalahan digunakan untuk debugger dan utilitas kdnet dan harus diinstal. Untuk informasi tentang cara mengunduh dan menginstal alat penelusuran kesalahan, lihat Alat Penelusuran Kesalahan untuk Windows.
Menyiapkan Penelusuran Kesalahan Jaringan Komputer Virtual - KDNET
Rekam Alamat IP Host
Untuk menjalankan debugger host pada PC yang sama dengan komputer virtual target, ikuti langkah-langkah ini.
Di OS komputer host, buka jendela Prompt Perintah dan masukkan IPConfig untuk menampilkan konfigurasi IP.
Dalam output perintah, temukan adaptor Ethernet yang Anda konfigurasi sebagai Sakelar Virtual Eksternal.
... Ethernet adapter vEthernet (External Virtual Switch): ... IPv4 Address. . . . . . . . . . . : <YourHostIPAddress> ...
Tip
Mungkin ada beberapa entri adaptor dengan nama serupa. Pastikan dan temukan sakelar virtual yang Anda buat.
Rekam alamat IPv4 Sakelar Virtual Eksternal yang akan digunakan sebagai alamat host untuk penelusuran kesalahan.
Untuk mengonfirmasi konektivitas antara target dan komputer host, buka jendela prompt perintah yang ditingkatkan pada komputer target, dan masukkan perintah berikut, di mana YourHostIPAddress adalah alamat IP komputer host.
ping -4 <YourHostIPAddress>
Menyiapkan Komputer Target VM
Gunakan utilitas kdnet.exe untuk mengonfigurasi pengaturan debugger secara otomatis pada PC target, dengan mengikuti langkah-langkah ini.
- Temukan file kdnet.exe dan VerifiedNICList.xml WDK. Secara default, mereka terletak di sini.
C:\Program Files (x86)\Windows Kits\10\Debuggers\x64
Catatan
Petunjuk ini mengasumsikan bahwa kedua PC menjalankan Windows versi 64-bit pada target dan host. Jika itu tidak terjadi, pendekatan terbaik adalah menjalankan "bitness" alat yang sama pada host yang dijalankan target. Misalnya, jika target menjalankan Windows 32-bit, jalankan versi 32 debugger pada host. Untuk informasi selengkapnya, lihat Memilih Alat Debugging 32-Bit atau 64-Bit.
Untuk mengizinkan kunci panjang yang digunakan untuk dipotong dan ditempelkan, aktifkan dukungan sesi yang ditingkatkan. Di jendela VM, dari menu Tarik-turun Tampilan , aktifkan Sesi yang ditingkatkan.
Pada komputer virtual target, buat direktori C:\KDNET dan salin file kdnet.exe dan VerifiedNICList.xml ke direktori tersebut.
Pada komputer target, buka jendela Prompt Perintah sebagai Administrator. Masukkan perintah ini untuk memverifikasi bahwa komputer target memiliki adaptor jaringan yang didukung.
C:\KDNET>kdnet Network debugging is supported on the following NICs: busparams=0.25.0, Intel(R) 82579LM Gigabit Network Connection, KDNET is running on this NIC.kdnet.exeKetik perintah ini untuk mengatur alamat IP sistem host dan menghasilkan kunci koneksi yang unik. Gunakan alamat IP sistem host yang Anda rekam sebelumnya. Pilih alamat port unik untuk setiap pasangan target/host yang bekerja dengan Anda, dalam rentang 50000-50039. Untuk contoh ini, kita akan memilih 50005.
C:\>kdnet <YourIPAddress> <YourDebugPort> Enabling network debugging on Microsoft Hypervisor Virtual Machine. Key=3u8smyv477z20.2owh9gl90gbxx.3sfsihzgq7di4.nh8ugnmzb4l7 To debug this vm, run the following command on your debugger host machine. windbg -k net:port=50005,key=3u8smyv477z20.2owh9gl90gbxx.3sfsihzgq7di4.nh8ugnmzb4l7 Then restart this VM by running shutdown -r -t 0 from this command prompt.Gunakan CRTL+C untuk menyalin output Windbg yang disediakan ke buffer perintah. Melakukan ini menghindari upaya untuk menuliskan nilai kunci panjang yang dikembalikan.
Aktifkan kembali BitLocker dan boot aman setelah Anda selesai mengonfigurasi pengaturan debugger.
Karena VM dengan dukungan sesi yang ditingkatkan dapat waktu habis saat dibiarkan dalam titik henti, nonaktifkan Dukungan sesi yang ditingkatkan menggunakan menu Tarik-turun Tampilan di VM.
VM akan dimulai ulang setelah debugger dimuat dan berjalan. Proses ini dijelaskan berikutnya.
Memulai Sesi Debugging
Untuk menyambungkan ke PC target, gunakan CTRL+V untuk menempelkan di jendela perintah OS utama string Windbg yang dikembalikan oleh kdnet yang Anda salin sebelumnya.
C:\Debuggers\windbg -k net:port=<YourDebugPort>,key=<YourKey>
Ketika pertama kali mencoba membuat koneksi penelusuran kesalahan jaringan, Anda mungkin diminta untuk mengizinkan akses aplikasi penelusuran kesalahan (WinDbg atau KD) melalui firewall. Anda harus merespons perintah dengan mencentang kotak untuk ketiga jenis jaringan: domain, privat, dan publik.
Memulai ulang PC Target
Setelah debugger tersambung, boot ulang komputer target. Untuk memaksa VM memulai ulang sepenuhnya, gunakan perintah ini, dari prompt perintah administrator.
shutdown -r -t 0
Ketika komputer virtual target dimulai ulang, debugger di OS host harus terhubung.
Setelah menyambungkan ke VM, tekan break pada debugger Anda dan Anda dapat mulai men-debug.
Untuk mendukung koneksi penelusuran kesalahan, Adaptor Jaringan Debug Kernel ditambahkan dan terlihat di properti jaringan setelah VM di-boot ulang.
Pemecahan Masalah Penelusuran Kesalahan Jaringan Komputer Virtual KDNET
Jika debugger tidak tersambung, gunakan perintah ping dari VM target untuk memverifikasi konektivitas.
C:\>Ping <HostComputerIPAddress>
Ada yang tidak berfungsi dengan baik dan aku tidak yakin apa...
- Pastikan Anda telah mengizinkan WinDbg melalui firewall Anda.
- Konfirmasikan bahwa Anda menggunakan Kunci unik yang dihasilkan oleh BCDEdit atau kdnet.
VM saya tidak memiliki konektivitas jaringan
- Buka Virtual Switch Manager dari Hyper-V Manager, pilih Sakelar Virtual yang ada, dan ubah NIC jaringan eksternal ke Adaptor Jaringan Debug Kernel Microsoft dengan memilihnya dari kotak drop-down lalu pilih OK di kotak dialog Virtual Switch Manager. Setelah memperbarui Virtual Switch NIC Anda, pastikan untuk mematikan dan memulai ulang VM Anda.
Urutan untuk menambahkan peran Hyper-V ke PC Windows
Jika komputer target Anda adalah host komputer virtual, Anda dapat menyiapkan penelusuran kesalahan jaringan dan masih memiliki akses jaringan untuk komputer virtual.
Misalkan Anda ingin menyiapkan penelusuran kesalahan jaringan dalam situasi berikut.
- Komputer target memiliki satu kartu antarmuka jaringan.
- Anda berniat untuk menginstal peran Hyper-V pada komputer target.
- Anda ingin membuat satu atau beberapa komputer virtual pada komputer target.
Pendekatan terbaik adalah menyiapkan penelusuran kesalahan jaringan pada komputer target sebelum Anda menginstal peran Hyper-V. Kemudian komputer virtual akan memiliki akses ke jaringan.
Jika Anda memutuskan untuk menyiapkan penelusuran kesalahan jaringan setelah peran Hyper-V diinstal pada komputer target, Anda harus mengubah pengaturan jaringan untuk komputer virtual Anda untuk menjembataninya ke Adaptor Debug Jaringan Microsoft Kernel. Jika tidak, komputer virtual tidak akan memiliki akses ke jaringan.
Lihat juga
Menyiapkan Debugging Mode Kernel komputer virtual secara manual menggunakan Port COM Virtual
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk