Merge "Install-guide-rst: Splitup networking"

doc/install-guide-rst/source/networking-neutron.rst

@@ -0,0 +1,44 @@
+==============================
+OpenStack Networking (neutron)
+==============================
+
+.. toctree::
+
+   neutron-concepts.rst
+   neutron-controller-node.rst
+
+.. todo(karenb)
+   section_neutron-network-node.xml
+   section_neutron-compute-node.xml
+   section_neutron-initial-networks.xml
+
+OpenStack Networking allows you to create and attach interface devices
+managed by other OpenStack services to networks. Plug-ins can be
+implemented to accommodate different networking equipment and
+software, providing flexibility to OpenStack architecture and
+deployment.
+
+It includes the following components:
+
+neutron-server
+  Accepts and routes API requests to the appropriate OpenStack
+  Networking plug-in for action.
+
+OpenStack Networking plug-ins and agents
+  Plugs and unplugs ports, creates networks or subnets, and provides
+  IP addressing. These plug-ins and agents differ depending on the
+  vendor and technologies used in the particular cloud. OpenStack
+  Networking ships with plug-ins and agents for Cisco virtual and
+  physical switches, NEC OpenFlow products, Open vSwitch, Linux
+  bridging, and the VMware NSX product.
+
+  The common agents are L3 (layer 3), DHCP (dynamic host IP
+  addressing), and a plug-in agent.
+
+Messaging queue
+  Used by most OpenStack Networking installations to route
+  information between the neutron-server and various agents, as well
+  as a database to store networking state for particular plug-ins.
+
+OpenStack Networking mainly interacts with OpenStack Compute to
+provide networks and connectivity for its instances.

doc/install-guide-rst/source/networking-next-steps.rst

@@ -0,0 +1,8 @@
+==========
+Next steps
+==========
+
+Your OpenStack environment now includes the core components necessary
+to launch a basic instance. You can :doc:`launch an
+instance <launch-instance-neutron>` or add more OpenStack services
+to your environment.

doc/install-guide-rst/source/networking-nova.rst

@@ -0,0 +1,9 @@
+================================
+Legacy networking (nova-network)
+================================
+
+.. todo(karenb)
+   section_nova-networking.xml
+   section_nova-networking-controller-node.xml
+   section_nova-networking-compute-node.xml
+   section_nova-networking-initial-network.xml

doc/install-guide-rst/source/networking.rst

@@ -14,35 +14,8 @@ For more information, see the
 `Networking <http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html>`__
 chapter of the OpenStack Cloud Administrator Guide.
 
-OpenStack Networking (neutron)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 .. toctree::
 
-   neutron-concepts.rst
-   neutron-controller-node.rst
-
-.. todo
-   section_getstart_networking.xml
-   section_neutron-network-node.xml
-   section_neutron-compute-node.xml
-   section_neutron-initial-networks.xml
-
-
-Legacy networking (nova-network)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. todo
-   section_nova-networking.xml
-   section_nova-networking-controller-node.xml
-   section_nova-networking-compute-node.xml
-   section_nova-networking-initial-network.xml
-
-
-Next steps
-~~~~~~~~~~
-
-Your OpenStack environment now includes the core components necessary
-to launch a basic instance. You can :doc:`launch an
-instance <launch-instance-neutron>` or add more OpenStack services
-to your environment.
+   networking-neutron.rst
+   networking-nova.rst
+   networking-next-steps.rst