performa/shaker
Code Issues Proposed changes

Update docs with scenario definition details

Browse Source 
Change-Id: I859af0deeb6d699ec2e79aeb35dacc278f3b53cd
This commit is contained in:
Ilya Shakhat 2015-05-28 19:28:01 +03:00
parent e2e6483177
commit 1e67f6ea2b
9 changed files with 588 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

527
doc/source/images/simultaneous.svg Normal file
View File

@ -0,0 +1,527 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="210mm"
height="148mm"
viewBox="0 0 744.09449 524.40944"
id="svg2"
version="1.1"
inkscape:version="0.91 r13725"
sodipodi:docname="simultaneous.svg"
inkscape:export-filename="/home/ishakhat/Work/shaker/doc/source/images/simultaneous.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90">
<defs
id="defs4">
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0.0"
refX="0.0"
id="marker5017"
style="overflow:visible;"
inkscape:isstock="true">
<path
id="path5019"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#2ca089;stroke-width:1pt;stroke-opacity:1;fill:#2ca089;fill-opacity:1"
transform="scale(0.4) rotate(180) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0.0"
refX="0.0"
id="marker5013"
style="overflow:visible;"
inkscape:isstock="true">
<path
id="path5015"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#2ca089;stroke-width:1pt;stroke-opacity:1;fill:#2ca089;fill-opacity:1"
transform="scale(0.4) rotate(180) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0.0"
refX="0.0"
id="marker5007"
style="overflow:visible;"
inkscape:isstock="true">
<path
id="path5009"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#2ca089;stroke-width:1pt;stroke-opacity:1;fill:#2ca089;fill-opacity:1"
transform="scale(0.4) rotate(180) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Mstart"
orient="auto"
refY="0.0"
refX="0.0"
id="marker4999"
style="overflow:visible"
inkscape:isstock="true">
<path
id="path5001"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#ff6600;stroke-width:1pt;stroke-opacity:1;fill:#ff6600;fill-opacity:1"
transform="scale(0.4) translate(10,0)" />
</marker>
<marker
inkscape:isstock="true"
style="overflow:visible;"
id="marker4987"
refX="0.0"
refY="0.0"
orient="auto"
inkscape:stockid="Arrow1Mend">
<path
transform="scale(0.4) rotate(180) translate(10,0)"
style="fill-rule:evenodd;stroke:#dd34bc;stroke-width:1pt;stroke-opacity:1;fill:#dd34bc;fill-opacity:1"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
id="path4989" />
</marker>
<marker
inkscape:isstock="true"
style="overflow:visible"
id="marker4983"
refX="0.0"
refY="0.0"
orient="auto"
inkscape:stockid="Arrow1Mstart">
<path
transform="scale(0.4) translate(10,0)"
style="fill-rule:evenodd;stroke:#dd34bc;stroke-width:1pt;stroke-opacity:1;fill:#dd34bc;fill-opacity:1"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
id="path4985" />
</marker>
<marker
inkscape:stockid="Arrow1Mstart"
orient="auto"
refY="0.0"
refX="0.0"
id="marker4973"
style="overflow:visible"
inkscape:isstock="true"
inkscape:collect="always">
<path
id="path4975"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#dd34bc;stroke-width:1pt;stroke-opacity:1;fill:#dd34bc;fill-opacity:1"
transform="scale(0.4) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0.0"
refX="0.0"
id="marker4969"
style="overflow:visible;"
inkscape:isstock="true"
inkscape:collect="always">
<path
id="path4971"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#dd34bc;stroke-width:1pt;stroke-opacity:1;fill:#dd34bc;fill-opacity:1"
transform="scale(0.4) rotate(180) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0.0"
refX="0.0"
id="marker4959"
style="overflow:visible;"
inkscape:isstock="true">
<path
id="path4961"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#009bc0;stroke-width:1pt;stroke-opacity:1;fill:#009bc0;fill-opacity:1"
transform="scale(0.4) rotate(180) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Mstart"
orient="auto"
refY="0.0"
refX="0.0"
id="Arrow1Mstart"
style="overflow:visible"
inkscape:isstock="true">
<path
id="path4662"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#37abc8;stroke-width:1pt;stroke-opacity:1;fill:#37abc8;fill-opacity:1"
transform="scale(0.4) translate(10,0)" />
</marker>
<marker
inkscape:isstock="true"
style="overflow:visible;"
id="marker4918"
refX="0.0"
refY="0.0"
orient="auto"
inkscape:stockid="Arrow1Mend">
<path
transform="scale(0.4) rotate(180) translate(10,0)"
style="fill-rule:evenodd;stroke:#ff6600;stroke-width:1pt;stroke-opacity:1;fill:#ff6600;fill-opacity:1"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
id="path4920" />
</marker>
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0.0"
refX="0.0"
id="Arrow1Mend"
style="overflow:visible;"
inkscape:isstock="true"
inkscape:collect="always">
<path
id="path4665"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#37abc8;stroke-width:1pt;stroke-opacity:1;fill:#37abc8;fill-opacity:1"
transform="scale(0.4) rotate(180) translate(10,0)" />
</marker>
<marker
inkscape:stockid="Arrow1Lend"
orient="auto"
refY="0.0"
refX="0.0"
id="Arrow1Lend"
style="overflow:visible;"
inkscape:isstock="true">
<path
id="path4659"
d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1;fill:#000000;fill-opacity:1"
transform="scale(0.8) rotate(180) translate(12.5,0)" />
</marker>
<marker
inkscape:isstock="true"
style="overflow:visible"
id="marker4612"
refX="0"
refY="0"
orient="auto"
inkscape:stockid="Arrow1Mend">
<path
inkscape:connector-curvature="0"
transform="matrix(-0.4,0,0,-0.4,-4,0)"
style="fill:#37c8ab;fill-opacity:1;fill-rule:evenodd;stroke:#37c8ab;stroke-width:1pt;stroke-opacity:1"
d="M 0,0 5,-5 -12.5,0 5,5 0,0 Z"
id="path4614" />
</marker>
<marker
inkscape:isstock="true"
style="overflow:visible"
id="marker4589"
refX="0"
refY="0"
orient="auto"
inkscape:stockid="Arrow1Mend">
<path
inkscape:connector-curvature="0"
transform="matrix(-0.4,0,0,-0.4,-4,0)"
style="fill:#ff7f2a;fill-opacity:1;fill-rule:evenodd;stroke:#ff7f2a;stroke-width:1pt;stroke-opacity:1"
d="M 0,0 5,-5 -12.5,0 5,5 0,0 Z"
id="path4591" />
</marker>
<marker
inkscape:stockid="Arrow1Mend"
orient="auto"
refY="0"
refX="0"
id="marker4585"
style="overflow:visible"
inkscape:isstock="true">
<path
inkscape:connector-curvature="0"
id="path4587"
d="M 0,0 5,-5 -12.5,0 5,5 0,0 Z"
style="fill:#ff7f2a;fill-opacity:1;fill-rule:evenodd;stroke:#ff7f2a;stroke-width:1pt;stroke-opacity:1"
transform="matrix(-0.4,0,0,-0.4,-4,0)" />
</marker>
</defs>
<sodipodi:namedview
id="base"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
inkscape:zoom="0.98994949"
inkscape:cx="475.10012"
inkscape:cy="352.74428"
inkscape:document-units="px"
inkscape:current-layer="layer1"
showgrid="false"
showguides="true"
inkscape:guide-bbox="true"
inkscape:window-width="1855"
inkscape:window-height="1056"
inkscape:window-x="65"
inkscape:window-y="24"
inkscape:window-maximized="1"
inkscape:snap-global="true" />
<metadata
id="metadata7">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:label="Layer 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(0,-527.95276)">
<text
xml:space="preserve"
style="font-style:normal;font-weight:normal;font-size:11.25px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
x="228.77196"
y="233.99899"
id="text4280"
sodipodi:linespacing="125%"><tspan
sodipodi:role="line"
id="tspan4282"
x="228.77196"
y="233.99899" /></text>
<rect
style="fill:none;stroke:#e6e6e6;stroke-width:2.477391;stroke-miterlimit:4;stroke-dasharray:none"
id="rect4693"
width="689.41901"
height="345.99469"
x="26.422159"
y="599.63434"
rx="6.4777622"
ry="5.9216704" />
<path
style="fill:none;fill-opacity:0.59215686;fill-rule:evenodd;stroke:#dd34bc;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-start:url(#marker4973);marker-end:url(#marker4969)"
d="m 270.16898,654.77786 247.85714,0"
id="path4928"
inkscape:connector-curvature="0"
sodipodi:nodetypes="cc" />
<path
sodipodi:nodetypes="cc"
inkscape:connector-curvature="0"
id="path4977"
d="m 270.88326,774.77786 246.42857,0"
style="fill:none;fill-opacity:0.59215686;fill-rule:evenodd;stroke:#dd34bc;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-start:url(#marker4983);marker-end:url(#marker4987)" />
<text
transform="scale(0.97958908,1.0208362)"
xml:space="preserve"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
x="172.48006"
y="909.75385"
id="text5232"
sodipodi:linespacing="125%"><tspan
style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:sans-serif;-inkscape-font-specification:'sans-serif Italic';text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1"
id="tspan5236"
sodipodi:role="line"
x="172.48006"
y="909.75385">poll task</tspan></text>
<path
style="fill:none;fill-rule:evenodd;stroke:#37abc8;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#Arrow1Mend)"
d="m 131.24831,646.57306 -81.142863,0.41907 0,263.42515 244.289833,0"
id="path4650"
inkscape:connector-curvature="0"
sodipodi:nodetypes="cccc" />
<path
inkscape:connector-curvature="0"
id="path4916"
d="m 130.3504,671.7073 -57.42858,-0.2866 0,205.99917 222.1261,0"
style="fill:none;fill-rule:evenodd;stroke:#37abc8;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-start:url(#Arrow1Mstart)"
sodipodi:nodetypes="cccc" />
<text
sodipodi:linespacing="125%"
id="text4924"
y="844.68115"
x="189.25092"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
xml:space="preserve"
transform="scale(0.97958908,1.0208362)"><tspan
y="844.68115"
x="189.25092"
sodipodi:role="line"
style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:sans-serif;-inkscape-font-specification:'sans-serif Italic';text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1"
id="tspan4963">schedule task at time X</tspan></text>
<rect
style="fill:#37abc8;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
id="rect3342"
width="140"
height="83.808189"
x="131.65811"
y="614.53381"
rx="8.4507885"
ry="7.8269691" />
<text
sodipodi:linespacing="125%"
id="text3350"
y="626.37268"
x="205.87675"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
xml:space="preserve"
transform="scale(0.97958908,1.0208362)"><tspan
y="626.37268"
x="205.87675"
id="tspan3352"
sodipodi:role="line"
style="text-align:center;text-anchor:middle;fill:#ffffff" /><tspan
y="647.93671"
x="205.87675"
sodipodi:role="line"
id="tspan4695"
style="text-align:center;text-anchor:middle;fill:#ffffff">master_1</tspan></text>
<rect
style="fill:#2ca089;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
id="rect3410"
width="140"
height="83.808189"
x="131.65811"
y="728.10522"
rx="8.4507885"
ry="7.8269691" />
<text
xml:space="preserve"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
x="165.6969"
y="758.66028"
id="text3412"
sodipodi:linespacing="125%"
transform="scale(0.97958908,1.0208362)"><tspan
sodipodi:role="line"
id="tspan3414"
x="165.6969"
y="758.66028">master_2</tspan></text>
<rect
style="fill:#dd34bc;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
id="rect3422"
width="140"
height="83.808189"
x="519.15784"
y="614.53381"
rx="8.4507885"
ry="7.8269691" />
<text
xml:space="preserve"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
x="569.36975"
y="647.55859"
id="text3424"
sodipodi:linespacing="125%"
transform="scale(0.97958908,1.0208362)"><tspan
sodipodi:role="line"
id="tspan3426"
x="569.36975"
y="647.55859">slave_1</tspan></text>
<rect
ry="7.8269691"
rx="8.4507885"
y="728.10522"
x="519.15784"
height="83.808189"
width="140"
id="rect3434"
style="fill:#dd34bc;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
<text
sodipodi:linespacing="125%"
id="text3436"
y="758.81189"
x="569.43719"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
xml:space="preserve"
transform="scale(0.97958908,1.0208362)"><tspan
y="758.81189"
x="569.43719"
id="tspan3438"
sodipodi:role="line">slave_2</tspan></text>
<text
sodipodi:linespacing="125%"
id="text4965"
y="662.61755"
x="415.14746"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
xml:space="preserve"
transform="scale(0.97958908,1.0208362)"><tspan
y="662.61755"
x="415.14746"
sodipodi:role="line"
id="tspan4967"
style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:sans-serif;-inkscape-font-specification:'sans-serif Italic';text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1">iperf/netperf traffic</tspan></text>
<text
transform="scale(0.97958908,1.0208362)"
xml:space="preserve"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
x="414.4183"
y="780.16821"
id="text4979"
sodipodi:linespacing="125%"><tspan
style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:sans-serif;-inkscape-font-specification:'sans-serif Italic';text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1"
id="tspan4981"
sodipodi:role="line"
x="414.4183"
y="780.16821">iperf/netperf traffic</tspan></text>
<path
style="fill:none;fill-rule:evenodd;stroke:#2ca089;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker5007)"
d="m 130.45469,752.70642 -72.22408,0 0,149.80565 236.15265,0"
id="path5005"
inkscape:connector-curvature="0"
sodipodi:nodetypes="cccc" />
<path
style="fill:none;fill-rule:evenodd;stroke:#2ca089;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker5013)"
d="m 294.02612,869.56356 -213.35679,0 0,-91.42857 51.92822,0"
id="path5011"
inkscape:connector-curvature="0"
sodipodi:nodetypes="cccc" />
<rect
ry="7.8269691"
rx="9.0544157"
y="844.6189"
x="296.13165"
height="83.808189"
width="150"
id="rect4274"
style="fill:#ff6600;fill-rule:evenodd;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
<text
sodipodi:linespacing="125%"
id="text4276"
y="874.10754"
x="378.45187"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
xml:space="preserve"
transform="scale(0.97958908,1.0208362)"><tspan
y="874.10754"
x="378.45187"
id="tspan4278"
sodipodi:role="line"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-family:sans-serif;-inkscape-font-specification:'sans-serif Bold';text-align:center;text-anchor:middle">shaker</tspan></text>
<text
sodipodi:linespacing="125%"
id="text4215"
y="572.00867"
x="394.21512"
style="font-style:normal;font-weight:normal;font-size:17.25123024px;line-height:125%;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
xml:space="preserve"
transform="scale(0.97958908,1.0208362)"><tspan
y="572.00867"
x="394.21512"
sodipodi:role="line"
id="tspan4217"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:22.5px;font-family:sans-serif;-inkscape-font-specification:sans-serif;text-align:center;text-anchor:middle;fill:#000000" /></text>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 21 KiB

14
doc/source/index.rst
View File

@ -4,14 +4,14 @@ Welcome to Shaker!
The distributed data-plane testing tool for OpenStack.
.. toctree::
:maxdepth: 2
:maxdepth: 2
installation
usage
examples
tools
architecture
contributing
installation
usage
tools
examples
architecture
contributing
.. Indices and tables
.. ==================

4
doc/source/tools/shaker-agent.txt
View File

@ -51,14 +51,14 @@ optional arguments:
--syslog-log-facility SYSLOG_LOG_FACILITY
Syslog facility to receive log lines.
--use-syslog Use syslog for logging. Existing syslog format is
DEPRECATED during I, and will change in J to honor
DEPRECATED during I, and changed in J to honor
RFC5424.
--use-syslog-rfc-format
(Optional) Enables or disables syslog rfc5424 format
for logging. If enabled, prefixes the MSG part of the
syslog message with APP-NAME (RFC5424). The format
without the APP-NAME is deprecated in K, and will be
removed in L, along with this option.
removed in M, along with this option.
--verbose, -v Print more verbose output (set logging level to INFO
instead of default WARNING level).
--version show program's version number and exit

4
doc/source/tools/shaker-cleanup.txt
View File

@ -76,14 +76,14 @@ optional arguments:
--syslog-log-facility SYSLOG_LOG_FACILITY
Syslog facility to receive log lines.
--use-syslog Use syslog for logging. Existing syslog format is
DEPRECATED during I, and will change in J to honor
DEPRECATED during I, and changed in J to honor
RFC5424.
--use-syslog-rfc-format
(Optional) Enables or disables syslog rfc5424 format
for logging. If enabled, prefixes the MSG part of the
syslog message with APP-NAME (RFC5424). The format
without the APP-NAME is deprecated in K, and will be
removed in L, along with this option.
removed in M, along with this option.
--verbose, -v Print more verbose output (set logging level to INFO
instead of default WARNING level).
--version show program's version number and exit

