You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by se...@apache.org on 2014/02/20 16:01:25 UTC
[29/34] refactor docs repo
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/release-notes/en-US/Revision_History.xml
----------------------------------------------------------------------
diff --git a/archive/release-notes/en-US/Revision_History.xml b/archive/release-notes/en-US/Revision_History.xml
new file mode 100644
index 0000000..55d741a
--- /dev/null
+++ b/archive/release-notes/en-US/Revision_History.xml
@@ -0,0 +1,45 @@
+<?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 "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.
+-->
+
+<appendix id="appe-cloudstack-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0-0</revnumber>
+ <date>Tue May 29 2012</date>
+ <author>
+ <firstname>Jessica</firstname>
+ <surname>Tomechak</surname>
+ <email/>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial creation of book by publican</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/release-notes/en-US/fallback.xml
----------------------------------------------------------------------
diff --git a/archive/release-notes/en-US/fallback.xml b/archive/release-notes/en-US/fallback.xml
new file mode 100644
index 0000000..28ad3ef
--- /dev/null
+++ b/archive/release-notes/en-US/fallback.xml
@@ -0,0 +1,24 @@
+<?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="fallback">
+ <title>Fallback</title>
+ <para>to-do</para>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/release-notes/en-US/feedback.xml
----------------------------------------------------------------------
diff --git a/archive/release-notes/en-US/feedback.xml b/archive/release-notes/en-US/feedback.xml
new file mode 100644
index 0000000..4b06c9f
--- /dev/null
+++ b/archive/release-notes/en-US/feedback.xml
@@ -0,0 +1,24 @@
+<?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="feedback">
+ <title>Feedback</title>
+ <para>to-do</para>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/release-notes/publican.cfg
----------------------------------------------------------------------
diff --git a/archive/release-notes/publican.cfg b/archive/release-notes/publican.cfg
new file mode 100644
index 0000000..b6af406
--- /dev/null
+++ b/archive/release-notes/publican.cfg
@@ -0,0 +1,27 @@
+# Publican configuration file for CloudStack 4.0 Release Notes
+# Config::Simple 4.58
+# Tue May 29 00:57:27 2012
+#
+# 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.
+
+xml_lang: en-US
+type: Book
+docname: Release_Notes
+brand: cloudstack
+chunk_first: 0
+chunk_section_depth: 0
+toc_section_depth: 1
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/Author_Group.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/Author_Group.xml b/archive/vxlan/en-US/Author_Group.xml
new file mode 100644
index 0000000..1184c50
--- /dev/null
+++ b/archive/vxlan/en-US/Author_Group.xml
@@ -0,0 +1,31 @@
+<?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;
+]>
+
+<!-- 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.
+-->
+
+
+<authorgroup>
+ <author>
+ <firstname>Apache</firstname>
+ <surname>CloudStack</surname>
+ </author>
+</authorgroup>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/Book_Info.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/Book_Info.xml b/archive/vxlan/en-US/Book_Info.xml
new file mode 100644
index 0000000..e063e23
--- /dev/null
+++ b/archive/vxlan/en-US/Book_Info.xml
@@ -0,0 +1,47 @@
+<?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 "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.
+-->
+
+<bookinfo id="book-release-notes-3.0.4">
+ <title>&PRODUCT; Guide</title>
+ <subtitle>Revised August 9, 2012 10:48 pm Pacific</subtitle>
+ <productname>Apache CloudStack</productname>
+ <productnumber>4.3.0</productnumber>
+ <edition>1</edition>
+ <pubsnumber></pubsnumber>
+ <abstract>
+ <para>
+ Complete technical documentation of &PRODUCT;.
+ </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/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/CloudStack_VXLAN_Guide.ent
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/CloudStack_VXLAN_Guide.ent b/archive/vxlan/en-US/CloudStack_VXLAN_Guide.ent
new file mode 100644
index 0000000..f31c407
--- /dev/null
+++ b/archive/vxlan/en-US/CloudStack_VXLAN_Guide.ent
@@ -0,0 +1,22 @@
+<!-- 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.
+-->
+
+<!ENTITY PRODUCT "CloudStack">
+<!ENTITY BOOKID "Technical Documentation">
+<!ENTITY YEAR "2013">
+<!ENTITY HOLDER "Apache Software Foundation">
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/CloudStack_VXLAN_Guide.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/CloudStack_VXLAN_Guide.xml b/archive/vxlan/en-US/CloudStack_VXLAN_Guide.xml
new file mode 100644
index 0000000..d7886c8
--- /dev/null
+++ b/archive/vxlan/en-US/CloudStack_VXLAN_Guide.xml
@@ -0,0 +1,53 @@
+<?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 "cloudstack.ent">
+%BOOK_ENTITIES;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+
+<!-- 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.
+-->
+
+<book>
+ <bookinfo id="cloudstack_plugin_vxlan">
+ <title>&PRODUCT; Plugin Guide for the VXLAN Plugin</title>
+ <productname>Apache CloudStack</productname>
+ <productnumber>4.3.0</productnumber>
+ <edition>0</edition>
+ <pubsnumber></pubsnumber>
+ <abstract>
+ <para>
+ Plugin Guide for the VXLAN Plugin.
+ </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>
+ <xi:include href="plugin-vxlan-about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="plugin-vxlan-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="plugin-vxlan-configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="plugin-vxlan-revision-history.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</book>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/images/vxlan-physicalnetwork.png
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/images/vxlan-physicalnetwork.png b/archive/vxlan/en-US/images/vxlan-physicalnetwork.png
new file mode 100644
index 0000000..eb06fcd
Binary files /dev/null and b/archive/vxlan/en-US/images/vxlan-physicalnetwork.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/images/vxlan-trafficlabel.png
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/images/vxlan-trafficlabel.png b/archive/vxlan/en-US/images/vxlan-trafficlabel.png
new file mode 100644
index 0000000..916e944
Binary files /dev/null and b/archive/vxlan/en-US/images/vxlan-trafficlabel.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/images/vxlan-vniconfig.png
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/images/vxlan-vniconfig.png b/archive/vxlan/en-US/images/vxlan-vniconfig.png
new file mode 100644
index 0000000..c7372a0
Binary files /dev/null and b/archive/vxlan/en-US/images/vxlan-vniconfig.png differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-about.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-about.xml b/archive/vxlan/en-US/plugin-vxlan-about.xml
new file mode 100644
index 0000000..5cf0c34
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-about.xml
@@ -0,0 +1,27 @@
+<?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;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+<!-- 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="About-the-VXLAN-Plugin" >
+ <title>The VXLAN Plugin</title>
+ <xi:include href="plugin-vxlan-introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="plugin-vxlan-features.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-config-hypervisor.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-config-hypervisor.xml b/archive/vxlan/en-US/plugin-vxlan-config-hypervisor.xml
new file mode 100644
index 0000000..d441c8b
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-config-hypervisor.xml
@@ -0,0 +1,204 @@
+<?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;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+<!-- 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="plugin-vxlan-config-hypervisor">
+ <title>Configure hypervisor</title>
+ <section id="plugin-vxlan-config-hypervisor-kvm">
+ <title>Configure hypervisor: KVM</title>
+ <para>
+ In addition to "KVM Hypervisor Host Installation" in "&PRODUCT; Installation Guide", you have to configure the following item on the host.
+ </para>
+ <section id="plugin-vxlan-config-hypervisor-kvm-bridge">
+ <title>Create bridge interface with IPv4 address</title>
+ <para>
+ This plugin requires an IPv4 address on the KVM host to terminate and originate VXLAN traffic.
+ The address should be assinged to a physical interface or a bridge interface bound to a physical interface.
+ Both a private address or a public address are fine for the purpose.
+ It is not required to be in the same subnet for all hypervisors in a zone, but they should be able to reach each other via IP multicast with UDP/8472 port.
+ A name of a physical interface or a name of a bridge interface bound to a physical interface can be used as a traffic label.
+ Physical interface name fits for almost all cases, but if physical interface name differs per host, you may use a bridge to set a same name.
+ If you would like to use a bridge name as a traffic label, you may create a bridge in this way.
+ </para>
+ <para>
+ Let <parameter>cloudbr1</parameter> be the bridge interface for the instances' private network.
+ </para>
+ <section id="plugin-vxlan-config-hypervisor-kvm-bridge-rhel">
+ <title>Configure in RHEL or CentOS</title>
+ <para>
+ When you configured the <parameter>cloudbr1</parameter> interface as below,
+ </para>
+ <programlisting language="Bash">$ sudo vi /etc/sysconfig/network-scripts/ifcfg-cloudbr1
+ </programlisting>
+ <programlisting language="Bash">DEVICE=cloudbr1
+TYPE=Bridge
+ONBOOT=yes
+BOOTPROTO=none
+IPV6INIT=no
+IPV6_AUTOCONF=no
+DELAY=5
+STP=yes
+ </programlisting>
+ <para>
+ you would change the configuration similar to below.
+ </para>
+ <programlisting language="Bash">DEVICE=cloudbr1
+TYPE=Bridge
+ONBOOT=yes
+BOOTPROTO=static
+IPADDR=192.0.2.X
+NETMASK=255.255.255.0
+IPV6INIT=no
+IPV6_AUTOCONF=no
+DELAY=5
+STP=yes
+ </programlisting>
+
+ </section>
+ <section id="plugin-vxlan-config-hypervisor-kvm-bridge-ubuntu">
+ <title>Configure in Ubuntu</title>
+ <para>
+ When you configured <parameter>cloudbr1</parameter> as below,
+ </para>
+ <programlisting language="Bash">$ sudo vi /etc/network/interfaces
+ </programlisting>
+ <programlisting language="Bash">auto lo
+iface lo inet loopback
+
+# The primary network interface
+auto eth0.100
+iface eth0.100 inet static
+ address 192.168.42.11
+ netmask 255.255.255.240
+ gateway 192.168.42.1
+ dns-nameservers 8.8.8.8 8.8.4.4
+ dns-domain lab.example.org
+
+# Public network
+auto cloudbr0
+iface cloudbr0 inet manual
+ bridge_ports eth0.200
+ bridge_fd 5
+ bridge_stp off
+ bridge_maxwait 1
+
+# Private network
+auto cloudbr1
+iface cloudbr1 inet manual
+ bridge_ports eth0.300
+ bridge_fd 5
+ bridge_stp off
+ bridge_maxwait 1
+ </programlisting>
+ <para>
+ you would change the configuration similar to below.
+ </para>
+ <programlisting language="Bash">auto lo
+iface lo inet loopback
+
+# The primary network interface
+auto eth0.100
+iface eth0.100 inet static
+ address 192.168.42.11
+ netmask 255.255.255.240
+ gateway 192.168.42.1
+ dns-nameservers 8.8.8.8 8.8.4.4
+ dns-domain lab.example.org
+
+# Public network
+auto cloudbr0
+iface cloudbr0 inet manual
+ bridge_ports eth0.200
+ bridge_fd 5
+ bridge_stp off
+ bridge_maxwait 1
+
+# Private network
+auto cloudbr1
+iface cloudbr1 inet static
+ addres 192.0.2.X
+ netmask 255.255.255.0
+ bridge_ports eth0.300
+ bridge_fd 5
+ bridge_stp off
+ bridge_maxwait 1
+ </programlisting>
+ </section>
+ </section>
+ <section id="plugin-vxlan-config-hypervisor-kvm-iptables">
+ <title>Configure iptables to pass XVLAN packets</title>
+ <para>
+ Since VXLAN uses UDP packet to forward encapsulated the L2 frames, UDP/8472 port must be opened.
+ </para>
+ <section id="plugin-vxlan-config-hypervisor-kvm-iptables-rhel">
+ <title>Configure in RHEL or CentOS</title>
+ <para>
+ RHEL and CentOS use iptables for firewalling the system, you can open extra ports by executing the following iptable commands:
+ </para>
+ <programlisting language="Bash">$ sudo iptables -I INPUT -p udp -m udp --dport 8472 -j ACCEPT
+ </programlisting>
+ <para>
+ These iptable settings are not persistent accross reboots, we have to save them first.
+ </para>
+ <programlisting language="Bash">$ sudo iptables-save > /etc/sysconfig/iptables
+ </programlisting>
+ <para>
+ With this configuration you should be able to restart the network, although a reboot is recommended to see if everything works properly.
+ </para>
+ <programlisting language="Bash">$ sudo service network restart
+ $ sudo reboot
+ </programlisting>
+ <warning>
+ <para>
+ Make sure you have an alternative way like IPMI or ILO to reach the machine in case you made a configuration error and the network stops functioning!
+ </para>
+ </warning>
+ </section>
+ <section id="plugin-vxlan-config-hypervisor-kvm-iptables-ubuntu">
+ <title>Configure in Ubuntu</title>
+ <para>
+ The default firewall under Ubuntu is UFW (Uncomplicated FireWall), which is a Python wrapper around iptables.
+ </para>
+ <para>
+ To open the required ports, execute the following commands:
+ </para>
+ <programlisting language="Bash">$ sudo ufw allow proto udp from any to any port 8472
+ </programlisting>
+ <note>
+ <para>
+ By default UFW is not enabled on Ubuntu. Executing these commands with the firewall disabled does not enable the firewall.
+ </para>
+ </note>
+ <para>
+ With this configuration you should be able to restart the network, although a reboot is recommended to see if everything works properly.
+ </para>
+ <programlisting language="Bash">$ sudo service networking restart
+$ sudo reboot
+ </programlisting>
+ <warning>
+ <para>
+ Make sure you have an alternative way like IPMI or ILO to reach the machine in case you made a configuration error and the network stops functioning!
+ </para>
+ </warning>
+ </section>
+ </section>
+ </section>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-config-management.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-config-management.xml b/archive/vxlan/en-US/plugin-vxlan-config-management.xml
new file mode 100644
index 0000000..d8ba907
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-config-management.xml
@@ -0,0 +1,76 @@
+<?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;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+<!-- 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="plugin-vxlan-config-management">
+ <title>Setup zone using VXLAN</title>
+ <para>
+ In almost all parts of zone setup, you can just follow the advanced zone setup istruction in "&PRODUCT; Installation Guide" to use this plugin.
+ It is not required to add a network element nor to reconfigure the network offering.
+ The only thing you have to do is configure the physical network to use VXLAN as the isolation method for Guest Network.
+ </para>
+ <section id="plugin-vxlan-config-management-physical-network">
+ <title>Configure the physical network</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/vxlan-physicalnetwork.png"/>
+ </imageobject>
+ <textobject>
+ <phrase>vxlan-physicalnetowkr.png: physicalnetwork configuration for VXLAN</phrase>
+ </textobject>
+ </mediaobject>
+ <para>
+ CloudStack needs to have one physical network for Guest Traffic with the isolation method set to "VXLAN".
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/vxlan-trafficlabel.png"/>
+ </imageobject>
+ <textobject>
+ <phrase>vxlan-trafficlabel.png: traffic label configuration for VXLAN</phrase>
+ </textobject>
+ </mediaobject>
+ <para>
+ Guest Network traffic label should be the name of the physical interface or the name of the bridge interface and the bridge interface and they should have an IPv4 address.
+ See <xref linkend="plugin-vxlan-config-hypervisor-kvm-bridge"/> for details.
+ </para>
+ </section>
+ <section id="plugin-vxlan-config-management-guest-traffic">
+ <title>Configure the guest traffic</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/vxlan-vniconfig.png"/>
+ </imageobject>
+ <textobject>
+ <phrase>vxlan-vniconfig.png: VNI configuration</phrase>
+ </textobject>
+ </mediaobject>
+ <para>
+ Specify a range of VNIs you would like to use for carrying guest network traffic.
+ </para>
+ <warning>
+ <para>
+ VNI must be unique per zone and no duplicate VNIs can exist in the zone. Exercise care when designing your VNI allocation policy.
+ </para>
+ </warning>
+ </section>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-configuration.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-configuration.xml b/archive/vxlan/en-US/plugin-vxlan-configuration.xml
new file mode 100644
index 0000000..03daf0d
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-configuration.xml
@@ -0,0 +1,27 @@
+<?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;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+<!-- 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="How-to-configure-VXLAN-Plugin" >
+ <title>Configure &PRODUCT; to use VXLAN Plugin</title>
+ <xi:include href="plugin-vxlan-config-hypervisor.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="plugin-vxlan-config-management.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-features.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-features.xml b/archive/vxlan/en-US/plugin-vxlan-features.xml
new file mode 100644
index 0000000..904956a
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-features.xml
@@ -0,0 +1,42 @@
+<?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;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+<!-- 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="Features-of-the-VXLAN-Plugin">
+ <title>Features of the VXLAN Plugin</title>
+
+ <para>
+ In &PRODUCT; release 4.3.0 this plugin supports Advanced Isolated network mode.
+ This plugin enables more than 4096 isolated guest networks in a Zone, with almost the same usability as VLAN isolation.
+ </para>
+
+ <para>
+ By the nature of VXLAN's MAC-in-IP encapsulation, the MAC addresses of VMs are encapsulated and concealed in the MAC addresses of Hypervisors.
+ So, the physical switch no longer needs to learn the MAC addresses of the individual VMs.
+ Thus, the required MAC address table size of the physical switch would be greatly reduced.
+ </para>
+
+ <para>
+ This plugin doesn't provide network services.
+ With this plugin, network services ( VPN, Source NAT, Static NAT, Port Forwarding, Firewall, and Load Balancing ) are provided by the Virtual Router.
+ </para>
+
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-introduction.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-introduction.xml b/archive/vxlan/en-US/plugin-vxlan-introduction.xml
new file mode 100644
index 0000000..dc67f3a
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-introduction.xml
@@ -0,0 +1,26 @@
+<?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;
+<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
+%xinclude;
+]>
+<!-- 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-to-the-VXLAN-Plugin">
+ <title>Introduction to the VXLAN Plugin</title>
+ <para>The VXLAN plugin adds VXLAN as one of the guest network isolation methods in &PRODUCT;.</para>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-requirements.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-requirements.xml b/archive/vxlan/en-US/plugin-vxlan-requirements.xml
new file mode 100644
index 0000000..041dfaa
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-requirements.xml
@@ -0,0 +1,190 @@
+<?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="vxlan-requirements">
+ <title>System Requirements for VXLAN</title>
+ <section id="vxlan-table-of-requirement">
+ <title>System Requirements for VXLAN</title>
+ <para>In &PRODUCT; 4.3.0, this plugin only supports the KVM hypervisor with the standard linux bridge.</para>
+
+ <para>The following table lists the requirements for the hypervisor.</para>
+ <table>
+ <title>Hypervisor Requirement for VXLAN</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Item</entry>
+ <entry>Requirement</entry>
+ <entry>Note</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Hypervisor</entry>
+ <entry>KVM</entry>
+ <entry>OvsVifDriver is not supported by this plugin in &PRODUCT; 4.3.0, use BridgeVifDriver (default).</entry>
+ </row>
+ <row>
+ <entry>Linux kernel</entry>
+ <entry>version >= 3.7, VXLAN kernel module enabled</entry>
+ <entry>It is recommended to use kernel >=3.9, since Linux kernel categorizes the VXLAN driver as experimental <3.9.</entry>
+ </row>
+ <row>
+ <entry>iproute2</entry>
+ <entry>matches kernel version</entry>
+ <entry></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
+ <section id="vxlan-req-distribution">
+ <title>Linux Distributions that meet the requirements</title>
+ <para>
+ The following table lists distributions which meet requirements.
+ </para>
+ <table>
+ <title>List of Linux distributions which meet the hypervisor requirements</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Distribution</entry>
+ <entry>Release Version</entry>
+ <entry>Kernel Version (Date confirmed)</entry>
+ <entry>Note</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Ubuntu</entry>
+ <entry>13.04</entry>
+ <entry>3.8.0 (2013/07/23)</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry>Fedora</entry>
+ <entry>>= 17</entry>
+ <entry>3.9.10 (2013/07/23)</entry>
+ <entry>Latest kernel packages are available in "update" repository.</entry>
+ </row>
+ <row>
+ <entry>CentOS</entry>
+ <entry>>= 6.5</entry>
+ <entry>2.6.32-431.3.1.el6.x86_64 (2014/01/21)</entry>
+ <entry></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="vxlan-confirm">
+ <title>Check the capability of your system</title>
+ <para>
+ To check the capability of your system, execute the following commands.
+ </para>
+ <programlisting language="Bash">
+$ sudo modprobe vxlan && echo $?
+# Confirm the output is "0".
+# If it's non-0 value or error message, your kernel doesn't have VXLAN kernel module.
+
+$ ip link add type vxlan help
+# Confirm the output is usage of the command and that it's for VXLAN.
+# If it's not, your iproute2 utility doesn't support VXLAN.
+ </programlisting>
+ </section>
+ <section id="vxlan-req-build">
+ <title>Advanced: Build kernel and iproute2</title>
+ <para>
+ Even if your system doesn't support VXLAN, you can compile the kernel and iproute2 by yourself.
+ The following procedure is an example for CentOS 6.4.
+ </para>
+ <section id="vxlan-build-kernel">
+ <title>Build kernel</title>
+ <programlisting language="Bash">$ sudo yum groupinstall "Development Tools"
+$ sudo yum install ncurses-devel hmaccalc zlib-devel binutils-devel elfutils-libelf-devel bc
+
+$ KERNEL_VERSION=3.10.4
+# Declare the kernel version you want to build.
+
+$ wget https://www.kernel.org/pub/linux/kernel/v3.x/linux-${KERNEL_VERSION}.tar.xz
+$ tar xvf linux-${KERNEL_VERSION}.tar.xz
+$ cd linux-${KERNEL_VERSION}
+$ cp /boot/config-`uname -r` .config
+$ make oldconfig
+# You may keep hitting enter and choose the default.
+
+$ make menuconfig
+# Dig into "Device Drivers" -> "Network device support",
+# then select "Virtual eXtensible Local Area Network (VXLAN)" and hit space.
+# Make sure it indicates "<M>" (build as module), then Save and Exit.
+
+# You may also want to check "IPv4 NAT" and its child nodes in "IP: Netfilter Configuration"
+# and "IPv6 NAT" and its child nodes in "IPv6: Netfilter Configuration".
+# In 3.10.4, you can find the options in
+# "Networking support" -> "Networking options"
+# -> "Network packet filtering framework (Netfilter)".
+
+$ make # -j N
+# You may use -j N option to make the build process parallel and faster,
+# generally N = 1 + (cores your machine have).
+
+$ sudo make modules_install
+$ sudo make install
+# You would get an error like "ERROR: modinfo: could not find module XXXX" here.
+# This happens mainly due to config structure changes between kernel versions.
+# You can ignore this error, until you find you need the kernel module.
+# If you feel uneasy, you can go back to make menuconfig,
+# find module XXXX by using '/' key, enable the module, build and install the kernel again.
+
+$ sudo vi /etc/grub.conf
+# Make sure the new kernel isn't set as the default and the timeout is long enough,
+# so you can select the new kernel during boot process.
+# It's not a good idea to set the new kernel as the default until you confirm the kernel works fine.
+
+$ sudo reboot
+# Select the new kernel during the boot process.
+ </programlisting>
+ </section>
+ <section id="vxlan-build-iproute2">
+ <title>Build iproute2</title>
+ <programlisting>$ sudo yum install db4-devel
+
+$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/shemminger/iproute2.git
+$ cd iproute2
+$ git tag
+# Find the version that matches the kernel.
+# If you built kernel 3.10.4 as above, it would be v3.10.0.
+
+$ git checkout v3.10.0
+$ ./configure
+$ make # -j N
+$ sudo make install
+ </programlisting>
+ <note>
+ <para>Please use rebuild kernel and tools at your own risk.</para>
+ </note>
+ </section>
+ </section>
+</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/en-US/plugin-vxlan-revision-history.xml
----------------------------------------------------------------------
diff --git a/archive/vxlan/en-US/plugin-vxlan-revision-history.xml b/archive/vxlan/en-US/plugin-vxlan-revision-history.xml
new file mode 100644
index 0000000..7c45a54
--- /dev/null
+++ b/archive/vxlan/en-US/plugin-vxlan-revision-history.xml
@@ -0,0 +1,72 @@
+<?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 "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.
+-->
+
+<appendix id="plugin-vxlan-revision-history">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0-2</revnumber>
+ <date>January 21 2014</date>
+ <author>
+ <firstname>Yoshikazu</firstname>
+ <surname>Nojima</surname>
+ <email/>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Add a section to describe VNI allocation matter. Add a description that explain a physical interface name can be used for traffic label.</member>
+ </simplelist>
+ </revdescription>
+ </revision> <revision>
+ <revnumber>0-1</revnumber>
+ <date>October 3 2013</date>
+ <author>
+ <firstname>Yoshikazu</firstname>
+ <surname>Nojima</surname>
+ <email/>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial revision</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>0-0</revnumber>
+ <date>August 2 2013</date>
+ <author>
+ <firstname>Toshiaki</firstname>
+ <surname>Hatano</surname>
+ <email/>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Draft</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/archive/vxlan/publican.cfg
----------------------------------------------------------------------
diff --git a/archive/vxlan/publican.cfg b/archive/vxlan/publican.cfg
new file mode 100644
index 0000000..f46b8a1
--- /dev/null
+++ b/archive/vxlan/publican.cfg
@@ -0,0 +1,28 @@
+# Publican configuration file for CloudStack Complete Documentation Set
+# Contains all technical docs except release notes
+# Config::Simple 4.58
+# Tue May 29 00:57:27 2012
+#
+# 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.
+
+xml_lang: en-US
+type: Book
+docname: CloudStack_VXLAN_Guide
+brand: cloudstack
+chunk_first: 1
+chunk_section_depth: 1
+condition: install
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/Author_Group.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/Author_Group.xml b/midonet/en-US/Author_Group.xml
deleted file mode 100644
index ba9e651..0000000
--- a/midonet/en-US/Author_Group.xml
+++ /dev/null
@@ -1,32 +0,0 @@
-<?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;
-]>
-
-<!-- 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.
--->
-
-
-<authorgroup>
- <author>
- <firstname>Apache</firstname>
- <surname>CloudStack</surname>
- </author>
-</authorgroup>
-
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/Book_Info.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/Book_Info.xml b/midonet/en-US/Book_Info.xml
deleted file mode 100644
index 327668d..0000000
--- a/midonet/en-US/Book_Info.xml
+++ /dev/null
@@ -1,47 +0,0 @@
-<?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 "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.
--->
-
-<bookinfo id="book-release-notes-3.0.4">
- <title>&PRODUCT; Guide</title>
- <subtitle>Revised August 9, 2012 10:48 pm Pacific</subtitle>
- <productname>Apache CloudStack</productname>
- <productnumber>4.2.0</productnumber>
- <edition>1</edition>
- <pubsnumber></pubsnumber>
- <abstract>
- <para>
- Complete technical documentation of &PRODUCT;.
- </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/cloudstack-docs/blob/cb915b74/midonet/en-US/MidoNet_Plugin_Guide.ent
----------------------------------------------------------------------
diff --git a/midonet/en-US/MidoNet_Plugin_Guide.ent b/midonet/en-US/MidoNet_Plugin_Guide.ent
deleted file mode 100644
index f31c407..0000000
--- a/midonet/en-US/MidoNet_Plugin_Guide.ent
+++ /dev/null
@@ -1,22 +0,0 @@
-<!-- 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.
--->
-
-<!ENTITY PRODUCT "CloudStack">
-<!ENTITY BOOKID "Technical Documentation">
-<!ENTITY YEAR "2013">
-<!ENTITY HOLDER "Apache Software Foundation">
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/MidoNet_Plugin_Guide.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/MidoNet_Plugin_Guide.xml b/midonet/en-US/MidoNet_Plugin_Guide.xml
deleted file mode 100644
index 86182e6..0000000
--- a/midonet/en-US/MidoNet_Plugin_Guide.xml
+++ /dev/null
@@ -1,52 +0,0 @@
-<?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 "cloudstack.ent">
-%BOOK_ENTITIES;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-
-<!-- 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.
--->
-
-<book>
- <bookinfo id="midonet_plugin">
- <title>&PRODUCT; Plugin Guide for the MidoNet Plugin</title>
- <productname>Apache CloudStack</productname>
- <productnumber>4.2.0</productnumber>
- <edition>1</edition>
- <pubsnumber></pubsnumber>
- <abstract>
- <para>
- Plugin Guide for the MidoNet Plugin.
- </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>
- <xi:include href="plugin-midonet-about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="plugin-midonet-usage.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="plugin-midonet-revisions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</book>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-about.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-about.xml b/midonet/en-US/plugin-midonet-about.xml
deleted file mode 100644
index dd9b3ad..0000000
--- a/midonet/en-US/plugin-midonet-about.xml
+++ /dev/null
@@ -1,27 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="About-the-MidoNet-Plugin" >
- <title>The MidoNet Plugin</title>
- <xi:include href="plugin-midonet-introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="plugin-midonet-features.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-features.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-features.xml b/midonet/en-US/plugin-midonet-features.xml
deleted file mode 100644
index f242d63..0000000
--- a/midonet/en-US/plugin-midonet-features.xml
+++ /dev/null
@@ -1,57 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="Features-of-the-MidoNet-Plugin">
- <title>Features of the MidoNet Plugin</title>
-
- <note>
- <para>
- In &PRODUCT; 4.2.0 only the KVM hypervisor is supported for use in combination with MidoNet.
- </para>
- </note>
-
- <para>In &PRODUCT; release 4.2.0 this plugin supports several services in the Advanced Isolated network mode.
- </para>
-
- <para>
- When tenants create new isolated layer 3 networks, instead of spinning up extra Virtual Router VMs, the relevant L3 elements (routers etc) are created in the MidoNet virtual topology by making the appropriate calls to the MidoNet API. Instead of using VLANs, isolation is provided by MidoNet.
- </para>
-
- <para>
- Aside from the above service (Connectivity), several extra features are supported in the 4.2.0 release:
- </para>
-
- <itemizedlist>
- <listitem><para>DHCP</para></listitem>
- <listitem><para>Firewall (ingress)</para></listitem>
- <listitem><para>Source NAT</para></listitem>
- <listitem><para>Static NAT</para></listitem>
- <listitem><para>Port Forwarding</para></listitem>
- </itemizedlist>
-
- <para>
- The plugin has been tested with MidoNet version 12.12. (Caddo).
- </para>
-
-
-
-</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-introduction.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-introduction.xml b/midonet/en-US/plugin-midonet-introduction.xml
deleted file mode 100644
index 7793ecb..0000000
--- a/midonet/en-US/plugin-midonet-introduction.xml
+++ /dev/null
@@ -1,26 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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-to-the-MidoNet-Plugin">
- <title>Introduction to the MidoNet Plugin</title>
- <para>The MidoNet plugin allows &PRODUCT; to use the MidoNet virtualized networking solution as a provider for &PRODUCT; networks and services. For more information on MidoNet and how it works, see <ulink url="http://www.midokura.com/midonet/">http://www.midokura.com/midonet/</ulink>.</para>
-</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-preparations.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-preparations.xml b/midonet/en-US/plugin-midonet-preparations.xml
deleted file mode 100644
index cf78774..0000000
--- a/midonet/en-US/plugin-midonet-preparations.xml
+++ /dev/null
@@ -1,90 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="Prerequisites">
- <title>Prerequisites</title>
-
- <para>In order to use the MidoNet plugin, the compute hosts must be running the MidoNet Agent, and the MidoNet API server must be available. Please consult the MidoNet User Guide for more information. The following section describes the &PRODUCT; side setup.</para>
-
- <orderedlist>
- <listitem>
- <para>&PRODUCT; needs to have at least one physical network with the isolation method set to "MIDO". This network should be enabled for the Guest and Public traffic types.</para>
- </listitem>
-
-<listitem>
- <para>Next, we need to set the following &PRODUCT; settings under "Global Settings" in the UI:</para>
-
-<table frame='all'><title>&PRODUCT; settings</title>
-<tgroup cols='3' align='left' colsep='1' rowsep='1'>
-<thead>
-<row>
- <entry>Setting Name</entry>
- <entry>Description</entry>
- <entry>Example</entry>
-</row>
-</thead>
-<tbody>
-<row>
- <entry>midonet.apiserver.address</entry>
- <entry>Specify the address at which the Midonet API server can be contacted</entry>
- <entry>http://192.168.1.144:8081/midolmanj-mgmt</entry>
-</row>
-<row>
- <entry>midonet.providerrouter.id</entry>
- <entry>Specifies the UUID of the Midonet provider router</entry>
- <entry>d7c5e6a3-e2f4-426b-b728-b7ce6a0448e5</entry>
-</row>
-</tbody>
-</tgroup>
-</table>
-</listitem>
-
-<listitem>
- <para>
- We also want MidoNet to take care of public traffic, so in <emphasis>componentContext.xml</emphasis> we need to replace this line:
-
- <programlisting><![CDATA[<bean id="PublicNetworkGuru" class="com.cloud.network.guru.PublicNetworkGuru">]]>
- </programlisting>
-
- With this:
-
- <programlisting><![CDATA[<bean id="PublicNetworkGuru" class="com.cloud.network.guru.MidoNetPublicNetworkGuru">]]>
- </programlisting>
-</para>
-</listitem>
-</orderedlist>
-
- <note>
- <para>
- On the compute host, MidoNet takes advantage of per-traffic type VIF driver support in &PRODUCT; KVM.
- </para>
- <para>
- In agent.properties, we set the following to make MidoNet take care of Guest and Public traffic:
-
-<programlisting>libvirt.vif.driver.Guest=com.cloud.network.resource.MidoNetVifDriver
-libvirt.vif.driver.Public=com.cloud.network.resource.MidoNetVifDriver</programlisting>
-
- This is explained further in MidoNet User Guide.
- </para>
- </note>
-
-</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-provider.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-provider.xml b/midonet/en-US/plugin-midonet-provider.xml
deleted file mode 100644
index 904828c..0000000
--- a/midonet/en-US/plugin-midonet-provider.xml
+++ /dev/null
@@ -1,39 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="Enabling-the-service-provider">
- <title>Enabling the MidoNet service provider via the API</title>
- <para>
- To enable via the API, use the following API calls:</para>
- <para><emphasis>addNetworkServiceProvider</emphasis></para>
- <itemizedlist>
- <listitem><para>name = "MidoNet"</para></listitem>
- <listitem><para>physicalnetworkid = <the uuid of the physical network></para></listitem>
- </itemizedlist>
- <para><emphasis>updateNetworkServiceProvider</emphasis></para>
- <itemizedlist>
- <listitem><para>id = <the provider uuid returned by the previous call></para></listitem>
- <listitem><para>state = "Enabled"</para></listitem>
- </itemizedlist>
-
-
-</section>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-revisions.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-revisions.xml b/midonet/en-US/plugin-midonet-revisions.xml
deleted file mode 100644
index 73def23..0000000
--- a/midonet/en-US/plugin-midonet-revisions.xml
+++ /dev/null
@@ -1,45 +0,0 @@
-<?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 "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.
--->
-
-<appendix id="appe-cloudstack-Revision_History">
- <title>Revision History</title>
- <simpara>
- <revhistory>
- <revision>
- <revnumber>0-0</revnumber>
- <date>Wed Mar 13 2013</date>
- <author>
- <firstname>Dave</firstname>
- <surname>Cahill</surname>
- <email>dcahill@midokura.com</email>
- </author>
- <revdescription>
- <simplelist>
- <member>Documentation created for 4.2.0 version of the MidoNet Plugin</member>
- </simplelist>
- </revdescription>
- </revision>
- </revhistory>
- </simpara>
-</appendix>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-ui.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-ui.xml b/midonet/en-US/plugin-midonet-ui.xml
deleted file mode 100644
index 8ee9850..0000000
--- a/midonet/en-US/plugin-midonet-ui.xml
+++ /dev/null
@@ -1,65 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="plugin-midonet-ui">
- <title>Enabling the MidoNet service provider via the UI</title>
- <para>To allow &PRODUCT; to use the MidoNet Plugin the network service provider needs to be enabled on the physical network.
- </para>
-
- <para>
- The steps to enable via the UI are as follows:
- <orderedlist>
- <listitem><para>
- In the left navbar, click Infrastructure
- </para></listitem>
-
- <listitem><para>
- In Zones, click View All
- </para></listitem>
-
- <listitem><para>
- Click the name of the Zone on which you are setting up MidoNet
- </para></listitem>
-
- <listitem><para>
- Click the Physical Network tab
- </para></listitem>
-
- <listitem><para>
- Click the Name of the Network on which you are setting up MidoNet
- </para></listitem>
-
- <listitem><para>
- Click Configure on the Network Service Providers box
- </para></listitem>
-
- <listitem><para>
- Click on the name MidoNet
- </para></listitem>
-
- <listitem><para>
- Click the Enable Provider button in the Network tab
- </para></listitem>
-
- </orderedlist>
- </para>
-</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/en-US/plugin-midonet-usage.xml
----------------------------------------------------------------------
diff --git a/midonet/en-US/plugin-midonet-usage.xml b/midonet/en-US/plugin-midonet-usage.xml
deleted file mode 100644
index a314581..0000000
--- a/midonet/en-US/plugin-midonet-usage.xml
+++ /dev/null
@@ -1,29 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="Using-the-MidoNet-Plugin" >
- <title>Using the MidoNet Plugin</title>
-
- <xi:include href="plugin-midonet-preparations.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="plugin-midonet-ui.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="plugin-midonet-provider.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-</chapter>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/midonet/publican.cfg
----------------------------------------------------------------------
diff --git a/midonet/publican.cfg b/midonet/publican.cfg
deleted file mode 100644
index 6558d99..0000000
--- a/midonet/publican.cfg
+++ /dev/null
@@ -1,28 +0,0 @@
-# Publican configuration file for CloudStack Complete Documentation Set
-# Contains all technical docs except release notes
-# Config::Simple 4.58
-# Tue May 29 00:57:27 2012
-#
-# 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.
-
-xml_lang: en-US
-type: Book
-docname: MidoNet_Plugin_Guide
-brand: cloudstack
-chunk_first: 1
-chunk_section_depth: 1
-condition: install
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/Author_Group.xml
----------------------------------------------------------------------
diff --git a/nicira/en-US/Author_Group.xml b/nicira/en-US/Author_Group.xml
deleted file mode 100644
index ba9e651..0000000
--- a/nicira/en-US/Author_Group.xml
+++ /dev/null
@@ -1,32 +0,0 @@
-<?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;
-]>
-
-<!-- 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.
--->
-
-
-<authorgroup>
- <author>
- <firstname>Apache</firstname>
- <surname>CloudStack</surname>
- </author>
-</authorgroup>
-
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/Book_Info.xml
----------------------------------------------------------------------
diff --git a/nicira/en-US/Book_Info.xml b/nicira/en-US/Book_Info.xml
deleted file mode 100644
index 327668d..0000000
--- a/nicira/en-US/Book_Info.xml
+++ /dev/null
@@ -1,47 +0,0 @@
-<?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 "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.
--->
-
-<bookinfo id="book-release-notes-3.0.4">
- <title>&PRODUCT; Guide</title>
- <subtitle>Revised August 9, 2012 10:48 pm Pacific</subtitle>
- <productname>Apache CloudStack</productname>
- <productnumber>4.2.0</productnumber>
- <edition>1</edition>
- <pubsnumber></pubsnumber>
- <abstract>
- <para>
- Complete technical documentation of &PRODUCT;.
- </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/cloudstack-docs/blob/cb915b74/nicira/en-US/CloudStack_Nicira_NVP_Guide.ent
----------------------------------------------------------------------
diff --git a/nicira/en-US/CloudStack_Nicira_NVP_Guide.ent b/nicira/en-US/CloudStack_Nicira_NVP_Guide.ent
deleted file mode 100644
index abb1885..0000000
--- a/nicira/en-US/CloudStack_Nicira_NVP_Guide.ent
+++ /dev/null
@@ -1,22 +0,0 @@
-<!-- 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.
--->
-
-<!ENTITY PRODUCT "CloudStack">
-<!ENTITY BOOKID "Technical Documentation">
-<!ENTITY YEAR "2012">
-<!ENTITY HOLDER "Apache Software Foundation">
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/CloudStack_Nicira_NVP_Guide.xml
----------------------------------------------------------------------
diff --git a/nicira/en-US/CloudStack_Nicira_NVP_Guide.xml b/nicira/en-US/CloudStack_Nicira_NVP_Guide.xml
deleted file mode 100644
index 5431fc1..0000000
--- a/nicira/en-US/CloudStack_Nicira_NVP_Guide.xml
+++ /dev/null
@@ -1,55 +0,0 @@
-<?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 "cloudstack.ent">
-%BOOK_ENTITIES;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-
-<!-- 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.
--->
-
-<book>
- <bookinfo id="cloudstack_plugin_niciranvp">
- <title>&PRODUCT; Plugin Guide for the Nicira NVP Plugin</title>
- <productname>Apache CloudStack</productname>
- <productnumber>4.2.0</productnumber>
- <edition>1</edition>
- <pubsnumber></pubsnumber>
- <abstract>
- <para>
- Plugin Guide for the Nicira NVP Plugin.
- </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>
- <xi:include href="plugin-niciranvp-about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="plugin-niciranvp-usage.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="plugin-niciranvp-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="plugin-niciranvp-troubleshooting.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="plugin-niciranvp-revisions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-</book>
-
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/images/nvp-add-controller.png
----------------------------------------------------------------------
diff --git a/nicira/en-US/images/nvp-add-controller.png b/nicira/en-US/images/nvp-add-controller.png
deleted file mode 100644
index e02d31f..0000000
Binary files a/nicira/en-US/images/nvp-add-controller.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/images/nvp-enable-provider.png
----------------------------------------------------------------------
diff --git a/nicira/en-US/images/nvp-enable-provider.png b/nicira/en-US/images/nvp-enable-provider.png
deleted file mode 100644
index 0f2d02d..0000000
Binary files a/nicira/en-US/images/nvp-enable-provider.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/images/nvp-network-offering.png
----------------------------------------------------------------------
diff --git a/nicira/en-US/images/nvp-network-offering.png b/nicira/en-US/images/nvp-network-offering.png
deleted file mode 100644
index c2d25c4..0000000
Binary files a/nicira/en-US/images/nvp-network-offering.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/images/nvp-physical-network-stt.png
----------------------------------------------------------------------
diff --git a/nicira/en-US/images/nvp-physical-network-stt.png b/nicira/en-US/images/nvp-physical-network-stt.png
deleted file mode 100644
index 2ce7853..0000000
Binary files a/nicira/en-US/images/nvp-physical-network-stt.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/images/nvp-vpc-offering-edit.png
----------------------------------------------------------------------
diff --git a/nicira/en-US/images/nvp-vpc-offering-edit.png b/nicira/en-US/images/nvp-vpc-offering-edit.png
deleted file mode 100644
index ff235e2..0000000
Binary files a/nicira/en-US/images/nvp-vpc-offering-edit.png and /dev/null differ
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/cb915b74/nicira/en-US/plugin-niciranvp-about.xml
----------------------------------------------------------------------
diff --git a/nicira/en-US/plugin-niciranvp-about.xml b/nicira/en-US/plugin-niciranvp-about.xml
deleted file mode 100644
index cfab83c..0000000
--- a/nicira/en-US/plugin-niciranvp-about.xml
+++ /dev/null
@@ -1,28 +0,0 @@
-<?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;
-<!ENTITY % xinclude SYSTEM "http://www.docbook.org/xml/4.4/xinclude.mod">
-%xinclude;
-]>
-<!-- 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="About-the-Nicira-NVP-Plugin" >
- <title>The Nicira NVP Plugin</title>
- <xi:include href="plugin-niciranvp-introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="plugin-niciranvp-features.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
-</chapter>
-