Advanced NDISTest options

Advanced NDISTest topicsYan Vugenfirer, [email protected]

Miki Mishael, [email protected]

Sameeh Jubran, [email protected]

Daynix Computing LTD

mailto:[email protected]




Agenda

Running NDISTest in stand alone mode

Debugging parameters of NDISTest subtests


NDISTest

Where Do I get the NDISTest?

NDISTest is part of the Windows Hardware Certification

Kit (http://msdn.microsoft.com/en-

us/library/windows/hardware/hh833788.aspx)

Test environment configuration and prerequisites -

http://msdn.microsoft.com/en-

us/library/windows/hardware/hh997862.aspx

NDISTest 6.5 LAN Tests - http://msdn.microsoft.com/en-

us/library/windows/hardware/dn260273.aspx

http://msdn.microsoft.com/en-us/library/windows/hardware/hh833788.aspx

http://msdn.microsoft.com/en-us/library/windows/hardware/hh997862.aspx

http://msdn.microsoft.com/en-us/library/windows/hardware/dn260273.aspx


Running in stand alone

modeOpen \\hck-

studio\Tests\<your

client

architecture>\NDIS\

NDISTest.Net

directory

Run NDISTest.exe

with administrator

privileges


NDISTest - Running the server

(1)

Choose

“Server” menu

item in the

“File” menu



(2)

Choose message

device - the other

NIC installed on the

NDISTest server

machine that is not

your NIC under test

(e1000 in

virtualization

environment)



(3)

Choose the support

adapter in the list

from the left side,

should be the

device on test


NDISTest - advanced

options on server (1)

19

In the “View” menu

click on “options”

item to open

configuration dialog

of NDISTest server


NDISTest - advanced

options on server (2)

19

One of the most

important options is

in “General” tab -

StopOnFail

Change StopOnFail

to “true” to enable

easy debugging in

case of failure


Links NDISTest - Running the

server (4)

Press on “start” in

the lower right

conner to start the

server


Links NDISTest - Running the

server (5)

Server is running


Links NDISTest - Running

the client (1)Run NDISTest

(server should

already be running on

server machine)

Choose “Client” menu

item in the “File”

menu



the client (2)Choose test target

(miniport for miniport

driver)



the client (3)Choose test device



the client (4)Choose message

device



the client (5)Choose support

device (the one that

runs in server, the

GUI might show also

additional local

devices in the list)

And choose “job

group” (right upper

conner)


NDISTest - advanced

options on client (1)View -> options

to ioen

NDISTest

options

Same as with

server - very

useful

parameter is

“StopOnFail”


NDISTest - advanced

options on client (2)Right click on the test to

bring context menu with

additional options

Interesting options

View description

Edit Job

View Hot Parameters


NDISTest - advanced

options on client (3)View description -

read job description


NDISTest - advanced

options on client (4)Edit Job - edit the

script used to run

the job


NDISTest - advanced

options on client (5)View Hot

Parameters - edit

hot parameters of

the test

For example the

amount of loops the

test will run and

other internal

parameters



the client (6) Selected the jobs

you want to run

Click on “Start”

button to run the

selected tests



the client (7) In case of test failure

and configured

“StopOnFail”

parameter - the test

will stop when error is

hit


Looping tests in NDISTest

Looping option is

can be very helpful

Change

EnableLooping to

“true” to enable

looping


Looping tests in NDISTest

Set LoopCount to the

required number of

test loops.

When LoopCount

value is 0 the test will

run infinitely until

stopped manually


Advanced options on client - list

of tests and hot parameters (1)

Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

ConfigChec

k

Filter

Service

Name

FALSE

PM_WakeO

nLinkChang

e

WoLC

Delay

5 Send/Recv

Pass

Percentage

0

VMQCheck

Connectivit

y

Acceptable

receive

percentage

95

VMQBasicV

erification

Acceptable

receive

percentage

95Set VLAN

tag in OOB true

Test

selector

0xFFFFFFFNumber of

packets for

send/receive

