Configure Networking

This article describes how to configure networking for Platform9 Managed OpenStack (PMO) for Linux-KVM.

Before your configure networking for your PMO cloud, we recommend reading the following documents for an in-depth understanding of PMO networing.

Network Configuration

Network configuration in PMO is managed via the Networks -> Network Config dashboard, accessible only to users with administrator privileges.

Networking in PMO can be configured in two modes:

  1. Distributed Virtual Routing (L3-DVR) or,
  2. Legacy mode.

The mode that you choose to use depends on your specific use case, each having its own pros and cons.

Step 1: Setup Network Options Using the Network Config Page

The first step in networking configuration in PMO is configuration of networking options you would like to use and expose.

Network Config Screen

Selecting a Routing Mode 

  • Checking “Enable Distributed Virtual Routing” will enable DVR mode. In DVR, each hypervisor is L3-capable. Both east-west traffic and north-south traffic using floating IPs are handled directly at the hypervisor.
  • Leaving “Enable Distributed Virtual Routing” unchecked will enable legacy mode. In the legacy mode, both east-west and north-south traffic using floating IPs are handled through one or more dedicated Network Nodes.

If you plan to use DVR, check this box and skip Step 2.

DNS Domain 

This configuration option enables DNS resolution across virtual machines (instances) within a given tenant network. The DNS name for a given instance will be formed as <instance name>.<dns domain>. This option must be populated to enable VM DNS.

Number of DHCP Servers per Network

Specifies the number of DHCP servers you want to run in active-active mode per Neutron tenant network. This is useful for redundancy.

DNS Forwarding Addresses

These are a list of DNS forwarding resolvers that will be used when a DNS query cannot be resolved within Neutron (For example, VM within a tenant tries resolving a hostname outside the tenant network; say

Network Type 

Choose the type of networks you would like Neutron to support as well as the type of networks you would like Neutron to provide to self-service users for creating tenant networks (isolated networks). Drag and arrange to specify the order in which the networks are chosen upon tenant network creation.

Neutron leverages physical infrastructure configuration for VLAN-based tenant networks as well as using IP connectivity for overlay networks such as VXLAN and GRE. Select the type of configuration you would like to choose. Depending on the type of network you choose, you will need to specify additional information.

  • Tunneling-based networks - VXLAN and GRE -  require a VNID (Identifier) range to be specified.
  • VLAN-based networks require you specify VLAN ranges on specific physical network config. See below.

VLAN-Specific Configuration: Create One or More Physical Network Configs

A physical network config identifies the physical networking infrastructure configuration as it exists in your data center. This is the networking backing that Neutron will utilize.

Physical network configuration consists of:

  • A unique label (eg phys-net1), that allows Neutron to identify the network from here on.
  • A description of your networking topology, by specifying for each hypervisor, what network interface maps to this physical network config.

Your can define one or more ‘physical network configs’ in OpenStack, allowing you to make Neutron aware of multiple networks. These are created as part of assigning Neutron network node role to a physical server.

As shown in the screenshot above, for each physical network config, you need to define a unique label for the specific physical network, and specify a range of VLAN IDs corresponding to this physical network. You would want to specify a range of VLAN IDs when you are using VLAN-based networking, and you’d like Neutron to use a specific subrange of VLAN IDs corresponding to this physical network.

Step 2: (Non DVR Mode) Assigning Networking Role to A Physical Server / Network Node

Once you have configured the network config and added a server to your Platform9 controller, the next step is configuring a server node with ‘networking’ role to one of your physical servers, similar to configuration of Glance image catalog, Cinder block storage, etc. Assigning ‘networking’ role to a server results in Platform9 deploying the necessary OpenStack Neutron services on that node.

We recommend designating a server to act as dedicated ‘network node’ that is not otherwise used to run virtual machines, even though Platform9 will not prevent assigning both hypervisor role and networking role to the same server. This node is utilized for deploying OpenStack default routing components, DHCP server(s) for tenant networks, etc. We recommend creating a dedicated network node if: * You plan to run more than 50 virtual machines in your Platform9 setup, and/or * You plan to deploy more than 10 networks * You plan to use OpenStack default implementation of Neutron, i.e., not leverage a third-party vendor for Neutron implementation

The servers that are assigned the networking role are responsible for L3 routing - east-west, north-south - DHCP, and DNS services. It is recommended to have more than one network node for redundancy purposes.

It is recommended to make all network nodes DHCP capable.

Step 3: Networking configuration during hypervisor authorization

For tunneling-based network support i.e. if you choose VXLAN or GRE in step 1, the only configuration change that you would need to make on both the Network Node (in case of legacy mode) and the Hypervisors is to select the tunnel endpoint that you would use for data traffic.

Authorize Hypervisor-Neutron

If you choose a combination of VLAN and one of the tunneling protocols, along with the tunnel endpoint, you must specify the physical network label along with the corresponding bridge to be used for VLAN based data traffic.

To complete the network topology specification for each physical network interface on each hypervisor, you need to specify what ‘physical network config’ it maps to by supplying the unique ‘physical network config’ label that you defined above.

In the case of DVR, you will need to specify whether you want to make this server DHCP capable or not.

The mapping bridge device is the one you created as part of handling your host operating system specific prerequisites mentioned here:

At this point, your networking configuration in PMO is complete.