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 2013/10/08 21:27:37 UTC
[33/70] [partial] Adding documents from 4.2
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/egress-firewall-rule.png
----------------------------------------------------------------------
diff --git a/en-US/images/egress-firewall-rule.png b/en-US/images/egress-firewall-rule.png
new file mode 100644
index 0000000..fa1d8ec
Binary files /dev/null and b/en-US/images/egress-firewall-rule.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/eip-ns-basiczone.png
----------------------------------------------------------------------
diff --git a/en-US/images/eip-ns-basiczone.png b/en-US/images/eip-ns-basiczone.png
new file mode 100644
index 0000000..bc88570
Binary files /dev/null and b/en-US/images/eip-ns-basiczone.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/enable-disable-autoscale.png
----------------------------------------------------------------------
diff --git a/en-US/images/enable-disable-autoscale.png b/en-US/images/enable-disable-autoscale.png
new file mode 100644
index 0000000..ee02ef2
Binary files /dev/null and b/en-US/images/enable-disable-autoscale.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/enable-disable.png
----------------------------------------------------------------------
diff --git a/en-US/images/enable-disable.png b/en-US/images/enable-disable.png
new file mode 100644
index 0000000..cab31ae
Binary files /dev/null and b/en-US/images/enable-disable.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/gslb.png
----------------------------------------------------------------------
diff --git a/en-US/images/gslb.png b/en-US/images/gslb.png
new file mode 100644
index 0000000..f0a04db
Binary files /dev/null and b/en-US/images/gslb.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/guest-traffic-setup.png
----------------------------------------------------------------------
diff --git a/en-US/images/guest-traffic-setup.png b/en-US/images/guest-traffic-setup.png
new file mode 100644
index 0000000..5250819
Binary files /dev/null and b/en-US/images/guest-traffic-setup.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/http-access.png
----------------------------------------------------------------------
diff --git a/en-US/images/http-access.png b/en-US/images/http-access.png
new file mode 100644
index 0000000..817f197
Binary files /dev/null and b/en-US/images/http-access.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/icon.svg
----------------------------------------------------------------------
diff --git a/en-US/images/icon.svg b/en-US/images/icon.svg
new file mode 100644
index 0000000..37f94c0
--- /dev/null
+++ b/en-US/images/icon.svg
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+<svg xmlns:svg="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.0" width="32" height="32" id="svg3017">
+ <defs id="defs3019">
+ <linearGradient id="linearGradient2381">
+ <stop id="stop2383" style="stop-color:#ffffff;stop-opacity:1" offset="0"/>
+ <stop id="stop2385" style="stop-color:#ffffff;stop-opacity:0" offset="1"/>
+ </linearGradient>
+ <linearGradient x1="296.4996" y1="188.81061" x2="317.32471" y2="209.69398" id="linearGradient2371" xlink:href="#linearGradient2381" gradientUnits="userSpaceOnUse" gradientTransform="matrix(0.90776,0,0,0.90776,24.35648,49.24131)"/>
+ </defs>
+ <g transform="matrix(0.437808,-0.437808,0.437808,0.437808,-220.8237,43.55311)" id="g5089">
+ <path d="m 8.4382985,-6.28125 c -0.6073916,0 -4.3132985,5.94886271 -4.3132985,8.25 l 0,26.71875 c 0,0.846384 0.5818159,1.125 1.15625,1.125 l 25.5625,0 c 0.632342,0 1.125001,-0.492658 1.125,-1.125 l 0,-5.21875 0.28125,0 c 0.49684,0 0.906249,-0.409411 0.90625,-0.90625 l 0,-27.9375 c 0,-0.4968398 -0.40941,-0.90625 -0.90625,-0.90625 l -23.8117015,0 z" transform="translate(282.8327,227.1903)" id="path5091" style="fill:#5c5c4f;stroke:#000000;stroke-width:3.23021388;stroke-miterlimit:4;stroke-dasharray:none"/>
+ <rect width="27.85074" height="29.369793" rx="1.1414107" ry="1.1414107" x="286.96509" y="227.63805" id="rect5093" style="fill:#032c87"/>
+ <path d="m 288.43262,225.43675 25.2418,0 0,29.3698 -26.37615,0.0241 1.13435,-29.39394 z" id="rect5095" style="fill:#ffffff"/>
+ <path d="m 302.44536,251.73726 c 1.38691,7.85917 -0.69311,11.28365 -0.69311,11.28365 2.24384,-1.60762 3.96426,-3.47694 4.90522,-5.736 0.96708,2.19264 1.83294,4.42866 4.27443,5.98941 0,0 -1.59504,-7.2004 -1.71143,-11.53706 l -6.77511,0 z" id="path5097" style="fill:#a70000;fill-opacity:1;stroke-width:2"/>
+ <rect width="25.241802" height="29.736675" rx="0.89682275" ry="0.89682275" x="290.73544" y="220.92249" id="rect5099" style="fill:#809cc9"/>
+ <path d="m 576.47347,725.93939 6.37084,0.41502 0.4069,29.51809 c -1.89202,-1.31785 -6.85427,-3.7608 -8.26232,-1.68101 l 0,-26.76752 c 0,-0.82246 0.66212,-1.48458 1.48458,-1.48458 z" transform="matrix(0.499065,-0.866565,0,1,0,0)" id="rect5101" style="fill:#4573b3;fill-opacity:1"/>
+ <path d="m 293.2599,221.89363 20.73918,0 c 0.45101,0 0.8141,0.3631 0.8141,0.81411 0.21547,6.32836 -19.36824,21.7635 -22.36739,17.59717 l 0,-17.59717 c 0,-0.45101 0.3631,-0.81411 0.81411,-0.81411 z" id="path5103" style="opacity:0.65536726;fill:url(#linearGradient2371);fill-opacity:1"/>
+ </g>
+</svg>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/infrastructure-overview.png
----------------------------------------------------------------------
diff --git a/en-US/images/infrastructure-overview.png b/en-US/images/infrastructure-overview.png
new file mode 100644
index 0000000..24aeecf
Binary files /dev/null and b/en-US/images/infrastructure-overview.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/installation-complete.png
----------------------------------------------------------------------
diff --git a/en-US/images/installation-complete.png b/en-US/images/installation-complete.png
new file mode 100644
index 0000000..4626f86
Binary files /dev/null and b/en-US/images/installation-complete.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/iso-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/iso-icon.png b/en-US/images/iso-icon.png
new file mode 100644
index 0000000..8d547fb
Binary files /dev/null and b/en-US/images/iso-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/large-scale-redundant-setup.png
----------------------------------------------------------------------
diff --git a/en-US/images/large-scale-redundant-setup.png b/en-US/images/large-scale-redundant-setup.png
new file mode 100644
index 0000000..5d2581a
Binary files /dev/null and b/en-US/images/large-scale-redundant-setup.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/mesos-integration-arch.jpg
----------------------------------------------------------------------
diff --git a/en-US/images/mesos-integration-arch.jpg b/en-US/images/mesos-integration-arch.jpg
new file mode 100644
index 0000000..e69de29
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/migrate-instance.png
----------------------------------------------------------------------
diff --git a/en-US/images/migrate-instance.png b/en-US/images/migrate-instance.png
new file mode 100644
index 0000000..25ff572
Binary files /dev/null and b/en-US/images/migrate-instance.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/multi-node-management-server.png
----------------------------------------------------------------------
diff --git a/en-US/images/multi-node-management-server.png b/en-US/images/multi-node-management-server.png
new file mode 100644
index 0000000..5cf5ed5
Binary files /dev/null and b/en-US/images/multi-node-management-server.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/multi-site-deployment.png
----------------------------------------------------------------------
diff --git a/en-US/images/multi-site-deployment.png b/en-US/images/multi-site-deployment.png
new file mode 100644
index 0000000..f3ae5bb
Binary files /dev/null and b/en-US/images/multi-site-deployment.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/multi-tier-app.png
----------------------------------------------------------------------
diff --git a/en-US/images/multi-tier-app.png b/en-US/images/multi-tier-app.png
new file mode 100644
index 0000000..cec1122
Binary files /dev/null and b/en-US/images/multi-tier-app.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/network-acl.png
----------------------------------------------------------------------
diff --git a/en-US/images/network-acl.png b/en-US/images/network-acl.png
new file mode 100644
index 0000000..5602827
Binary files /dev/null and b/en-US/images/network-acl.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/network-setup-zone.png
----------------------------------------------------------------------
diff --git a/en-US/images/network-setup-zone.png b/en-US/images/network-setup-zone.png
new file mode 100644
index 0000000..8324ff8
Binary files /dev/null and b/en-US/images/network-setup-zone.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/network-singlepod.png
----------------------------------------------------------------------
diff --git a/en-US/images/network-singlepod.png b/en-US/images/network-singlepod.png
new file mode 100644
index 0000000..e1214ea
Binary files /dev/null and b/en-US/images/network-singlepod.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/networking-in-a-pod.png
----------------------------------------------------------------------
diff --git a/en-US/images/networking-in-a-pod.png b/en-US/images/networking-in-a-pod.png
new file mode 100644
index 0000000..bf73171
Binary files /dev/null and b/en-US/images/networking-in-a-pod.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/networking-in-a-zone.png
----------------------------------------------------------------------
diff --git a/en-US/images/networking-in-a-zone.png b/en-US/images/networking-in-a-zone.png
new file mode 100644
index 0000000..fb740da
Binary files /dev/null and b/en-US/images/networking-in-a-zone.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/nic-bonding-and-multipath-io.png
----------------------------------------------------------------------
diff --git a/en-US/images/nic-bonding-and-multipath-io.png b/en-US/images/nic-bonding-and-multipath-io.png
new file mode 100644
index 0000000..0fe60b6
Binary files /dev/null and b/en-US/images/nic-bonding-and-multipath-io.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/nvp-add-controller.png
----------------------------------------------------------------------
diff --git a/en-US/images/nvp-add-controller.png b/en-US/images/nvp-add-controller.png
new file mode 100644
index 0000000..e02d31f
Binary files /dev/null and b/en-US/images/nvp-add-controller.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/nvp-enable-provider.png
----------------------------------------------------------------------
diff --git a/en-US/images/nvp-enable-provider.png b/en-US/images/nvp-enable-provider.png
new file mode 100644
index 0000000..0f2d02d
Binary files /dev/null and b/en-US/images/nvp-enable-provider.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/nvp-network-offering.png
----------------------------------------------------------------------
diff --git a/en-US/images/nvp-network-offering.png b/en-US/images/nvp-network-offering.png
new file mode 100644
index 0000000..c2d25c4
Binary files /dev/null and b/en-US/images/nvp-network-offering.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/nvp-physical-network-stt.png
----------------------------------------------------------------------
diff --git a/en-US/images/nvp-physical-network-stt.png b/en-US/images/nvp-physical-network-stt.png
new file mode 100644
index 0000000..2ce7853
Binary files /dev/null and b/en-US/images/nvp-physical-network-stt.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/nvp-vpc-offering-edit.png
----------------------------------------------------------------------
diff --git a/en-US/images/nvp-vpc-offering-edit.png b/en-US/images/nvp-vpc-offering-edit.png
new file mode 100644
index 0000000..ff235e2
Binary files /dev/null and b/en-US/images/nvp-vpc-offering-edit.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/parallel-mode.png
----------------------------------------------------------------------
diff --git a/en-US/images/parallel-mode.png b/en-US/images/parallel-mode.png
new file mode 100644
index 0000000..3b67a17
Binary files /dev/null and b/en-US/images/parallel-mode.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/plugin1.jpg
----------------------------------------------------------------------
diff --git a/en-US/images/plugin1.jpg b/en-US/images/plugin1.jpg
new file mode 100644
index 0000000..970233d
Binary files /dev/null and b/en-US/images/plugin1.jpg differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/plugin2.jpg
----------------------------------------------------------------------
diff --git a/en-US/images/plugin2.jpg b/en-US/images/plugin2.jpg
new file mode 100644
index 0000000..9c8a610
Binary files /dev/null and b/en-US/images/plugin2.jpg differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/plugin3.jpg
----------------------------------------------------------------------
diff --git a/en-US/images/plugin3.jpg b/en-US/images/plugin3.jpg
new file mode 100644
index 0000000..07fae79
Binary files /dev/null and b/en-US/images/plugin3.jpg differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/plugin4.jpg
----------------------------------------------------------------------
diff --git a/en-US/images/plugin4.jpg b/en-US/images/plugin4.jpg
new file mode 100644
index 0000000..2bcec9f
Binary files /dev/null and b/en-US/images/plugin4.jpg differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/plugin_intro.jpg
----------------------------------------------------------------------
diff --git a/en-US/images/plugin_intro.jpg b/en-US/images/plugin_intro.jpg
new file mode 100644
index 0000000..113ffb3
Binary files /dev/null and b/en-US/images/plugin_intro.jpg differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/pod-overview.png
----------------------------------------------------------------------
diff --git a/en-US/images/pod-overview.png b/en-US/images/pod-overview.png
new file mode 100644
index 0000000..c180060
Binary files /dev/null and b/en-US/images/pod-overview.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/provisioning-overview.png
----------------------------------------------------------------------
diff --git a/en-US/images/provisioning-overview.png b/en-US/images/provisioning-overview.png
new file mode 100644
index 0000000..25cc97e
Binary files /dev/null and b/en-US/images/provisioning-overview.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/region-overview.png
----------------------------------------------------------------------
diff --git a/en-US/images/region-overview.png b/en-US/images/region-overview.png
new file mode 100644
index 0000000..528445c
Binary files /dev/null and b/en-US/images/region-overview.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/release-ip-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/release-ip-icon.png b/en-US/images/release-ip-icon.png
new file mode 100644
index 0000000..aa9846c
Binary files /dev/null and b/en-US/images/release-ip-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/remove-nic.png
----------------------------------------------------------------------
diff --git a/en-US/images/remove-nic.png b/en-US/images/remove-nic.png
new file mode 100644
index 0000000..27145ce
Binary files /dev/null and b/en-US/images/remove-nic.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/remove-tier.png
----------------------------------------------------------------------
diff --git a/en-US/images/remove-tier.png b/en-US/images/remove-tier.png
new file mode 100644
index 0000000..e14d08f
Binary files /dev/null and b/en-US/images/remove-tier.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/remove-vpc.png
----------------------------------------------------------------------
diff --git a/en-US/images/remove-vpc.png b/en-US/images/remove-vpc.png
new file mode 100644
index 0000000..aa9846c
Binary files /dev/null and b/en-US/images/remove-vpc.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/remove-vpn.png
----------------------------------------------------------------------
diff --git a/en-US/images/remove-vpn.png b/en-US/images/remove-vpn.png
new file mode 100644
index 0000000..27145ce
Binary files /dev/null and b/en-US/images/remove-vpn.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/replace-acl-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/replace-acl-icon.png b/en-US/images/replace-acl-icon.png
new file mode 100644
index 0000000..ae953ba
Binary files /dev/null and b/en-US/images/replace-acl-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/replace-acl-list.png
----------------------------------------------------------------------
diff --git a/en-US/images/replace-acl-list.png b/en-US/images/replace-acl-list.png
new file mode 100644
index 0000000..3375017
Binary files /dev/null and b/en-US/images/replace-acl-list.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/reset-vpn.png
----------------------------------------------------------------------
diff --git a/en-US/images/reset-vpn.png b/en-US/images/reset-vpn.png
new file mode 100644
index 0000000..04655dc
Binary files /dev/null and b/en-US/images/reset-vpn.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/resize-volume-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/resize-volume-icon.png b/en-US/images/resize-volume-icon.png
new file mode 100644
index 0000000..4849902
Binary files /dev/null and b/en-US/images/resize-volume-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/resize-volume.png
----------------------------------------------------------------------
diff --git a/en-US/images/resize-volume.png b/en-US/images/resize-volume.png
new file mode 100644
index 0000000..6195623
Binary files /dev/null and b/en-US/images/resize-volume.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/restart-vpc.png
----------------------------------------------------------------------
diff --git a/en-US/images/restart-vpc.png b/en-US/images/restart-vpc.png
new file mode 100644
index 0000000..04655dc
Binary files /dev/null and b/en-US/images/restart-vpc.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/revert-vm.png
----------------------------------------------------------------------
diff --git a/en-US/images/revert-vm.png b/en-US/images/revert-vm.png
new file mode 100644
index 0000000..04655dc
Binary files /dev/null and b/en-US/images/revert-vm.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/search-button.png
----------------------------------------------------------------------
diff --git a/en-US/images/search-button.png b/en-US/images/search-button.png
new file mode 100644
index 0000000..f329aef
Binary files /dev/null and b/en-US/images/search-button.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/select-vm-staticnat-vpc.png
----------------------------------------------------------------------
diff --git a/en-US/images/select-vm-staticnat-vpc.png b/en-US/images/select-vm-staticnat-vpc.png
new file mode 100644
index 0000000..12fde26
Binary files /dev/null and b/en-US/images/select-vm-staticnat-vpc.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/separate-storage-network.png
----------------------------------------------------------------------
diff --git a/en-US/images/separate-storage-network.png b/en-US/images/separate-storage-network.png
new file mode 100644
index 0000000..24dbbef
Binary files /dev/null and b/en-US/images/separate-storage-network.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/set-default-nic.png
----------------------------------------------------------------------
diff --git a/en-US/images/set-default-nic.png b/en-US/images/set-default-nic.png
new file mode 100644
index 0000000..f329aef
Binary files /dev/null and b/en-US/images/set-default-nic.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/small-scale-deployment.png
----------------------------------------------------------------------
diff --git a/en-US/images/small-scale-deployment.png b/en-US/images/small-scale-deployment.png
new file mode 100644
index 0000000..1c88520
Binary files /dev/null and b/en-US/images/small-scale-deployment.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/software-license.png
----------------------------------------------------------------------
diff --git a/en-US/images/software-license.png b/en-US/images/software-license.png
new file mode 100644
index 0000000..67aa255
Binary files /dev/null and b/en-US/images/software-license.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/stop-instance-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/stop-instance-icon.png b/en-US/images/stop-instance-icon.png
new file mode 100644
index 0000000..209afce
Binary files /dev/null and b/en-US/images/stop-instance-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/suspend-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/suspend-icon.png b/en-US/images/suspend-icon.png
new file mode 100644
index 0000000..cab31ae
Binary files /dev/null and b/en-US/images/suspend-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/sysmanager.png
----------------------------------------------------------------------
diff --git a/en-US/images/sysmanager.png b/en-US/images/sysmanager.png
new file mode 100644
index 0000000..5b9df34
Binary files /dev/null and b/en-US/images/sysmanager.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/traffic-type.png
----------------------------------------------------------------------
diff --git a/en-US/images/traffic-type.png b/en-US/images/traffic-type.png
new file mode 100644
index 0000000..10d5ddb
Binary files /dev/null and b/en-US/images/traffic-type.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vds-name.png
----------------------------------------------------------------------
diff --git a/en-US/images/vds-name.png b/en-US/images/vds-name.png
new file mode 100644
index 0000000..bf5b4fc
Binary files /dev/null and b/en-US/images/vds-name.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/view-console-button.png
----------------------------------------------------------------------
diff --git a/en-US/images/view-console-button.png b/en-US/images/view-console-button.png
new file mode 100644
index 0000000..b321cea
Binary files /dev/null and b/en-US/images/view-console-button.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/view-systemvm-details.png
----------------------------------------------------------------------
diff --git a/en-US/images/view-systemvm-details.png b/en-US/images/view-systemvm-details.png
new file mode 100755
index 0000000..bce270b
Binary files /dev/null and b/en-US/images/view-systemvm-details.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vm-lifecycle.png
----------------------------------------------------------------------
diff --git a/en-US/images/vm-lifecycle.png b/en-US/images/vm-lifecycle.png
new file mode 100644
index 0000000..97823fc
Binary files /dev/null and b/en-US/images/vm-lifecycle.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-increase-ports.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-increase-ports.png b/en-US/images/vmware-increase-ports.png
new file mode 100644
index 0000000..fe96815
Binary files /dev/null and b/en-US/images/vmware-increase-ports.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-iscsi-datastore.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-iscsi-datastore.png b/en-US/images/vmware-iscsi-datastore.png
new file mode 100644
index 0000000..9f6b33f
Binary files /dev/null and b/en-US/images/vmware-iscsi-datastore.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-iscsi-general.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-iscsi-general.png b/en-US/images/vmware-iscsi-general.png
new file mode 100644
index 0000000..863602b
Binary files /dev/null and b/en-US/images/vmware-iscsi-general.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-iscsi-initiator-properties.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-iscsi-initiator-properties.png b/en-US/images/vmware-iscsi-initiator-properties.png
new file mode 100644
index 0000000..1fab031
Binary files /dev/null and b/en-US/images/vmware-iscsi-initiator-properties.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-iscsi-initiator.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-iscsi-initiator.png b/en-US/images/vmware-iscsi-initiator.png
new file mode 100644
index 0000000..a9a8301
Binary files /dev/null and b/en-US/images/vmware-iscsi-initiator.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-iscsi-target-add.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-iscsi-target-add.png b/en-US/images/vmware-iscsi-target-add.png
new file mode 100644
index 0000000..f016da7
Binary files /dev/null and b/en-US/images/vmware-iscsi-target-add.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-mgt-network-properties.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-mgt-network-properties.png b/en-US/images/vmware-mgt-network-properties.png
new file mode 100644
index 0000000..9141af9
Binary files /dev/null and b/en-US/images/vmware-mgt-network-properties.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-nexus-add-cluster.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-nexus-add-cluster.png b/en-US/images/vmware-nexus-add-cluster.png
new file mode 100644
index 0000000..7c1dd73
Binary files /dev/null and b/en-US/images/vmware-nexus-add-cluster.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-nexus-port-profile.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-nexus-port-profile.png b/en-US/images/vmware-nexus-port-profile.png
new file mode 100644
index 0000000..19b264f
Binary files /dev/null and b/en-US/images/vmware-nexus-port-profile.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-physical-network.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-physical-network.png b/en-US/images/vmware-physical-network.png
new file mode 100644
index 0000000..a7495c7
Binary files /dev/null and b/en-US/images/vmware-physical-network.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vmware-vswitch-properties.png
----------------------------------------------------------------------
diff --git a/en-US/images/vmware-vswitch-properties.png b/en-US/images/vmware-vswitch-properties.png
new file mode 100644
index 0000000..bc247d2
Binary files /dev/null and b/en-US/images/vmware-vswitch-properties.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vpc-lb.png
----------------------------------------------------------------------
diff --git a/en-US/images/vpc-lb.png b/en-US/images/vpc-lb.png
new file mode 100644
index 0000000..4269e8b
Binary files /dev/null and b/en-US/images/vpc-lb.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vpc-setting.png
----------------------------------------------------------------------
diff --git a/en-US/images/vpc-setting.png b/en-US/images/vpc-setting.png
new file mode 100644
index 0000000..782299e
Binary files /dev/null and b/en-US/images/vpc-setting.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vpn-icon.png
----------------------------------------------------------------------
diff --git a/en-US/images/vpn-icon.png b/en-US/images/vpn-icon.png
new file mode 100644
index 0000000..2ac12f7
Binary files /dev/null and b/en-US/images/vpn-icon.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/vsphere-client.png
----------------------------------------------------------------------
diff --git a/en-US/images/vsphere-client.png b/en-US/images/vsphere-client.png
new file mode 100644
index 0000000..2acc8b8
Binary files /dev/null and b/en-US/images/vsphere-client.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/workloads.png
----------------------------------------------------------------------
diff --git a/en-US/images/workloads.png b/en-US/images/workloads.png
new file mode 100644
index 0000000..a8334d9
Binary files /dev/null and b/en-US/images/workloads.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/images/zone-overview.png
----------------------------------------------------------------------
diff --git a/en-US/images/zone-overview.png b/en-US/images/zone-overview.png
new file mode 100644
index 0000000..24aeecf
Binary files /dev/null and b/en-US/images/zone-overview.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/import-ami.xml
----------------------------------------------------------------------
diff --git a/en-US/import-ami.xml b/en-US/import-ami.xml
new file mode 100644
index 0000000..16fe78a
--- /dev/null
+++ b/en-US/import-ami.xml
@@ -0,0 +1,114 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<section id="import-ami">
+ <title>Importing Amazon Machine Images</title>
+ <para>The following procedures describe how to import an Amazon Machine Image (AMI) into &PRODUCT; when using the XenServer hypervisor.</para>
+ <para>Assume you have an AMI file and this file is called CentOS_6.2_x64. Assume further that you are working on a CentOS host. If the AMI is a Fedora image, you need to be working on a Fedora host initially.</para>
+ <para>You need to have a XenServer host with a file-based storage repository (either a local ext3 SR or an NFS SR) to convert to a VHD once the image file has been customized on the Centos/Fedora host.</para>
+ <note><para>When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.</para>
+ </note>
+ <para></para>
+ <para>To import an AMI:</para>
+ <orderedlist>
+ <listitem><para>Set up loopback on image file:</para><programlisting># mkdir -p /mnt/loop/centos62
+# mount -o loop CentOS_6.2_x64 /mnt/loop/centos54
+</programlisting></listitem>
+ <listitem><para>Install the kernel-xen package into the image. This downloads the PV kernel and ramdisk to the image.</para><programlisting># yum -c /mnt/loop/centos54/etc/yum.conf --installroot=/mnt/loop/centos62/ -y install kernel-xen</programlisting></listitem>
+ <listitem><para>Create a grub entry in /boot/grub/grub.conf.</para><programlisting># mkdir -p /mnt/loop/centos62/boot/grub
+# touch /mnt/loop/centos62/boot/grub/grub.conf
+# echo "" > /mnt/loop/centos62/boot/grub/grub.conf
+</programlisting></listitem>
+ <listitem><para>Determine the name of the PV kernel that has been installed into the image.</para>
+ <programlisting># cd /mnt/loop/centos62
+# ls lib/modules/
+2.6.16.33-xenU 2.6.16-xenU 2.6.18-164.15.1.el5xen 2.6.18-164.6.1.el5.centos.plus 2.6.18-xenU-ec2-v1.0 2.6.21.7-2.fc8xen 2.6.31-302-ec2
+# ls boot/initrd*
+boot/initrd-2.6.18-164.6.1.el5.centos.plus.img boot/initrd-2.6.18-164.15.1.el5xen.img
+# ls boot/vmlinuz*
+boot/vmlinuz-2.6.18-164.15.1.el5xen boot/vmlinuz-2.6.18-164.6.1.el5.centos.plus boot/vmlinuz-2.6.18-xenU-ec2-v1.0 boot/vmlinuz-2.6.21-2952.fc8xen
+ </programlisting>
+ <para>Xen kernels/ramdisk always end with "xen". For the kernel version you choose, there has to be an entry for that version under lib/modules, there has to be an initrd and vmlinuz corresponding to that. Above, the only kernel that satisfies this condition is 2.6.18-164.15.1.el5xen.</para></listitem>
+ <listitem><para>Based on your findings, create an entry in the grub.conf file. Below is an example entry.</para><programlisting>default=0
+timeout=5
+hiddenmenu
+title CentOS (2.6.18-164.15.1.el5xen)
+ root (hd0,0)
+ kernel /boot/vmlinuz-2.6.18-164.15.1.el5xen ro root=/dev/xvda
+ initrd /boot/initrd-2.6.18-164.15.1.el5xen.img
+</programlisting></listitem>
+ <listitem><para>Edit etc/fstab, changing “sda1” to “xvda” and changing “sdb” to “xvdb”.</para>
+ <programlisting># cat etc/fstab
+/dev/xvda / ext3 defaults 1 1
+/dev/xvdb /mnt ext3 defaults 0 0
+none /dev/pts devpts gid=5,mode=620 0 0
+none /proc proc defaults 0 0
+none /sys sysfs defaults 0 0
+</programlisting></listitem>
+ <listitem><para>Enable login via the console. The default console device in a XenServer system is xvc0. Ensure that etc/inittab and etc/securetty have the following lines respectively:</para>
+ <programlisting># grep xvc0 etc/inittab
+co:2345:respawn:/sbin/agetty xvc0 9600 vt100-nav
+# grep xvc0 etc/securetty
+xvc0
+</programlisting></listitem>
+ <listitem><para>Ensure the ramdisk supports PV disk and PV network. Customize this for the kernel version you have determined above.</para>
+ <programlisting># chroot /mnt/loop/centos54
+# cd /boot/
+# mv initrd-2.6.18-164.15.1.el5xen.img initrd-2.6.18-164.15.1.el5xen.img.bak
+# mkinitrd -f /boot/initrd-2.6.18-164.15.1.el5xen.img --with=xennet --preload=xenblk --omit-scsi-modules 2.6.18-164.15.1.el5xen
+</programlisting></listitem>
+ <listitem><para>Change the password.</para>
+ <programlisting># passwd
+Changing password for user root.
+New UNIX password:
+Retype new UNIX password:
+passwd: all authentication tokens updated successfully.
+</programlisting></listitem>
+ <listitem><para>Exit out of chroot.</para><programlisting># exit</programlisting></listitem>
+ <listitem><para>Check etc/ssh/sshd_config for lines allowing ssh login using a password.</para>
+ <programlisting># egrep "PermitRootLogin|PasswordAuthentication" /mnt/loop/centos54/etc/ssh/sshd_config
+PermitRootLogin yes
+PasswordAuthentication yes
+</programlisting></listitem>
+ <listitem><para>If you need the template to be enabled to reset passwords from the &PRODUCT; UI or API,
+ install the password change script into the image at this point. See
+ <xref linkend="add-password-management-to-templates"/>.</para></listitem>
+ <listitem><para>Unmount and delete loopback mount.</para><programlisting># umount /mnt/loop/centos54
+# losetup -d /dev/loop0
+</programlisting></listitem>
+ <listitem><para>Copy the image file to your XenServer host's file-based storage repository. In the example below, the Xenserver is "xenhost". This XenServer has an NFS repository whose uuid is a9c5b8c8-536b-a193-a6dc-51af3e5ff799.</para>
+ <programlisting># scp CentOS_6.2_x64 xenhost:/var/run/sr-mount/a9c5b8c8-536b-a193-a6dc-51af3e5ff799/</programlisting></listitem>
+ <listitem><para>Log in to the Xenserver and create a VDI the same size as the image.</para>
+ <programlisting>[root@xenhost ~]# cd /var/run/sr-mount/a9c5b8c8-536b-a193-a6dc-51af3e5ff799
+[root@xenhost a9c5b8c8-536b-a193-a6dc-51af3e5ff799]# ls -lh CentOS_6.2_x64
+-rw-r--r-- 1 root root 10G Mar 16 16:49 CentOS_6.2_x64
+[root@xenhost a9c5b8c8-536b-a193-a6dc-51af3e5ff799]# xe vdi-create virtual-size=10GiB sr-uuid=a9c5b8c8-536b-a193-a6dc-51af3e5ff799 type=user name-label="Centos 6.2 x86_64"
+cad7317c-258b-4ef7-b207-cdf0283a7923
+</programlisting></listitem>
+ <listitem><para>Import the image file into the VDI. This may take 10–20 minutes.</para><programlisting>[root@xenhost a9c5b8c8-536b-a193-a6dc-51af3e5ff799]# xe vdi-import filename=CentOS_6.2_x64 uuid=cad7317c-258b-4ef7-b207-cdf0283a7923</programlisting></listitem>
+ <listitem><para>Locate a the VHD file. This is the file with the VDI’s UUID as its name. Compress it and upload it to your web server.</para>
+ <programlisting>[root@xenhost a9c5b8c8-536b-a193-a6dc-51af3e5ff799]# bzip2 -c cad7317c-258b-4ef7-b207-cdf0283a7923.vhd > CentOS_6.2_x64.vhd.bz2
+[root@xenhost a9c5b8c8-536b-a193-a6dc-51af3e5ff799]# scp CentOS_6.2_x64.vhd.bz2 webserver:/var/www/html/templates/
+</programlisting></listitem>
+ </orderedlist>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/increase-management-server-max-memory.xml
----------------------------------------------------------------------
diff --git a/en-US/increase-management-server-max-memory.xml b/en-US/increase-management-server-max-memory.xml
new file mode 100644
index 0000000..8992ad6
--- /dev/null
+++ b/en-US/increase-management-server-max-memory.xml
@@ -0,0 +1,35 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="increase-management-server-max-memory">
+ <title>Increase Management Server Maximum Memory</title>
+ <para>If the Management Server is subject to high demand, the default maximum JVM memory allocation can be insufficient. To increase the memory:</para>
+ <orderedlist>
+ <listitem><para>Edit the Tomcat configuration file:</para><programlisting>/etc/cloudstack/management/tomcat6.conf</programlisting></listitem>
+ <listitem><para>Change the command-line parameter -XmxNNNm to a higher value of N.</para><para>For example, if the current value is -Xmx128m, change it to -Xmx1024m or higher.</para></listitem>
+ <listitem><para>To put the new setting into effect, restart the Management Server.</para><programlisting># service cloudstack-management restart</programlisting></listitem>
+ </orderedlist>
+ <para>For more information about memory issues, see "FAQ: Memory" at <ulink url="http://wiki.apache.org/tomcat/FAQ/Memory">Tomcat Wiki.</ulink></para>
+</section>
+
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/incremental-snapshots-backup.xml
----------------------------------------------------------------------
diff --git a/en-US/incremental-snapshots-backup.xml b/en-US/incremental-snapshots-backup.xml
new file mode 100644
index 0000000..ade00c9
--- /dev/null
+++ b/en-US/incremental-snapshots-backup.xml
@@ -0,0 +1,51 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="incremental-snapshots-backup">
+ <title>Incremental Snapshots and Backup </title>
+ <para>Snapshots are created on primary storage where a disk resides. After a snapshot is created, it is immediately backed up to secondary storage and removed from primary storage for optimal utilization of space on primary storage.</para>
+ <para>&PRODUCT; does incremental backups for some hypervisors. When incremental backups are supported, every N backup is a full backup.</para>
+ <informaltable>
+ <tgroup cols="4" align="left" colsep="1" rowsep="1">
+
+ <thead>
+ <row>
+ <entry></entry>
+ <entry><para>VMware vSphere</para></entry>
+ <entry><para>Citrix XenServer</para></entry>
+ <entry><para>KVM</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><para>Support incremental backup</para></entry>
+ <entry><para>N</para></entry>
+ <entry><para>Y</para></entry>
+ <entry><para>N</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ </section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/initial-setup-of-external-firewalls-loadbalancers.xml
----------------------------------------------------------------------
diff --git a/en-US/initial-setup-of-external-firewalls-loadbalancers.xml b/en-US/initial-setup-of-external-firewalls-loadbalancers.xml
new file mode 100644
index 0000000..332afa0
--- /dev/null
+++ b/en-US/initial-setup-of-external-firewalls-loadbalancers.xml
@@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="initial-setup-of-external-firewalls-loadbalancer">
+ <title>Initial Setup of External Firewalls and Load Balancers</title>
+ <para>When the first VM is created for a new account, &PRODUCT; programs the external firewall and load balancer to work with the VM. The following objects are created on the firewall:</para>
+ <itemizedlist>
+ <listitem><para>A new logical interface to connect to the account's private VLAN. The interface IP is always the first IP of the account's private subnet (e.g. 10.1.1.1). </para></listitem>
+ <listitem><para>A source NAT rule that forwards all outgoing traffic from the account's private VLAN to the public Internet, using the account's public IP address as the source address</para></listitem>
+ <listitem><para>A firewall filter counter that measures the number of bytes of outgoing traffic for the account</para></listitem>
+ </itemizedlist>
+ <para>The following objects are created on the load balancer:</para>
+ <itemizedlist>
+ <listitem><para>A new VLAN that matches the account's provisioned Zone VLAN</para></listitem>
+ <listitem><para>A self IP for the VLAN. This is always the second IP of the account's private subnet (e.g. 10.1.1.2).</para></listitem>
+ </itemizedlist>
+ </section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/initialize-and-test.xml
----------------------------------------------------------------------
diff --git a/en-US/initialize-and-test.xml b/en-US/initialize-and-test.xml
new file mode 100644
index 0000000..2dd6e25
--- /dev/null
+++ b/en-US/initialize-and-test.xml
@@ -0,0 +1,77 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<section id="initialize-and-test">
+ <title>Initialize and Test</title>
+ <para>After everything is configured, &PRODUCT; will perform its initialization. This can take 30 minutes or more, depending on the speed of your network. When the initialization has completed successfully, the administrator's Dashboard should be displayed in the &PRODUCT; UI.</para>
+
+ <orderedlist>
+
+ <listitem><para>Verify that the system is ready. In the left navigation bar, select Templates. Click on the CentOS 5.5 (64bit) no Gui (KVM) template. Check to be sure that the status is "Download Complete." Do not proceed to the next step until this status is displayed.</para></listitem>
+
+ <listitem><para>Go to the Instances tab, and filter by My Instances.</para></listitem>
+
+ <listitem><para>Click Add Instance and follow the steps in the wizard.</para>
+
+ <orderedlist numeration="loweralpha">
+
+ <listitem><para>Choose the zone you just added.</para></listitem>
+
+ <listitem><para>In the template selection, choose the template to use in the VM. If this is a fresh installation, likely only the provided CentOS template is available.</para></listitem>
+
+ <listitem><para>Select a service offering. Be sure that the hardware you have allows starting the selected service offering.</para></listitem>
+
+ <listitem><para>In data disk offering, if desired, add another data disk. This is a second volume that will be available to but not mounted in the guest. For example, in Linux on XenServer you will see /dev/xvdb in the guest after rebooting the VM. A reboot is not required if you have a PV-enabled OS kernel in use.</para></listitem>
+
+ <listitem><para>In default network, choose the primary network for the guest. In a trial installation, you would have only one option here.</para></listitem>
+ <listitem><para>Optionally give your VM a name and a group. Use any descriptive text you would like.</para></listitem>
+
+ <listitem><para>Click Launch VM. Your VM will be created and started. It might take some time to download the template and complete the VM startup. You can watch the VM’s progress in the Instances screen.</para></listitem>
+
+ </orderedlist>
+
+ </listitem>
+
+ <listitem>
+
+ <para>To use the VM, click the View Console button.
+
+ <inlinemediaobject>
+
+ <imageobject><imagedata fileref="./images/console-icon.png" /></imageobject>
+
+ <textobject><phrase>ConsoleButton.png: button to launch a console</phrase></textobject>
+
+ </inlinemediaobject>
+
+ </para>
+
+ <para>For more information about using VMs, including instructions for how to allow incoming network traffic to the VM, start, stop, and delete VMs, and move a VM from one host to another, see Working With Virtual Machines in the Administrator’s Guide.</para>
+ </listitem>
+
+ </orderedlist>
+
+ <para>Congratulations! You have successfully completed a &PRODUCT; Installation.</para>
+
+ <para>If you decide to grow your deployment, you can add more hosts, primary storage, zones, pods, and clusters.</para>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/install-usage-server.xml
----------------------------------------------------------------------
diff --git a/en-US/install-usage-server.xml b/en-US/install-usage-server.xml
new file mode 100644
index 0000000..ffd748d
--- /dev/null
+++ b/en-US/install-usage-server.xml
@@ -0,0 +1,61 @@
+<?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 "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="install-usage-server">
+ <title>Installing the Usage Server (Optional)</title>
+ <para>You can optionally install the Usage Server once the Management Server is configured properly. The Usage Server takes data from the events in the system and enables usage-based billing for accounts.</para>
+ <para>When multiple Management Servers are present, the Usage Server may be installed on any number of them. The Usage Servers will coordinate usage processing. A site that is concerned about availability should install Usage Servers on at least two Management Servers.</para>
+ <section id="requirements-install-usage-server">
+ <title>Requirements for Installing the Usage Server</title>
+ <itemizedlist>
+ <listitem><para>The Management Server must be running when the Usage Server is installed.</para></listitem>
+ <listitem><para>The Usage Server must be installed on the same server as a Management Server.</para></listitem>
+ </itemizedlist>
+ </section>
+ <section id="steps-install-usage-server">
+ <title>Steps to Install the Usage Server</title>
+ <orderedlist>
+ <listitem>
+ <para>Run ./install.sh.</para>
+ <programlisting>
+# ./install.sh
+ </programlisting>
+ <para>You should see a few messages as the installer prepares, followed by a list of choices.</para>
+ </listitem>
+ <listitem>
+ <para>Choose "S" to install the Usage Server.</para>
+ <programlisting>
+ > S
+ </programlisting>
+ </listitem>
+ <listitem>
+ <para>Once installed, start the Usage Server with the following command.</para>
+ <programlisting>
+# service cloudstack-usage start
+ </programlisting>
+ </listitem>
+ </orderedlist>
+ <para>The Administration Guide discusses further configuration of the Usage Server.</para>
+ </section>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/installation-complete.xml
----------------------------------------------------------------------
diff --git a/en-US/installation-complete.xml b/en-US/installation-complete.xml
new file mode 100644
index 0000000..b39040b
--- /dev/null
+++ b/en-US/installation-complete.xml
@@ -0,0 +1,39 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="installation-complete">
+ <title>Installation Complete! Next Steps</title>
+ <para>Congratulations! You have now installed &PRODUCT; Management Server and the database it uses to persist system data.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/installation-complete.png" />
+ </imageobject>
+ <textobject><phrase>installation-complete.png: Finished installs with single Management Server and multiple Management Servers</phrase></textobject>
+ </mediaobject>
+ <para>What should you do next?</para>
+ <itemizedlist>
+ <listitem><para>Even without adding any cloud infrastructure, you can run the UI to get a feel for what's offered and how you will interact with &PRODUCT; on an ongoing basis. See <xref linkend="ui" />.</para></listitem>
+ <listitem><para>When you're ready, add the cloud infrastructure and try running some virtual machines on it, so you can watch how &PRODUCT; manages the infrastructure. See <xref linkend="provisioning-steps" />.</para></listitem>
+ </itemizedlist>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/installation-steps-overview.xml
----------------------------------------------------------------------
diff --git a/en-US/installation-steps-overview.xml b/en-US/installation-steps-overview.xml
new file mode 100644
index 0000000..ea00057
--- /dev/null
+++ b/en-US/installation-steps-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 "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="installation-steps-overview">
+ <title>Overview of Installation Steps</title>
+ <para>For anything more than a simple trial installation, you will need guidance for a variety of configuration choices. It is strongly recommended that you read the following:</para>
+ <itemizedlist>
+ <listitem><para>Choosing a Deployment Architecture</para></listitem>
+ <listitem><para>Choosing a Hypervisor: Supported Features</para></listitem>
+ <listitem><para>Network Setup</para></listitem>
+ <listitem><para>Storage Setup</para></listitem>
+ <listitem><para>Best Practices</para></listitem>
+ </itemizedlist>
+ <orderedlist>
+ <listitem>
+ <para>Make sure you have the required hardware ready. See <xref linkend="minimum-system-requirements"/></para>
+ </listitem>
+ <listitem>
+ <para>Install the Management Server (choose single-node or multi-node). See <xref linkend="management-server-install-flow"/></para>
+ </listitem>
+ <listitem>
+ <para>Log in to the UI. See <xref linkend="ui"/></para>
+ </listitem>
+ <listitem>
+ <para>Add a zone. Includes the first pod, cluster, and host. See <xref linkend="zone-add"/></para>
+ </listitem>
+ <listitem>
+ <para>Add more pods (optional). See <xref linkend="pod-add"/></para>
+ </listitem>
+ <listitem>
+ <para>Add more clusters (optional). See <xref linkend="cluster-add"/></para>
+ </listitem>
+ <listitem>
+ <para>Add more hosts (optional). See <xref linkend="host-add"/></para>
+ </listitem>
+ <listitem>
+ <para>Add more primary storage (optional). See <xref linkend="primary-storage-add"/></para>
+ </listitem>
+ <listitem>
+ <para>Add more secondary storage (optional). See <xref linkend="secondary-storage-add"/></para>
+ </listitem>
+ <listitem>
+ <para>Try using the cloud. See <xref linkend="initialize-and-test"/></para>
+ </listitem>
+ </orderedlist>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/installation.xml
----------------------------------------------------------------------
diff --git a/en-US/installation.xml b/en-US/installation.xml
new file mode 100644
index 0000000..5fc550e
--- /dev/null
+++ b/en-US/installation.xml
@@ -0,0 +1,32 @@
+<?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 "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<chapter id="installation">
+ <title>Installation</title>
+ <xi:include href="who-should-read-installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="installation-steps-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="minimum-system-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="configure-package-repository.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-flow.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/installation_steps_overview.xml
----------------------------------------------------------------------
diff --git a/en-US/installation_steps_overview.xml b/en-US/installation_steps_overview.xml
new file mode 100644
index 0000000..2632a4d
--- /dev/null
+++ b/en-US/installation_steps_overview.xml
@@ -0,0 +1,84 @@
+<?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 "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="installation_steps_overview">
+ <title>Overview of Installation Steps</title>
+ <para>For anything more than a simple trial installation, you will need
+ guidance for a variety of configuration choices. It is strongly
+ recommended that you read the following:</para>
+ <itemizedlist>
+ <listitem><para>Choosing a Deployment Architecture</para></listitem>
+ <listitem><para>Choosing a Hypervisor: Supported Features</para></listitem>
+ <listitem><para>Network Setup</para></listitem>
+ <listitem><para>Storage Setup</para></listitem>
+ <listitem><para>Best Practices</para></listitem>
+ </itemizedlist>
+ <orderedlist>
+ <listitem>
+ <para>
+ <emphasis role="bold">Prepare</emphasis>
+ </para>
+ <para>Make sure you have the required hardware ready</para>
+ </listitem>
+ <listitem>
+ <para>(Optional) Fill out the preparation checklists</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Install the &PRODUCT; software</emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Install the Management Server (choose single-node or multi-node)</para>
+ </listitem>
+ <listitem>
+ <para>Log in to the UI</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Provision your cloud infrastructure</emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Add a zone. Includes the first pod, cluster, and host</para>
+ </listitem>
+ <listitem>
+ <para>Add more pods</para>
+ </listitem>
+ <listitem>
+ <para>Add more clusters</para>
+ </listitem>
+ <listitem>
+ <para>Add more hosts</para>
+ </listitem>
+ <listitem>
+ <para>Add more primary storage</para>
+ </listitem>
+ <listitem>
+ <para>Add more secondary storage</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Try using the cloud</emphasis></para>
+ </listitem>
+ <listitem>
+ <para>Initialization and testing</para>
+ </listitem>
+ </orderedlist>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/installing-publican.xml
----------------------------------------------------------------------
diff --git a/en-US/installing-publican.xml b/en-US/installing-publican.xml
new file mode 100644
index 0000000..9f180aa
--- /dev/null
+++ b/en-US/installing-publican.xml
@@ -0,0 +1,46 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="installing-publican">
+ <title>Installing Publican</title>
+ <para>&PRODUCT; documentation is built using publican. This section describes how to install publican on your own machine so that you can build the documentation guides.</para>
+ <note>
+ <para>The &PRODUCT; documentation source code is located under <emphasis>/docs</emphasis></para>
+ <para>Publican documentation itself is also very <ulink url="http://docs.fedoraproject.org/en-US/Fedora_Contributor_Documentation/1/html/Users_Guide/chap-Users_Guide-Installing_Publican.html">useful</ulink>.</para>
+ </note>
+ <para>On RHEL and RHEL derivatives, install publican with the following command:</para>
+ <programlisting>yum install publican publican-doc</programlisting>
+ <para>On Ubuntu, install publican with the following command:</para>
+ <programlisting>apt-get install publican publican-doc</programlisting>
+ <para>For other distribution refer to the publican documentation listed above. For latest versions of OSX you may have to install from <ulink url="https://fedorahosted.org/publican/wiki/Installing_OSX">source</ulink> and tweak it to your own setup.</para>
+ <para>Once publican is installed, you need to setup the so-called &PRODUCT; brand defined in the <emphasis>docs/publican-&PRODUCT;</emphasis> directory.</para>
+ <para>To do so, enter the following commands:</para>
+ <programlisting>
+ sudo cp -R publican-cloudstack /usr/share/publican/Common_Content/cloudstack
+ </programlisting>
+ <para>If this fails or you later face errors related to the brand files, see the publican <ulink url="http://docs.fedoraproject.org/en-US/Fedora_Contributor_Documentation/1/html/Users_Guide/chap-Users_Guide-Branding.html#sect-Users_Guide-Installing_a_brand">documentation</ulink>.</para>
+ <para>With publican installed and the &PRODUCT; brand files in place, you should be able to build any documentation guide.</para>
+
+
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/inter-vlan-routing.xml
----------------------------------------------------------------------
diff --git a/en-US/inter-vlan-routing.xml b/en-US/inter-vlan-routing.xml
new file mode 100644
index 0000000..59115de
--- /dev/null
+++ b/en-US/inter-vlan-routing.xml
@@ -0,0 +1,107 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<section id="inter-vlan-routing">
+ <title>About Inter-VLAN Routing (nTier Apps)</title>
+ <para>Inter-VLAN Routing (nTier Apps) is the capability to route network traffic between VLANs.
+ This feature enables you to build Virtual Private Clouds (VPC), an isolated segment of your
+ cloud, that can hold multi-tier applications. These tiers are deployed on different VLANs that
+ can communicate with each other. You provision VLANs to the tiers your create, and VMs can be
+ deployed on different tiers. The VLANs are connected to a virtual router, which facilitates
+ communication between the VMs. In effect, you can segment VMs by means of VLANs into different
+ networks that can host multi-tier applications, such as Web, Application, or Database. Such
+ segmentation by means of VLANs logically separate application VMs for higher security and lower
+ broadcasts, while remaining physically connected to the same device.</para>
+ <para>This feature is supported on XenServer, KVM, and VMware hypervisors.</para>
+ <para>The major advantages are:</para>
+ <itemizedlist>
+ <listitem>
+ <para>The administrator can deploy a set of VLANs and allow users to deploy VMs on these
+ VLANs. A guest VLAN is randomly alloted to an account from a pre-specified set of guest
+ VLANs. All the VMs of a certain tier of an account reside on the guest VLAN allotted to that
+ account.</para>
+ <note>
+ <para>A VLAN allocated for an account cannot be shared between multiple accounts. </para>
+ </note>
+ </listitem>
+ <listitem>
+ <para>The administrator can allow users create their own VPC and deploy the application. In
+ this scenario, the VMs that belong to the account are deployed on the VLANs allotted to that
+ account.</para>
+ </listitem>
+ <listitem>
+ <para>Both administrators and users can create multiple VPCs. The guest network NIC is plugged
+ to the VPC virtual router when the first VM is deployed in a tier. </para>
+ </listitem>
+ <listitem>
+ <para>The administrator can create the following gateways to send to or receive traffic from
+ the VMs:</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">VPN Gateway</emphasis>: For more information, see <xref
+ linkend="create-vpn-gateway-for-vpc"/>.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Public Gateway</emphasis>: The public gateway for a VPC is
+ added to the virtual router when the virtual router is created for VPC. The public
+ gateway is not exposed to the end users. You are not allowed to list it, nor allowed to
+ create any static routes.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Private Gateway</emphasis>: For more information, see <xref
+ linkend="add-gateway-vpc"/>.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Both administrators and users can create various possible destinations-gateway
+ combinations. However, only one gateway of each type can be used in a deployment.</para>
+ <para>For example:</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">VLANs and Public Gateway</emphasis>: For example, an
+ application is deployed in the cloud, and the Web application VMs communicate with the
+ Internet.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">VLANs, VPN Gateway, and Public Gateway</emphasis>: For
+ example, an application is deployed in the cloud; the Web application VMs communicate
+ with the Internet; and the database VMs communicate with the on-premise devices.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>The administrator can define Network Access Control List (ACL) on the virtual router to
+ filter the traffic among the VLANs or between the Internet and a VLAN. You can define ACL
+ based on CIDR, port range, protocol, type code (if ICMP protocol is selected) and
+ Ingress/Egress type.</para>
+ </listitem>
+ </itemizedlist>
+ <para>The following figure shows the possible deployment scenarios of a Inter-VLAN setup:</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/multi-tier-app.png"/>
+ </imageobject>
+ <textobject>
+ <phrase>mutltier.png: a multi-tier setup.</phrase>
+ </textobject>
+ </mediaobject>
+ <para>To set up a multi-tier Inter-VLAN deployment, see <xref linkend="configure-vpc"/>.</para>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/introduction.xml
----------------------------------------------------------------------
diff --git a/en-US/introduction.xml b/en-US/introduction.xml
new file mode 100644
index 0000000..9aca8bd
--- /dev/null
+++ b/en-US/introduction.xml
@@ -0,0 +1,30 @@
+<?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 "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="introduction">
+ <title>Introduction</title>
+ <xi:include href="roles.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="api-reference.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="developer-getting-started.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/ip-forwarding-firewalling.xml
----------------------------------------------------------------------
diff --git a/en-US/ip-forwarding-firewalling.xml b/en-US/ip-forwarding-firewalling.xml
new file mode 100644
index 0000000..d1beb2e
--- /dev/null
+++ b/en-US/ip-forwarding-firewalling.xml
@@ -0,0 +1,35 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<section id="ip-forwarding-firewalling">
+ <title>IP Forwarding and Firewalling</title>
+ <para>By default, all incoming traffic to the public IP address is rejected. All outgoing traffic
+ from the guests is also blocked by default.</para>
+ <para>To allow outgoing traffic, follow the procedure in <xref linkend="egress-firewall-rule"
+ />.</para>
+ <para>To allow incoming traffic, users may set up firewall rules and/or port forwarding rules. For
+ example, you can use a firewall rule to open a range of ports on the public IP address, such as
+ 33 through 44. Then use port forwarding rules to direct traffic from individual ports within
+ that range to specific ports on user VMs. For example, one port forwarding rule could route
+ incoming traffic on the public IP's port 33 to port 100 on one user VM's private IP.</para>
+ <xi:include href="firewall-rules.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="egress-firewall-rule.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="port-forwarding.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/ip-load-balancing.xml
----------------------------------------------------------------------
diff --git a/en-US/ip-load-balancing.xml b/en-US/ip-load-balancing.xml
new file mode 100644
index 0000000..ae569e7
--- /dev/null
+++ b/en-US/ip-load-balancing.xml
@@ -0,0 +1,34 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="ip-load-balancing">
+ <title>IP Load Balancing</title>
+ <para>The user may choose to associate the same public IP for multiple guests. &PRODUCT; implements a TCP-level load balancer with the following policies.</para>
+ <itemizedlist>
+ <listitem><para>Round-robin</para></listitem>
+ <listitem><para>Least connection</para></listitem>
+ <listitem><para>Source IP</para></listitem>
+ </itemizedlist>
+ <para>This is similar to port forwarding but the destination may be multiple IP addresses.</para>
+</section>