X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fintroduction%2Ftest_environment_pre_test_server_calib.rst;fp=docs%2Freport%2Fintroduction%2Ftest_environment_pre_test_server_calib.rst;h=325c61b212bcb8f9160c8399755393338f6bfab9;hb=12c3608c3464add7664e3b8f41b07b9b8fd03f1c;hp=0000000000000000000000000000000000000000;hpb=d0f1e8778dac3549a1f1e403541de9f3ee88ec8d;p=csit.git

diff --git a/docs/report/introduction/test_environment_pre_test_server_calib.rst b/docs/report/introduction/test_environment_pre_test_server_calib.rst
new file mode 100644
index 0000000000..325c61b212
--- /dev/null
+++ b/docs/report/introduction/test_environment_pre_test_server_calib.rst
@@ -0,0 +1,26 @@
+Pre-Test Server Calibration
+---------------------------
+
+Number of SUT server sub-system runtime parameters have been identified
+as impacting data plane performance tests. Calibrating those parameters
+is part of FD.io CSIT pre-test activities, and includes measuring and
+reporting following:
+
+#. System level core jitter - measure duration of core interrupts by
+   Linux in clock cycles and how often interrupts happen. Using
+   `CPU core jitter tool <https://git.fd.io/pma_tools/tree/jitter>`_.
+
+#. Memory bandwidth - measure bandwidth with `Intel MLC tool
+   <https://software.intel.com/en-us/articles/intelr-memory-latency-checker>`_.
+
+#. Memory latency - measure memory latency with Intel MLC tool.
+
+#. Cache latency at all levels (L1, L2, and Last Level Cache) - measure
+   cache latency with Intel MLC tool.
+
+Measured values of listed parameters are especially important for
+repeatable zero packet loss throughput measurements across multiple
+system instances. Generally they come useful as a background data for
+comparing data plane performance results across disparate servers.
+
+Following sections include measured calibration data for testbeds.