4
doc/source/tools/shaker-image-builder.txt
View File

@ -78,14 +78,14 @@ optional arguments:
--syslog-log-facility SYSLOG_LOG_FACILITY
Syslog facility to receive log lines.
--use-syslog Use syslog for logging. Existing syslog format is
DEPRECATED during I, and will change in J to honor
DEPRECATED during I, and changed in J to honor
RFC5424.
--use-syslog-rfc-format
(Optional) Enables or disables syslog rfc5424 format
for logging. If enabled, prefixes the MSG part of the
syslog message with APP-NAME (RFC5424). The format
without the APP-NAME is deprecated in K, and will be
removed in L, along with this option.
removed in M, along with this option.
--verbose, -v Print more verbose output (set logging level to INFO
instead of default WARNING level).
--version show program's version number and exit

4
doc/source/tools/shaker-report.txt
View File

@ -53,14 +53,14 @@ optional arguments:
--syslog-log-facility SYSLOG_LOG_FACILITY
Syslog facility to receive log lines.
--use-syslog Use syslog for logging. Existing syslog format is
DEPRECATED during I, and will change in J to honor
DEPRECATED during I, and changed in J to honor
RFC5424.
--use-syslog-rfc-format
(Optional) Enables or disables syslog rfc5424 format
for logging. If enabled, prefixes the MSG part of the
syslog message with APP-NAME (RFC5424). The format
without the APP-NAME is deprecated in K, and will be
removed in L, along with this option.
removed in M, along with this option.
--verbose, -v Print more verbose output (set logging level to INFO
instead of default WARNING level).
--version show program's version number and exit

