Methodology: Update MLRsearch descriptions 33/33333/2
authorVratko Polak <vrpolak@cisco.com>
Wed, 4 Aug 2021 08:26:28 +0000 (10:26 +0200)
committerTibor Frank <tifrank@cisco.com>
Wed, 4 Aug 2021 12:07:59 +0000 (12:07 +0000)
Change-Id: Icdcb7210835fa90a6f5f1688b815a6edf07a4b39
Signed-off-by: Vratko Polak <vrpolak@cisco.com>
docs/report/introduction/methodology_data_plane_throughput/methodology_data_plane_throughput.rst
docs/report/introduction/methodology_data_plane_throughput/methodology_mlrsearch_tests.rst

index 00dcb0b..4af9db6 100644 (file)
@@ -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
 ^^^^^^^^^
index 1209697..5457daa 100644 (file)
@@ -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