diff options
Diffstat (limited to 'docs/requirements')
| -rw-r--r-- | docs/requirements/LICENSE | 2 | ||||
| -rw-r--r-- | docs/requirements/ietf_draft/LICENSE | 12 | ||||
| -rw-r--r-- | docs/requirements/index.rst | 11 | ||||
| -rw-r--r-- | docs/requirements/vswitchperf_ltd.rst | 63 | ||||
| -rw-r--r-- | docs/requirements/vswitchperf_ltp.rst | 8 |
5 files changed, 54 insertions, 42 deletions
diff --git a/docs/requirements/LICENSE b/docs/requirements/LICENSE new file mode 100644 index 00000000..7bc572ce --- /dev/null +++ b/docs/requirements/LICENSE @@ -0,0 +1,2 @@ +This work is licensed under a Creative Commons Attribution 4.0 International License. +http://creativecommons.org/licenses/by/4.0 diff --git a/docs/requirements/ietf_draft/LICENSE b/docs/requirements/ietf_draft/LICENSE new file mode 100644 index 00000000..7fc9ae14 --- /dev/null +++ b/docs/requirements/ietf_draft/LICENSE @@ -0,0 +1,12 @@ +Copyright (c) 2016 IETF Trust and the persons identified as the +document authors. All rights reserved. + +This document is subject to BCP 78 and the IETF Trust's Legal +Provisions Relating to IETF Documents +(http://trustee.ietf.org/license-info) in effect on the date of +publication of this document. Please review these documents +carefully, as they describe your rights and restrictions with respect +to this document. Code Components extracted from this document must +include Simplified BSD License text as described in Section 4.e of +the Trust Legal Provisions and are provided without warranty as +described in the Simplified BSD License. diff --git a/docs/requirements/index.rst b/docs/requirements/index.rst deleted file mode 100644 index 311ddb07..00000000 --- a/docs/requirements/index.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) OPNFV, Intel Corporation, AT&T and others. - -.. toctree:: - :maxdepth: 3 - :numbered: 5 - - vswitchperf_ltp.rst - vswitchperf_ltd.rst - diff --git a/docs/requirements/vswitchperf_ltd.rst b/docs/requirements/vswitchperf_ltd.rst index 69497c5c..e1372520 100644 --- a/docs/requirements/vswitchperf_ltd.rst +++ b/docs/requirements/vswitchperf_ltd.rst @@ -127,6 +127,8 @@ expected that more will be added. .. 3.2.2.1.1 +.. _PacketLossRatio: + Test ID: LTD.Throughput.RFC2544.PacketLossRatio ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -144,8 +146,8 @@ Test ID: LTD.Throughput.RFC2544.PacketLossRatio Note: Other values can be tested if required by the user. - The selected frame sizes are those previously defined under `Default - Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + The selected frame sizes are those previously defined under + :ref:`default-test-parameters`. The test can also be used to determine the average latency of the traffic. Under the `RFC2544 <https://www.rfc-editor.org/rfc/rfc2544.txt>`__ @@ -178,6 +180,8 @@ Test ID: LTD.Throughput.RFC2544.PacketLossRatio .. 3.2.2.1.2 +.. _PacketLossRatioFrameModification: + Test ID: LTD.Throughput.RFC2544.PacketLossRatioFrameModification ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -196,8 +200,8 @@ Test ID: LTD.Throughput.RFC2544.PacketLossRatioFrameModification Note: Other values can be tested if required by the user. - The selected frame sizes are those previously defined under `Default - Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + The selected frame sizes are those previously defined under + :ref:`default-test-parameters`. The test can also be used to determine the average latency of the traffic. Under the `RFC2544 <https://www.rfc-editor.org/rfc/rfc2544.txt>`__ @@ -267,8 +271,8 @@ Test ID: LTD.Throughput.RFC2544.Profile and latency as the offered rate increases is slow and graceful or sudden and severe. - The selected frame sizes are those previously defined under `Default - Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + The selected frame sizes are those previously defined under + :ref:`default-test-parameters`. The offered traffic rate is described as a percentage delta with respect to the DUT's RFC 2544 Throughput as determined by @@ -319,8 +323,7 @@ Test ID: LTD.Throughput.RFC2544.SystemRecoveryTime The aim of this test is to determine the length of time it takes the DUT to recover from an overload condition for a constant load (fixed length frames at a fixed interval time). The selected frame sizes are those - previously defined under `Default Test Parameters - <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__, + previously defined under :ref:`default-test-parameters`, traffic should be sent to the DUT under normal conditions. During the duration of the test and while the traffic flows are passing though the DUT, at least one situation leading to an overload condition for the DUT @@ -359,6 +362,8 @@ Test ID: LTD.Throughput.RFC2544.SystemRecoveryTime .. 3.2.2.1.5 +.. _BackToBackFrames: + Test ID: LTD.Throughput.RFC2544.BackToBackFrames ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -372,9 +377,7 @@ Test ID: LTD.Throughput.RFC2544.BackToBackFrames The aim of this test is to characterize the ability of the DUT to process back-to-back frames. For each frame size previously defined - under `Default Test Parameters - <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__, - a burst of traffic + under :ref:`default-test-parameters`, a burst of traffic is sent to the DUT with the minimum inter-frame gap between each frame. If the number of received frames equals the number of frames that were transmitted, the burst size should be increased and traffic is sent to @@ -527,8 +530,7 @@ Test ID: LTD.Throughput.RFC6201.ResetTime Both reset methods SHOULD be exercised. - For each frame size previously defined under `Default Test - Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__, + For each frame size previously defined under :ref:`default-test-parameters`, traffic should be sent to the DUT under normal conditions. During the duration of the test and while the traffic flows are passing through the DUT, the DUT should be reset and the Reset @@ -613,8 +615,7 @@ Test ID: LTD.Throughput.RFC2889.MaxForwardingRate This test measures the DUT's Max Forwarding Rate when the Offered Load is varied between the throughput and the Maximum Offered Load for fixed length frames at a fixed time interval. The selected frame sizes are - those previously defined under `Default Test - Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + those previously defined under :ref:`default-test-parameters`. The throughput is the maximum offered load with 0% frame loss (measured by the prerequisite test), and the Maximum Offered Load (as defined by @@ -749,8 +750,7 @@ Test ID: LTD.Throughput.RFC2889.BroadcastFrameForwarding The aim of this test is to determine the maximum forwarding rate of the DUT when forwarding broadcast traffic. For each frame previously defined - under `Default Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__, - the traffic should + under :ref:`default-test-parameters`, the traffic should be set up as broadcast traffic. The traffic throughput of the DUT should be measured. @@ -917,8 +917,8 @@ Test ID: LTD.Throughput.Overlay.Network.<tech>.RFC2544.PacketLossRatio - De-encapsulate the packet, if required - Switch the packet to the correct port - The selected frame sizes are those previously defined under `Default - Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + The selected frame sizes are those previously defined under + :ref:`default-test-parameters`. Thus, each test comprises an overlay technology, a network function, and a packet size *with* overlay network overhead included @@ -1041,8 +1041,8 @@ Test ID: LTD.Throughput.RFC2544.MatchAction.PacketLossRatio The default loss percentages to be tested are: - X = 0% - X = 10^-7% Other values can be tested if required by the user. The selected - frame sizes are those previously defined under `Default Test Parameters - <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + frame sizes are those previously defined under + :ref:`default-test-parameters`. The test can also be used to determine the average latency of the traffic when a match action is applied to packets in a flow. Under @@ -1189,6 +1189,8 @@ It is expected that more will be added. .. 3.2.2.3.1 +.. _Scalability0PacketLoss: + Test ID: LTD.Scalability.Flows.RFC2544.0PacketLoss ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1207,8 +1209,7 @@ Test ID: LTD.Scalability.Flows.RFC2544.0PacketLoss through the fastpath, as such the flows need to be installed on the DUT before passing traffic. - For each frame size previously defined under `Default Test - Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__ + For each frame size previously defined under :ref:`default-test-parameters` and for each of the following number of flows: - 1,000 @@ -1336,8 +1337,8 @@ Test ID: LTD.Scalability.VNF.RFC2544.PacketLossRatio would be to continue to add VNFs without bringing down the DUT. The approach used needs to be documented as part of the test report. - The selected frame sizes are those previously defined under `Default - Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + The selected frame sizes are those previously defined under + :ref:`default-test-parameters`. The test can also be used to determine the average latency of the traffic. Under the `RFC2544 <https://www.rfc-editor.org/rfc/rfc2544.txt>`__ @@ -1397,8 +1398,8 @@ Test ID: LTD.Scalability.VNF.RFC2544.PacketLossProfile and graceful, or sudden and severe. The minimum number of VNFs to be tested is 3. - The selected frame sizes are those previously defined under `Default - Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + The selected frame sizes are those previously defined under + :ref:`default-test-parameters`. The offered traffic rate is described as a percentage delta with respect to the DUT's RFC 2544 Throughput as determined by @@ -1479,8 +1480,7 @@ Test ID: LTD.Activation.RFC2889.AddressCachingCapacity MAC learning. The aim of this test is to determine the address caching capacity of the DUT for a constant load (fixed length frames at a fixed interval time). The selected frame sizes are those previously defined - under `Default Test Parameters - <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__. + under :ref:`default-test-parameters`. In order to run this test the aging time, that is the maximum time the DUT will keep a learned address in its flow table, and a set of initial @@ -1533,8 +1533,7 @@ Test ID: LTD.Activation.RFC2889.AddressLearningRate MAC learning. The aim of this test is to determine the rate of address learning of the DUT for a constant load (fixed length frames at a fixed interval time). The selected frame sizes are those previously defined - under `Default Test Parameters <http://artifacts.opnfv.org/vswitchperf/docs/index.html#default-test-parameters>`__, - traffic should be + under :ref:`default-test-parameters`, traffic should be sent with each IPv4/IPv6 address incremented by one. The rate at which the DUT learns a new address should be measured. The maximum caching capacity from LTD.Memory.RFC2889.AddressCachingCapacity should be taken @@ -1626,6 +1625,8 @@ should be required. It is expected that more will be added. .. 3.2.2.6.1 +.. _CPU0PacketLoss: + Test ID: LTD.Stress.RFC2544.0PacketLoss ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/requirements/vswitchperf_ltp.rst b/docs/requirements/vswitchperf_ltp.rst index 14303de5..2b74d676 100644 --- a/docs/requirements/vswitchperf_ltp.rst +++ b/docs/requirements/vswitchperf_ltp.rst @@ -303,6 +303,8 @@ datapaths to physical ports (to NICs) and to logical ports (to VNFs): .. 3.2.5.1.1 +.. _Phy2Phy: + Physical port → vSwitch → physical port ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: console @@ -326,6 +328,8 @@ Physical port → vSwitch → physical port .. 3.2.5.1.2 +.. _PVP: + Physical port → vSwitch → VNF → vSwitch → physical port ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: console @@ -365,6 +369,8 @@ Physical port → vSwitch → VNF → vSwitch → physical port .. 3.2.5.1.3 +.. _PVVP: + Physical port → vSwitch → VNF → vSwitch → VNF → vSwitch → physical port ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -639,6 +645,8 @@ Suitable real Telco workload VNFs are yet to be identified. .. 3.2.5.2.1 +.. _default-test-parameters: + Default Test Parameters ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |