You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ke...@apache.org on 2012/06/29 17:19:55 UTC
[2/4] adding runbook and publican-cloudstack to docs
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/image_left.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/image_left.svg b/docs/publican-cloudstack/en-US/images/image_left.svg
new file mode 100644
index 0000000..99ce61c
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/image_left.svg
@@ -0,0 +1,331 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: Adobe Illustrator 14.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 43363) -->
+
+<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:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ version="1.1"
+ id="Layer_1"
+ x="0px"
+ y="0px"
+ width="500"
+ height="88"
+ viewBox="0 0 500 88"
+ enable-background="new 0 0 543 197"
+ xml:space="preserve"
+ inkscape:version="0.48.1 r9760"
+ sodipodi:docname="cloudstack_logo_rgb_FINAL.svg"><metadata
+ id="metadata3261"><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><defs
+ id="defs3259" /><sodipodi:namedview
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1"
+ objecttolerance="10"
+ gridtolerance="10"
+ guidetolerance="10"
+ inkscape:pageopacity="0"
+ inkscape:pageshadow="2"
+ inkscape:window-width="1280"
+ inkscape:window-height="753"
+ id="namedview3257"
+ showgrid="false"
+ inkscape:zoom="0.94290976"
+ inkscape:cx="135.75"
+ inkscape:cy="98.5"
+ inkscape:window-x="-3"
+ inkscape:window-y="-3"
+ inkscape:window-maximized="1"
+ inkscape:current-layer="Layer_1" />
+<pattern
+ x="-123.5"
+ y="403.5"
+ width="322"
+ height="182"
+ patternUnits="userSpaceOnUse"
+ id="Unnamed_Pattern"
+ viewBox="0 -182 322 182"
+ overflow="visible">
+ <g
+ id="g3165">
+ <polygon
+ fill="none"
+ points="0,-182 322,-182 322,0 0,0 "
+ id="polygon3167" />
+
+ <linearGradient
+ id="SVGID_1_"
+ gradientUnits="userSpaceOnUse"
+ x1="7745.8442"
+ y1="-8448.6895"
+ x2="7746.8442"
+ y2="-8448.6895"
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)">
+ <stop
+ offset="0"
+ style="stop-color:#ABABAB"
+ id="stop3170" />
+ <stop
+ offset="1"
+ style="stop-color:#787878"
+ id="stop3172" />
+ </linearGradient>
+ <polygon
+ fill="url(#SVGID_1_)"
+ points="322,0 322,-182 0,-182 0,0 "
+ id="polygon3174" />
+ </g>
+</pattern>
+<pattern
+ x="-123.5"
+ y="403.5"
+ width="322"
+ height="182"
+ patternUnits="userSpaceOnUse"
+ id="Unnamed_Pattern_1"
+ viewBox="0 -182 322 182"
+ overflow="visible">
+ <g
+ id="g3177">
+ <polygon
+ fill="none"
+ points="0,-182 322,-182 322,0 0,0 "
+ id="polygon3179" />
+
+ <linearGradient
+ id="SVGID_2_"
+ gradientUnits="userSpaceOnUse"
+ x1="7745.8442"
+ y1="-8448.6895"
+ x2="7746.8442"
+ y2="-8448.6895"
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)">
+ <stop
+ offset="0"
+ style="stop-color:#ABABAB"
+ id="stop3182" />
+ <stop
+ offset="1"
+ style="stop-color:#787878"
+ id="stop3184" />
+ </linearGradient>
+ <polygon
+ fill="url(#SVGID_2_)"
+ points="322,0 322,-182 0,-182 0,0 "
+ id="polygon3186" />
+ </g>
+</pattern>
+<pattern
+ x="-123.5"
+ y="403.5"
+ width="322"
+ height="182"
+ patternUnits="userSpaceOnUse"
+ id="Unnamed_Pattern_2"
+ viewBox="0 -182 322 182"
+ overflow="visible">
+ <g
+ id="g3189">
+ <polygon
+ fill="none"
+ points="0,-182 322,-182 322,0 0,0 "
+ id="polygon3191" />
+
+ <linearGradient
+ id="SVGID_3_"
+ gradientUnits="userSpaceOnUse"
+ x1="7745.8442"
+ y1="-8448.6895"
+ x2="7746.8442"
+ y2="-8448.6895"
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)">
+ <stop
+ offset="0"
+ style="stop-color:#ABABAB"
+ id="stop3194" />
+ <stop
+ offset="1"
+ style="stop-color:#787878"
+ id="stop3196" />
+ </linearGradient>
+ <polygon
+ fill="url(#SVGID_3_)"
+ points="322,0 322,-182 0,-182 0,0 "
+ id="polygon3198" />
+ </g>
+</pattern>
+<pattern
+ x="-123.5"
+ y="403.5"
+ width="322"
+ height="182"
+ patternUnits="userSpaceOnUse"
+ id="Unnamed_Pattern_3"
+ viewBox="0 -182 322 182"
+ overflow="visible">
+ <g
+ id="g3201">
+ <polygon
+ fill="none"
+ points="0,-182 322,-182 322,0 0,0 "
+ id="polygon3203" />
+
+ <linearGradient
+ id="SVGID_4_"
+ gradientUnits="userSpaceOnUse"
+ x1="7745.8442"
+ y1="-8448.6895"
+ x2="7746.8442"
+ y2="-8448.6895"
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)">
+ <stop
+ offset="0"
+ style="stop-color:#ABABAB"
+ id="stop3206" />
+ <stop
+ offset="1"
+ style="stop-color:#787878"
+ id="stop3208" />
+ </linearGradient>
+ <polygon
+ fill="url(#SVGID_4_)"
+ points="322,0 322,-182 0,-182 0,0 "
+ id="polygon3210" />
+ </g>
+</pattern>
+<pattern
+ x="-123.5"
+ y="403.5"
+ width="322"
+ height="182"
+ patternUnits="userSpaceOnUse"
+ id="Unnamed_Pattern_4"
+ viewBox="0 -182 322 182"
+ overflow="visible">
+ <g
+ id="g3213">
+ <polygon
+ fill="none"
+ points="0,-182 322,-182 322,0 0,0 "
+ id="polygon3215" />
+
+ <linearGradient
+ id="SVGID_5_"
+ gradientUnits="userSpaceOnUse"
+ x1="7745.8442"
+ y1="-8448.6895"
+ x2="7746.8442"
+ y2="-8448.6895"
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)">
+ <stop
+ offset="0"
+ style="stop-color:#ABABAB"
+ id="stop3218" />
+ <stop
+ offset="1"
+ style="stop-color:#787878"
+ id="stop3220" />
+ </linearGradient>
+ <polygon
+ fill="url(#SVGID_5_)"
+ points="322,0 322,-182 0,-182 0,0 "
+ id="polygon3222" />
+ </g>
+</pattern>
+<g
+ id="g3224"
+ transform="translate(-23.332031,-40.064453)">
+ <path
+ d="m 53.199,124.06 c -14.587,0 -25.282,-12.24 -25.282,-27.35 v -0.195 c 0,-15.11 10.603,-27.549 25.463,-27.549 9.151,0 14.863,3.362 19.389,8.885 l -8.424,9.873 C 61.26,84.172 58.178,81.898 53.288,81.898 46.4,81.898 41.509,88.513 41.509,96.32 v 0.195 c 0,8.097 4.802,14.606 12.324,14.606 4.618,0 7.791,-2.161 11.145,-5.624 l 8.061,8.893 c -4.715,5.619 -10.147,9.67 -19.84,9.67"
+ id="path3226"
+ inkscape:connector-curvature="0"
+ style="fill:#69afd8" />
+ <path
+ d="m 123.247,123.876 c -15.037,0 -26.184,-12.149 -26.184,-27.35 V 96.33 c 0,-15.202 11.235,-27.549 26.368,-27.549 15.035,0 26.188,12.144 26.188,27.354 v 0.195 c -0.001,15.198 -11.248,27.546 -26.372,27.546 M 136.025,96.33 c 0,-7.802 -5.169,-14.616 -12.779,-14.616 -7.884,0 -12.586,6.615 -12.586,14.421 v 0.195 c 0,7.799 5.16,14.604 12.77,14.604 7.88,0 12.595,-6.604 12.595,-14.408 V 96.33 z"
+ id="path3228"
+ inkscape:connector-curvature="0"
+ style="fill:#69afd8" />
+ <path
+ d="m 185.459,123.946 v -7.498 c -3.169,4.435 -7.253,8.488 -14.219,8.488 -10.43,0 -16.496,-7.5 -16.496,-19.646 V 71.026 h 13.776 v 29.524 c 0,7.113 3.081,10.757 8.337,10.757 5.248,0 8.602,-3.645 8.602,-10.757 V 71.026 h 13.769 v 52.92 h -13.769 z"
+ id="path3230"
+ inkscape:connector-curvature="0"
+ style="fill:#69afd8" />
+ <path
+ d="m 242.488,123.792 v -7.604 c -3.346,4.945 -7.968,8.594 -15.133,8.594 -11.321,0 -22.106,-9.674 -22.106,-27.346 v -0.195 c 0,-17.676 10.601,-27.354 22.106,-27.354 7.342,0 11.868,3.652 15.133,7.901 V 51.724 h 13.769 v 72.068 h -13.769 z m 0.178,-26.551 c 0,-8.787 -5.344,-14.613 -11.771,-14.613 -6.435,0 -11.868,5.719 -11.868,14.613 v 0.195 c 0,8.785 5.433,14.606 11.868,14.606 6.427,0 11.771,-5.821 11.771,-14.606 v -0.195 z"
+ id="path3232"
+ inkscape:connector-curvature="0"
+ style="fill:#69afd8" />
+ <rect
+ x="77.877998"
+ y="48.307999"
+ width="14.72"
+ height="76.083"
+ id="rect3234"
+ style="fill:#69afd8" />
+ <pattern
+ id="SVGID_6_"
+ xlink:href="#Unnamed_Pattern"
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)">
+ </pattern>
+ <path
+ d="m 294.264,86.414 c -2.354,-2.924 -5.457,-4.387 -9.31,-4.387 -1.356,0 -2.675,0.321 -3.959,0.963 -1.284,0.642 -1.926,1.749 -1.926,3.317 0,1.284 0.657,2.231 1.979,2.836 1.318,0.606 2.995,1.142 5.028,1.604 2.033,0.465 4.208,0.964 6.526,1.499 2.318,0.535 4.495,1.374 6.527,2.514 2.033,1.142 3.709,2.694 5.029,4.654 1.319,1.963 1.98,4.585 1.98,7.865 0,3.354 -0.732,6.117 -2.194,8.293 -1.463,2.176 -3.335,3.924 -5.617,5.242 -2.284,1.321 -4.853,2.247 -7.704,2.782 -2.854,0.535 -5.671,0.803 -8.453,0.803 -3.638,0 -7.312,-0.519 -11.021,-1.552 -3.71,-1.033 -6.848,-2.87 -9.416,-5.511 l 9.737,-10.807 c 1.498,1.856 3.156,3.264 4.975,4.227 1.818,0.963 3.941,1.444 6.367,1.444 1.854,0 3.531,-0.267 5.029,-0.803 1.498,-0.535 2.246,-1.515 2.246,-2.942 0,-1.354 -0.66,-2.37 -1.979,-3.05 -1.321,-0.677 -2.996,-1.246 -5.029,-1.711 -2.032,-0.464 -4.21,-0.963 -6.526,-1.498 -2.319,-0.535 -4.495,-1.338 -6.528,-2.408 -2.033,-1.07 -3.71,-2.584 -5.029,-4.547 -1.32,-1.961 -1.979,-4.583 -1.979,-7.865 0,-3.066 0.623,
-5.706 1.872,-7.918 1.247,-2.21 2.889,-4.029 4.922,-5.457 2.033,-1.426 4.369,-2.478 7.009,-3.156 2.638,-0.678 5.312,-1.017 8.025,-1.017 3.424,0 6.883,0.5 10.379,1.498 3.494,1 6.455,2.782 8.881,5.35 l -9.841,9.738 z"
+ id="path3237"
+ inkscape:connector-curvature="0"
+ style="fill:url(#SVGID_6_)" />
+ <pattern
+ id="SVGID_7_"
+ xlink:href="#Unnamed_Pattern_1"
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)">
+ </pattern>
+ <path
+ d="m 349.795,83.953 h -14.123 v 17.334 c 0,1.428 0.07,2.729 0.213,3.906 0.143,1.176 0.463,2.193 0.963,3.049 0.5,0.856 1.266,1.517 2.301,1.979 1.033,0.465 2.408,0.695 4.119,0.695 0.857,0 1.98,-0.089 3.371,-0.267 1.391,-0.178 2.443,-0.59 3.156,-1.23 v 13.374 c -1.783,0.643 -3.637,1.07 -5.563,1.284 -1.926,0.214 -3.817,0.321 -5.671,0.321 -2.711,0 -5.207,-0.286 -7.49,-0.856 -2.283,-0.57 -4.279,-1.479 -5.992,-2.729 -1.711,-1.247 -3.049,-2.87 -4.012,-4.868 -0.963,-1.996 -1.445,-4.423 -1.445,-7.276 V 83.953 H 309.35 v -12.84 h 10.271 V 55.705 h 16.051 v 15.408 h 14.123 v 12.84 z"
+ id="path3240"
+ inkscape:connector-curvature="0"
+ style="fill:url(#SVGID_7_)" />
+ <pattern
+ id="SVGID_8_"
+ xlink:href="#Unnamed_Pattern_2"
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)">
+ </pattern>
+ <path
+ d="m 390.562,116.588 h -0.215 c -1.783,2.782 -4.156,4.78 -7.115,5.992 -2.961,1.212 -6.082,1.819 -9.361,1.819 -2.426,0 -4.762,-0.34 -7.01,-1.017 -2.246,-0.677 -4.227,-1.693 -5.938,-3.05 -1.713,-1.354 -3.068,-3.031 -4.066,-5.028 -1,-1.996 -1.498,-4.315 -1.498,-6.955 0,-2.996 0.551,-5.527 1.658,-7.598 1.105,-2.068 2.604,-3.78 4.494,-5.136 1.889,-1.354 4.047,-2.408 6.473,-3.156 2.426,-0.749 4.939,-1.301 7.545,-1.659 2.604,-0.356 5.205,-0.57 7.811,-0.642 2.604,-0.07 5.01,-0.107 7.223,-0.107 0,-2.852 -1.018,-5.118 -3.049,-6.794 -2.033,-1.676 -4.441,-2.515 -7.224,-2.515 -2.64,0 -5.048,0.553 -7.222,1.659 -2.178,1.106 -4.119,2.621 -5.832,4.547 l -8.561,-8.774 c 2.996,-2.782 6.489,-4.869 10.486,-6.26 3.994,-1.39 8.133,-2.086 12.412,-2.086 4.709,0 8.576,0.589 11.609,1.766 3.031,1.177 5.457,2.907 7.275,5.189 1.82,2.284 3.086,5.082 3.799,8.399 0.713,3.318 1.07,7.153 1.07,11.503 v 26.429 H 390.56 v -6.526 z m -3.958,-16.264 c -1.215,0 -2.729,0.054 -4.547,0.161 -1.82,0.107 -3.568,0.411 -5.244,0
.909 -1.676,0.5 -3.104,1.249 -4.279,2.247 -1.178,1 -1.766,2.391 -1.766,4.173 0,1.926 0.818,3.354 2.461,4.279 1.641,0.928 3.352,1.392 5.137,1.392 1.566,0 3.084,-0.214 4.547,-0.642 1.461,-0.429 2.764,-1.033 3.904,-1.819 1.141,-0.784 2.051,-1.782 2.729,-2.996 0.678,-1.212 1.018,-2.638 1.018,-4.28 v -3.424 h -3.96 z"
+ id="path3243"
+ inkscape:connector-curvature="0"
+ style="fill:url(#SVGID_8_)" />
+ <pattern
+ id="SVGID_9_"
+ xlink:href="#Unnamed_Pattern_3"
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)">
+ </pattern>
+ <path
+ d="m 450.588,87.912 c -0.785,-1.14 -1.891,-2.086 -3.316,-2.835 -1.428,-0.749 -2.961,-1.124 -4.602,-1.124 -4.066,0 -7.223,1.214 -9.469,3.638 -2.248,2.426 -3.371,5.601 -3.371,9.523 0,3.924 1.123,7.099 3.371,9.522 2.246,2.426 5.402,3.639 9.469,3.639 1.783,0 3.318,-0.392 4.602,-1.178 1.283,-0.783 2.389,-1.711 3.316,-2.781 l 10.594,11.128 c -2.498,2.568 -5.441,4.37 -8.828,5.403 -3.389,1.033 -6.617,1.552 -9.684,1.552 -3.996,0 -7.758,-0.643 -11.287,-1.925 -3.531,-1.285 -6.6,-3.121 -9.203,-5.512 -2.605,-2.389 -4.654,-5.26 -6.152,-8.612 -1.498,-3.354 -2.246,-7.099 -2.246,-11.236 0,-4.136 0.748,-7.881 2.246,-11.235 1.498,-3.352 3.547,-6.222 6.152,-8.613 2.604,-2.39 5.672,-4.227 9.203,-5.511 3.529,-1.284 7.291,-1.926 11.287,-1.926 3.066,0 6.295,0.519 9.684,1.552 3.387,1.034 6.33,2.835 8.828,5.403 l -10.594,11.128 z"
+ id="path3246"
+ inkscape:connector-curvature="0"
+ style="fill:url(#SVGID_9_)" />
+ <pattern
+ id="SVGID_10_"
+ xlink:href="#Unnamed_Pattern_4"
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)">
+ </pattern>
+ <polygon
+ points="500.772,123.115 483.223,96.793 483.008,96.793 483.008,123.115 466.959,123.115 466.959,42.223 483.008,42.223 483.008,91.657 500.772,71.113 520.459,71.113 499.807,94.546 520.994,123.115 "
+ id="polygon3249"
+ style="fill:url(#SVGID_10_)" />
+</g>
+<rect
+ x="-123.5"
+ y="-295.5"
+ width="800"
+ height="600"
+ id="rect3251"
+ style="fill:none" />
+
+
+</svg>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/image_right.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/image_right.png b/docs/publican-cloudstack/en-US/images/image_right.png
new file mode 100644
index 0000000..5b67443
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/image_right.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/image_right.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/image_right.svg b/docs/publican-cloudstack/en-US/images/image_right.svg
new file mode 100644
index 0000000..7c9e01f
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/image_right.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="199"
+ height="41"
+ id="svgimage_right">
+ <defs
+ id="defsimage_right" />
+ <text
+ x="99.5"
+ y="20.5"
+ transform="scale(0.89833804,1.1131667)"
+ id="textimage_right"
+ xml:space="preserve"
+ style="font-size:20px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Liberation Serif;"><tspan
+ x="101.5"
+ y="22.5"
+ id="tspanimage_right">image_right</tspan></text>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/important.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/important.png b/docs/publican-cloudstack/en-US/images/important.png
new file mode 100644
index 0000000..969562b
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/important.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/important.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/important.svg b/docs/publican-cloudstack/en-US/images/important.svg
new file mode 100644
index 0000000..064c783
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/important.svg
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="48"
+ height="48"
+ id="svg2">
+ <defs
+ id="defs5" />
+ <path
+ d="M 255.25,-411.29002 L 261.86798,-400.85887 L 273.83367,-397.7882 L 265.95811,-388.27072 L 266.73534,-375.94179 L 255.25,-380.49082 L 243.76466,-375.94179 L 244.54189,-388.27072 L 236.66633,-397.7882 L 248.63202,-400.85887 L 255.25,-411.29002 z "
+ transform="matrix(1.1071323,0,0,1.1071323,-258.4137,459.98052)"
+ style="fill:#2e3436;fill-opacity:1;stroke:#2e3436;stroke-width:4.25880718;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+ id="path4450" />
+ <path
+ d="M 255.25,-411.29002 L 261.86798,-400.85887 L 273.83367,-397.7882 L 265.95811,-388.27072 L 266.73534,-375.94179 L 255.25,-380.49082 L 243.76466,-375.94179 L 244.54189,-388.27072 L 236.66633,-397.7882 L 248.63202,-400.85887 L 255.25,-411.29002 z "
+ transform="matrix(1.1071323,0,0,1.1071323,-258.4137,459.98052)"
+ style="fill:#fac521;fill-opacity:1;stroke-width:3.4070456;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+ id="path4452" />
+ <path
+ d="M 24.175987,4.476098 L 16.980534,16.087712 L 3.9317841,19.443104 L 16.980534,20.076901 L 24.175987,10.383543 L 31.408721,20.076901 L 44.457471,19.443104 L 31.468862,16.027571 L 24.175987,4.476098 z "
+ style="fill:#feeaab;fill-opacity:1;stroke-width:3.4070456;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+ id="path4531" />
+ <path
+ d="M 12.456856,24.055852 C 11.65845,24.299685 14.436112,29.177769 14.436112,32.041127 C 14.436112,37.343117 13.010825,39.831516 15.971742,37.364645 C 18.711008,35.08244 21.184735,34.873512 24.195894,34.873512 C 27.207053,34.873512 29.646656,35.08244 32.38592,37.364645 C 35.346837,39.831516 33.921551,37.343117 33.92155,32.041127 C 33.92155,28.223316 38.868232,20.827013 33.682674,25.591482 C 31.458295,27.635233 27.413886,29.481744 24.195894,29.481744 C 20.977903,29.481744 16.933493,27.635233 14.709113,25.591482 C 13.412724,24.400365 12.722992,23.974574 12.456856,24.055852 z "
+ style="fill:#fcd867;fill-opacity:1;stroke-width:3.4070456;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+ id="path2185" />
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/note.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/note.png b/docs/publican-cloudstack/en-US/images/note.png
new file mode 100644
index 0000000..d04775d
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/note.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/note.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/note.svg b/docs/publican-cloudstack/en-US/images/note.svg
new file mode 100644
index 0000000..abe5a60
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/note.svg
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="48"
+ height="48"
+ id="svg2">
+ <defs
+ id="defs5" />
+ <path
+ d="M 30.27396,4.1232594 L 18.765811,4.1232594 C 11.476786,4.1232594 5.5574109,10.546411 5.5574109,19.960741 C 5.5574109,24.746615 7.0844878,29.075948 9.5403943,32.177328 C 9.4616811,32.681104 9.414455,33.200619 9.414455,33.720144 C 9.414455,39.308917 13.554865,43.591015 18.891751,44.267966 C 17.506371,42.693663 16.656245,40.914707 16.656245,38.616218 C 16.656245,38.01799 16.719219,37.419752 16.82942,36.837262 C 17.459135,36.963202 18.104599,37.026176 18.750063,37.026176 L 30.258211,37.026176 C 37.547237,37.026176 43.466612,29.39081 43.466612,19.960741 C 43.466612,10.530672 37.578724,4.1232594 30.27396,4.1232594 z "
+ style="fill:#2e3436;fill-opacity:1;stroke:#2e3436;stroke-width:4.7150631;stroke-miterlimit:4;stroke-dasharray:none"
+ id="path4317" />
+ <path
+ d="M 30.27396,4.1232594 L 18.765811,4.1232594 C 11.476786,4.1232594 5.5574109,10.546411 5.5574109,19.960741 C 5.5574109,24.746615 7.0844878,29.075948 9.5403943,32.177328 C 9.4616811,32.681104 9.414455,33.200619 9.414455,33.720144 C 9.414455,39.308917 13.554865,43.591015 18.891751,44.267966 C 17.506371,42.693663 16.656245,40.914707 16.656245,38.616218 C 16.656245,38.01799 16.719219,37.419752 16.82942,36.837262 C 17.459135,36.963202 18.104599,37.026176 18.750063,37.026176 L 30.258211,37.026176 C 37.547237,37.026176 43.466612,29.39081 43.466612,19.960741 C 43.466612,10.530672 37.578724,4.1232594 30.27396,4.1232594 z "
+ style="fill:#bfdce8;fill-opacity:1"
+ id="path142" />
+ <path
+ d="M 19.200879,5.5648899 C 12.490241,5.5648899 7.0622987,11.295775 7.0622987,19.690323 C 7.0622987,22.890926 7.8418023,25.879852 9.1910836,28.332288 C 8.6113289,26.599889 8.2852163,24.667826 8.2852163,22.673336 C 8.2852163,14.629768 13.495502,9.1620492 19.925575,9.1620492 L 30.071259,9.1620492 C 36.515213,9.1620492 41.711609,14.616311 41.711609,22.673336 C 41.864688,21.709218 41.983366,20.710908 41.983366,19.690323 C 41.983366,11.281743 36.524624,5.5648899 29.799492,5.5648899 L 19.200879,5.5648899 z "
+ style="fill:#ffffff"
+ id="path2358" />
+ <path
+ d="M 28.241965,33.725087 L 20.792252,33.725087 C 16.073756,33.725087 12.241894,32.944782 12.241894,26.850486 C 12.241894,25.10387 12.368512,23.572125 15.515722,23.567487 L 33.508301,23.540969 C 36.182481,23.537028 36.782127,24.950794 36.782127,26.850486 C 36.782127,32.95497 32.970649,33.725087 28.241965,33.725087 z "
+ style="fill:#d0ecf9;fill-opacity:1"
+ id="path2173" />
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-go-back.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-go-back.png b/docs/publican-cloudstack/en-US/images/stock-go-back.png
new file mode 100644
index 0000000..00850b2
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/stock-go-back.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-go-back.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-go-back.svg b/docs/publican-cloudstack/en-US/images/stock-go-back.svg
new file mode 100644
index 0000000..b3b9081
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/stock-go-back.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="22"
+ height="22"
+ id="svgstock-go-back">
+ <defs
+ id="defsstock-go-back" />
+ <text
+ x="11"
+ y="11"
+ transform="scale(0.89833804,1.1131667)"
+ id="textstock-go-back"
+ xml:space="preserve"
+ style="font-size:20px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Liberation Serif;"><tspan
+ x="13"
+ y="13"
+ id="tspanstock-go-back">stock-go-back</tspan></text>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-go-forward.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-go-forward.png b/docs/publican-cloudstack/en-US/images/stock-go-forward.png
new file mode 100644
index 0000000..cc2797a
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/stock-go-forward.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-go-forward.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-go-forward.svg b/docs/publican-cloudstack/en-US/images/stock-go-forward.svg
new file mode 100644
index 0000000..7ee607b
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/stock-go-forward.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="22"
+ height="22"
+ id="svgstock-go-forward">
+ <defs
+ id="defsstock-go-forward" />
+ <text
+ x="11"
+ y="11"
+ transform="scale(0.89833804,1.1131667)"
+ id="textstock-go-forward"
+ xml:space="preserve"
+ style="font-size:20px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Liberation Serif;"><tspan
+ x="13"
+ y="13"
+ id="tspanstock-go-forward">stock-go-forward</tspan></text>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-go-up.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-go-up.png b/docs/publican-cloudstack/en-US/images/stock-go-up.png
new file mode 100644
index 0000000..1ebf279
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/stock-go-up.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-go-up.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-go-up.svg b/docs/publican-cloudstack/en-US/images/stock-go-up.svg
new file mode 100644
index 0000000..a7c2af2
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/stock-go-up.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="22"
+ height="22"
+ id="svgstock-go-up">
+ <defs
+ id="defsstock-go-up" />
+ <text
+ x="11"
+ y="11"
+ transform="scale(0.89833804,1.1131667)"
+ id="textstock-go-up"
+ xml:space="preserve"
+ style="font-size:20px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Liberation Serif;"><tspan
+ x="13"
+ y="13"
+ id="tspanstock-go-up">stock-go-up</tspan></text>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-home.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-home.png b/docs/publican-cloudstack/en-US/images/stock-home.png
new file mode 100644
index 0000000..3f0c190
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/stock-home.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/stock-home.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/stock-home.svg b/docs/publican-cloudstack/en-US/images/stock-home.svg
new file mode 100644
index 0000000..d06a544
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/stock-home.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="22"
+ height="22"
+ id="svgstock-home">
+ <defs
+ id="defsstock-home" />
+ <text
+ x="11"
+ y="11"
+ transform="scale(0.89833804,1.1131667)"
+ id="textstock-home"
+ xml:space="preserve"
+ style="font-size:20px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Liberation Serif;"><tspan
+ x="13"
+ y="13"
+ id="tspanstock-home">stock-home</tspan></text>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/title_logo.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/title_logo.png b/docs/publican-cloudstack/en-US/images/title_logo.png
new file mode 100644
index 0000000..f0b1d20
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/title_logo.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/title_logo.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/title_logo.svg b/docs/publican-cloudstack/en-US/images/title_logo.svg
new file mode 100644
index 0000000..e8b3eca
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/title_logo.svg
@@ -0,0 +1,335 @@
+<?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:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ version="1.1"
+ width="299"
+ height="100"
+ viewBox="0 0 299 100"
+ id="Layer_1"
+ xml:space="preserve"
+ inkscape:version="0.48.1 r9760"
+ sodipodi:docname="title_logo.svg"><sodipodi:namedview
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1"
+ objecttolerance="10"
+ gridtolerance="10"
+ guidetolerance="10"
+ inkscape:pageopacity="0"
+ inkscape:pageshadow="2"
+ inkscape:window-width="1280"
+ inkscape:window-height="753"
+ id="namedview59"
+ showgrid="false"
+ inkscape:zoom="4.4799236"
+ inkscape:cx="216.06083"
+ inkscape:cy="50"
+ inkscape:window-x="-3"
+ inkscape:window-y="-3"
+ inkscape:window-maximized="1"
+ inkscape:current-layer="g3224" /><metadata
+ id="metadata3261"><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><defs
+ id="defs3259" />
+<pattern
+ overflow="visible"
+ viewBox="0 -182 322 182"
+ id="Unnamed_Pattern"
+ patternUnits="userSpaceOnUse"
+ height="182"
+ width="322"
+ y="403.5"
+ x="-123.5">
+ <g
+ id="g3165">
+ <polygon
+ id="polygon3167"
+ points="0,-182 322,-182 322,0 0,0 "
+ fill="none" />
+
+ <linearGradient
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)"
+ y2="-8448.6895"
+ x2="7746.8442"
+ y1="-8448.6895"
+ x1="7745.8442"
+ gradientUnits="userSpaceOnUse"
+ id="SVGID_1_">
+ <stop
+ id="stop3170"
+ style="stop-color:#ABABAB"
+ offset="0" />
+ <stop
+ id="stop3172"
+ style="stop-color:#787878"
+ offset="1" />
+ </linearGradient>
+ <polygon
+ id="polygon3174"
+ points="322,0 322,-182 0,-182 0,0 "
+ fill="url(#SVGID_1_)" />
+ </g>
+</pattern>
+<pattern
+ overflow="visible"
+ viewBox="0 -182 322 182"
+ id="Unnamed_Pattern_1"
+ patternUnits="userSpaceOnUse"
+ height="182"
+ width="322"
+ y="403.5"
+ x="-123.5">
+ <g
+ id="g3177">
+ <polygon
+ id="polygon3179"
+ points="0,-182 322,-182 322,0 0,0 "
+ fill="none" />
+
+ <linearGradient
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)"
+ y2="-8448.6895"
+ x2="7746.8442"
+ y1="-8448.6895"
+ x1="7745.8442"
+ gradientUnits="userSpaceOnUse"
+ id="SVGID_2_">
+ <stop
+ id="stop3182"
+ style="stop-color:#ABABAB"
+ offset="0" />
+ <stop
+ id="stop3184"
+ style="stop-color:#787878"
+ offset="1" />
+ </linearGradient>
+ <polygon
+ id="polygon3186"
+ points="322,0 322,-182 0,-182 0,0 "
+ fill="url(#SVGID_2_)" />
+ </g>
+</pattern>
+<pattern
+ overflow="visible"
+ viewBox="0 -182 322 182"
+ id="Unnamed_Pattern_2"
+ patternUnits="userSpaceOnUse"
+ height="182"
+ width="322"
+ y="403.5"
+ x="-123.5">
+ <g
+ id="g3189">
+ <polygon
+ id="polygon3191"
+ points="0,-182 322,-182 322,0 0,0 "
+ fill="none" />
+
+ <linearGradient
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)"
+ y2="-8448.6895"
+ x2="7746.8442"
+ y1="-8448.6895"
+ x1="7745.8442"
+ gradientUnits="userSpaceOnUse"
+ id="SVGID_3_">
+ <stop
+ id="stop3194"
+ style="stop-color:#ABABAB"
+ offset="0" />
+ <stop
+ id="stop3196"
+ style="stop-color:#787878"
+ offset="1" />
+ </linearGradient>
+ <polygon
+ id="polygon3198"
+ points="322,0 322,-182 0,-182 0,0 "
+ fill="url(#SVGID_3_)" />
+ </g>
+</pattern>
+<pattern
+ overflow="visible"
+ viewBox="0 -182 322 182"
+ id="Unnamed_Pattern_3"
+ patternUnits="userSpaceOnUse"
+ height="182"
+ width="322"
+ y="403.5"
+ x="-123.5">
+ <g
+ id="g3201">
+ <polygon
+ id="polygon3203"
+ points="0,-182 322,-182 322,0 0,0 "
+ fill="none" />
+
+ <linearGradient
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)"
+ y2="-8448.6895"
+ x2="7746.8442"
+ y1="-8448.6895"
+ x1="7745.8442"
+ gradientUnits="userSpaceOnUse"
+ id="SVGID_4_">
+ <stop
+ id="stop3206"
+ style="stop-color:#ABABAB"
+ offset="0" />
+ <stop
+ id="stop3208"
+ style="stop-color:#787878"
+ offset="1" />
+ </linearGradient>
+ <polygon
+ id="polygon3210"
+ points="322,0 322,-182 0,-182 0,0 "
+ fill="url(#SVGID_4_)" />
+ </g>
+</pattern>
+<pattern
+ overflow="visible"
+ viewBox="0 -182 322 182"
+ id="Unnamed_Pattern_4"
+ patternUnits="userSpaceOnUse"
+ height="182"
+ width="322"
+ y="403.5"
+ x="-123.5">
+ <g
+ id="g3213">
+ <polygon
+ id="polygon3215"
+ points="0,-182 322,-182 322,0 0,0 "
+ fill="none" />
+
+ <linearGradient
+ gradientTransform="matrix(0 -182 -182 0 -1537500.375 1409743.625)"
+ y2="-8448.6895"
+ x2="7746.8442"
+ y1="-8448.6895"
+ x1="7745.8442"
+ gradientUnits="userSpaceOnUse"
+ id="SVGID_5_">
+ <stop
+ id="stop3218"
+ style="stop-color:#ABABAB"
+ offset="0" />
+ <stop
+ id="stop3220"
+ style="stop-color:#787878"
+ offset="1" />
+ </linearGradient>
+ <polygon
+ id="polygon3222"
+ points="322,0 322,-182 0,-182 0,0 "
+ fill="url(#SVGID_5_)" />
+ </g>
+</pattern>
+<g
+ transform="matrix(0.5397128,0,0,0.47429761,-11.54274,-15.412643)"
+ id="g3224">
+ <path
+ d="m 53.199,124.06 c -14.587,0 -25.282,-12.24 -25.282,-27.35 v -0.195 c 0,-15.11 10.603,-27.549 25.463,-27.549 9.151,0 14.863,3.362 19.389,8.885 l -8.424,9.873 C 61.26,84.172 58.178,81.898 53.288,81.898 46.4,81.898 41.509,88.513 41.509,96.32 v 0.195 c 0,8.097 4.802,14.606 12.324,14.606 4.618,0 7.791,-2.161 11.145,-5.624 l 8.061,8.893 c -4.715,5.619 -10.147,9.67 -19.84,9.67"
+ id="path3226"
+ style="fill:#69afd8" />
+ <path
+ d="m 123.247,123.876 c -15.037,0 -26.184,-12.149 -26.184,-27.35 V 96.33 c 0,-15.202 11.235,-27.549 26.368,-27.549 15.035,0 26.188,12.144 26.188,27.354 v 0.195 c -0.001,15.198 -11.248,27.546 -26.372,27.546 M 136.025,96.33 c 0,-7.802 -5.169,-14.616 -12.779,-14.616 -7.884,0 -12.586,6.615 -12.586,14.421 v 0.195 c 0,7.799 5.16,14.604 12.77,14.604 7.88,0 12.595,-6.604 12.595,-14.408 V 96.33 z"
+ id="path3228"
+ style="fill:#69afd8" />
+ <path
+ d="m 185.459,123.946 v -7.498 c -3.169,4.435 -7.253,8.488 -14.219,8.488 -10.43,0 -16.496,-7.5 -16.496,-19.646 V 71.026 h 13.776 v 29.524 c 0,7.113 3.081,10.757 8.337,10.757 5.248,0 8.602,-3.645 8.602,-10.757 V 71.026 h 13.769 v 52.92 h -13.769 z"
+ id="path3230"
+ style="fill:#69afd8" />
+ <path
+ d="m 242.488,123.792 v -7.604 c -3.346,4.945 -7.968,8.594 -15.133,8.594 -11.321,0 -22.106,-9.674 -22.106,-27.346 v -0.195 c 0,-17.676 10.601,-27.354 22.106,-27.354 7.342,0 11.868,3.652 15.133,7.901 V 51.724 h 13.769 v 72.068 h -13.769 z m 0.178,-26.551 c 0,-8.787 -5.344,-14.613 -11.771,-14.613 -6.435,0 -11.868,5.719 -11.868,14.613 v 0.195 c 0,8.785 5.433,14.606 11.868,14.606 6.427,0 11.771,-5.821 11.771,-14.606 v -0.195 z"
+ id="path3232"
+ style="fill:#69afd8" />
+ <rect
+ width="14.72"
+ height="76.083"
+ x="77.877998"
+ y="48.307999"
+ id="rect3234"
+ style="fill:#69afd8" />
+ <pattern
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)"
+ xlink:href="#Unnamed_Pattern"
+ id="SVGID_6_">
+ </pattern>
+ <path
+ d="m 294.264,86.414 c -2.354,-2.924 -5.457,-4.387 -9.31,-4.387 -1.356,0 -2.675,0.321 -3.959,0.963 -1.284,0.642 -1.926,1.749 -1.926,3.317 0,1.284 0.657,2.231 1.979,2.836 1.318,0.606 2.995,1.142 5.028,1.604 2.033,0.465 4.208,0.964 6.526,1.499 2.318,0.535 4.495,1.374 6.527,2.514 2.033,1.142 3.709,2.694 5.029,4.654 1.319,1.963 1.98,4.585 1.98,7.865 0,3.354 -0.732,6.117 -2.194,8.293 -1.463,2.176 -3.335,3.924 -5.617,5.242 -2.284,1.321 -4.853,2.247 -7.704,2.782 -2.854,0.535 -5.671,0.803 -8.453,0.803 -3.638,0 -7.312,-0.519 -11.021,-1.552 -3.71,-1.033 -6.848,-2.87 -9.416,-5.511 l 9.737,-10.807 c 1.498,1.856 3.156,3.264 4.975,4.227 1.818,0.963 3.941,1.444 6.367,1.444 1.854,0 3.531,-0.267 5.029,-0.803 1.498,-0.535 2.246,-1.515 2.246,-2.942 0,-1.354 -0.66,-2.37 -1.979,-3.05 -1.321,-0.677 -2.996,-1.246 -5.029,-1.711 -2.032,-0.464 -4.21,-0.963 -6.526,-1.498 -2.319,-0.535 -4.495,-1.338 -6.528,-2.408 -2.033,-1.07 -3.71,-2.584 -5.029,-4.547 -1.32,-1.961 -1.979,-4.583 -1.979,-7.865 0,-3.066 0.623,
-5.706 1.872,-7.918 1.247,-2.21 2.889,-4.029 4.922,-5.457 2.033,-1.426 4.369,-2.478 7.009,-3.156 2.638,-0.678 5.312,-1.017 8.025,-1.017 3.424,0 6.883,0.5 10.379,1.498 3.494,1 6.455,2.782 8.881,5.35 l -9.841,9.738 z"
+ id="path3237"
+ style="fill:#8a8a8a;stroke:#8a8a8a;stroke-opacity:0.94901961;fill-opacity:0.95060813000000000" />
+ <pattern
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)"
+ xlink:href="#Unnamed_Pattern_1"
+ id="SVGID_7_">
+ </pattern>
+ <path
+ d="m 349.795,83.953 h -14.123 v 17.334 c 0,1.428 0.07,2.729 0.213,3.906 0.143,1.176 0.463,2.193 0.963,3.049 0.5,0.856 1.266,1.517 2.301,1.979 1.033,0.465 2.408,0.695 4.119,0.695 0.857,0 1.98,-0.089 3.371,-0.267 1.391,-0.178 2.443,-0.59 3.156,-1.23 v 13.374 c -1.783,0.643 -3.637,1.07 -5.563,1.284 -1.926,0.214 -3.817,0.321 -5.671,0.321 -2.711,0 -5.207,-0.286 -7.49,-0.856 -2.283,-0.57 -4.279,-1.479 -5.992,-2.729 -1.711,-1.247 -3.049,-2.87 -4.012,-4.868 -0.963,-1.996 -1.445,-4.423 -1.445,-7.276 V 83.953 H 309.35 v -12.84 h 10.271 V 55.705 h 16.051 v 15.408 h 14.123 v 12.84 z"
+ id="path3240"
+ style="fill:#8a8a8a;stroke:#8a8a8a;stroke-opacity:0.94901961000000001;fill-opacity:0.94901961" />
+ <pattern
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)"
+ xlink:href="#Unnamed_Pattern_2"
+ id="SVGID_8_">
+ </pattern>
+ <path
+ d="m 390.562,116.588 h -0.215 c -1.783,2.782 -4.156,4.78 -7.115,5.992 -2.961,1.212 -6.082,1.819 -9.361,1.819 -2.426,0 -4.762,-0.34 -7.01,-1.017 -2.246,-0.677 -4.227,-1.693 -5.938,-3.05 -1.713,-1.354 -3.068,-3.031 -4.066,-5.028 -1,-1.996 -1.498,-4.315 -1.498,-6.955 0,-2.996 0.551,-5.527 1.658,-7.598 1.105,-2.068 2.604,-3.78 4.494,-5.136 1.889,-1.354 4.047,-2.408 6.473,-3.156 2.426,-0.749 4.939,-1.301 7.545,-1.659 2.604,-0.356 5.205,-0.57 7.811,-0.642 2.604,-0.07 5.01,-0.107 7.223,-0.107 0,-2.852 -1.018,-5.118 -3.049,-6.794 -2.033,-1.676 -4.441,-2.515 -7.224,-2.515 -2.64,0 -5.048,0.553 -7.222,1.659 -2.178,1.106 -4.119,2.621 -5.832,4.547 l -8.561,-8.774 c 2.996,-2.782 6.489,-4.869 10.486,-6.26 3.994,-1.39 8.133,-2.086 12.412,-2.086 4.709,0 8.576,0.589 11.609,1.766 3.031,1.177 5.457,2.907 7.275,5.189 1.82,2.284 3.086,5.082 3.799,8.399 0.713,3.318 1.07,7.153 1.07,11.503 v 26.429 H 390.56 v -6.526 z m -3.958,-16.264 c -1.215,0 -2.729,0.054 -4.547,0.161 -1.82,0.107 -3.568,0.411 -5.244,0
.909 -1.676,0.5 -3.104,1.249 -4.279,2.247 -1.178,1 -1.766,2.391 -1.766,4.173 0,1.926 0.818,3.354 2.461,4.279 1.641,0.928 3.352,1.392 5.137,1.392 1.566,0 3.084,-0.214 4.547,-0.642 1.461,-0.429 2.764,-1.033 3.904,-1.819 1.141,-0.784 2.051,-1.782 2.729,-2.996 0.678,-1.212 1.018,-2.638 1.018,-4.28 v -3.424 h -3.96 z"
+ id="path3243"
+ style="fill:#8a8a8a;fill-opacity:0.94901961000000001;stroke:#8a8a8a;stroke-opacity:0.94901961" />
+ <pattern
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)"
+ xlink:href="#Unnamed_Pattern_3"
+ id="SVGID_9_">
+ </pattern>
+ <path
+ d="m 450.588,87.912 c -0.785,-1.14 -1.891,-2.086 -3.316,-2.835 -1.428,-0.749 -2.961,-1.124 -4.602,-1.124 -4.066,0 -7.223,1.214 -9.469,3.638 -2.248,2.426 -3.371,5.601 -3.371,9.523 0,3.924 1.123,7.099 3.371,9.522 2.246,2.426 5.402,3.639 9.469,3.639 1.783,0 3.318,-0.392 4.602,-1.178 1.283,-0.783 2.389,-1.711 3.316,-2.781 l 10.594,11.128 c -2.498,2.568 -5.441,4.37 -8.828,5.403 -3.389,1.033 -6.617,1.552 -9.684,1.552 -3.996,0 -7.758,-0.643 -11.287,-1.925 -3.531,-1.285 -6.6,-3.121 -9.203,-5.512 -2.605,-2.389 -4.654,-5.26 -6.152,-8.612 -1.498,-3.354 -2.246,-7.099 -2.246,-11.236 0,-4.136 0.748,-7.881 2.246,-11.235 1.498,-3.352 3.547,-6.222 6.152,-8.613 2.604,-2.39 5.672,-4.227 9.203,-5.511 3.529,-1.284 7.291,-1.926 11.287,-1.926 3.066,0 6.295,0.519 9.684,1.552 3.387,1.034 6.33,2.835 8.828,5.403 l -10.594,11.128 z"
+ id="path3246"
+ style="fill:#8a8a8a;stroke:#8a8a8a;stroke-opacity:0.94901961000000001;fill-opacity:0.94901961" />
+ <pattern
+ patternTransform="matrix(1 0 0 -1 17.2363 -1377)"
+ xlink:href="#Unnamed_Pattern_4"
+ id="SVGID_10_">
+ </pattern>
+ <polygon
+ points="483.008,96.793 483.008,123.115 466.959,123.115 466.959,42.223 483.008,42.223 483.008,91.657 500.772,71.113 520.459,71.113 499.807,94.546 520.994,123.115 500.772,123.115 483.223,96.793 "
+ id="polygon3249"
+ style="fill:#8a8a8a;fill-opacity:0.94901961000000001;stroke:#8a8a8a;stroke-opacity:0.94901961" />
+</g>
+<rect
+ width="800"
+ height="600"
+ x="-123.5"
+ y="-283.5"
+ id="rect3251"
+ style="fill:none" />
+<line
+ x1="2.1267509"
+ y1="52.908203"
+ x2="293.45892"
+ y2="52.908203"
+ id="line3253"
+ style="fill:none;stroke:#6699cc;stroke-width:0.19496942" />
+<text
+ x="29.105854"
+ y="69.817314"
+ transform="scale(0.97693696,1.0236075)"
+ id="text3255"
+ style="font-size:18.040308px;fill:#8a8a8a;font-family:MyriadPro-Regular">open source cloud computing </text>
+
+
+
+
+</svg>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/warning.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/warning.png b/docs/publican-cloudstack/en-US/images/warning.png
new file mode 100644
index 0000000..94b69d1
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/warning.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/warning.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/warning.svg b/docs/publican-cloudstack/en-US/images/warning.svg
new file mode 100644
index 0000000..4231e5a
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/warning.svg
@@ -0,0 +1,130 @@
+<?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:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ version="1.0"
+ width="48"
+ height="48"
+ id="svg5921"
+ sodipodi:version="0.32"
+ inkscape:version="0.46"
+ sodipodi:docname="warning.svg"
+ inkscape:output_extension="org.inkscape.output.svg.inkscape">
+ <metadata
+ id="metadata11">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <sodipodi:namedview
+ inkscape:window-height="975"
+ inkscape:window-width="1680"
+ inkscape:pageshadow="2"
+ inkscape:pageopacity="0.0"
+ guidetolerance="10.0"
+ gridtolerance="10.0"
+ objecttolerance="10.0"
+ borderopacity="1.0"
+ bordercolor="#666666"
+ pagecolor="#ffffff"
+ id="base"
+ showgrid="false"
+ inkscape:zoom="1"
+ inkscape:cx="49.390126"
+ inkscape:cy="6.0062258"
+ inkscape:window-x="0"
+ inkscape:window-y="25"
+ inkscape:current-layer="svg5921" />
+ <defs
+ id="defs5923">
+ <linearGradient
+ inkscape:collect="always"
+ id="linearGradient2400">
+ <stop
+ style="stop-color:#fac521;stop-opacity:1;"
+ offset="0"
+ id="stop2402" />
+ <stop
+ style="stop-color:#fde7a3;stop-opacity:1"
+ offset="1"
+ id="stop2404" />
+ </linearGradient>
+ <inkscape:perspective
+ sodipodi:type="inkscape:persp3d"
+ inkscape:vp_x="0 : 20 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_z="40 : 20 : 1"
+ inkscape:persp3d-origin="20 : 13.333333 : 1"
+ id="perspective13" />
+ <inkscape:perspective
+ id="perspective2396"
+ inkscape:persp3d-origin="24 : 16 : 1"
+ inkscape:vp_z="48 : 24 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 24 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <inkscape:perspective
+ id="perspective2394"
+ inkscape:persp3d-origin="372.04724 : 350.78739 : 1"
+ inkscape:vp_z="744.09448 : 526.18109 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 526.18109 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <linearGradient
+ inkscape:collect="always"
+ xlink:href="#linearGradient2400"
+ id="linearGradient2406"
+ x1="-2684.8242"
+ y1="1639.8413"
+ x2="-2684.8242"
+ y2="1587.1559"
+ gradientUnits="userSpaceOnUse" />
+ </defs>
+ <g
+ transform="matrix(0.4536635,0,0,0.4536635,-5.1836431,-4.6889387)"
+ id="layer1">
+ <g
+ transform="translate(2745.6887,-1555.5977)"
+ id="g8304"
+ style="enable-background:new" />
+ </g>
+ <g
+ id="g3189"
+ transform="matrix(1.2987724,0,0,1.2987724,-1.4964485,-1.8271549)">
+ <path
+ style="opacity:1;fill:#2e3436;fill-opacity:1;stroke:none;stroke-opacity:1;enable-background:new"
+ id="path8034"
+ transform="matrix(0.3735251,4.0822414e-3,-4.0822414e-3,0.3735251,605.96125,-374.33682)"
+ d="M -1603,1054.4387 L -1577.0919,1027.891 L -1540,1027.4387 L -1513.4523,1053.3468 L -1513,1090.4387 L -1538.9081,1116.9864 L -1576,1117.4387 L -1602.5477,1091.5306 L -1603,1054.4387 z" />
+ <path
+ style="opacity:1;fill:url(#linearGradient2406);fill-opacity:1;stroke:none;stroke-width:0.72954363000000000;stroke-opacity:1;enable-background:new"
+ id="path8036"
+ d="M -2723.6739,1596.2775 L -2704.5623,1577.1175 L -2677.5001,1577.0833 L -2658.3401,1596.1949 L -2658.3059,1623.257 L -2677.4175,1642.417 L -2704.4797,1642.4513 L -2723.6396,1623.3396 L -2723.6739,1596.2775 z"
+ transform="matrix(0.4536635,0,0,0.4536635,1240.4351,-710.40684)" />
+ <path
+ transform="translate(6.7837002e-6,-8.8630501e-6)"
+ id="path3178"
+ d="M 13.46875,5.0625 L 4.8125,13.78125 L 4.8125,16.625 L 13.46875,7.9375 L 25.75,7.90625 L 34.4375,16.59375 L 34.4375,13.71875 L 25.75,5.0625 L 13.46875,5.0625 z"
+ style="opacity:1;fill:#fde8a6;fill-opacity:1;stroke:none;stroke-width:0.72954363;stroke-opacity:1;enable-background:new" />
+ <path
+ id="path4412"
+ style="fill:#fef2cb;fill-opacity:1;stroke:#fef2cb;stroke-width:0.9430126;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1"
+ d="M 23.308501,28.806303 C 23.308501,30.239154 22.087319,31.313792 20.231121,31.313792 L 20.198559,31.313792 C 18.358657,31.313792 17.121188,30.239154 17.121188,28.806303 C 17.121188,27.308327 18.391219,26.282537 20.231121,26.282537 C 22.054757,26.282537 23.27593,27.308327 23.308501,28.806303 z M 22.982851,24.507759 L 24.057489,11.351592 L 16.355915,11.351592 L 17.430553,24.507759 L 22.982851,24.507759 z" />
+ <path
+ id="path4414"
+ style="fill:#2e3436"
+ d="M 22.732962,27.86025 C 22.732962,29.293101 21.51178,30.36774 19.655592,30.36774 L 19.623029,30.36774 C 17.783118,30.36774 16.545659,29.293101 16.545659,27.86025 C 16.545659,26.362275 17.81568,25.336485 19.655592,25.336485 C 21.479218,25.336485 22.7004,26.362275 22.732962,27.86025 z M 22.407312,23.561697 L 23.48195,10.40553 L 15.780385,10.40553 L 16.855023,23.561697 L 22.407312,23.561697 z" />
+ </g>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/watermark-draft.png
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/watermark-draft.png b/docs/publican-cloudstack/en-US/images/watermark-draft.png
new file mode 100644
index 0000000..0ead5af
Binary files /dev/null and b/docs/publican-cloudstack/en-US/images/watermark-draft.png differ
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/en-US/images/watermark-draft.svg
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/images/watermark-draft.svg b/docs/publican-cloudstack/en-US/images/watermark-draft.svg
new file mode 100644
index 0000000..4ecbf37
--- /dev/null
+++ b/docs/publican-cloudstack/en-US/images/watermark-draft.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ version="1.0"
+ width="500"
+ height="500"
+ id="svgwatermark-draft">
+ <defs
+ id="defswatermark-draft" />
+ <text
+ x="250"
+ y="250"
+ transform="scale(0.89833804,1.1131667)"
+ id="textwatermark-draft"
+ xml:space="preserve"
+ style="font-size:20px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#ffffff;fill-opacity:1;stroke:none;font-family:Liberation Serif;"><tspan
+ x="252"
+ y="252"
+ id="tspanwatermark-draft">watermark-draft</tspan></text>
+</svg>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/publican-cloudstack/publican-cloudstack.spec
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/publican-cloudstack.spec b/docs/publican-cloudstack/publican-cloudstack.spec
new file mode 100644
index 0000000..f1f3c7d
--- /dev/null
+++ b/docs/publican-cloudstack/publican-cloudstack.spec
@@ -0,0 +1,46 @@
+%define brand cloudstack
+
+Name: publican-cloudstack
+Summary: Common documentation files for %{brand}
+Version: 0.2
+Release: 1%{?dist}
+License: ASLv2
+Group: Applications/Text
+Buildroot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
+Buildarch: noarch
+Source: %{name}-%{version}.tgz
+Requires: publican >= 1.99
+BuildRequires: publican >= 1.99
+URL: http://cloudstack.org
+
+%description
+This package provides common files and templates needed to build documentation
+for %{brand} with publican.
+
+%prep
+%setup -qn %{name}
+
+%build
+publican build --formats=xml --langs=en-US --publish
+
+%install
+rm -rf $RPM_BUILD_ROOT
+mkdir -p -m755 $RPM_BUILD_ROOT%{_datadir}/publican/Common_Content
+publican install_brand --path=$RPM_BUILD_ROOT%{_datadir}/publican/Common_Content
+
+%clean
+rm -rf $RPM_BUILD_ROOT
+
+%files
+%defattr(-,root,root,-)
+%doc README
+%doc LICENSE
+%doc NOTICE
+%{_datadir}/publican/Common_Content/%{brand}
+
+%changelog
+* Tue Jun 26 2012 David Nalley <da...@gnsa.us> 0.2-1
+- updated for ASF move
+* Sat Aug 11 2011 David Nalley <da...@gnsa.us> 0.1-1
+- Created Brand
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Author_Group.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Author_Group.xml b/docs/runbook/en-US/Author_Group.xml
new file mode 100644
index 0000000..6fbece3
--- /dev/null
+++ b/docs/runbook/en-US/Author_Group.xml
@@ -0,0 +1,12 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<authorgroup>
+ <author>
+ <firstname>Apache</firstname>
+ <surname>CloudStack</surname>
+ </author>
+</authorgroup>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Book_Info.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Book_Info.xml b/docs/runbook/en-US/Book_Info.xml
new file mode 100644
index 0000000..4d622d5
--- /dev/null
+++ b/docs/runbook/en-US/Book_Info.xml
@@ -0,0 +1,32 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<bookinfo id="book-Runbook-Runbook">
+ <title>Runbook</title>
+ <subtitle>Prescriptive instructions for deploying Apache CloudStack</subtitle>
+ <productname>Apache CloudStack</productname>
+ <productnumber>3.0.2</productnumber>
+ <edition>0</edition>
+ <pubsnumber>0</pubsnumber>
+ <abstract>
+ <para>
+ These runbooks are designed to provide a strict environment to guarantee
+ a higher degree of success in initial deployments of Apache CloudStack.
+ All of the elements of the environment will be provided to you.
+ Apache CloudStack is capable of much more complex configurations,
+ but they are beyond the scope of this document.
+ </para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Chapter.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Chapter.xml b/docs/runbook/en-US/Chapter.xml
new file mode 100644
index 0000000..79579aa
--- /dev/null
+++ b/docs/runbook/en-US/Chapter.xml
@@ -0,0 +1,33 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Test_Chapter">
+ <title>Test Chapter</title>
+ <para>
+ This is a test paragraph
+ </para>
+ <section id="sect-Runbook-Test_Chapter-Test_Section_1">
+ <title>Test Section 1</title>
+ <para>
+ This is a test paragraph in a section
+ </para>
+ </section>
+
+ <section id="sect-Runbook-Test_Chapter-Test_Section_2">
+ <title>Test Section 2</title>
+ <para>
+ This is a test paragraph in Section 2
+ <orderedlist>
+ <listitem>
+ <para>
+ listitem text
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </section>
+
+</chapter>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Environment.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Environment.xml b/docs/runbook/en-US/Environment.xml
new file mode 100644
index 0000000..1d65905
--- /dev/null
+++ b/docs/runbook/en-US/Environment.xml
@@ -0,0 +1,224 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Environment">
+ <title>Environment</title>
+ <para>
+ Before you begin, you need to prepare the environment before you install CloudStack.
+ We will go over the steps to prepare now.
+ </para>
+ <section id="sect-Runbook-Environment-operatingsys">
+ <title>Operating System</title>
+ <para>
+ Using the CentOS 6.2 x86_64 minimal install ISO, you'll need to install CentOS
+ on your hardware. The defaults will generally be acceptable for this installation.
+ </para>
+ <para>
+ Once this installation is complete, you'll want to connect to your freshly
+ installed machine via SSH as the root user. Note that you should not allow root
+ logins in a production environment, so be sure to turn off remote logins once you
+ have finished the installation and configuration.
+ </para>
+ <section id="sect-Runbook-Environment-operatingsys-network">
+ <title>Configuring the network</title>
+ <para>
+ By default the network will not come up on your hardware and you
+ will need to configure it to work in your environment. Since we
+ specified that there will be no DHCP server in this environment
+ we will be manually configuring your network interface. We will
+ assume, for the purposes of this exercise, that eth0 is the only network
+ interface that will be connected and used.
+ </para>
+ <para>
+ Connecting via the console you should login as root. Check the
+ file <filename>/etc/sysconfig/network-scripts/ifcfg-eth0</filename>,
+ it will look like this by default:
+ <screen>
+DEVICE="eth0"
+HWADDR="52:54:00:B9:A6:C0"
+NM_CONTROLLED="yes"
+ONBOOT="no"
+ </screen>
+ </para>
+ <para>
+ Unfortunately, this configuration will not permit you to connect to the network,
+ and is also unsuitable for our purposes with CloudStack. We want to
+ configure that file so that it specifies the IP address, netmask, etc., as shown
+ in the following example:
+ </para>
+ <screen>
+DEVICE=eth0
+HWADDR=52:54:00:B9:A6:C0
+NM_CONTROLLED=no
+ONBOOT=yes
+BOOTPROTO=none
+IPADDR=172.16.10.2
+NETMASK=255.255.255.0
+GATEWAY=172.16.10.1
+ </screen>
+ <note>
+ <title>IP Addressing</title>
+ <para>Throughout this document we are assuming that you will
+ have a /24 network for your CloudStack implementation. This can be any
+ RFC 1918 network. However, we are assuming that you will match the
+ machine address that we are using. Thus we may use
+ <userinput><replaceable>172.16.10</replaceable>.2</userinput> and because
+ you might be using the 192.168.55.0/24 network you would use
+ <userinput><replaceable>192.168.55</replaceable>.2</userinput>
+ </para>
+ </note>
+ <important>
+ <title>Hardware Addresses</title>
+ <para>You should not use the hardware address (aka MAC address) from our example
+ for your configuration. It is network interface specific, so you should keep the
+ address already provided in the HWADDR directive.
+ </para>
+ </important>
+ <para> Now that we have the configuration files properly set up, we need to run a
+ few commands to start up the network</para>
+ <screen><prompt># </prompt><userinput><command>chkconfig</command> network on</userinput></screen>
+ <screen><prompt># </prompt><userinput><command>service</command> network start</userinput></screen>
+ <para>This should bring the network up successfully, but we now need to enable name resolution.
+ To do that we will edit <filename>/etc/resolv.conf</filename>. These instructions will add
+ one of the nameservers from Google, though you are free to add a local nameserver if you wish.
+ Your <filename>/etc/resolv.conf</filename> should modified to look like:
+ </para>
+ <screen>
+nameserver 8.8.8.8
+ </screen>
+
+ </section>
+ <section id="sect-Runbook-Environment-operatingsys-hostname">
+ <title>Hostname</title>
+ <para>
+ Cloudstack requires that the hostname be properly set. If you used the default
+ options in the installation, then your hostname is currently set to
+ localhost.localdomain. To test this we will run: </para>
+ <screen><prompt># </prompt><userinput>hostname --fqdn</userinput></screen>
+ <para>At this point it will likely return:</para>
+ <screen>localhost</screen>
+ <para>To rectify this situation - we'll set the hostname by editing the
+ <filename>/etc/hosts</filename> file so that it follows a similar format to this example:<screen>
+127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4
+172.16.10.2 srvr1.cloud.priv
+</screen>
+ </para>
+ <para>After you've modified that file, go ahead and restart the network using:</para>
+<screen><prompt># </prompt><userinput><command>service</command> network restart</userinput></screen>
+ <para>Now recheck with the <command>hostname --fqdn</command> command and ensure that it returns
+ a FQDN response</para>
+ </section>
+ <section id="sect-Runbook-Environment-operatingsys-selinux">
+ <title>SELinux</title>
+ <para>At the moment, for CloudStack to work properly SELinux must be
+ set to permissive. We want to both configure this for future boots and modify it
+ in the current running system.
+ </para>
+ <para>To configure SELinux to be permissive in the running system we need to run
+ the following command:</para>
+ <screen><prompt># </prompt><userinput><command>setenforce</command> 0</userinput></screen>
+ <para>
+ To ensure that it remains in that state we need to configure the file
+ <filename>/etc/selinux/config</filename> to reflect the permissive state,
+ as shown in this example: </para>
+ <screen>
+
+# This file controls the state of SELinux on the system.
+# SELINUX= can take one of these three values:
+# enforcing - SELinux security policy is enforced.
+# permissive - SELinux prints warnings instead of enforcing.
+# disabled - No SELinux policy is loaded.
+SELINUX=permissive
+# SELINUXTYPE= can take one of these two values:
+# targeted - Targeted processes are protected,
+# mls - Multi Level Security protection.
+SELINUXTYPE=targeted
+ </screen>
+
+ </section>
+ <section id="sect-Runbook-Environment-operatingsys-ntp">
+ <title>NTP</title>
+ <para>NTP configuration is a necessity for keeping all of the clocks in your cloud
+ servers in sync. However, NTP is not installed by default. So we'll install and
+ and configure NTP at this stage. Installation is accomplished as follows:
+ </para>
+ <screen><prompt># </prompt><userinput><command>yum</command> install ntp</userinput></screen>
+ <para>The actual default configuration is fine for our purposes, so we merely need to
+ enable it and set it to start on boot as follows:</para>
+ <screen><prompt># </prompt><userinput><command>chkconfig</command> ntpd on</userinput></screen>
+ <screen><prompt># </prompt><userinput><command>service</command> ntpd start</userinput></screen>
+ </section>
+ </section>
+ <section id="sect-Runbook-Environment-nfs">
+ <title>NFS</title>
+ <para>
+ Our configuration is going to use NFS for both primary and secondary
+ storage. We are going to go ahead and setup two NFS shares for those
+ purposes. We'll start out by installing
+ <application>nfs-utils</application>.
+ </para>
+ <screen><prompt># </prompt><userinput><command>yum</command> install nfs-utils</userinput></screen>
+ <para>
+ We now need to configure NFS to serve up two different shares. This is handled comparatively easily
+ in the <filename>/etc/exports</filename> file. You should ensure that it has the following content:
+ </para>
+ <screen>
+/secondary *(rw,async,no_root_squash)
+/primary *(rw,async,no_root_squash)
+ </screen>
+ <para>
+ You will note that we specified two directories that don't exist (yet) on the system.
+ We'll go ahead and create those directories and set permissions appropriately on them with the following commands:
+ </para>
+ <screen>
+<prompt># </prompt><userinput><command>mkdir</command> /primary</userinput>
+<prompt># </prompt><userinput><command>mkdir</command> /secondary</userinput>
+<prompt># </prompt><userinput><command>chmod</command> 777 /primary</userinput>
+<prompt># </prompt><userinput><command>chmod</command> 777 /secondary</userinput>
+ </screen>
+ <para>CentOS 6.x releases use NFSv4 by default. NFSv4 requires that domain setting matches on all clients.
+ In our case, the domain is cloud.priv, so ensure that the domain setting in <filename>/etc/idmapd.conf</filename>
+ is uncommented and set as follows:</para>
+ <screen>Domain = cloud.priv</screen>
+ <para>Now you'll need uncomment the configuration values in the file <filename>/etc/sysconfig/nfs</filename></para>
+ <screen>
+LOCKD_TCPPORT=32803
+LOCKD_UDPPORT=32769
+MOUNTD_PORT=892
+RQUOTAD_PORT=875
+STATD_PORT=662
+STATD_OUTGOING_PORT=2020
+ </screen>
+ <para> Now we need to configure the firewall to permit incoming NFS connections.
+ Edit the file <filename>/etc/sysconfig/nfs</filename>
+ </para>
+ <screen>
+-A INPUT -m state --state NEW -p udp --dport 111 -j ACCEPT
+-A INPUT -m state --state NEW -p tcp --dport 111 -j ACCEPT
+-A INPUT -m state --state NEW -p tcp --dport 2049 -j ACCEPT
+-A INPUT -m state --state NEW -p tcp --dport 32803 -j ACCEPT
+-A INPUT -m state --state NEW -p udp --dport 32769 -j ACCEPT
+-A INPUT -m state --state NEW -p tcp --dport 892 -j ACCEPT
+-A INPUT -m state --state NEW -p udp --dport 892 -j ACCEPT
+-A INPUT -m state --state NEW -p tcp --dport 875 -j ACCEPT
+-A INPUT -m state --state NEW -p udp --dport 875 -j ACCEPT
+-A INPUT -m state --state NEW -p tcp --dport 662 -j ACCEPT
+-A INPUT -m state --state NEW -p udp --dport 662 -j ACCEPT
+ </screen>
+ <para>Now you can restart the iptables service with the following command:
+ </para>
+ <screen><prompt># </prompt><userinput><command>service</command> iptables restart</userinput></screen>
+ <para>We now need to configure nfs service to start on boot and actually start it on the host by
+ executing the following commands:</para>
+ <screen>
+ <prompt># </prompt><userinput><command>service</command> rpcbind start</userinput>
+ <prompt># </prompt><userinput><command>service</command> nfs start</userinput>
+ <prompt># </prompt><userinput><command>chkconfig</command> rpcbind on</userinput>
+ <prompt># </prompt><userinput><command>chkconfig</command> nfs on</userinput>
+ </screen>
+ </section>
+
+
+</chapter>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Management.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Management.xml b/docs/runbook/en-US/Management.xml
new file mode 100644
index 0000000..2d915e4
--- /dev/null
+++ b/docs/runbook/en-US/Management.xml
@@ -0,0 +1,107 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Management">
+ <title>Installation of the management server</title>
+ <para>
+ Now it is time to start installing CloudStack's management server
+ and some of the related components.
+ </para>
+ <section id="sect-Runbook-Management-database">
+ <title>Database Installation and Configuration</title>
+ <para>
+ We'll start out by installing <application>MySQL</application> and configuring
+ some options to ensure CloudStack runs well.
+ </para>
+ <para>
+ To install <application>MySQL</application> run the following command:
+ <screen><prompt># </prompt><userinput><command>yum</command> -y install mysql-server</userinput></screen>
+ </para>
+ <para>With <application>MySQL</application> installed we need to make
+ a few configuration changes to <filename>/etc/my.cnf</filename>.
+ Specifically we need to add the following options to the [mysqld] section:
+ <screen>
+innodb_rollback_on_timeout=1
+innodb_lock_wait_timeout=600
+max_connections=350
+log-bin=mysql-bin
+binlog-format = 'ROW'
+ </screen>
+ </para>
+ <para>
+ Now that <application>MySQL</application> is properly configured we can
+ start it and configure it to start on boot as follows:
+ <screen>
+ <prompt># </prompt><userinput><command>service</command> mysqld start</userinput>
+ <prompt># </prompt><userinput><command>chkconfig</command> mysqld on</userinput>
+ </screen>
+ </para>
+
+ </section>
+
+ <section id="sect-Runbook-Management-extraction">
+ <title>Extraction</title>
+ <para>
+ The next step is to extract the contents of the CloudStack tarball
+ (mentioned in <xref linkend="sect-Runbook-Overview-prereqs" />) you
+ downloaded previously. To extract the contents of this tarball use
+ the following command:
+ </para>
+ <screen>
+ <prompt># </prompt><userinput><command>tar</command> -xzvf CloudStack-oss-3.0.2-1-rhel6.2.tar.gz</userinput>
+ </screen>
+ <para> For the next few sections you'll need to <command>cd</command> into the first level that was just created.
+ </para>
+ </section>
+ <section id="sect-Runbook-Management-installation">
+ <title>Installation</title>
+ <para>Now that you are in the directory created by extracting the tarball, it's now time to install. We'll run
+ <filename>./install.sh</filename> and choose option <option>M</option>. This will install the management server
+ and necessary dependencies.
+ </para>
+ <para>With the application itself installed we can now setup the database, we'll do that with the following command
+ and options:
+ </para>
+ <screen>
+ <prompt># </prompt><userinput><command>cloud-setup-databases</command> cloud:<replaceable>password</replaceable>@localhost --deploy-as=root</userinput>
+ </screen>
+ <para>When this process is finished, you should see a message like "CloudStack has successfully initialized the database."
+ </para>
+ <para>Now that the database has been created, we can take the final step in setting up the management server by issuing the following command:</para>
+ <screen>
+ <prompt># </prompt><userinput><command>cloud-setup-mangament</command></userinput>
+ </screen>
+ </section>
+ <section id="sect-Runbook-Management-templatesetup">
+ <title>System Template Setup</title>
+ <para>CloudStack uses a number of system VMs to provide functionality for
+ accessing the console of virtual machines, providing various networking
+ services, and managing various aspects of storage. This step will
+ acquire those system images ready for deployment when we bootstrap
+ your cloud.
+ </para>
+ <para>
+ The place we are going to download these images to is the secondary
+ storage share that we setup earlier, so we'll need to mount that share
+ with the <command>mount</command> command run on the management server:
+ </para>
+ <screen>
+ <prompt># </prompt><userinput><command>mount</command> -t nfs <replaceable>172.16.10.</replaceable>2/secondary /mnt/secondary</userinput>
+ </screen>
+ <para>
+ Now we need to download the system VM template and deploy that to the
+ share we just mounted. The management server includes a script to properly
+ manipulate the system VMs images.
+ </para>
+ <screen>
+ <prompt># </prompt><userinput><command>/usr/lib64/cloud/agent/scripts/storage/secondary/cloud-install-sys-tmplt</command> -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2 -h kvm -F</userinput>
+ </screen>
+ <para>
+ That concludes our setup of the management server. We still need to
+ configure CloudStack, but we will do that after we get our hypervisor
+ set up.
+ </para>
+ </section>
+</chapter>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Overview.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Overview.xml b/docs/runbook/en-US/Overview.xml
new file mode 100644
index 0000000..b0bca9d
--- /dev/null
+++ b/docs/runbook/en-US/Overview.xml
@@ -0,0 +1,67 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Overview">
+ <title>Overview</title>
+ <para>
+ Infrastructure-as-a-Service (IaaS) clouds can be a complex thing to build,
+ and by definition they have a plethora of options, which often lead to confusion
+ for even experienced admins who are newcomers to building cloud platforms.
+ The goal for this runbook is to provide a straightforward set of instructions
+ to get you up and running with CloudStack with a minimum amount of trouble.
+ </para>
+ <section id="sect-Runbook-Overview-What_building">
+ <title>What exactly are we building?</title>
+ <para>
+ This runbook will focus on building a CloudStack cloud using KVM with
+ CentOS 6.2 with NFS storage utilizing Layer-3 for network isolation
+ (aka Security Groups).
+ </para>
+ <para>
+ KVM, or Kernel-based Virtual Machine is a virtualization technology
+ for the Linux kernel. KVM supports native virtualization atop
+ processors with hardware virtualization extensions.
+ </para>
+ <para>
+ Security Groups act as distributed firewalls that control access
+ to a group of virtual machines.
+ </para>
+ </section>
+
+ <section id="sect-Runbook-Overview-prereqs">
+ <title>Prerequisites</title>
+ <para>
+ To complete this runbook you'll need the following items:
+ <orderedlist>
+ <listitem>
+ <para>
+ At least one computer which supports hardware virtualization.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The CentOS 6.2 x86_64 minimal installation CD available from here:
+ <ulink url="http://mirrors.kernel.org/centos/6.2/isos/x86_64/CentOS-6.2-x86_64-minimal.iso">
+ </ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A /24 network with the gateway being at xxx.xxx.xxx.1, no DHCP should be on this network and
+ none of the computers running CloudStack may have a dynamic address.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Copy of CloudStack 3.0.2 for Red Hat Enterprise Linux (RHEL) and CentOS 6.2 available here:
+ <ulink url="http://sourceforge.net/projects/cloudstack/files/CloudStack%20Acton/3.0.2/CloudStack-oss-3.0.2-1-rhel6.2.tar.gz/download">
+ </ulink>
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </section>
+
+</chapter>
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Preface.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Preface.xml b/docs/runbook/en-US/Preface.xml
new file mode 100644
index 0000000..ff399fa
--- /dev/null
+++ b/docs/runbook/en-US/Preface.xml
@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-Runbook-Preface">
+ <title>Preface</title>
+ <xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
+ </xi:include>
+</preface>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Revision_History.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Revision_History.xml b/docs/runbook/en-US/Revision_History.xml
new file mode 100644
index 0000000..263cd93
--- /dev/null
+++ b/docs/runbook/en-US/Revision_History.xml
@@ -0,0 +1,22 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<appendix id="appe-Runbook-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0-0</revnumber>
+ <date>Mon Jun 25 2012</date>
+ <revdescription>
+ <simplelist>
+ <member>Initial creation of book by publican</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Runbook.ent
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Runbook.ent b/docs/runbook/en-US/Runbook.ent
new file mode 100644
index 0000000..535d45a
--- /dev/null
+++ b/docs/runbook/en-US/Runbook.ent
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "Apache CloudStack">
+<!ENTITY BOOKID "Runbook">
+<!ENTITY YEAR "2012">
+<!ENTITY HOLDER "Apache Software Foundation">
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/Runbook.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/Runbook.xml b/docs/runbook/en-US/Runbook.xml
new file mode 100644
index 0000000..f700a17
--- /dev/null
+++ b/docs/runbook/en-US/Runbook.xml
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Environment.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Management.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="kvm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="config.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- <index /> -->
+</book>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/3ae274a4/docs/runbook/en-US/config.xml
----------------------------------------------------------------------
diff --git a/docs/runbook/en-US/config.xml b/docs/runbook/en-US/config.xml
new file mode 100644
index 0000000..29a04f5
--- /dev/null
+++ b/docs/runbook/en-US/config.xml
@@ -0,0 +1,159 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Runbook.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Runbook-Config">
+ <title>Configuration</title>
+ <para>
+ As we noted before we will be using security groups to provide isolation
+ and by default that implies that we'll be using a flat layer-2 network.
+ It also means that the simplicity of our setup means that we can use the
+ quick installer.
+ </para>
+ <section id="sect-Runbook-Config-UI_Access">
+ <title>UI Access</title>
+ <para>
+ To get access to CloudStack's web interface, merely point your
+ browser to http://<replaceable>172.16.10.</replaceable>2:8080/client
+ The default username is 'admin', and the default password is 'password'.
+ You should see a splash screen that allows you to choose several options
+ for setting up CloudStack. You should choose the
+ <option>Continue with Basic Setup</option> option.
+ </para>
+ <para>
+ You should now see a prompt requiring you to change the password for
+ the admin user. Please do so.
+ </para>
+ </section>
+ <section id="sect-Runbook-Config-Zone">
+ <title>Setting up a Zone</title>
+ <para>
+ A zone is the largest organization entity in CloudStack - and we'll be creating one, this
+ should be the screen that you see in front of you now. And for us there are 5 pieces of
+ information that we need.
+ <orderedlist>
+ <listitem>
+ <para>Name - we will set this to the ever-descriptive 'Zone1' for our cloud.</para>
+ </listitem>
+ <listitem>
+ <para>Public DNS 1 - we will set this to '8.8.8.8' for our cloud.</para>
+ </listitem>
+ <listitem>
+ <para>Public DNS 2 - we will set this to '8.8.4.4' for our cloud.</para>
+ </listitem>
+ <listitem>
+ <para>Internal DNS1 - we will also set this to '8.8.8.8' for our cloud.</para>
+ </listitem>
+ <listitem>
+ <para>Internal DNS2 - we will also set this to '8.8.8.4' for our cloud.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <note>
+ <title>Notes about DNS settings</title>
+ <para>
+ CloudStack distinguishes between internal and public DNS. Internal
+ DNS is assumed to be capable of resolving internal-only
+ hostnames, such as your NFS server’s DNS name. Public DNS is
+ provided to the guest VMs to resolve public IP addresses. You can
+ enter the same DNS server for both types, but if you do so, you
+ must make sure that both internal and public IP addresses can
+ route to the DNS server. In our specific case we will not use any
+ names for resources internally, and we have indeed them set to look
+ to the same external resource so as to not add a namerserver setup
+ to our list of requirements.
+ </para>
+ </note>
+ </section>
+ <section id="sect-Runbook-Config-Pod">
+ <title>Pod Configuration</title>
+ <para>Now that we've added a Zone, the next step that comes up is a prompt
+ for information regading a pod. Which is looking for 4 items.
+ <orderedlist>
+ <listitem>
+ <para>Name - We'll use Pod1 for our cloud.</para>
+ </listitem>
+ <listitem>
+ <para>Gateway - We'll use <replaceable>172.16.10</replaceable>.1 as our gateway</para>
+ </listitem>
+ <listitem>
+ <para>Netmask - We'll use 255.255.255.0</para>
+ </listitem>
+ <listitem>
+ <para>Start/end reserved system IPs - we will use 172.16.10.10-172.16.10.20 </para>
+ </listitem>
+ <listitem>
+ <para>Guest gateway - We'll use <replaceable>172.16.10</replaceable>.1</para>
+ </listitem>
+ <listitem>
+ <para>Guest netmask - We'll use 255.255.255.0</para>
+ </listitem>
+ <listitem>
+ <para>Guest start/end IP - We'll use <replaceable>172.16.10.</replaceable>30-<replaceable>172.16.10.</replaceable>200</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </section>
+ <section id="Runbook-config-cluster">
+ <title>Cluster</title>
+ <para> Now that we've added a Zone, we need only add a few more items for configuring the cluster.
+ <orderedlist>
+ <listitem>
+ <para>Name - We'll use Cluster1</para>
+ </listitem>
+ <listitem>
+ <para>Hypervisor - If this is the first cluster, you may have already been prompted for which hypervisor you were going to use, in which case this will
+ be a read-only field. Otherwise choose KVM
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para> You should be prompted to add the first host to your cluster at this point. Only a few bits of information are needed.
+ <orderedlist>
+ <listitem>
+ <para>Hostname - we'll use the IP address <replaceable>172.16.10.</replaceable>2 since we didn't set up a DNS server.</para>
+ </listitem>
+ <listitem>
+ <para>Username - we'll use 'root' </para>
+ </listitem>
+ <listitem>
+ <para>Password - enter the operating system password for the root user</para>
+ </listitem>
+ <listitem>
+ <para>Host tags - This is an optional field and we will leave it blank</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <section id="Runbook-config-cluster-pristorage">
+ <title>Primary Storage</title>
+ <para>With you cluster now setup - you should be prompted for primary storage information. Choose NFS as the storage type and then enter the following values in the fields:
+ <orderedlist>
+ <listitem>
+ <para>Server - We'll be using the IP address <replaceable>172.16.10.</replaceable>2</para>
+ </listitem>
+ <listitem>
+ <para>Path - Well define /primary as the path we are using </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </section>
+ <section id="Runbook-config-cluster-secstorage">
+ <title>Secondary Storage</title>
+ <para> If this is a new zone, you'll be prompted for secondary storage information - populate it as follows:
+ <orderedlist>
+ <listitem>
+ <para>NFS server - We'll use the IP address <replaceable>172.16.10.</replaceable>2</para>
+ </listitem>
+ <listitem>
+ <para>Path - We'll use /secondary</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para> Now, click Launch and your cloud should begin setup - it may take several minutes depending on your internet connection speed for setup to finalize.</para>
+ </section>
+ </section>
+
+
+</chapter>
+