aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVratko Polak <vrpolak@cisco.com>2021-08-04 10:26:28 +0200
committerTibor Frank <tifrank@cisco.com>2021-08-04 12:08:07 +0000
commit6fdf1c2829225150b4e27bc0066631965b2baec4 (patch)
treebe79539faf7154586ffea2d424eeed7d33b6d598
parent8496be0c60a1a046b308a53e4d91381d857ada95 (diff)
Methodology: Update MLRsearch descriptions
Change-Id: Icdcb7210835fa90a6f5f1688b815a6edf07a4b39 Signed-off-by: Vratko Polak <vrpolak@cisco.com> (cherry picked from commit ad8442c642f5dd4a6630e1e66c980cb86c5039bb)
-rw-r--r--docs/report/introduction/methodology_data_plane_throughput/methodology_data_plane_throughput.rst4
-rw-r--r--docs/report/introduction/methodology_data_plane_throughput/methodology_mlrsearch_tests.rst24
2 files changed, 13 insertions, 15 deletions
diff --git a/docs/report/introduction/methodology_data_plane_throughput/methodology_data_plane_throughput.rst b/docs/report/introduction/methodology_data_plane_throughput/methodology_data_plane_throughput.rst
index 00dcb0b40e..4af9db61f0 100644
--- a/docs/report/introduction/methodology_data_plane_throughput/methodology_data_plane_throughput.rst
+++ b/docs/report/introduction/methodology_data_plane_throughput/methodology_data_plane_throughput.rst
@@ -52,8 +52,8 @@ Details
~~~~~~~
See :ref:`mlrsearch_algorithm` section for more detail. MLRsearch is
-being standardized in IETF in `draft-vpolak-mkonstan-mlrsearch
-<https://tools.ietf.org/html/draft-vpolak-mkonstan-bmwg-mlrsearch>`_.
+being standardized in IETF in `draft-ietf-bmwg-mlrsearch
+<https://datatracker.ietf.org/doc/html/draft-ietf-bmwg-mlrsearch-01>`_.
MRR Tests
^^^^^^^^^
diff --git a/docs/report/introduction/methodology_data_plane_throughput/methodology_mlrsearch_tests.rst b/docs/report/introduction/methodology_data_plane_throughput/methodology_mlrsearch_tests.rst
index 1209697195..5457daa555 100644
--- a/docs/report/introduction/methodology_data_plane_throughput/methodology_mlrsearch_tests.rst
+++ b/docs/report/introduction/methodology_data_plane_throughput/methodology_mlrsearch_tests.rst
@@ -7,25 +7,22 @@ Overview
~~~~~~~~
Multiple Loss Rate search (MLRsearch) tests use new search algorithm
-implemented in FD.io CSIT project. MLRsearch discovers multiple packet
+implemented in FD.io CSIT project. MLRsearch discovers any number of packet
throughput rates in a single search, with each rate associated with a
different Packet Loss Ratio (PLR) criteria.
-Two throughput measurements used in FD.io CSIT are Non-Drop Rate (NDR,
+Two throughput rates of interest in FD.io CSIT are Non-Drop Rate (NDR,
with zero packet loss, PLR=0) and Partial Drop Rate (PDR, with packet
-loss rate not greater than the configured non-zero PLR).
+loss rate not greater than the configured non-zero PLR, currently 0.5%).
-MLRsearch discovers NDR and PDR in a single pass reducing required time
-duration compared to separate `binary search`_es for NDR and PDR. Overall
+MLRsearch discovers all the rates in a single pass, reducing required time
+duration compared to separate `binary search`_es for each rate. Overall
search time is reduced even further by relying on shorter trial
durations of intermediate steps, with only the final measurements
conducted at the specified final trial duration. This results in the
shorter overall execution time when compared to standard NDR/PDR binary
search, while guaranteeing similar results.
-If needed, next version of MLRsearch can be easily adopted
-to discover more throughput rates with different pre-defined PLRs.
-
.. Note:: All throughput rates are *always* bi-directional
aggregates of two equal (symmetric) uni-directional packet rates
received and reported by an external traffic generator.
@@ -34,8 +31,8 @@ Search Implementation
~~~~~~~~~~~~~~~~~~~~~
Detailed description of the MLRsearch algorithm is included in the IETF
-draft `draft-vpolak-mkonstan-mlrsearch
-<https://tools.ietf.org/html/draft-vpolak-mkonstan-bmwg-mlrsearch>`_
+draft `draft-ietf-bmwg-mlrsearch-01
+<https://datatracker.ietf.org/doc/html/draft-ietf-bmwg-mlrsearch-01>`_
that is in the process of being standardized in the IETF Benchmarking
Methodology Working Group (BMWG).
@@ -45,8 +42,9 @@ MLRsearch is also available as a `PyPI (Python Package Index) library
Implementation Deviations
~~~~~~~~~~~~~~~~~~~~~~~~~
-FD.io CSIT implementation of MLRsearch so far is fully based on the -02
-version of the `draft-vpolak-mkonstan-mlrsearch-02
-<https://tools.ietf.org/html/draft-vpolak-mkonstan-bmwg-mlrsearch-02>`_.
+FD.io CSIT implementation of MLRsearch is currently fully based on the -01`
+version of the `draft-ietf-bmwg-mlrsearch
+<https://datatracker.ietf.org/doc/html/draft-ietf-bmwg-mlrsearch-01>`_,
+the PyPI version is slightly older.
.. _binary search: https://en.wikipedia.org/wiki/Binary_search