operation

250

IOVVMQBa

sicVerificati

on

Acceptable

receive

percentage

95Set VLAN

tag in OOB true

Test

selector

0xFFFFNumber of

packets for

send/receive

operation

250

DynamicVM

QBasicVerif

ication

Acceptable

receive

percentage

95Set VLAN

tag in OOBtrue

Test

selector

0xFFFFFFFNumber of

packets for

send/receive

operation

250

VMQScalab

ility

Acceptable

receive

percentage

95Set VLAN

tag in OOB true

Test total

number of

filters can

be set on all

receive

queues

false

Number of

packets for

send/receive

operation

250




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

VMQPower

Manageme

nt

Acceptable

receive

percentage

95 Sleep time 10

Number of

packets for

send/receiv

e operation

250

VMQPnpTe

st

Acceptable

receive

percentage

98 Reset count

10 Duration

between

reset

0

Number of

packets for

send/receiv

e operation

250

VMQStress

Test

Duration of

stress test

in minutes

10

Number of

send/receiv

e threads

8

Number of

allocate/fre

e queue

threads

1

Number of

reset

adapter

threads

1

Number of

bind/unbind

adapter

threads

1

VMQReceiv

eQueueStat

eChecking

Test

duration (in

minutes)

10Set VLAN

tag in OOBtrue

Number of

packets for

send/receiv

e operation

250

OffloadRsc

Acceptable

Receive

Percentage

99

CheckConn

ectivityLoopCount 1

AutofailEna

bleFALSE




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

GlitchFreeD

evice

Acceptable

Receive

Percentage

40

Packets Per

DPC To

Test

10,100,100

0

Maximum

Number of

Packets to

Send

10000

CheckConn

ectivityStres

s

Acceptable

Receive

Percentage

40Send

Duration30

VlanSendR

ecv

Acceptable

receive

percentage

95Alternative

VLAN ID

0x306Check

VLAN tag in

the OOB

trueNumber of

packets for

send/receiv

e

250

Default

VLAN

priority

6

SRIOVVMS

witchStress

Duration of

PnP Test30

MultipointC

heckConne

ctivity

Number of

destinations2

HotParamet

er99

PM_GtkRef

resh

Time to

standby300

Is WLAN

test

1




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

PM_WoWla

nMagicpack

et

Send/Recv

Pass

Percentage

90Random

Seed0

Link

Establishm

ent time

30Time to

standby60

Delayed

send time

PM_WoWla

nMagicpack

et

Send

Complete

Timeout

15

Wake up

tolerance

time

20Is WLAN

test1

PM_WoWla

nPattern

Send/Recv

Pass

Percentage

90Random

Seed0

Link

Establishm

ent time

30Time to

standby60

Delayed

send time256

PM_WoWla

nPattern

Send

Complete

Timeout

15

Wake up

tolerance

time

20

Max wake

pattern

size.

128Is WLAN

test1

TxFlowCtrl

Acceptable

Receive

Percentage

95

Acceptable

Deviation of

Paused

Time

Duration

20

Acceptable

Ratio of 2-

pause over

1-pause

50

Miniport

Initialization

Delay

120

Skip

OID_GEN_

LINK_PAR

AMETERS

Set Test

40000

ResetReset

Count40

Duration

between

