openstack-manuals/doc/install-guide/source/basics-networking-neutron.rst
Deena 1ab6f4c957 Removed unnecessary note admonitions
Removed note markup from content in the network assumptions list of OpenStack
Networking (neutron).

Fixed instances of capital "i" in internet.

Change-Id: Iea98b9b35a470ef9fc752de26e8b05b15f73424d
Closes-Bug: #1494575
2015-09-12 12:43:03 +10:00

13 KiB

OpenStack Networking (neutron)

The example architecture with OpenStack Networking (neutron) requires one controller node, one network node, and at least one compute node. The controller node contains one network interface on the management network. The network node contains one network interface on the management network, one on the instance tunnels network, and one on the external network. The compute node contains one network interface on the management network and one on the instance tunnels network.

The example architecture assumes use of the following networks:

  • Management on 10.0.0.0/24 with gateway 10.0.0.1

    This network requires a gateway to provide internet access to all nodes for administrative purposes such as package installation, security updates, DNS, and Network Time Protocol (NTP).

  • Instance tunnels on 10.0.1.0/24 without a gateway

    This network does not require a gateway because communication only occurs among network and compute nodes in your OpenStack environment.

  • External on 203.0.113.0/24 with gateway 203.0.113.1

    This network requires a gateway to provide internet access to instances in your OpenStack environment.

You can modify these ranges and gateways to work with your particular network infrastructure.

Note

Network interface names vary by distribution. Traditionally, interfaces use "eth" followed by a sequential number. To cover all variations, this guide simply refers to the first interface as the interface with the lowest number, the second interface as the interface with the middle number, and the third interface as the interface with the highest number.

Unless you intend to use the exact configuration provided in this example architecture, you must modify the networks in this procedure to match your environment. Also, each node must resolve the other nodes by name in addition to IP address. For example, the controller name must resolve to 10.0.0.11, the IP address of the management interface on the controller node.

Warning

Reconfiguring network interfaces will interrupt network connectivity. We recommend using a local terminal session for these procedures.

Controller node

To configure networking:

  1. Configure the first interface as the management interface:

    IP address: 10.0.0.11

    Network mask: 255.255.255.0 (or /24)

    Default gateway: 10.0.0.1

  2. Reboot the system to activate the changes.

To configure name resolution:

  1. Set the hostname of the node to controller.

  2. Edit the /etc/hosts: file to contain the following:

    # controller
    10.0.0.11       controller
    
    # network
    10.0.0.21       network
    
    # compute1
    10.0.0.31       compute1

    Warning

    Some distributions add an extraneous entry in the /etc/hosts file that resolves the actual hostname to another loopback IP address such as 127.0.1.1. Note it's 127.0.*1.1*, do not remove the required 127.0.0.1 entry. You must comment out or remove this entry to prevent name resolution problems.

Network node

To configure networking:

  1. Configure the first interface as the management interface:

    IP address: 10.0.0.21

    Network mask: 255.255.255.0 (or /24)

    Default gateway: 10.0.0.1

  2. Configure the second interface as the instance tunnels interface:

    IP address: 10.0.1.21

    Network mask: 255.255.255.0 (or /24)

  3. The external interface uses a special configuration without an IP address assigned to it. Configure the third interface as the external interface:

    Replace INTERFACE_NAME with the actual interface name. For example, eth2 or ens256.

    ubuntu or debian

    1. Edit the /etc/network/interfaces file to contain the following:

      # The external network interface
      auto INTERFACE_NAME
      iface INTERFACE_NAME inet manual
            up ip link set dev $IFACE up
            down ip link set dev $IFACE down

    rdo

    1. Edit the /etc/sysconfig/network-scripts/ifcfg-INTERFACE_NAME file to contain the following:

      Do not change the HWADDR and UUID keys.

      DEVICE= INTERFACE_NAME
      TYPE=Ethernet
      ONBOOT="yes"
      BOOTPROTO="none"

    obs

    1. Edit the /etc/sysconfig/network/ifcfg-INTERFACE_NAME file to contain the following:

      STARTMODE='auto'
      BOOTPROTO='static'
  4. Reboot the system to activate the changes.

To configure name resolution:

  1. Set the hostname of the node to network.

  2. Edit the /etc/hosts file to contain the following:

    # network
    10.0.0.21       network
    
    # controller
    10.0.0.11       controller
    
    # compute1
    10.0.0.31       compute1

    Warning

    Some distributions add an extraneous entry in the /etc/hosts file that resolves the actual hostname to another loopback IP address such as 127.0.1.1. Note it's 127.0.*1.1*, do not remove the required 127.0.0.1 entry. You must comment out or remove this entry to prevent name resolution problems.

Compute node

To configure networking:

  1. Configure the first interface as the management interface:

    IP address: 10.0.0.31

    Network mask: 255.255.255.0 (or /24)

    Default gateway: 10.0.0.1

    Note

    Additional compute nodes should use 10.0.0.32, 10.0.0.33, and so on.

  2. Configure the second interface as the instance tunnels interface:

    IP address: 10.0.1.31

    Network mask: 255.255.255.0 (or /24)

    Note

    Additional compute nodes should use 10.0.1.32, 10.0.1.33, and so on.

  3. Reboot the system to activate the changes.

