openstack/ironic
Code Issues Proposed changes

Add documentation for baremetal mech

Browse Source 
Add to configure-networking section, installation and
configuration of networking-baremetal plugin.

Related-Bug: #1658964
Change-Id: Ic9a5d1de959cbeedb0e56ab5447042ce29028a8d
This commit is contained in:
Harald Jensas 2018-01-24 12:18:45 +01:00
parent cd7fd1feff
commit 3ad7a3e4ad
1 changed files with 28 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/source/install/configure-networking.rst
View File

@ -8,11 +8,19 @@ with the Networking service for DHCP, PXE boot and other requirements.
This section covers configuring Networking for a single flat network for bare This section covers configuring Networking for a single flat network for bare
metal provisioning. metal provisioning.
Baremetal service requires the baremetal mechanism driver to be installed and
enabled in the networking service for flat networks. Documentation regarding
installation and configuration of the baremetal mechanism driver is available
at `here <https://docs.openstack.org/networking-baremetal/latest/index.html>`_.
You will also need to provide Bare Metal service with the MAC address(es) of You will also need to provide Bare Metal service with the MAC address(es) of
each node that it is provisioning; Bare Metal service in turn will pass this each node that it is provisioning; Bare Metal service in turn will pass this
information to Networking service for DHCP and PXE boot configuration. information to Networking service for DHCP and PXE boot configuration.
An example of this is shown in the :ref:`enrollment` section. An example of this is shown in the :ref:`enrollment` section.
#. Install the networking-baremetal ml2 mechanism driver and l2 agent in the
Networking service.
#. Edit ``/etc/neutron/plugins/ml2/ml2_conf.ini`` and modify these: #. Edit ``/etc/neutron/plugins/ml2/ml2_conf.ini`` and modify these:
.. code-block:: ini .. code-block:: ini
@ -20,7 +28,7 @@ An example of this is shown in the :ref:`enrollment` section.
[ml2] [ml2]
type_drivers = flat type_drivers = flat
tenant_network_types = flat tenant_network_types = flat
mechanism_drivers = openvswitch mechanism_drivers = openvswitch,baremetal
[ml2_type_flat] [ml2_type_flat]
flat_networks = physnet1 flat_networks = physnet1
@ -34,6 +42,25 @@ An example of this is shown in the :ref:`enrollment` section.
# Replace eth2 with the interface on the neutron node which you # Replace eth2 with the interface on the neutron node which you
# are using to connect to the bare metal server # are using to connect to the bare metal server
#. Restart the ``neutron-server`` service, to load the new configuration.
#. Create and edit ``/etc/neutron/plugins/ml2/ironic_neutron_agent.ini`` and
add the required configuration. For example:
.. code-block:: ini
[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
#. Make sure the ``ironic-neutron-agent`` service is started.
#. If neutron-openvswitch-agent runs with ``ovs_neutron_plugin.ini`` as the input #. If neutron-openvswitch-agent runs with ``ovs_neutron_plugin.ini`` as the input
config-file, edit ``ovs_neutron_plugin.ini`` to configure the bridge mappings config-file, edit ``ovs_neutron_plugin.ini`` to configure the bridge mappings
by adding the [ovs] section described in the previous step, and restart the by adding the [ovs] section described in the previous step, and restart the