Installation

Installation

This section describes how to install and configure the networking-baremetal plugin and ironic-neutron-agent.

The ironic-neutron-agent is a neutron agent that populates the host to physical network mapping for baremetal nodes in neutron. Neutron uses this to calculate the segment to host mapping information.

Install the networking-baremetal plugin and agent

At the command line:

$ pip install networking-baremetal

Or, if you have neutron installed in a virtualenv, install the networking-baremetal plugin to the same virtualenv:

$ . <path-to-neutron-venv>/bin/activate
$ pip install networking-baremetal

Enable baremetal mechanism driver in the Networking service

To enable mechanism drivers in the ML2 plug-in, edit the /etc/neutron/plugins/ml2/ml2_conf.ini configuration file. For example, this enables the openvswitch and baremetal mechanism drivers:

[ml2]
mechanism_drivers = openvswitch,baremetal

Configure ironic-neutron-agent

To configure the baremetal neutron agent, edit the neutron configuration /etc/neutron/plugins/ml2/ironic_neutron_agent.ini file. Add an [ironic] section. For example:

[ironic]
project_domain_name = Default
project_name = service
user_domain_name = Default
password = password
username = ironic
auth_url = http://identity-server.example.com/identity
auth_type = password
region_name = RegionOne

Start ironic-neutron-agent service

To start the agent either run it from the command line like in the example below or add it to the init system.

$ ironic-neutron-agent \
    --config-dir /etc/neutron \
    --config-file /etc/neutron/plugins/ml2/ironic_neutron_agent.ini \
    --log-file /var/log/neutron/ironic_neutron_agent.log
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.