Mengaktifkan Klien Debugging
Setelah server penelusuran kesalahan diaktifkan, Anda dapat memulai klien penelusuran kesalahan di komputer lain dan menyambungkan ke sesi penelusuran kesalahan.
Ada dua cara untuk memulai klien penelusuran kesalahan: dengan menggunakan opsi -remote command-line, atau dengan menggunakan antarmuka grafis WinDbg.
Protokol klien harus sesuai dengan protokol server. Sintaks umum untuk memulai klien penelusuran kesalahan tergantung pada protokol yang digunakan. Opsi berikut ini ada:
Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password]
Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6]
Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]
Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]
Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]
Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]
Untuk menggunakan antarmuka grafis untuk menyambungkan ke sesi penelusuran kesalahan jarak jauh, WinDbg harus dalam mode tidak aktif -- harus dimulai tanpa parameter baris perintah, atau harus mengakhiri sesi debugging sebelumnya. Pilih File | Sambungkan ke perintah menu Sesi Jarak Jauh, atau tekan tombol pintasan CTRL+R. Saat kotak dialog Sambungkan ke Sesi Debugger Jarak Jauh muncul, masukkan salah satu string berikut ke dalam kotak teks String koneksi:
npipe:server=Server,pipe=PipeName[,password=Password]
tcp:server=Server,port=Socket[,password=Password][,ipversion=6]
tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]
com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]
ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]
ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]
Atau, Anda dapat menggunakan tombol Telusuri untuk menemukan server penelusuran kesalahan aktif.
Parameter dalam perintah sebelumnya memiliki nilai yang mungkin berikut:
Debugger
Ini tidak harus debugger yang sama dengan yang digunakan oleh klien debugging -- WinDbg, KD, dan CDB semuanya dapat dipertukarkan untuk tujuan penelusuran kesalahan jarak jauh melalui debugger.
Peladen
Ini adalah nama jaringan atau alamat IP komputer tempat server debugging dibuat. Dua garis miring terbalik awal (\) bersifat opsional pada baris perintah, tetapi tidak diizinkan dalam kotak dialog WinDbg.
pipe= PipeName
Jika protokol NPIPE atau SPIPE digunakan, PipeName adalah nama yang diberikan ke pipa saat server dibuat.
Jika Anda tidak masuk ke komputer klien dengan akun yang memiliki akses ke komputer server, Anda harus memberikan nama pengguna dan kata sandi. Di komputer klien, di jendela Prompt Perintah, masukkan perintah berikut.
net use \\Server\ipc$ /user:UserName
di mana Server adalah nama komputer server, dan UserName adalah nama akun yang memiliki akses ke komputer server.
Saat Diminta, masukkan kata sandi untuk UserName.
Setelah perintah ini berhasil, Anda dapat mengaktifkan klien penelusuran kesalahan dengan menggunakan opsi -remote command-line atau dengan menggunakan antarmuka grafis WinDbg.
Catatan Anda mungkin perlu memfungsikan berbagi file dan printer pada komputer server. Di Panel Kontrol, navigasikan ke pengaturan berbagi Tingkat Lanjut Jaringan dan Jaringan Internet > dan Pusat> Berbagi. Pilih Aktifkan berbagi file dan printer.
port= Soket
Jika protokol TCP atau SSL digunakan, Soket adalah nomor port soket yang sama yang digunakan saat server dibuat.
clicon
Menentukan bahwa server penelusuran kesalahan akan mencoba menyambungkan ke klien melalui koneksi terbalik. Klien harus menggunakan clicon jika dan hanya jika server menggunakan clicon. Dalam kebanyakan kasus, klien penelusuran kesalahan dimulai sebelum server debugging saat koneksi terbalik digunakan.
port= COMPort
Jika protokol COM digunakan, COMPort menentukan port COM yang akan digunakan. Awalan "COM" bersifat opsional -- misalnya, "com2" dan "2" dapat diterima.
baud= BaudRate
Jika protokol COM digunakan, BaudRate harus cocok dengan laju baud yang dipilih saat server dibuat.
channel= COMChannel
Jika protokol COM digunakan, COMChannel harus cocok dengan nomor saluran yang dipilih saat server dibuat.
proto= Protokol
Jika protokol SSL atau SPIPE digunakan, Protokol harus cocok dengan protokol aman yang digunakan saat server dibuat.
Cert
Jika protokol SSL atau SPIPE digunakan, Anda harus menggunakan parameter certuser=Cert atau machuser= Cert yang identik yang digunakan saat server dibuat.
kata sandi= Kata sandi
Jika kata sandi digunakan saat server dibuat, Kata sandi harus disediakan untuk membuat klien penelusuran kesalahan. Ini harus cocok dengan kata sandi asli. Kata sandi peka huruf besar/kecil. Jika kata sandi yang salah disediakan, pesan kesalahan akan menentukan "Kesalahan 0x80004005." Panjang kata sandi harus dua belas karakter atau kurang.
ipversion=6
(Alat Debugging untuk Windows 6.6.07 dan yang lebih lama saja) Memaksa debugger untuk menggunakan IP versi 6 daripada versi 4 saat menggunakan TCP untuk terhubung ke Internet. Di Windows Vista dan versi yang lebih baru, debugger mencoba default otomatis ke IP versi 6, membuat opsi ini tidak perlu.
Opsi baris perintah yang digunakan untuk memulai sesi penelusuran kesalahan baru (seperti -p) tidak dapat digunakan oleh klien penelusuran kesalahan, tetapi hanya oleh server. Opsi konfigurasi (seperti -n) akan berfungsi dari klien atau server.