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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<chapter id="clav_vnf_example">
<title>Clavister VNF Example Use-cases</title>
<section id="clav_vnf">
<title>Clavister VNF</title>
<para>In this use case, <literal>target_1</literal> will run the Clavister
VNF and an Open vSwitch bridge, while <literal>target_2</literal> will run
two iPerf VNFs.</para>
<figure>
<title>Clavister VNF Example Overview</title>
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/clavister_vnf_diagram.png"
scale="50" />
</imageobject>
</mediaobject>
</figure>
<para><emphasis role="bold">How to setup the target to run the Clavister
VNF and an Open vSwitch Bridge</emphasis></para>
<orderedlist>
<para><emphasis role="bold">Configure the Network on target_1 and
target_2:</emphasis></para>
<listitem>
<para>From the uCPE Manager select the target_1:
<literal>Configuration</literal> -> <literal>OpenVSwitch</literal>
-> H<literal>ost Interfaces</literal> ->
<literal>Add</literal></para>
</listitem>
<listitem>
<para>Select the network interface that will be used to connect to the
second target, configure it for DPDK, and click
<literal>Create</literal> to send the configuration to the
target:</para>
<figure>
<title>Host Interface Creation</title>
<mediaobject>
<imageobject>
<imagedata align="center"
fileref="images/host_interface_creation.png" />
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>Create an Open vSwitch bridge (<literal>ovsbr0</literal>) with
one DPDK interface by selecting the <literal>Add</literal> button from
the <literal>Bridges</literal> tab.</para>
</listitem>
<listitem>
<para>Once the bridge creation popup appears, fill the fields and add
the physical interface:</para>
<figure>
<title>OVS bridge</title>
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/ovs_bridge_zero.png"
scale="80" />
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>Repeat the steps above on the target_2, by also using one DPDK
interface and creating an OVS bridge.</para>
</listitem>
</orderedlist>
<orderedlist>
<para><emphasis role="bold">Instantiate the VNFs:</emphasis></para>
<para>Once the network configuration has been completed on both targets
instantiate the VNFs:</para>
<para><emphasis role="bold">A) Instantiate Clavister VNF on
target_1:</emphasis></para>
<listitem>
<para>Select the target_1, then the VNF option from the top toolbar:
<literal>VNF</literal> -> <literal>Instances</literal> ->
<literal>Add</literal>.</para>
</listitem>
<listitem>
<para>Fill in the required information about the
<literal>Clavister</literal> VNF, (the default network configuration
can be used):</para>
<figure>
<title>VNF Instance</title>
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/vnf_instance.png"
scale="80" />
</imageobject>
</mediaobject>
</figure>
</listitem>
</orderedlist>
<orderedlist>
<para><emphasis role="bold">B) Instantiate two iPerf VNFs (one as client
and one as server) on target_2: </emphasis></para>
<listitem>
<para>Instantiate two <literal>iPerf</literal> VNFs on target_2. One
will act as the server and the second as the client.</para>
</listitem>
<listitem>
<para>Select target_2, then the VNF option from the top toolbar:
<literal>VNF</literal> -> <literal>Instances</literal> ->
<literal>Add</literal>.</para>
</listitem>
<listitem>
<para>In the <literal>VNF Instance</literal> window, select the first
<literal>iPerf</literal> VNF from the dropdown menu, configure it to
act as a server by unchecking the <literal>Client mode IPerf</literal>
box, and click the <literal>Create</literal> button.</para>
</listitem>
<listitem>
<para>Select <literal>Add</literal>, enable the <literal>Client mode
IPerf</literal> checkbox and then click <literal>Create</literal> to
instantiate the second <literal>iPerf VNF</literal> as a client, and
to run it in client mode.</para>
</listitem>
<listitem>
<para>In order to check that traffic is forwarded between the VNFs,
connect to the iPerf VNF client console:</para>
<para>Connect to the target_2 by using: <literal>SSH</literal> ->
<literal>user</literal> (root) -><literal>Connect</literal> and run
the following:</para>
<programlisting>virsh list
virsh console
root@qemux86-64:~# iperf3 -c 192.168.10.10</programlisting>
</listitem>
</orderedlist>
</section>
<section id="clav_example_sriov">
<title>Clavister VNF using SR-IOV</title>
<para>In this use case, target 1 will run the iPerf server and iPerf
client VNFs using SR-IOV and target 2 will run the Clavister VNF using
SR-IOV with two virtual functions (vf1 and vf2):</para>
<figure>
<title>Example Overview</title>
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/clav_VNF_demo_SR-IOV.png"
scale="60" />
</imageobject>
</mediaobject>
</figure>
<orderedlist>
<listitem>
<para>On target 2, create an SR-IOV configuration with 2 virtual
functions: <literal>Configuration</literal> ->
<literal>OpenVSwitch</literal> -> <literal>Host
Interfaces</literal> -> <literal>Add</literal>:</para>
<figure>
<title>SR-IOV configuration with 2 virtual functions</title>
<mediaobject>
<imageobject>
<imagedata align="center"
fileref="images/sriov_configuration.png" scale="80" />
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>Instantiate the Clavister VNF on target 2, by clicking
<literal>VNF</literal> -> <literal>Instances</literal> ->
<literal>Add</literal>.</para>
<para>Select <literal>SrIovAdapterPool</literal> as an Interface type
for both Interface1 type and 2 type, before clicking
<literal>Create</literal>:</para>
<figure>
<title>Instantiating the Clavister VNF on target 2</title>
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/srlov_adap_pool.png"
scale="70" />
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>On target 1, create an SR-IOV interface as done in step
1.</para>
</listitem>
<listitem>
<para>Create the iPerf server on target 1. Select
<literal>SrIovAdapterPool</literal> as an Interface type:</para>
<figure>
<title>IPerf Server Interface Type</title>
<mediaobject>
<imageobject>
<imagedata align="center"
fileref="images/iperf_server_inttype.png" scale="70" />
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>Create the iPerf client on target 1. Select
<literal>SrIovAdapterPool</literal> as an Interface type and tick the
<literal>Client mode IPer</literal> checkbox:</para>
<figure>
<title>IPerf Client Interface Type</title>
<mediaobject>
<imageobject>
<imagedata align="center"
fileref="images/iperf_client_inttype.png" scale="70" />
</imageobject>
</mediaobject>
</figure>
</listitem>
<listitem>
<para>In order to check that traffic is forwarded between the VNFs,
connect to the iPerf VNF client console by using:
<literal>SSH</literal> -> <literal>user</literal> (root)
-><literal>Connect</literal> and run the following
commands:<programlisting>virsh list
virsh console
root@qemux86-64:~# iperf3 -c 192.168.10.10</programlisting></para>
</listitem>
</orderedlist>
</section>
</chapter>
|