diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/development/design/index.rst | 3 | ||||
-rw-r--r-- | docs/development/design/ndrpdr.rst | 29 | ||||
-rw-r--r-- | docs/development/index.rst | 2 | ||||
-rw-r--r-- | docs/testing/user/userguide/advanced.rst | 7 | ||||
-rw-r--r-- | docs/testing/user/userguide/images/extchain-config.svg | 150 | ||||
-rw-r--r-- | docs/testing/user/userguide/sriov.rst | 9 |
6 files changed, 126 insertions, 74 deletions
diff --git a/docs/development/design/index.rst b/docs/development/design/index.rst index 22e79d9..a8093cb 100644 --- a/docs/development/design/index.rst +++ b/docs/development/design/index.rst @@ -5,6 +5,7 @@ OPNFV NFVbench Euphrates Design ============================================= .. toctree:: - :maxdepth: 1 + :maxdepth: 2 design + ndrpdr diff --git a/docs/development/design/ndrpdr.rst b/docs/development/design/ndrpdr.rst new file mode 100644 index 0000000..f748476 --- /dev/null +++ b/docs/development/design/ndrpdr.rst @@ -0,0 +1,29 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International +.. License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Cisco Systems, Inc + +NDR/PDR Binary Search +===================== + +Algorithm Outline +----------------- + +The ServiceChain class is responsible for calculating the NDR/PDR for all frame sizes requested in the configuration. +Calculation for 1 frame size is delegated to the TrafficClient class. + +Call chain for calculating the NDR-PDR for a list of frame sizes: + +- ServiceChain.run() + - ServiceChain._get_chain_results() + - for every frame size: + - ServiceChain.__get_result_per_frame_size() + - TrafficClient.get_ndr_pdr() + - TrafficClient.__range_search() recursive binary search + +The search range is delimited by a left and right rate (expressed as a % of line rate per direction). + +The recursion narrows down the range by half and stops when: +- the range is smaller than the configured load_epsilon value +- or when the search hits 100% or 0% of line rate + diff --git a/docs/development/index.rst b/docs/development/index.rst index 1dd34cc..1db91e7 100644 --- a/docs/development/index.rst +++ b/docs/development/index.rst @@ -4,7 +4,7 @@ .. (c) Cisco Systems, Inc .. toctree:: - :maxdepth: 1 + :maxdepth: 3 overview/index design/index diff --git a/docs/testing/user/userguide/advanced.rst b/docs/testing/user/userguide/advanced.rst index bfffa24..6823cb1 100644 --- a/docs/testing/user/userguide/advanced.rst +++ b/docs/testing/user/userguide/advanced.rst @@ -323,9 +323,9 @@ The nfvbench_cleanup script will cleanup resources created by NFVbench. You need OpenStack. Example of run: -.. code-block:: bash +.. code-block:: none - nfvbench_9425 [root@c45-build /]# nfvbench_cleanup -r /tmp/nfvbench/openrc + # nfvbench_cleanup -r /tmp/nfvbench/openrc Discovering Storage resources... Discovering Compute resources... Discovering Network resources... @@ -358,5 +358,4 @@ Example of run: + Network port cc2d8f1b-49fe-491e-9e44-6990fc57e891 is successfully deleted + NETWORK nfvbench-net1 is successfully deleted *** KEYSTONE cleanup - nfvbench_9425 [root@c45-build /]# - + # diff --git a/docs/testing/user/userguide/images/extchain-config.svg b/docs/testing/user/userguide/images/extchain-config.svg index 4e3db47..e519946 100644 --- a/docs/testing/user/userguide/images/extchain-config.svg +++ b/docs/testing/user/userguide/images/extchain-config.svg @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"> -<svg xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" viewBox="78 81 726 460" width="726pt" height="460pt" xmlns:dc="http://purl.org/dc/elements/1.1/"> - <metadata> Produced by OmniGraffle 7.3 - <dc:date>2017-03-31 20:15:29 +0000</dc:date> +<svg xmlns="http://www.w3.org/2000/svg" xmlns:xl="http://www.w3.org/1999/xlink" version="1.1" viewBox="63 81 740 531" width="740pt" height="531pt" xmlns:dc="http://purl.org/dc/elements/1.1/"> + <metadata> Produced by OmniGraffle 7.4.1 + <dc:date>2017-08-08 22:08:48 +0000</dc:date> </metadata> <defs> <filter id="Shadow" filterUnits="userSpaceOnUse"> @@ -56,11 +56,21 @@ <path d="M -1.6 0 L 0 .6 L 0 -.6 Z" fill="currentColor" stroke="currentColor" stroke-width="1"/> </g> </marker> + <font-face font-family="Lucida Sans" font-size="10" panose-1="2 11 6 2 3 5 4 9 2 4" units-per-em="1000" underline-position="-97.65625" underline-thickness="48.828125" slope="-1125" x-height="541.9922" cap-height="740.7227" ascent="966.7969" descent="-210.9375" font-style="italic" font-weight="500"> + <font-face-src> + <font-face-name name="LucidaSans-Italic"/> + </font-face-src> + </font-face> <font-face font-family="Helvetica" font-size="10" units-per-em="1000" underline-position="-75.68359" underline-thickness="49.316406" slope="0" x-height="522.9492" cap-height="717.28516" ascent="770.0195" descent="-229.98047" font-weight="500"> <font-face-src> <font-face-name name="Helvetica"/> </font-face-src> </font-face> + <font-face font-family="Lucida Sans" font-size="10" panose-1="2 11 7 3 4 5 4 2 2 4" units-per-em="1000" underline-position="-97.65625" underline-thickness="48.828125" slope="0" x-height="548.33984" cap-height="740.7227" ascent="966.7969" descent="-210.9375" font-weight="bold"> + <font-face-src> + <font-face-name name="LucidaSans-Demi"/> + </font-face-src> + </font-face> <font-face font-family="Osaka" font-size="12" panose-1="2 11 6 0 0 0 0 0 0 0" units-per-em="1000" underline-position="0" underline-thickness="59.037876" slope="0" x-height="464.84375" cap-height="648.4375" ascent="855.4688" descent="-191.40625" font-weight="500"> <font-face-src> <font-face-name name="Osaka-Mono"/> @@ -85,14 +95,14 @@ <rect x="82.125" y="148.5" width="247.32675" height="182.87344" fill="#f0f0f0"/> <rect x="82.125" y="148.5" width="247.32675" height="182.87344" stroke="#a5a5a5" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/> <text transform="translate(87.125 148.5)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="79.13457" y="10" textLength="79.05762">traffic generator</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-weight="500" x="79.13457" y="10" textLength="79.05762">traffic generator</tspan> </text> </g> <g id="id48_Graphic"> - <rect x="479.25" y="167.625" width="176.625" height="151.875" fill="#f5f5eb"/> - <path d="M 479.25 167.625 L 655.875 167.625 L 655.875 319.5 L 479.25 319.5 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5" stroke-dasharray="4,4"/> - <text transform="translate(484.25 167.625)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="93.13867" y="10" textLength="73.48633">SERVICE CHAIN</tspan> + <rect x="476.66667" y="167.625" width="176.625" height="151.875" fill="#f5f5eb"/> + <path d="M 476.66667 167.625 L 653.2917 167.625 L 653.2917 319.5 L 476.66667 319.5 Z" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5" stroke-dasharray="4,4"/> + <text transform="translate(481.66667 167.625)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-weight="500" x="93.13867" y="10" textLength="73.48633">SERVICE CHAIN</tspan> </text> </g> <line x1="507.125" y1="260" x2="507.125" y2="186.20833" stroke="#929292" stroke-linecap="round" stroke-linejoin="round" stroke-width="5"/> @@ -107,13 +117,13 @@ <line x1="274.14287" y1="292.33777" x2="626.52315" y2="293.47495" marker-end="url(#Box_Marker)" marker-start="url(#Box_Marker_2)" stroke="#cec3fa" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/> <line x1="631.3333" y1="308.625" x2="630" y2="212.625" stroke="#cec3fa" stroke-linecap="round" stroke-linejoin="round" stroke-width="5"/> <line x1="273.76087" y1="205.73606" x2="502.52503" y2="206.58753" marker-end="url(#Ball_Marker)" marker-start="url(#Ball_Marker_2)" stroke="#929292" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/> - <line x1="546.0999" y1="228.59572" x2="511.7247" y2="228.97873" marker-end="url(#Ball_Marker)" stroke="#929292" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/> - <line x1="589.094" y1="243.43417" x2="625.8217" y2="243.0174" marker-end="url(#Box_Marker)" stroke="#cec3fa" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/> - <ellipse cx="567.4375" cy="236.73324" rx="21.812535" ry="27.48328" fill="#eaf2bf"/> - <ellipse cx="567.4375" cy="236.73324" rx="21.812535" ry="27.48328" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> - <text transform="translate(554.9875 225.73324)" fill="black"> - <tspan font-family="Gill Sans" font-size="10" font-weight="500" fill="black" x="7.498828" y="9" textLength="12.680664">L3 </tspan> - <tspan font-family="Gill Sans" font-size="10" font-weight="500" fill="black" x="3.1799805" y="20" textLength="18.54004">VNF</tspan> + <line x1="546.1047" y1="223.56943" x2="511.6805" y2="228.3918" marker-end="url(#Ball_Marker)" stroke="#929292" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/> + <line x1="588.7675" y1="235.58714" x2="625.8919" y2="242.1629" marker-end="url(#Box_Marker)" stroke="#cec3fa" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"/> + <ellipse cx="567.4375" cy="229.5" rx="21.812535" ry="20.250032" fill="#eaf2bf"/> + <ellipse cx="567.4375" cy="229.5" rx="21.812535" ry="20.250032" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> + <text transform="translate(554.9875 218.5)" fill="black"> + <tspan font-family="Gill Sans" font-size="10" font-weight="500" x="7.498828" y="9" textLength="12.680664">L3 </tspan> + <tspan font-family="Gill Sans" font-size="10" font-weight="500" x="3.1799805" y="20" textLength="18.54004">VNF</tspan> </text> <ellipse cx="244.20895" cy="205.40873" rx="24.458986" ry="12.852811" fill="#eaf2bf"/> <ellipse cx="244.20895" cy="205.40873" rx="24.458986" ry="12.852811" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> @@ -128,26 +138,25 @@ <tspan font-family="Futura" font-size="10" font-weight="600" x="4.747821" y="10" textLength="19.638672">gwB</tspan> </text> <path d="M 287.06743 305.7484 C 383.5292 303.84953 517.4412 309.08555 536.8379 307.16983 C 557.0879 305.16983 623.125 308.875 621.7917 272.875 C 620.4583 236.875 506.8675 259.29167 502.08333 252.625 C 497.29917 245.95833 494.08333 258.625 494.08333 229.95833 C 494.08333 201.29167 497.34544 216.1918 487.1968 204.85848 C 477.6795 194.23016 353.7978 198.7745 286.9911 197.26211" marker-end="url(#FilledArrow_Marker)" marker-start="url(#FilledArrow_Marker_2)" stroke="#d4c057" stroke-opacity=".493177" stroke-linecap="butt" stroke-linejoin="round" stroke-width="4"/> - <text transform="translate(545 483.125)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="10" textLength="67.59766">right public IP</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="22" textLength="34.785156">2.2.0.2</tspan> + <text transform="translate(453.875 345.875)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="10" textLength="67.944336">right public IP</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="22" textLength="34.785156">2.2.0.2</tspan> </text> - <line x1="588.27516" y1="244.87632" x2="579.6301" y2="478.125" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(323.25 364.375)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x=".13378906" y="10" textLength="95.73242">right virtual devices</tspan> + <text transform="translate(155.875 357.625)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x=".4501953" y="10" textLength="97.09961">right virtual devices</tspan> </text> - <line x1="155.375" y1="283.97184" x2="342.5177" y2="358.875" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> + <line x1="155.375" y1="283.97184" x2="197.7284" y2="352.125" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> <text transform="translate(677.75 127.625)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="10" textLength="63.291016">static routes:</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="22" textLength="120.07324">20.0.0.0/8 gw 2.2.0.102</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="34" textLength="120.07324">10.0.0.0/8 gw 1.1.0.102</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="10" textLength="63.53516">static routes:</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="22" textLength="119.90723">20.0.0.0/8 gw 2.2.0.102</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="34" textLength="119.90723">10.0.0.0/8 gw 1.1.0.102</tspan> </text> - <line x1="586.2303" y1="222.76824" x2="692.92584" y2="168.625" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(478.375 360.5)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x=".234375" y="10" textLength="99.53125">right virtual gateway</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="26.28418" y="22" textLength="47.43164">2.2.0.102</tspan> + <line x1="586.2303" y1="219.21042" x2="690.3907" y2="168.625" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> + <text transform="translate(272.375 361.625)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x=".057128906" y="10" textLength="102.88574">right virtual gateway</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="27.78418" y="22" textLength="47.43164">2.2.0.102</tspan> </text> - <line x1="269.5429" y1="292.32292" x2="473.49465" y2="355.5" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> + <line x1="269.5429" y1="292.32292" x2="312.51433" y2="356.625" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> <rect x="100.26389" y="269.51805" width="55.11111" height="42.857143" fill="white"/> <rect x="100.26389" y="269.51805" width="55.11111" height="42.857143" stroke="black" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> <rect x="96.81944" y="265.94663" width="55.11111" height="42.857143" fill="white"/> @@ -169,51 +178,62 @@ <tspan font-family="Helvetica" font-size="10" font-weight="500" x="5.6024306" y="22" textLength="33.90625">devices</tspan> </text> <text transform="translate(375.125 86)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="45.3125" y="10" textLength="34.375">’marin’</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x=".4296875" y="22" textLength="124.14062">service chain left network</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="36.313477" y="34" textLength="52.373047">1.1.0.0/24</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="44.68994" y="10" textLength="35.620117">’marin’</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x=".16601562" y="22" textLength="124.66797">service chain left network</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="36.37451" y="34" textLength="52.250977">1.1.0.0/24</tspan> </text> <line x1="507.125" y1="192.32936" x2="455.72204" y2="127" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(609.125 423.5)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="10" textLength="29.873047">‘napa’</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="22" textLength="131.42578">service chain right network</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="0" y="34" textLength="52.373047">2.2.0.0/24</tspan> + <text transform="translate(647.375 345.875)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="10" textLength="30.786133">‘napa’</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="22" textLength="132.61719">service chain right network</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="0" y="34" textLength="52.250977">2.2.0.0/24</tspan> </text> - <line x1="631.2763" y1="304.51667" x2="667.7626" y2="418.5" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(502 116.375)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x=".34375" y="10" textLength="60.3125">left public IP</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="13.107422" y="22" textLength="34.785156">1.1.0.2</tspan> + <line x1="631.2763" y1="304.51667" x2="681.8699" y2="340.875" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> + <text transform="translate(502.5 116.375)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x=".0024414062" y="10" textLength="59.99512">left public IP</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="12.607422" y="22" textLength="34.785156">1.1.0.2</tspan> </text> - <line x1="546.5302" y1="228.09501" x2="534.89194" y2="145.375" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(250 95)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x=".37695312" y="10" textLength="92.24609">left virtual gateway</tspan> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x="22.78418" y="22" textLength="47.43164">1.1.0.102</tspan> + <line x1="546.5265" y1="223.00546" x2="535.0198" y2="145.375" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> + <text transform="translate(249 95)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x=".03173828" y="10" textLength="94.93652">left virtual gateway</tspan> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x="23.78418" y="22" textLength="47.43164">1.1.0.102</tspan> </text> <line x1="271.58333" y1="206.31494" x2="292.23495" y2="124" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(116.25 95.5)" fill="black"> - <tspan font-family="Lucida Sans" font-size="10" font-weight="500" fill="black" x=".2763672" y="10" textLength="88.44727">left virtual devices</tspan> + <text transform="translate(115.75 95.5)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-style="italic" font-weight="500" x=".4248047" y="10" textLength="89.15039">left virtual devices</tspan> </text> <line x1="122.453" y1="178.7318" x2="155.04748" y2="113" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> - <text transform="translate(97.25 396.85107)" fill="black"> - <tspan font-family="Futura" font-size="10" font-weight="600" x="0" y="10" textLength="35.253906">nfvbenc</tspan> - <tspan font-family="Futura" font-size="10" font-weight="600" x="35.512695" y="10" textLength="30.13672">h confi</tspan> - <tspan font-family="Futura" font-size="10" font-weight="600" x="65.649414" y="10" textLength="14.379883">g fi</tspan> - <tspan font-family="Futura" font-size="10" font-weight="600" x="80.0293" y="10" textLength="11.108398">le:</tspan> + <text transform="translate(68 400.375)" fill="black"> + <tspan font-family="Lucida Sans" font-size="10" font-weight="bold" x="0" y="10" textLength="142.47559">nfvbench configuration file:</tspan> </text> <text transform="translate(91.625 425.75)" fill="black"> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="10" textLength="252">internal_network_name: [‘marin', ‘napa']</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="22" textLength="108">traffic_generator:</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="34" textLength="252"> ip_addrs: ['10.0.0.0/8', '20.0.0.0/8']</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="46" textLength="156"> ip_addrs_step: 0.0.0.1</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="58" textLength="318"> tg_gateway_ip_addrs: ['1.1.0.102’, '2.2.0.102’]</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="70" textLength="222"> tg_gateway_ip_addrs_step: 0.0.0.1</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="82" textLength="264"> gateway_ip_addrs: ['1.1.0.2', '2.2.0.2']</tspan> - <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="94" textLength="204"> gateway_ip_addrs_step: 0.0.0.1</tspan> - </text> - <path d="M 604.125 438.8336 C 558.9773 439.34514 343.50462 360.4248 324.713 418.4743" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> - <path d="M 540 497.4063 C 494.85924 497.91775 348.4386 576.5024 327.58433 519.6221" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> - <path d="M 503.41667 393.95833 C 483.9034 443.0562 422.1928 531.9741 383.3793 497.97585" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> - <path d="M 366.45733 381.875 C 362.811 420.01984 368.47553 438.26776 347.53805 447.0305" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="10" textLength="108">traffic_generator:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="22" textLength="252"> ip_addrs: ['10.0.0.0/8', '20.0.0.0/8']</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="34" textLength="318"> tg_gateway_ip_addrs: ['1.1.0.102’, '2.2.0.102’]</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="46" textLength="264"> gateway_ip_addrs: ['1.1.0.2', '2.2.0.2']</tspan> + </text> + <path d="M 702.8684 386.875 C 704.3708 431.30164 739.1638 481.572 644.4365 524.10205" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> + <path d="M 466.88135 374.875 C 421.04833 375.3943 419.39485 537.2865 349.49473 482.4735" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> + <path d="M 333.823 390.625 C 322.2158 416.3434 350.7126 419.0818 361.1498 434.07423" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> + <path d="M 219.74693 375.125 C 215.90936 415.2706 275.1279 389.9882 295.55615 427.5162" marker-end="url(#StickArrow_Marker)" stroke="#e86fd0" stroke-linecap="round" stroke-linejoin="round" stroke-width="1"/> + <text transform="translate(483.125 414.5)" fill="black"> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="10" textLength="108">internal_networks:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="22" textLength="54"> left:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="34" textLength="138"> name: ‘marin’</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="46" textLength="204"> subnet: 'nfvbench-subnet0'</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="58" textLength="162"> cidr: ‘1.1.0.0/24'</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="70" textLength="168"> network_type: 'vlan'</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="82" textLength="144"> segmentation_id:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="94" textLength="150"> physical_network:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="106" textLength="60"> right:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="118" textLength="132"> name: ‘napa’</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="130" textLength="204"> subnet: 'nfvbench-subnet1'</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="142" textLength="162"> cidr: ’2.2.0.0/24'</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="154" textLength="168"> network_type: 'vlan'</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="166" textLength="144"> segmentation_id:</tspan> + <tspan font-family="Osaka" font-size="12" font-weight="500" x="0" y="178" textLength="150"> physical_network:</tspan> + </text> + <path d="M 590 234 L 590 276 L 509.0796 340.875" stroke="#847b5a" stroke-linecap="round" stroke-linejoin="round" stroke-width="1" stroke-dasharray="4,4"/> </g> </g> </svg> diff --git a/docs/testing/user/userguide/sriov.rst b/docs/testing/user/userguide/sriov.rst index c63a6d7..2efb495 100644 --- a/docs/testing/user/userguide/sriov.rst +++ b/docs/testing/user/userguide/sriov.rst @@ -15,7 +15,8 @@ You will also need to know: - the name of the physical networks associated to your SR-IOV interfaces (this is a configuration in Nova compute) - the VLAN range that can be used on the switch ports that are wired to the SR-IOV ports. Such switch ports are normally configured in trunk mode with a range of VLAN ids enabled on that port -For example, in the case of 2 SR-IOV ports per compute node, 2 physical networks are generally configured in OpenStack with a distinct name. The VLAN range to use is is also allocated and reserved by the network administrator and in coordination with the corresponding top of rack switch port configuration. +For example, in the case of 2 SR-IOV ports per compute node, 2 physical networks are generally configured in OpenStack with a distinct name. +The VLAN range to use is is also allocated and reserved by the network administrator and in coordination with the corresponding top of rack switch port configuration. Configuration @@ -24,7 +25,7 @@ To enable SR-IOV test, you will need to provide the following configuration opti This example instructs NFVbench to create the left and right networks of a PVP packet flow to run on 2 SRIOV ports named "phys_sriov0" and "phys_sriov1" using resp. segmentation_id 2000 and 2001: .. code-block:: bash - + internal_networks: left: segmentation_id: 2000 @@ -56,5 +57,7 @@ If the 2 selected ports reside on NICs that are on different NUMA sockets, you w "hw:mem_page_size": large "hw:numa_nodes": 2 -Failure to do so might cause the VM creation to fail with the Nova error "Instance creation error: Insufficient compute resources: Requested instance NUMA topology together with requested PCI devices cannot fit the given host NUMA topology." +Failure to do so might cause the VM creation to fail with the Nova error +"Instance creation error: Insufficient compute resources: +Requested instance NUMA topology together with requested PCI devices cannot fit the given host NUMA topology." |