src/plugins/srv6-mobile/extra/runner_doc.md

   1 # What's `runner.py` doing?
   2
   3 ## Common configurations
   4
   5 ### VPP1
   6 ```
   7 create host-interface name eth1
   8 set int ip addr host-eth1 A1::1/120
   9 set int state host-eth1 up
  10 ip route add ::/0 via host-eth1 A1::2
  11 ```
  12
  13
  14 ### VPP2
  15
  16 ```
  17 create host-interface name eth1
  18 set int ip addr host-eth1 A1::2/120
  19 create host-interface name eth2
  20 set int ip addr host-eth2 A2::1/120
  21 set int state host-eth1 up
  22 set int state host-eth2 up
  23 ip route add ::/0 via host-eth2 A2::2
  24 ```
  25
  26
  27 ### VPP3
  28
  29 ```
  30 create host-interface name eth1
  31 set int ip addr host-eth1 A2::2/120
  32 create host-interface name eth2
  33 set int ip addr host-eth2 A3::1/120
  34 set int state host-eth1 up
  35 set int state host-eth2 up
  36 ip route add ::/0 via host-eth1 A2::1
  37 ```
  38
  39 ### VPP4
  40
  41 ```
  42 create host-interface name eth1
  43 set int ip addr host-eth1 A3::2/120
  44 set int state host-eth1 up
  45 ip route add ::/0 via host-eth1 A3::1
  46 ```
  47
  48
  49 ## Drop-in for GTP-U over IPv4
  50
  51 Drop-in mode is handy to test both GTP-U-to-SRv6 and SRv6-to-GTP-U functions at same time. Let's see what's happened when you run `test gtp4`:
  52
  53     $ ./runner.py test gtp4
  54
  55
  56 Setting up a virtual interface of packet generator:
  57
  58 #### VPP1
  59
  60 ```
  61 create packet-generator interface pg0
  62 set int mac address pg0 aa:bb:cc:dd:ee:01
  63 set int ip addr pg0 172.16.0.1/30
  64 set ip arp pg0 172.16.0.2/30 aa:bb:cc:dd:ee:02
  65 ```
  66
  67 #### VPP4
  68
  69 ```
  70 create packet-generator interface pg0
  71 set int mac address pg0 aa:bb:cc:dd:ee:11
  72 set int ip addr pg0 1.0.0.2/30
  73 set ip arp pg0 1.0.0.1 aa:bb:cc:dd:ee:22
  74 ```
  75
  76 SRv6 and IP routing settings:
  77
  78 #### VPP1
  79
  80 ```
  81 sr policy add bsid D4:: next D2:: next D3::
  82 sr policy add bsid D5:: behavior t.m.gtp4.d D4::/32 v6src_prefix C1::/64 nhtype ipv4
  83 sr steer l3 172.20.0.1/32 via bsid D5::
  84 ```
  85
  86 #### VPP2
  87
  88 ```
  89 sr localsid address D2:: behavior end
  90 ip route add D3::/128 via host-eth2 A2::2
  91 ```
  92
  93 #### VPP3
  94
  95 ```
  96 sr localsid address D3:: behavior end
  97 ip route add D4::/32 via host-eth2 A3::2
  98 ```
  99
 100 #### VPP4
 101
 102 ```
 103 sr localsid prefix D4::/32 behavior end.m.gtp4.e v4src_position 64
 104 ip route add 172.20.0.1/32 via pg0 1.0.0.1
 105 ```