To configure name resolution:

  1. Set the hostname of the node to compute1.

  2. Edit the /etc/hosts file to contain the following:

    # compute1
    10.0.0.31       compute1
    
    # controller
    10.0.0.11       controller
    
    # network
    10.0.0.21       network

    Warning

    Some distributions add an extraneous entry in the /etc/hosts file that resolves the actual hostname to another loopback IP address such as 127.0.1.1. You must comment out or remove this entry to prevent name resolution problems.

Verify connectivity

We recommend that you verify network connectivity to the internet and among the nodes before proceeding further.

  1. From the controller node, ping a site on the internet:

    # ping -c 4 openstack.org
    PING openstack.org (174.143.194.225) 56(84) bytes of data.
    64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
    64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
    64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
    64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
    
    --- openstack.org ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3022ms
    rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms
  2. From the controller node, ping the management interface on the network node:

    # ping -c 4 network
    PING network (10.0.0.21) 56(84) bytes of data.
    64 bytes from network (10.0.0.21): icmp_seq=1 ttl=64 time=0.263 ms
    64 bytes from network (10.0.0.21): icmp_seq=2 ttl=64 time=0.202 ms
    64 bytes from network (10.0.0.21): icmp_seq=3 ttl=64 time=0.203 ms
    64 bytes from network (10.0.0.21): icmp_seq=4 ttl=64 time=0.202 ms
    
    --- network ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3000ms
    rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms
  3. From the controller node, ping the management interface on the compute node:

    # ping -c 4 compute1
    PING compute1 (10.0.0.31) 56(84) bytes of data.
    64 bytes from compute1 (10.0.0.31): icmp_seq=1 ttl=64 time=0.263 ms
    64 bytes from compute1 (10.0.0.31): icmp_seq=2 ttl=64 time=0.202 ms
    64 bytes from compute1 (10.0.0.31): icmp_seq=3 ttl=64 time=0.203 ms
    64 bytes from compute1 (10.0.0.31): icmp_seq=4 ttl=64 time=0.202 ms
    
    --- network ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3000ms
    rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms
  4. From the network node, ping a site on the internet:

    # ping -c 4 openstack.org
    PING openstack.org (174.143.194.225) 56(84) bytes of data.
    64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
    64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
    64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
    64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
    
    --- openstack.org ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3022ms
    rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms
  5. From the network node, ping the management interface on the controller node:

    # ping -c 4 controller
    PING controller (10.0.0.11) 56(84) bytes of data.
    64 bytes from controller (10.0.0.11): icmp_seq=1 ttl=64 time=0.263 ms
    64 bytes from controller (10.0.0.11): icmp_seq=2 ttl=64 time=0.202 ms
    64 bytes from controller (10.0.0.11): icmp_seq=3 ttl=64 time=0.203 ms
    64 bytes from controller (10.0.0.11): icmp_seq=4 ttl=64 time=0.202 ms
    
    --- controller ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3000ms
    rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms
  6. From the network node, ping the instance tunnels interface on the compute node:

    # ping -c 4 10.0.1.31
    PING 10.0.1.31 (10.0.1.31) 56(84) bytes of data.
    64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=1 ttl=64 time=0.263 ms
    64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=2 ttl=64 time=0.202 ms
    64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=3 ttl=64 time=0.203 ms
    64 bytes from 10.0.1.31 (10.0.1.31): icmp_seq=4 ttl=64 time=0.202 ms
    
    --- 10.0.1.31 ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3000ms
    rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms
  7. From the compute node, ping a site on the internet:

    # ping -c 4 openstack.org
    PING openstack.org (174.143.194.225) 56(84) bytes of data.
    64 bytes from 174.143.194.225: icmp_seq=1 ttl=54 time=18.3 ms
    64 bytes from 174.143.194.225: icmp_seq=2 ttl=54 time=17.5 ms
    64 bytes from 174.143.194.225: icmp_seq=3 ttl=54 time=17.5 ms
    64 bytes from 174.143.194.225: icmp_seq=4 ttl=54 time=17.4 ms
    
    --- openstack.org ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3022ms
    rtt min/avg/max/mdev = 17.489/17.715/18.346/0.364 ms
  8. From the compute node, ping the management interface on the controller node:

    # ping -c 4 controller
    PING controller (10.0.0.11) 56(84) bytes of data.
    64 bytes from controller (10.0.0.11): icmp_seq=1 ttl=64 time=0.263 ms
    64 bytes from controller (10.0.0.11): icmp_seq=2 ttl=64 time=0.202 ms
    64 bytes from controller (10.0.0.11): icmp_seq=3 ttl=64 time=0.203 ms
    64 bytes from controller (10.0.0.11): icmp_seq=4 ttl=64 time=0.202 ms
    
    --- controller ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3000ms
    rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms
  9. From the compute node, ping the instance tunnels interface on the network node:

    # ping -c 4 10.0.1.21
    PING 10.0.1.21 (10.0.1.21) 56(84) bytes of data.
    64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=1 ttl=64 time=0.263 ms
    64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=2 ttl=64 time=0.202 ms
    64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=3 ttl=64 time=0.203 ms
    64 bytes from 10.0.1.21 (10.0.1.21): icmp_seq=4 ttl=64 time=0.202 ms
    
    --- 10.0.1.21 ping statistics ---
    4 packets transmitted, 4 received, 0% packet loss, time 3000ms
    rtt min/avg/max/mdev = 0.202/0.217/0.263/0.030 ms