Files
openstack-manuals/doc/install-guide/source/neutron-compute-install.rst
Matthew Kassawara 88088445ab [install] Liberty updates for neutron
Update neutron configuration for Liberty and address some
consistency issues.

Changes and testing specific to distribution packages
primarily involve Ubuntu. Other distributions may require
additional patches.

Change-Id: I81b1adef8b0455e4415b1dee0f3b91cbe5f600fa
Closes-Bug: 1502760
Implements: blueprint installguide-liberty
2015-10-05 05:33:20 +00:00

7.8 KiB

Install and configure compute node

The compute node handles connectivity and security groups <security group> for instances.

Prerequisites

Before you install and configure OpenStack Networking, you must kernel networking parameters to disable reverse-path filtering:

  1. Edit the /etc/sysctl.conf file to contain the following parameters:

    net.ipv4.conf.all.rp_filter=0
    net.ipv4.conf.default.rp_filter=0
  2. Implement the changes:

    # sysctl -p

ubuntu or rdo or obs

Install the components

ubuntu

# apt-get install neutron-plugin-linuxbridge-agent

rdo

# yum install openstack-neutron-linuxbridge

obs

# zypper install --no-recommends openstack-neutron-linuxbridge-agent ipset

debian

Install and configure the Networking components

  1. # apt-get install neutron-plugin-linuxbridge-agent
  2. Respond to prompts for database management, Identity service credentials, service endpoint, and message queue credentials.

  3. Select the ML2 plug-in:

    Neutron plug-in selection dialog

    Note

    Selecting the ML2 plug-in also populates the service_plugins and allow_overlapping_ips options in the /etc/neutron/neutron.conf file with the appropriate values.

ubuntu or rdo or obs

Configure the common component

The Networking common component configuration includes the authentication mechanism, message queue, and plug-in.

  1. Edit the /etc/neutron/neutron.conf file and complete the following actions:
    • In the [database] section, comment out any connection options because compute nodes do not directly access the database.

    • In the [DEFAULT] and [oslo_messaging_rabbit] sections, configure RabbitMQ message queue access:

      [DEFAULT]
      ...
      rpc_backend = rabbit
      
      [oslo_messaging_rabbit]
      ...
      rabbit_host = controller
      rabbit_userid = openstack
      rabbit_password = RABBIT_PASS

      Replace RABBIT_PASS with the password you chose for the openstack account in RabbitMQ.

    • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

      [DEFAULT]
      ...
      auth_strategy = keystone
      
      [keystone_authtoken]
      ...
      auth_uri = http://controller:5000
      auth_url = http://controller:35357
      auth_plugin = password
      project_domain_id = default
      user_domain_id = default
      project_name = service
      username = neutron
      password = NEUTRON_PASS

      Replace NEUTRON_PASS with the password you chose for the neutron user in the Identity service.

      Note

      Comment out or remove any other options in the [keystone_authtoken] section.

    • (Optional) To assist with troubleshooting, enable verbose logging in the [DEFAULT] section:

      [DEFAULT]
      ...
      verbose = True

Configure networking options

Choose the same networking option that you chose for the controller node to configure services specific to it.

Note

Option 2 augments option 1 with the layer-3 (routing) service and enables self-service (private) networks. If you want to use public (provider) and private (self-service) networks, choose option 2.

neutron-compute-install-option1.rst neutron-compute-install-option2.rst

Configure Compute to use Networking

  1. Edit the /etc/nova/nova.conf file and complete the following actions:
    • In the [neutron] section, configure access parameters:

      [neutron]
      ...
      url = http://controller:9696
      auth_url = http://controller:35357
      auth_plugin = password
      project_domain_id = default
      user_domain_id = default
      region_name = RegionOne
      project_name = service
      username = neutron
      password = NEUTRON_PASS

      Replace NEUTRON_PASS with the password you chose for the neutron user in the Identity service.

Finalize installation

rdo

  1. The Networking service initialization scripts expect a symbolic link /etc/neutron/plugin.ini pointing to the ML2 plug-in configuration file, /etc/neutron/plugins/ml2/ml2_conf.ini. If this symbolic link does not exist, create it using the following command:

    # ln -s /etc/neutron/plugins/ml2/ml2_conf.ini /etc/neutron/plugin.ini
  2. Due to a packaging issue, the Linux bridge agent initialization script explicitly looks for the Linux bridge plug-in configuration file rather than the agent configuration file. Run the following commands to resolve this issue:

    # cp /usr/lib/systemd/system/neutron-linuxbridge-agent.service \
      /usr/lib/systemd/system/neutron-linuxbridge-agent.service.orig
    # sed -i 's,openvswitch/linuxbridge_neutron_plugin.ini,ml2/linuxbridge_agent.ini,g' \
      /usr/lib/systemd/system/neutron-linuxbridge-agent.service

    Note

    Future upgrades of the neutron-linuxbridge-agent package may overwrite this modification.

  3. Restart the Compute service:

    # systemctl restart openstack-nova-compute.service
  4. Start the Linux bridge agent and configure it to start when the system boots:

    # systemctl enable neutron-linuxbridge-agent.service
    # systemctl start neutron-linuxbridge-agent.service

obs

  1. The Networking service initialization scripts expect the variable NEUTRON_PLUGIN_CONF in the /etc/sysconfig/neutron file to reference the ML2 plug-in configuration file. Edit the /etc/sysconfig/neutron file and add the following:

    NEUTRON_PLUGIN_CONF="/etc/neutron/plugins/ml2/ml2_conf.ini"
  2. Restart the Compute service:

    # systemctl restart openstack-nova-compute.service
  3. Start the Linux Bridge agent and configure it to start when the system boots:

    # systemctl enable openstack-neutron-linuxbridge-agent.service
    # systemctl start openstack-neutron-linuxbridge-agent.service

ubuntu or debian

  1. Restart the Compute service:

    # service nova-compute restart
  2. Due to a packaging issue, the Linux bridge agent initialization script explicitly looks for the ML2 plug-in configuration file rather than the agent configuration file. Run the following commands to resolve this issue:

    # cp /etc/init/neutron-plugin-linuxbridge-agent.conf \
      /etc/init/neutron-plugin-linuxbridge-agent.conf.orig
    # sed -i 's,ml2_conf.ini,linuxbridge_agent.ini,g' \
      /etc/init/neutron-plugin-linuxbridge-agent.conf
  3. Restart the Linux bridge agent:

    # service neutron-plugin-linuxbridge-agent restart