aboutsummaryrefslogtreecommitdiffstats
path: root/docs/xtesting/index.rst
blob: 20a291a15818ac0c28bf24c5fceba1eff4f40848 (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
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. (c) OPNFV, Spirent, AT&T, Ixia  and others.

.. Anuket ViNePerf Documentation master file.

***********************************
Anuket ViNePerf with OPNFV Xtesting
***********************************

============
Introduction
============
User can use ViNePerf with Xtesting for two different usecases.

1. Baremetal Dataplane Testing/Benchmarking.
2. Openstack Dataplane Testing/Benchmarking.

The Baremetal usecase is the legacy usecase of Anuket ViNePerf.

The below figure summarizes both the usecases.

.. image:: ./vsperf-xtesting.png
  :width: 400

===========
How to Use?
===========

Step-1: Build the container
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Go the xtesting/baremetal or xtesting/openstack and run the following command.

.. code-block:: console

  docker build -t 127.0.0.1:5000/vsperfbm


Step-2: Install and run Xtesting Playbook
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

These commands are described in OPNFV Xtesting Documentation. Please refere to OPNFV Xtesting wiki for description of these commands.

.. code-block:: console

  virtualenv xtesting
  . xtesting/bin/activate
  ansible-galaxy install collivier.xtesting
  ansible-playbook site.yml

======================
Accessing the Results?
======================

ViNePerf automatically publishes the results to any Anuket Testapi deployment.
User has to configure following two parameters in ViNePerf.

1. OPNFVPOD - The name of the pod.
2. OPNFV_URL - The endpoint serving testapi.

As Xtesting runs its own testapi, user should point to this (testapi endpoint of Xtesting) using the above two configuration.

The above two configurations should be done wherever ViNePerf is running (refer to the figure above)

NOTE: Before running the test, it would help if user can prepre the testapi of Xtesting (if needed). The preparation include setting up the following:

1. Projects
2. Testcases.
3. Pods.

Please refer to the documentation of testapi for more details.

=======================================
Accessing other components of Xtesting?
=======================================

Please refer to the documentation of Xtesting in OPNFV Wiki.

===========
Limitations
===========
For Jerma Release, following limitations apply:

1. For both baremetal and openstack, only phy2phy_tput testcase is supported.
2. For openstack, only Spirent's STCv and Keysight's Ixnet-Virtual is supported.