4
doc/source/tools/shaker.txt
View File

@ -97,14 +97,14 @@ optional arguments:
--syslog-log-facility SYSLOG_LOG_FACILITY
Syslog facility to receive log lines.
--use-syslog Use syslog for logging. Existing syslog format is
DEPRECATED during I, and will change in J to honor
DEPRECATED during I, and changed in J to honor
RFC5424.
--use-syslog-rfc-format
(Optional) Enables or disables syslog rfc5424 format
for logging. If enabled, prefixes the MSG part of the
syslog message with APP-NAME (RFC5424). The format
without the APP-NAME is deprecated in K, and will be
removed in L, along with this option.
removed in M, along with this option.
--verbose, -v Print more verbose output (set logging level to INFO
instead of default WARNING level).
--version show program's version number and exit

42
doc/source/usage.rst
View File

@ -31,7 +31,7 @@ are deployed at OpenStack instances a reference to Heat template is provided.
accommodation: [pair, single_room]
execution:
size: quadratic_progression
progression: quadratic
tests:
-
title: Iperf TCP
@ -65,19 +65,49 @@ Execution
^^^^^^^^^
The execution part of scenario contains a list of tests that are executed one by one. By default Shaker runs the test
simultaneously on all available agents. The level of concurrency can be controlled by option ``size``. There are
simultaneously on all available agents. The level of concurrency can be controlled by option ``progression``. There are
3 values available:
* ``size`` is not specified - all agents are involved;
* ``size: linear_progression`` - the execution starts with 1 agent and increases by 1 until all agents are involved;
* ``size: quadratic_progression`` - the execution starts with 1 agent (or 1 pair) and doubles until all agents are involved.
* no value specified - all agents are involved;
* ``linear`` - the execution starts with 1 agent and increases by 1 until all agents are involved;
* ``quadratic`` - the execution starts with 1 agent (or 1 pair) and doubles until all agents are involved.
Tests are executed in order of definition. The exact action is defined by option ``class``, additional attributes are provided
by respective parameters. The following classes are available:
* ``iperf_graph`` - runs ``iperf`` tool and shows chart and statistics
* ``netperf_wrapper`` - runs ``netperf-wrapper`` and shows chart and statistics
* ``flent`` - runs ``flent`` (http://flent.org) and shows chart and statistics
* ``iperf`` - runs ``iperf`` tool and shows plain output
* ``netperf`` - runs ``netpers`` tool and shows plain output
* ``shell`` - runs any shell command or process and shows plain output
Test classes
^^^^^^^^^^^^
Tools are configured via key-value attributes in test definition. For all networking tools Shaker offers unified parameters, that are translated
automatically.
iperf_graph, iperf:
~~~~~~~~~~~~~~~~~~~
* ``time`` - time in seconds to transmit for, defaults to `60`
* ``udp`` - use UDP instead of TCP, defaults to `TCP`
* ``interval`` - seconds between periodic bandwidth reports, defaults to `1 s`
* ``bandwidth`` - for UDP, bandwidth to send at in bits/sec, defaults to `1 Mbit/s`
* ``threads`` - number of parallel client threads to run
flent:
~~~~~~
* ``time`` - time in seconds to transmit for, defaults to `60`
* ``interval`` - seconds between periodic bandwidth reports, defaults to `1`
* ``method`` - which flent scenario to use, see https://github.com/tohojo/flent/tree/master/flent/tests for the whole list, defaults to `tcp_download`
netperf:
~~~~~~~~
* ``time`` - time in seconds to transmit for, defaults to `60`
* ``method`` - one of built-in test names, see http://linux.die.net/man/1/netperf for the whole list, defaults to `TCP_STREAM`
shell:
~~~~~~
* ``program`` - run single program
* ``script`` - run bash script

11
etc/shaker.conf
View File

@ -39,13 +39,15 @@
#log_dir = <None>
# Use syslog for logging. Existing syslog format is DEPRECATED during I, and
# will change in J to honor RFC5424. (boolean value)
# changed in J to honor RFC5424. (boolean value)
#use_syslog = false
# (Optional) Enables or disables syslog rfc5424 format for logging. If enabled,
# prefixes the MSG part of the syslog message with APP-NAME (RFC5424). The
# format without the APP-NAME is deprecated in K, and will be removed in L,
# format without the APP-NAME is deprecated in K, and will be removed in M,
# along with this option. (boolean value)
# This option is deprecated for removal.
# Its value may be silently ignored in the future.
#use_syslog_rfc_format = true
# Syslog facility to receive log lines. (string value)
@ -64,7 +66,7 @@
#logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d
# Prefix each line of exception output with this format. (string value)
#logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d TRACE %(name)s %(instance)s
#logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s
# List of logger=LEVEL pairs. (list value)
#default_log_levels = amqp=WARN,amqplib=WARN,boto=WARN,qpid=WARN,sqlalchemy=WARN,suds=INFO,oslo.messaging=INFO,iso8601=WARN,requests.packages.urllib3.connectionpool=WARN,urllib3.connectionpool=WARN,websocket=WARN,requests.packages.urllib3.util.retry=WARN,urllib3.util.retry=WARN,keystonemiddleware=WARN,routes.middleware=WARN,stevedore=WARN
@ -83,6 +85,9 @@
# value)
#instance_uuid_format = "[instance: %(uuid)s] "
# Enables or disables fatal status of deprecations. (boolean value)
#fatal_deprecations = false
#
# From shaker.engine.config
#