From ec96f7db39f148b6e0393f1cd4799bf1f5e8ea46 Mon Sep 17 00:00:00 2001 From: Andreas Jaeger Date: Fri, 24 Jul 2015 10:26:45 +0200 Subject: [PATCH] Install-guide-rst: Splitup networking Create three top-level files to recreate DocBook structure. Add networking-service-overview.html Remove include usage. Change-Id: I52f87e32be241d1921892e2519698ce85451c32d --- .../source/networking-neutron.rst | 44 +++++++++++++++++++ .../source/networking-next-steps.rst | 8 ++++ .../source/networking-nova.rst | 9 ++++ doc/install-guide-rst/source/networking.rst | 33 ++------------ 4 files changed, 64 insertions(+), 30 deletions(-) create mode 100644 doc/install-guide-rst/source/networking-neutron.rst create mode 100644 doc/install-guide-rst/source/networking-next-steps.rst create mode 100644 doc/install-guide-rst/source/networking-nova.rst diff --git a/doc/install-guide-rst/source/networking-neutron.rst b/doc/install-guide-rst/source/networking-neutron.rst new file mode 100644 index 0000000000..09bf5a6f59 --- /dev/null +++ b/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. diff --git a/doc/install-guide-rst/source/networking-next-steps.rst b/doc/install-guide-rst/source/networking-next-steps.rst new file mode 100644 index 0000000000..483d2651f7 --- /dev/null +++ b/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 ` or add more OpenStack services +to your environment. diff --git a/doc/install-guide-rst/source/networking-nova.rst b/doc/install-guide-rst/source/networking-nova.rst new file mode 100644 index 0000000000..3923df02ef --- /dev/null +++ b/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 diff --git a/doc/install-guide-rst/source/networking.rst b/doc/install-guide-rst/source/networking.rst index 0751e765dc..5d283419f3 100644 --- a/doc/install-guide-rst/source/networking.rst +++ b/doc/install-guide-rst/source/networking.rst @@ -14,35 +14,8 @@ For more information, see the `Networking `__ 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 ` or add more OpenStack services -to your environment. + networking-neutron.rst + networking-nova.rst + networking-next-steps.rst