resets (in

Millisecond

s

0 5000




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

AddressCh

ange

Test case

to execute31

Sleep Time

of Adapter

(in msec)

5000

Link

Timeout (in

sec)

90Passing

Percentage95

HeaderPayl

oadSplit

Acceptable

Receive

Percentage

99

Acceptable

percentage

number for

packets

indicated

with

Header-

Data split

95Number of

Send Calls50

Number of

packets per

Send Call

4 Packet Size 256

HeaderPayl

oadSplit

Stress

Send

Duration

5000

Controls the

set of tests

to run.

2

Ignore

VLAN

requirement

0

InvalidPack

ets

Acceptable

Receive

Percentage

99Number of

Send Calls50

Number of

packets per

Send Call

4 Packet Size 1024

Stress

Send

Duration

40000

InterruptMo

deration

Acceptable

receive

percentage

Default

Minimum

expected

improveme

nt with

moderation

15Send

Duration60000

Total

number of

endpoints

15

IPSecAH

Acceptable

Receive

Percentage

99Number of

Send Calls250

Number of

packets per

Send Call

4

Packet Size 256

Stress

Send

Duration

5000




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

IPSecESP

Acceptable

Receive

Percentage

99Number of

Send Calls250

Number of

packets per

Send Call

4 Packet Size 256

Stress

Send

Duration

5000

IPSecESPTest

Selector0x003f007f SPI Default

SecretKeyD

ataDefault

IPSecStdKe

y

Test

Selector0xf SPI Default

SecretKeyD

ataDefault

IPSecAhEs

p

Acceptable

Receive

Percentage

99Number of

Send Calls

25Number of

packets per

Send Call

4 Packet Size 256Test

Selector21

IPSecAhEs

pSPI Default

SecretKeyD

ataDefault

KeepAlive

Offload

Protocols3

Disable

Test:

Protocol

Offload

0

Disable

Test:

Packet

Interception

0

Disable

Negative

Test:

Protocol

Offload

0

Disable

Negative

Test: Invalid

Packets

0


Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

KeepAlive

Disable

Negative

Test:

Network

Traffic

0

Number of

Address

Resolution

Requests

1Wakeup

Time80 Poke Delay 60

Send

Complete

Timeout

60

KeepAliveSimulate

Test0

Do Not

Unbind

Protocols

0

Backchann

el

Syncronizat

ion Delay

10

Disable

Test:

Protocol

Offload

Capacity

Test

0

Sleep Delay

for Offload

Capacity

test

0

E2EPerfTraffic

Duration30

Minimum

Threads4

Maximum

Threads16

Do

Receivestrue Do Sends true

QosCapabil

ities

Debug a

test case0

Stop test on

failure

0

QosSpeed

Check

Traffic

Duration10

Traffic

Streams1

Priority Tag

Override-1

Expected

Link

Utilization

90

Monitor

Bandwidth

Utilization

1

QosEts

Traffic

Sample

Duration

10Expected

Link

Utilization

90

Traffic

Class

Deviation

10

Traffic

Class

Minimum

Utilization

1

Strict

Priority Link

Utilization

40






Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

QosEts

Test Strict

Priority with

ETS

trueTest

Selector

31

QosPriority

FlowControl

Traffic

Duration In

Seconds

10

Rampup

Duration In

Seconds

10

Test End

Duration In

Seconds

6

Maximum

Bytes per

Second for

No Traffic

0

Minimum

Bytes per

Second for

Each Traffic

Stream

(Priority

Class)

QosPriority

FlowControl

Traffic

Generator

Threads

4

Maximum

Percent

Deviation

for No

Pause

10

Minimum

Percent

Deviation

for Full

Pause

50

Debug Aid -

Traffic

Generator

Connection

Timeout

0

Debug Aid -

Use UDP

Protocol

instead of

TCP

1

QosPriority

FlowControl

Debug Aid -

Debug a

test case

0

Debug Aid -

Stop test on

failure

0

QosRemote

Settings

LLDP Inter-

Frame

Delay In

Seconds

1

Debug Aid -

Time to

Configure

IP Address

60

Debug Aid -

Debug a

test case

0

Debug Aid -

Stop test on

failure

0

QosPnpPo

wer

Traffic

Sample

Duration

10Expected

Link

Utilization

90

Traffic

Class

Deviation

10

Traffic

Class

Minimum 1

Strict

Priority Link

Utilization

40




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

QosPnpPo

werSleep time 10

QosStorage

Interop

Storage

DriveQ

Storage

Connection

Mode

ISCSI

Test

Duration In

Seconds

30

ETS

Assertion

Tollerance

0

Minimum

Network

Traffic

Utilization

90

QosStorage

Interop

Minimum

Storage

Traffic

Utilization

20

Network

Traffic

Generator

Threads

12

Bandwidth

Per

Network

Traffic

Generator

Thread

0

Network

Traffic

Rampup

Duration In

Seconds

10

Network

Traffic

Rundown

Duration in

Seconds

6

QosStorage

Interop

Storage

Traffic

Exerciser

Storage

Traffic

Exerciser

Program

Parameters

Storage

Traffic

Exerciser

Working

Directory

Storage

Traffic

Rampup

Duration In

Seconds

15

Debug Aid -

Use UDP

Protocol

instead of

TCP for

Network

Traffic

Generator

false

QosStorage

Interop

Debug Aid -

Network

Traffic

Generator

Connection

0

Debug Aid -

Time to

Configure

IP Address

60

Debug Aid -

Debug a

test case

0




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

OffloadChe

cksum

Tcp+Ipv4

checksum

offload

1

Udp+Ipv4

checksum

offload

1

Tcp

checksum

offload with

Ipv4

fragment

1

Udp

checksum

offload with

Ipv4

fragment

1

Tcp

checksum

offload with

GRE encap

3

OffloadLSO

Number of

Packets to

Send

30 Test LSOv2 1 Test LSOv1 1

Ipv4

Checksum

Offload

1Gre with

LSO1

OffloadMIS

CNA

PacketFilter

s

Packet

Filters to

test

47

Acceptable

Receive

Percentage

for Unicast

Default

Acceptable

Receive

Percentage

for Multicast

Default

Acceptable

Receive

Percentage

for

Broadcast

Default

Stats

Number of

Opens","De

fines the

number of

opens the

test will use

to saturate

the link

2




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

PM_Power

StateTransit

ion

Amount of

time to

sleep in

seconds

60

Sleep time

for re

connection

in seconds

60Send

Duration10000

PM_Requir

ements

ARPOffload

NumAddres

sesRequire

d

-1NSOffloadR

equired-1

NSOffloadN

umAddress

esRequired

-1NPOS_Req

uired-1

WakePacke

tIndicationR

equired

-1

PM_Requir

ements

WakeOnMe

diaConnect

Required

-1

WakeOnMe

diaDisconn

ectRequired

-1

UsbSelectiv

eSuspendR

equired

-1

MaxLinkSp

eedRequire

d

0

MiniportChe

ckForHang

Allowed

-1

PM_Requir

ements

StaticPatter

nCredit-1

SelectiveSu

spend

Packet

Drop Ratio

Test

Duration

10Idle Test

Duration300

Minimum

Packet

Pass Ratio

during

wakeup

75

Minimum

Packet

Pass Ratio

in working

state

90

Idle

Detection

Accuracy

50

SelectiveSu

spend

Device

Latency1000

Enable

Adapter

Binding

Delay

60

Disable

Adapter

Binding

Delay

60

Debug Aid -

Debug a

test case

0




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

PM_WolPat

tern

Send/Recv

Pass

Percentage

90Random

Seed0

Link

Establishm

ent time

30Time to

standby60

Delayed

send time20

PM_WolPat

tern

Send

Complete

Timeout

15Wake up

tolerance

time

20Max wake

pattern size128

Is WLAN

test0

PM_WolMa

gicPacket

Send/Recv

Pass

Percentage

90Random

Seed0

Link

Establishm

ent time

30Time to

standby60

Delayed

send time20

PM_WolMa

gicPacket

Send

Complete

Timeout

15

Wake up

tolerance

time

20Is WLAN

test

0

GenericMini

portRequire

ments

Invalid

Chars*?[]`

Standardize

dKeywords

Target

Keyword

_AllKeywor

ds__




Test NameParameter

1

Default

value

Parameter

2

Default

value

Parameter

3

Default

value

Parameter

4

Default

value

Parameter

5

Default

value

SingleEther

Type

Number of

Send Calls50

Number of

packets per

Send Call

4 Packet Size 1024

Q&A45

Technology

Advanced NDISTest options