summaryrefslogtreecommitdiffstats
path: root/docs/usecases/networksim.rst
blob: 9324c992f00df8df65ca7f12b3866754b3a1c687 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
Generating traffic with VPP
===========================

Vpp includes a fairly capable network simulator plugin, which can
simulate real-world round-trip times and a configurable network packet
loss rate. It’s perfect for evaluating the performance of a TCP stack
under specified delay/bandwidth/loss conditions.

The “nsim” plugin cross-connects two physical interfaces at layer 2,
introducing the specified delay and network loss parameters.
Reconfiguration on the fly is OK, with the proviso that packets held in
the network simulator scheduling wheel will be lost.

Configuration
-------------

Configuration by debug CLI is simple. First, specify the simulator
configuration: unidirectional delay (half of the desired RTT), the link
bandwidth, and the expected average packet size. These parameters allow
the network simulator allocate the right amount of buffering to produce
the requested delay/bandwidth product.

::

       set nsim delay 25.0 ms bandwidth 10 gbit packet-size 128

To simulate network packet drops, add either “packets-per-drop ” or
“drop-fraction [0.0 … 1.0]” parameters:

::

       set nsim delay 25.0 ms bandwidth 10 gbit packet-size 128 packets-per-drop 10000

Remember to configure the layer-2 cross-connect:

::

       nsim enable-disable <interface-1> <interface-2>

Packet Generator Configuration
------------------------------

Here’s a unit-test configuration for the vpp packet generator:

::

     loop cre
     set int ip address loop0 11.22.33.1/24
     set int state loop0 up

     loop cre
     set int ip address loop1 11.22.34.1/24
     set int state loop1 up

     set nsim delay 1.0 ms bandwidth 10 gbit packet-size 128 packets-per-drop 1000
     nsim enable-disable loop0 loop1

     packet-generator new {
         name s0
         limit 10000
         size 128-128
         interface loop0
         node ethernet-input
         data { IP4: 1.2.3 -> 4.5.6
                UDP: 11.22.33.44 -> 11.22.34.44
                UDP: 1234 -> 2345
                incrementing 114
         }
     }

For extra realism, the network simulator drops any specific packet with
the specified probability. In this example, we see that slight variation
from run to run occurs as it should.

::

       DBGvpp# pa en
       DBGvpp# sh err
          Count                    Node                  Reason
             9991                  nsim                  Packets buffered
                9                  nsim                  Network loss simulation drop packets
             9991             ethernet-input             l3 mac mismatch

       DBGvpp# clear err
       DBGvpp# pa en
       DBGvpp# sh err
       sh err
          Count                    Node                  Reason
             9993                  nsim                  Packets buffered
                7                  nsim                  Network loss simulation drop packets
             9993             ethernet-input             l3 mac mismatch