aboutsummaryrefslogtreecommitdiffstats
path: root/docs/report/introduction/test_environment_intro.rst
blob: c2feb1b4c4797ba49d1f184d138299e8f2b8adf7 (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
92
93
94
95
96
97
98
99
100
101
102
103
104
Test Environment
================

.. _test_environment_versioning:

Environment Versioning
----------------------

CSIT test environment versioning has been introduced to track
modifications of the test environment.

Any benchmark anomalies (progressions, regressions) between releases of
a DUT application (e.g. VPP, DPDK), are determined by testing it in the
same test environment, to avoid test environment changes clouding the
picture.
To beter distinguish impact of test environment changes,
we also execute tests without any SUT (just with TRex TG sending packets
over a link looping back to TG).

A mirror approach is introduced to determine benchmarking anomalies due
to the test environment change. This is achieved by testing the same DUT
application version between releases of CSIT test system. This works
under the assumption that the behaviour of the DUT is deterministic
under the test conditions.

CSIT test environment versioning scheme ensures integrity of all the
test system components, including their HW revisions, compiled SW code
versions and SW source code, within a specific CSIT version. Components
included in the CSIT environment versioning include:

- **HW** Server hardware firmware and BIOS (motherboard, processsor,
  NIC(s), accelerator card(s)), tracked in CSIT branch in
  :file:`./docs/lab/<server_platform_name>_hw_bios_cfg.md`, e.g. `Xeon
  Skylake servers
  <https://git.fd.io/csit/tree/docs/lab/testbeds_sm_skx_hw_bios_cfg.md#n556>`_.
- **Linux** Server Linux OS version and configuration, tracked in CSIT
  Reports in `SUT Settings
  <https://s3-docs.fd.io/csit/master/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_
  and `Pre-Test Server Calibration
  <https://s3-docs.fd.io/csit/master/report/vpp_performance_tests/test_environment.html#id21>`_.
- **TRex** TRex Traffic Generator version, drivers and configuration
  tracked in `TG Settings
  <https://s3-docs.fd.io/csit/master/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_.
- **CSIT** CSIT framework code tracked in CSIT release branches.

Following is the list of CSIT versions to date:

- Ver. 1 associated with CSIT rls1908 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls1908>`_, `Linux
  <https://docs.fd.io/csit/rls1908/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://docs.fd.io/csit/rls1908/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls1908>`_).
- Ver. 2 associated with CSIT rls2001 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls2001>`_, `Linux
  <https://docs.fd.io/csit/rls2001/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://docs.fd.io/csit/rls2001/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls2001>`_).
- Ver. 4 associated with CSIT rls2005 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls2005>`_, `Linux
  <https://docs.fd.io/csit/rls2005/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://docs.fd.io/csit/rls2005/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls2005>`_).
- Ver. 5 associated with CSIT rls2009 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls2009>`_, `Linux
  <https://docs.fd.io/csit/rls2009/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://docs.fd.io/csit/rls2009/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls2009>`_).

  - The main change is TRex data-plane core resource adjustments:
    `increase from 7 to 8 cores and pinning cores to interfaces <https://gerrit.fd.io/r/c/csit/+/28184>`_
    for better TRex performance with symmetric traffic profiles.
- Ver. 6 associated with CSIT rls2101 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls2101>`_, `Linux
  <https://docs.fd.io/csit/rls2101/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://docs.fd.io/csit/rls2101/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls2101>`_).

  - The main change is TRex version upgrade:
    `increase from 2.82 to 2.86 <https://gerrit.fd.io/r/c/csit/+/29980>`_.
- Ver. 7 associated with CSIT rls2106 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls2106>`_, `Linux
  <https://s3-docs.fd.io/csit/rls2106/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://s3-docs.fd.io/csit/rls2106/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls2106>`_).

  - TRex version upgrade:
    `increase from 2.86 to 2.88 <https://gerrit.fd.io/r/c/csit/+/31652>`_.
  - Ubuntu upgrade:
    `upgrade from 18.04 LTS to 20.04.2 LTS <https://gerrit.fd.io/r/c/csit/+/31290>`_.
- Ver. 8 associated with CSIT rls2110 branch (`HW
  <https://git.fd.io/csit/tree/docs/lab?h=rls2110>`_, `Linux
  <https://s3-docs.fd.io/csit/rls2110/report/vpp_performance_tests/test_environment.html#sut-settings-linux>`_,
  `TRex
  <https://s3-docs.fd.io/csit/rls2110/report/vpp_performance_tests/test_environment.html#tg-settings-trex>`_,
  `CSIT <https://git.fd.io/csit/tree/?h=rls2110>`_).

  - Intel NIC 700/800 series firmware upgrade based on DPDK compatibility
    matrix: `depends on testbed type <https://gerrit.fd.io/r/c/csit/+/33311>`_.