Spec for ITM Yang models cleanup
[genius.git] / docs / testplans / itm-scalability.rst
1
2 .. contents:: Table of Contents
3       :depth: 3
4
5 ===============
6 ITM Scalability
7 ===============
8
9 This document serves as the test plan for the ITM Scalability – OF Based tunnels.  This document comprises of
10 test cases pertaining to all the use case covered by the Functional Spec.
11
12 .. note::
13
14   Name of suite and test cases should map exactly to as they appear in Robot reports.
15
16
17 Test Setup
18 ==========
19
20 Brief description of test setup.
21
22 Testbed Topologies
23 ------------------
24 Topology device software and inter node communication details -
25
26 #. **ODL Node** – 1 or 3 Node ODL Environment should be used
27 #. **Switch Node** - 2 or 3 Nodes with OVS 2.6
28
29 Test Topology
30 ^^^^^^^^^^^^^
31
32 .. literalinclude:: topologies/default-topology.txt
33
34
35 Hardware Requirements
36 ---------------------
37
38 #. 1 controller with 2 OVS for functional testing
39 #. 3 controller with 2 OVS for functional testing
40
41 Software Requirements
42 ---------------------
43 N.A.
44
45 Test Suite Requirements
46 =======================
47
48 Test Suite Bringup
49 ------------------
50
51 In test suit bringup build the topology as described in the Test Topology. Bring all the tunnels UP.
52
53 Test Suite Cleanup
54 ------------------
55
56 Final steps after all tests in suite are done. This should include any cleanup, sanity checks,
57 configuration etc. that needs to be done once all test cases in suite are done.
58
59 Debugging
60 ---------
61
62 Capture any debugging information that is captured at start of suite and end of suite.
63
64
65 Test Cases
66 ==========
67
68 Verify Tunnel Creation with enabled IFM Bypass
69 ----------------------------------------------
70 Change the config parameter to enable IFM Bypass of ITM provisioning and Verify Tunnel Creation is successful.
71
72 Test Steps and Pass Criteria
73 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
74
75 #. Create the VxLAN Tunnels between the OVS to OVS.
76
77    #. Verify that the tunnels are built properly between all the End Points with VxLan Encapsulation.
78    #. Change the configuration parameter as per the new way of ITM provisioning.
79    #. Verify the tunnel creation is successful.
80
81
82 Verify Tunnel Creation with disabled IFM Bypass
83 -----------------------------------------------
84 Change the config parameter to enable without IFM Bypass of ITM provisioning and Verify Tunnel Creation is successful.
85
86 Test Steps and Pass Criteria
87 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
88
89 #. Create the VxLAN Tunnels between the OVS to OVS.
90
91    #. Verify that the tunnels are built properly between all the End Points with VxLan Encapsulation.
92    #. Change the configuration parameter as per the old way of ITM provisioning.
93    #. Verify the tunnel creation is successful.
94
95
96 Change ITM provisioning parameter to enable IFM Bypass
97 ------------------------------------------------------
98 Clean up existing ITM config, change ITM provisioning parameter to provide IFM Bypass, Verify ITM creation succeeds.
99
100 Test Steps and Pass Criteria
101 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
102
103 #. Create the VxLAN Tunnels between the OVS to OVS.
104
105    #. Check for any existing ITM configuration in the system.
106    #. Do a clean up of all the existing ITM configuration.
107    #. Configure the ITM as per the new way of provisioning.
108    #. Verify the tunnel creation is successful.
109
110 Change ITM provisioning parameter to disable IFM Bypass
111 -------------------------------------------------------
112 Clean up existing ITM config, change ITM provisioning parameter to disable IFM Bypass, Verify ITM creation succeeds.
113
114 Test Steps and Pass Criteria
115 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
116
117 #. Create the VxLAN Tunnels between the OVS to OVS.
118
119    #. Check for any existing ITM configuration in the system.
120    #. Do a clean up of all the existing ITM configuration.
121    #. Configure the ITM as per the old way of provisioning
122    #. Verify the tunnel creation is successful
123
124
125 Bring DOWN the datapath
126 -----------------------
127 Configure ITM tunnel Mesh, Bring DOWN the datapath and Verify Tunnel status is updated in ODL.
128
129 Test Steps and Pass Criteria
130 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
131
132 #. Create the VxLAN Tunnels between the OVS to OVS.
133
134    #. Verify that the tunnels are built properly between all the End Points with VxLan Encapsulation.
135    #. Configure the ITM tunnel mesh.
136    #. Verify the tunnel creation is successful.
137    #. Bring down the datapath on the system.
138    #. Verify the tunnel status is updated in ODL.
139
140
141 Bring UP the datapath
142 ------------------------
143 Configure ITM tunnel Mesh, Bring UP the datapath and Verify Tunnel status is updated in ODL.
144
145 Test Steps and Pass Criteria
146 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
147
148 #. Create the VxLAN Tunnels between the OVS to OVS.
149
150    #. Configure the ITM tunnel mesh.
151    #. Verify the tunnel creation is successful.
152    #. Bring UP the datapath on the system.
153    #. Verify the tunnel status is updated in ODL.
154
155
156 Enable BFD Monitoring for ITM Tunnels
157 -------------------------------------
158 Change ITM config parameters to enable IFM Bypass and Verify BFD monitoring can be enabled for ITM tunnels.
159
160 Test Steps and Pass Criteria
161 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
162
163 #. And configure the tunnel monitoring to BFD.
164
165    #. Bring up the ITM config as per the new way of provisioning.
166    #. Verify the tunnel creation is successful.
167    #. Verify whether the BFD monitoring is enabled.
168
169
170 Disable BFD Monitoring for ITM Tunnels
171 --------------------------------------
172 Change ITM config parameters to enable IFM Bypass and Verify BFD monitoring can be disabled for ITM tunnels
173
174 Test Steps and Pass Criteria
175 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
176
177 #. Configure the tunnel monitoring to BFD.
178
179    #. Bring up the ITM config as per the new way of provisioning.
180    #. Verify the tunnel creation is successful.
181    #. Disable BFD monitoring.
182    #. Verify whether the BFD monitoring is disabled
183
184
185 Enable/Disable BFD to verify tunnel status alarm
186 ------------------------------------------------
187 Enable BFD and check for the data path alarm and as well as control path alarms.
188
189 Test Steps and Pass Criteria
190 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
191
192 #. Configure the tunnel monitoring to BFD.
193
194    #. Bring up the ITM config as per the new way of provisioning.
195    #. Verify the tunnel creation is successful.
196    #. Verify whether the BFD monitoring is enabled.
197    #. Bring down the tunnel and check for the Alarms.
198    #. Disable alarm support and verify whether alarm is not reporting.
199
200
201 Verify Tunnel down alarm is reported
202 ------------------------------------
203 Enable Tunnel status alarm and Bring down the Tunnel port, and verify Tunnel down alarm is reported.
204
205 Test Steps and Pass Criteria
206 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
207
208 #. Configure the tunnel monitoring to BFD.
209
210    #. Bring up the ITM config as per the new way of provisioning.
211    #. Verify the tunnel creation is successful.
212    #. Verify whether the BFD monitoring is enabled.
213    #. Enable the alarms for the tunnel UP/DOWN notification.
214    #. Bring down the tunnel and check for the Alarms.
215
216
217 Verify Tunnel status for the Disconnected DPN
218 ---------------------------------------------
219 Disconnect DPN from ODL and verify Tunnel status is shown as UNKNOWN for the Disconnected DPN.
220
221 Test Steps and Pass Criteria
222 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
223
224 #. And configure the tunnel monitoring to BFD.
225
226    #. Bring up the ITM config as per the new way of provisioning.
227    #. Verify the tunnel creation is successful.
228    #. Disconnect the DPN from the ODL.
229    #. Verify tunnel status is shown as ‘UNKNOWN’  for the disconnected DPN.
230
231
232 Verify Tunnel down alarm is cleared
233 -----------------------------------
234 Enable Tunnel status alarm and Bring up the Tunnel port which is down, and verify Tunnel down alarm is cleared.
235
236 Test Steps and Pass Criteria
237 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
238
239 #. And configure the tunnel monitoring to BFD.
240
241    #. Bring up the ITM config as per the new way of provisioning.
242    #. Verify the tunnel creation is successful.
243    #. Enable the alarms for the tunnel UP/DOWN notification.
244    #. Bring ‘DOWN’ the tunnel and check for the alarm notification.
245
246
247 Perform ODL reboot
248 ------------------
249 Create ITM with provisioning config parameter set to true, Perform ODL reboot and Verify dataplane is intact.
250
251 Test Steps and Pass Criteria
252 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
253
254 #. Create the VxLAN Tunnels between the OVS to OVS.
255
256    #. Bring up the ITM config as per the new way of provisioning.
257    #. Do a ODL Reboot.
258    #. Verify the dataplane is intact.
259
260
261 Verify Re-sync is successful once connection is up
262 --------------------------------------------------
263 Create ITM with provisioning config parameter set to true for IFM Bypass, bring down control plane
264 connection(between ODL--OVS), modify ODL config, Verify Re-sync is successful once connection is up.
265
266 Test Steps and Pass Criteria
267 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
268
269 #. Create the VxLAN Tunnels between the OVS to OVS.
270
271    #. Bring up the ITM config as per the new way of provisioning.
272    #. Bring down the control plane connection between ODL – OVS.
273    #. Modify ODL configuration.
274    #. Check whether the Re-sync is successful once the connection is UP.
275
276
277 Verify ITM creation with 2 DPNs
278 -------------------------------
279
280 Test Steps and Pass Criteria
281 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
282
283 #. Create the VxLAN Tunnels between the OVS to OVS.
284
285    #. Check for any existing ITM configuration in the system.
286    #. Do a clean up of all the existing ITM configuration.
287    #. Configure the ITM as per the old way of provisioning
288    #. Verify the tunnel creation is successful
289
290
291 Verify TEP Creation
292 -------------------
293 Add new TEP's and verify Creation is successful
294
295 Test Steps and Pass Criteria
296 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
297
298 #. Create the VxLAN Tunnels between the OVS to OVS.
299
300    #. Verify that the tunnels are built properly between all the End Points  with VxLan Encapsulation.
301    #. Add new TEP’s to the existing configuration.
302    #. Monitor the time taken for tunnel addition and flow programming.
303    #. Verify the tunnel creation is successful.
304
305
306 Verify TEP Deletion
307 -------------------
308 Delete few TEP's and verify Deletion is successful and no stale(flows,config) is left.
309
310 Test Steps and Pass Criteria
311 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
312
313 #. Create the VxLAN Tunnels between the OVS to OVS.
314
315    #. Verify that the tunnels are built properly between all the End Points with VxLan Encapsulation.
316    #. Delete the newly added TEP configuration.
317    #. Monitor the time taken for tunnel deletion and flow re-programming.
318    #. Verify the deletion is successful and no stale entries left.
319
320
321 Verify ITM creation by Re-adding TEPs
322 -------------------------------------
323 Re-add deleted TEP's and Verify ITM creation is successful
324
325 Test Steps and Pass Criteria
326 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
327
328 #. Create the VxLAN Tunnels between the OVS to OVS.
329
330    #. Verify that the tunnels are built properly between all the End Points  with VxLan Encapsulation.
331    #. Re-add the deleted TEP entries
332    #. Monitor the time taken for tunnel re-addition and flow programming
333    #. Verify the tunnel creation is successful.
334
335
336 Verify Deletion of All TEPs
337 ---------------------------
338 Delete all TEP's and verify Deletion is successful and no stale(flows,config) is left
339
340 Test Steps and Pass Criteria
341 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
342
343 #. Create the VxLAN Tunnels between the OVS to OVS.
344
345    #. Verify that the tunnels are built properly between all the End Points with VxLan Encapsulation.
346    #. Delete all the TEP entries.
347    #. Monitor the time taken for tunnel deletion and flow re-programming
348    #. Verify the deletion is successful and no stale entries left.
349
350
351 Implementation
352 ==============
353 N.A.
354
355 Assignee(s)
356 -----------
357 Who is contributing test cases? In case of multiple authors, designate a
358 primary assignee and other contributors. Primary assignee is also expected to
359 be maintainer once test code is in.
360
361 Primary assignee:
362   Faseela K
363
364 Other contributors:
365   Nidhi Adhvaryu,
366   Sathwik Boggarapu
367
368
369 Work Items
370 ----------
371 N.A.
372
373 Links
374 -----
375
376 * Link to implementation patche(s) in CSIT
377
378 References
379 ==========
380 N.A.