Red Hat Bugzilla – Bug 994233
[Doc][RFE] creating a network from the command line doesn't work
Last modified: 2014-10-30 18:29:29 EDT
Document URL: https://access.redhat.com/site/documentation/en-US/Red_Hat_OpenStack/3/html/Getting_Started_Guide/sect-Working_with_Quantum_Networking.html
Section Number and Name: 7.8.1. Creating a Network
Describe the issue: Creating a network fails.
# source ~/keystonerc_admin
[~(keystone_admin)]# quantum net-create public01 --router:external True --provider:network_type flat --provider:physical_network public01
Invalid input for operation: Unknown provider:physical_network public01.
Suggestions for improvement:
I assume since I'm using a "local" network type, rather than a "flat" network type, this is failing. The documentation lacks information on what I need to do to change the network type appropriately in order for the above command to succeed.
It looks to me like the reporter is using a physical network name that doesn't exist. That physical network should be listed in the /etc/hosts file? Or how can they confirm that they're using a valid name?
But to make the documentation clearer, it looks like we could add examples for each type. Can you confirm that only the local, flat, and vlan types are currently supported (not gre)?
Brent, Ryan thought you might be able to answer this. thanks, Summer
Needinfo Marun Newby.
Please see Summer's Q in comment 2.
(From the link in comment 0 this is a neutron related issue, not nova networking, so setting needinfo to Maru Newby.)
Provider networks aren't my area of expertise, reassigning to Bob.
(In reply to Need Real Name from comment #0)
> Document URL:
> Section Number and Name: 7.8.1. Creating a Network
> Describe the issue: Creating a network fails.
> # source ~/keystonerc_admin
> [~(keystone_admin)]# quantum net-create public01 --router:external True
> --provider:network_type flat --provider:physical_network public01
> Invalid input for operation: Unknown provider:physical_network public01.
This error means that the physical network "public01" is not listed in network_vlan_ranges on the node where quantum-server runs. Creating a provider network of type flat or vlan requires specifying a physical network that is listed in network_vlan_ranges. Its OK to use:
network_vlan_ranges = public01,public02
or something like that, with no ranges of VLAN tags specified. This makes the physical networks available for flat or vlan provider networks without making VLANs on those physical networks available as tenant networks.
> Suggestions for improvement:
> I assume since I'm using a "local" network type, rather than a "flat"
> network type, this is failing. The documentation lacks information on what I
> need to do to change the network type appropriately in order for the above
> command to succeed.
The tenant_network_type is really orthogonal to anything having to do with enabling provider networks. You should be able to use flat or vlan provider networks in combination with any type of tenant network (vlan, local, gre). Unfortunately, bug 1019044 causes packstack to ignore CONFIG_NEUTRON_OVS_VLAN_RANGES, CONFIG_NEUTRON_OVS_BRIDGE_MAPPINGS, and CONFIG_NEUTRON_OVS_BRIDGE_IFACES for certain settings of CONFIG_NEUTRON_OVS_TENANT_NETWORK_TYPE.
Is this clarification sufficient, or does the documentation need to be updated to clarify the need to set network_vlan_ranges to include physical networks used for provider networks?
The whole openstack neworking thing has now moved to End User Guide, closing this bug.