Debug del kernel per le istanze di Windows sulla rete

Il KDNET Extensibility Module for Elastic Network Adapter (ENA) è un livello di supporto per i driver hardware che consente il debug del kernel di Windows sulla rete tramite ENA su istanze Amazon Elastic Compute Cloud. Puoi utilizzare il modulo di estensibilità con Windows Debugger () per eseguire il debug a livello di kernel su istanze EC2 che eseguono Windows. WinDbg

Il debugging del kernel consente di diagnosticare e risolvere problemi di basso livello del sistema operativo, come errori di schermata blu (BSOD), guasti dei driver e problemi di avvio sulle istanze EC2 Windows.

Prerequisiti

Prima di iniziare, assicurati di disporre di:

Due istanze EC2 per Windows, nella stessa sottorete:

Per ulteriori informazioni sull'avvio delle istanze, consulta. Inizia a usare Amazon EC2

I gruppi di sicurezza per le istanze host e target devono consentire il traffico UDP in entrata e in uscita sulla porta utilizzata per il debug di KDNET (intervallo consigliato: 50000-50039). Il modo più semplice per configurarlo è creare un gruppo di sicurezza con una regola in entrata che consenta il traffico UDP proveniente da se stesso come origine e quindi collegare quel gruppo di sicurezza a entrambe le istanze. Per ulteriori informazioni, consulta Regole del gruppo di sicurezza nella Guida per l’utente di Amazon VPC.

L'istanza di destinazione di debug deve eseguire una delle seguenti versioni di Windows (o successive):

Test-Path C:\Windows\system32\kd_02_1d0f.dll

Passaggio 1: installare gli strumenti di debug di Windows sull'host di debug

Installa gli strumenti di debug di Windows sull'istanza dell'host di debug eseguendo il comando seguente in una sessione: PowerShell

winget install microsoft.windbg

Per istruzioni dettagliate sull'installazione, vedi Installare Windows Debugger nella documentazione Microsoft.

Dopo l'installazione, verifica che il debugger funzioni eseguendo il comando seguente in una sessione: PowerShell

windbgx

La WinDbg finestra dovrebbe aprirsi. In caso affermativo, l'installazione è andata a buon fine e puoi chiudere la finestra.

Fase 2: Impostare l'obiettivo di debug

Sulla destinazione di debug, apri una PowerShell sessione con privilegi elevati e configura il debug del kernel utilizzando i seguenti passaggi.

Eseguite il comando seguente per elencare il bus, il dispositivo e il numero di funzione dell'adattatore ENA collegato all'istanza:

Get-NetAdapter -Physical |
    Where-Object -Property PnPDeviceID -Match -Value '^PCI\\VEN_1D0F&DEV_EC2[01]&' |
    Get-NetAdapterHardwareInfo |
    Select-Object InterfaceDescription, BusNumber, DeviceNumber, FunctionNumber |
    Format-List

Get-NetAdapter -Physical |
    Where-Object PnPDeviceID -Match '^PCI\\VEN_1D0F&DEV_EC2[01]&' |
    ForEach-Object {
        $adapter = $_
        $hwInfo = $adapter | Get-NetAdapterHardwareInfo
        $ipInfo = Get-NetIPAddress -InterfaceIndex $adapter.InterfaceIndex -AddressFamily IPv4
        [PSCustomObject]@{
            InterfaceDescription = $adapter.InterfaceDescription
            IPAddress            = $ipInfo.IPAddress
            BusNumber            = $hwInfo.BusNumber
            DeviceNumber         = $hwInfo.DeviceNumber
            FunctionNumber       = $hwInfo.FunctionNumber
        }
    } | Format-List

Annotate i FunctionNumber valori BusNumberDeviceNumber, e dell'adattatore ENA da utilizzare per il debug dall'output.

Eseguite i seguenti comandi per configurare il debug del kernel. Sostituisci i valori segnaposto con la tua configurazione specifica:

bcdedit /debug on
bcdedit /set loadoptions FORCEHVTONOTSHAREDEBUGDEVICE
bcdedit /dbgsettings net hostip:host-private-ip port:port-number key:encryption-key busparams:b.d.f

(bcdedit /enum) -match "loadoptions"

Dove:

bcdedit /bootdebug on

Passaggio 3: avviare la sessione di debug sull'host di debug

Per consentire il debug del traffico sull'host, puoi creare una regola firewall per l'applicazione o una porta UDP specifica. WinDbg

Opzione 1: consentire l'applicazione WinDbg

Esegui i seguenti comandi per autorizzare l' WinDbg eseguibile:

$WinDbgxPath = "$env:LocalAppData\Microsoft\WindowsApps\WinDbgX.exe"
New-NetFirewallRule -DisplayName "Allow Inbound KDNET Connection" -Action Allow -Program $WinDbgxPath

Opzione 2: consentire una porta UDP specifica

In alternativa, puoi consentire il traffico UDP in entrata verso la porta configurata per il debug del kernel. Sostituisci con la porta port-number KDNET scelta:

$DebugPort = port-number
New-NetFirewallRule -DisplayName "Allow Inbound KDNET Connection" -Direction Inbound -LocalPort $DebugPort -Protocol UDP -Action Allow

Inizia WinDbg con la porta e la chiave che corrispondono alla configurazione della destinazione di debug. È possibile specificare opzioni di debug del kernel aggiuntive documentate nel riferimento alla riga di comando di WinDbg Microsoft in base al proprio caso d'uso.

windbgx -k net:port=port-number,key=encryption-key

WinDbg si apre e attende che il target di debug si connetta.

Passaggio 4: riavviare la destinazione di debug

Sulla destinazione di debug, riavvia l'istanza per avviare la connessione di debug:

shutdown -r -t 0

Dopo il riavvio della destinazione di debug, WinDbg sull'host di debug si connette automaticamente alla destinazione. È ora possibile utilizzarlo WinDbg per controllare lo stato del kernel, impostare i breakpoint e diagnosticare i problemi.

Pulisci le impostazioni di debug dopo il debug

Sulla destinazione di debug

Al termine del debug, rimuovete la configurazione di debug del kernel dalla destinazione di debug per ripristinare il normale comportamento di avvio. Sulla destinazione di debug, aprite una sessione con privilegi elevati ed eseguite i seguenti comandi: PowerShell

bcdedit /debug off
bcdedit /dbgsettings LOCAL
bcdedit /deletevalue loadoptions

Se ne esistono di loadoptions diversiFORCEHVTONOTSHAREDEBUGDEVICE, è necessario ripristinare l'impostazione eseguendola bcdedit /set loadoptions con l'originale. loadoptions

Se hai abilitato il debug di avvio, esegui anche:

bcdedit /bootdebug off

Riavvia l'istanza per rendere effettive le modifiche.

Sull'host di debug

Rimuovi la regola del firewall eseguendo:

Remove-NetFirewallRule -DisplayName "Allow Inbound KDNET Connection"

Limitazioni

Il modulo di estensibilità KDNET per ENA attualmente non supporta:

Il modulo attualmente non supporta istanze con Secure Boot abilitato. È possibile verificare lo stato Confirm-SecureBootUEFI eseguendo una sessione con privilegi elevati. PowerShell Se l'output èTrue, Secure Boot è attivo. Tieni presente che tutte le immagini fornite da Amazon con un prefisso «TPM» hanno Secure Boot abilitato per impostazione predefinita.

Note aggiuntive

Se riscontri problemi di connessione del debugger all'istanza di destinazione, verifica quanto segue:

Per ulteriori indicazioni, consulta Configurare manualmente il debug del kernel di rete KDNET nella documentazione Microsoft.