Difference between revisions of "NetworkingGuide/TOC"
Ionosphere80 (talk | contribs) |
Ionosphere80 (talk | contribs) |
||
Line 1: | Line 1: | ||
− | + | This guide targets OpenStack administrators seeking to deploy and manage neutron. | |
− | + | == Instructions for Contributors == | |
− | |||
− | |||
# Pick a topic. | # Pick a topic. | ||
# Develop content (text and/or diagrams) in a format that supports at least basic markup (titles, paragraphs, lists, etc.). | # Develop content (text and/or diagrams) in a format that supports at least basic markup (titles, paragraphs, lists, etc.). | ||
− | # Provide a link to the content (e.g., gist on github.com) | + | # Provide a link to the content (e.g., gist on github.com) under the associated topic. |
# Send e-mail to reviewers. | # Send e-mail to reviewers. | ||
− | + | == Proposed topics for the Networking Guide == | |
− | + | Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/create-networking-guide | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | NOTE: This is the initial "import" from the install and admin guides, as a starting point. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Preface === | === Preface === | ||
Line 118: | Line 62: | ||
### Server | ### Server | ||
#### Overview/concepts (provides API, manages database, etc.) | #### Overview/concepts (provides API, manages database, etc.) | ||
− | |||
### Plug-ins | ### Plug-ins | ||
#### Overview/concepts (manages agents) | #### Overview/concepts (manages agents) | ||
− | |||
### Agents | ### Agents | ||
#### Overview/concepts (provide layer 2/3 connectivity to instances, handle physical-virtual network transition, handle metadata, etc.) | #### Overview/concepts (provide layer 2/3 connectivity to instances, handle physical-virtual network transition, handle metadata, etc.) | ||
Line 127: | Line 69: | ||
##### Linux Bridge | ##### Linux Bridge | ||
###### Overview/concepts | ###### Overview/concepts | ||
− | |||
##### OVS | ##### OVS | ||
###### Overview/concepts | ###### Overview/concepts | ||
− | |||
#### Layer 3 (IP/Routing) | #### Layer 3 (IP/Routing) | ||
##### L3 | ##### L3 | ||
###### Overview/concepts | ###### Overview/concepts | ||
− | |||
##### DHCP | ##### DHCP | ||
###### Overview/concepts | ###### Overview/concepts | ||
− | |||
#### Miscellaneous | #### Miscellaneous | ||
##### Metadata | ##### Metadata | ||
###### Overview/concepts | ###### Overview/concepts | ||
− | |||
− | |||
− | |||
=== Configuration === | === Configuration === | ||
Line 159: | Line 94: | ||
##### Flat | ##### Flat | ||
##### VLAN | ##### 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) | |
− | + | #### Security | |
− | + | ##### Options | |
− | + | ### Agents | |
− | + | #### L3 | |
− | + | ##### Configuration file | |
− | + | #### DHCP | |
− | + | ##### Configuration file | |
− | + | #### Metadata agent | |
− | + | ##### Configuration file | |
− | + | ##### Packet routing magic | |
− | + | ||
− | + | === 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 | ||
+ | ### 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 | ||
+ | |||
+ | # Adding high availability for DHCP | ||
+ | ## DHCP agents (http://docs.openstack.org/admin-guide-cloud/content/app_demo_multi_dhcp_agents.html) | ||
+ | |||
+ | === Advanced configuration === | ||
Content copied from: | Content copied from: | ||
*http://docs.openstack.org/admin-guide-cloud/content/section_networking-advanced-config.html | *http://docs.openstack.org/admin-guide-cloud/content/section_networking-advanced-config.html | ||
Line 206: | Line 171: | ||
*http://docs.openstack.org/admin-guide-cloud/content/section_networking-adv-operational_features.html | *http://docs.openstack.org/admin-guide-cloud/content/section_networking-adv-operational_features.html | ||
− | + | # Operational | |
− | |||
1. Logging (http://docs.openstack.org/admin-guide-cloud/content/section_adv_logging.html) | 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 == | ||
+ | |||
+ | * [http://docs.openstack.org/grizzly/openstack-network/admin/content/ Grizzly Networking Administration Guide] | ||
+ | * Networking section of Install Guide for [http://docs.openstack.org/icehouse/install-guide/install/yum/content/ch_networking.html Red Hat], [http://docs.openstack.org/icehouse/install-guide/install/zypper/content/ch_networking.html SUSE], [http://docs.openstack.org/icehouse/install-guide/install/apt-debian/content/ch_networking.html Debian], [http://docs.openstack.org/icehouse/install-guide/install/apt/content/ch_networking.html Ubuntu] | ||
+ | * [http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html Networking section of Cloud Admin Guide] | ||
+ | * [http://docs.openstack.org/openstack-ops/content/network_design.html Networking section of Operators Guide] | ||
+ | * [http://docs.openstack.org/security-guide/content/networking.html Networking section of Security Guide] | ||
+ | * [http://docs.openstack.org/icehouse/config-reference/content/ch_configuring-openstack-networking.html Networking section of Config Reference] | ||
+ | * [http://docs.openstack.org/api/openstack-network/2.0/content/ Network API Reference] | ||
+ | |||
+ | 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 hypervs) | ||
+ | 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 (concpet 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 (mostly links) | ||
+ | Operations Guide | ||
+ | (concept info on different architecture and topologies) | ||
+ | Security Guide ... | ||
[[Category:Documentation Blueprint]] | [[Category:Documentation Blueprint]] |
Revision as of 15:26, 27 September 2014
This guide targets OpenStack administrators seeking to deploy and manage neutron.
Contents
Instructions for Contributors
- Pick a topic.
- Develop content (text and/or diagrams) in a format that supports at least basic markup (titles, paragraphs, lists, etc.).
- Provide a link to the content (e.g., gist on github.com) under the associated topic.
- Send e-mail to reviewers.
Proposed topics for the Networking Guide
Blueprint: https://blueprints.launchpad.net/openstack-manuals/+spec/create-networking-guide
NOTE: This is the initial "import" from the install and admin guides, as a starting point.
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 agent
- Configuration file
- Packet routing magic
- 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
- 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
- Adding high availability for DHCP
Advanced configuration
Content copied from: *http://docs.openstack.org/admin-guide-cloud/content/section_networking-advanced-config.html *http://docs.openstack.org/admin-guide-cloud/content/section_networking-adv-features.html *http://docs.openstack.org/admin-guide-cloud/content/section_networking-adv-operational_features.html
- 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
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 hypervs) 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 (concpet 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 (mostly links) Operations Guide (concept info on different architecture and topologies) Security Guide ...