NetworkingGuide/TOC
This guide targets OpenStack administrators seeking to deploy and manage neutron.
Contents
Instructions for Contributors
- Pick an existing topic or create a new topic. For new topics, we're primarily interested in deployment scenarios.
- Develop content (text and/or diagrams) in a format that supports at least basic markup (e.g., titles, paragraphs, lists, etc.).
- Provide a link to the content (e.g., gist on github.com, wiki page, blog post, etc.) under the associated topic.
- Send e-mail to reviewers at networking@openstacknow.com.
Proposed topics for the Networking Guide
Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/create-networking-guide
Preface
Document change history
Introduction to networking
- Basic networking
- Ethernet
- VLANs
- ARP
- IP
- ICMP/TCP/UDP
- Network components
- Switches
- Routers
- Firewalls
- Load balancers
- Tunnel (segmentation) technologies
- Layer 2
- VLAN
- Layer 3
- GRE
- VXLAN
- Layer 2
- Network namespaces
- Concepts (relation to VRFs)
Introduction to OpenStack Networking (neutron)
- Virtual network component comparisons (how neutron models above components) (terms in http://docs.openstack.org/admin-guide-cloud/content/api_abstractions.html)
- Networks (switches?)
- Flat
- VLAN
- GRE
- VXLAN
- Subnets (supports multiple per network?)
- Ports (switch ports?)
- Routers (routers)
- Security groups (firewalls)
- Extensions
- Networks (switches?)
- Architecture
- Overview/concepts
- Service/component hierarchy
- Server
- Overview/concepts (provides API, manages database, etc.)
- Plug-ins
- Overview/concepts (manages agents)
- Agents
- Overview/concepts (provide layer 2/3 connectivity to instances, handle physical-virtual network transition, handle metadata, etc.)
- Layer 2 (Ethernet/Switching)
- Linux Bridge
- Overview/concepts
- OVS
- Overview/concepts
- Linux Bridge
- Layer 3 (IP/Routing)
- L3
- Overview/concepts
- DHCP
- Overview/concepts
- L3
- Miscellaneous
- Metadata
- Overview/concepts
- Metadata
- Server
Configuration
- Server
- Architecture
- Configuration file organization, relationships, etc.
- Reference common configuration items
- ML2 plug-in
- Overview
- Architecture
- Configuration file organization, relationships, etc.
- Network type drivers
- Flat
- VLAN
- GRE
- VXLAN
- Tenant network types (similar info in http://docs.openstack.org/admin-guide-cloud/content/tenant-provider-networks.html)
- Local
- VLAN
- ID ranges
- GRE
- Tunnel ID ranges
- VXLAN
- ID ranges
- Multicast discovery (L2 population)
- Mechanisms
- Linux Bridge
- Option stanza/section
- OVS
- Option stanza/section
- L2 Population
- Open Daylight
- Proprietary (vendor)
- Linux Bridge
- Security
- Options
- Network type drivers
- Agents
- L3
- Configuration file
- DHCP
- Configuration file
- Metadata
- Configuration file
- L3
- Overview
Deployment Scenarios
- Architecture 1 - Classic
- Controller node, network node, and 1+ compute nodes
- Provider networks
- Flat
- VLAN
- Tenant networks
- VLAN
- GRE
- VXLAN
- Architecture 2 - High availability (DVR and Open vSwitch)
- Controller node and 1+ compute nodes
- Provider networks
- Flat
- VLAN
- Tenant networks - for Juno with DVR, only VXLAN is supported
- VLAN
- GRE
- VXLAN
- Architecture 3 - High availability (L3 HA and Linux Bridge)
- Controller node, two network nodes, and 1+ compute nodes
- Provider networks
- Flat
- VLAN
- Tenant networks
- VLAN
- GRE
- VXLAN
- Architecture 4 - Provider networks handle L3 and DHCP services (bare pipes)
- Controller node and 1+ compute nodes
- Provider networks
- Flat
- VLAN
Miscellaneous
- Adding high availability for DHCP
Advanced configuration
- Operational
1. Logging (http://docs.openstack.org/admin-guide-cloud/content/section_adv_logging.html)
- LBaaS (http://docs.openstack.org/admin-guide-cloud/content/section_lbaas-overview.html and http://docs.openstack.org/admin-guide-cloud/content/lbaas_workflow.html and http://docs.openstack.org/admin-guide-cloud/content/install_neutron-lbaas-agent.html)
- FWaaS (http://docs.openstack.org/admin-guide-cloud/content/install_neutron-fwaas-agent.html and http://docs.openstack.org/admin-guide-cloud/content/fwaas.html)
- VPNaaS
- Service Chaining (regXboi)
- Group policy (regXboi)
- How it differs from legacy neutron data model
- Debugging
- Neutron-debug command
Potential Resources and Reusable Content
- Grizzly Networking Administration Guide
- Networking section of Install Guide for Red Hat, SUSE, Debian, Ubuntu
- Networking section of Cloud Admin Guide
- Networking section of Operators Guide
- Networking section of Security Guide
- Networking section of Config Reference
- Network API Reference
- Advanced Networking Config section of Cloud Admin Guide
- Advanced Features section of Cloud Admin Guide
- Advanced Operational Features section of Cloud Admin Guide
Cloud Administrator Guide
- Networking API (includes table with mapping from some net concepts and mapping to Neutron)
- Configuring SSL support (mostly config ref)
- LBaaS overview (mostly config ref)
- FWaaS overview (task-oriented, nice diagram)
- Plug-in architecture (links, some ref on which plug-ins work with which hypervisors)
- Plug-in configurations (subsections task-oriented on different plug-ins)
- Configure data-forwarding nodes (subsections task-oriented on different plug-ins)
- Configure DHCP agent (subsections task-oriented on different plug-ins)
- Configure L3 agent (task-oriented)
- Configure metering agent (task-oriented)
- Configure LBaaS (task-oriented, OVS or Linux Bridge)
- Networking architecture overview (overview of some neutron services)
- Network connectivity for physical hosts (diagram of basic three-node arch)
- Tenant and provider networks (info on types of networks, diagram)
- VMware NSX integration
- Configure Identity service for networking (subsections with tasks and some config ref)
- Networking scenarios - OVS (two scenarios, diagrams, tasks, OVS tunneling)
- Networking scenarios - Linux Bridge (two scenarios, diagrams)
- Networking scenarios - ML2 (concept info, two scenarios, diagrams, sec group API)
- Advanced config options (mostly config ref)
- Scalable and HA DHCP agents (tasks, diagram)
- API abstractions (concept info on neutron, good sets of tasks)
- Basic Networking operations
- Administrative operations
- Advanced Networking operations
- Use Compute with networking (lots of good tasks for common stuff)
- Advanced features through API extensions - Provider networks
- Advanced features through API extensions - L3 routing and NAT
- Advanced features through API extensions - Security groups
- Advanced features through API extensions - Basic LBaaS operations
- Advanced features through API extensions - FWaaS
- Advanced features through API extensions - Plug-in specific extensions
- Advanced features through API extensions - L3 metering
- Advanced operational features - Logging
- Advanced operational features - Notifications
- Authentication and authorization (lots of concept info, policy reference)
High Availability Guide
- (mostly links)
Operations Guide
- (concept info on different architecture and topologies)