From 3ad7a3e4adcfaf7b4595cdf816d5fe4ec1615f99 Mon Sep 17 00:00:00 2001 From: Harald Jensas Date: Wed, 24 Jan 2018 12:18:45 +0100 Subject: [PATCH] Add documentation for baremetal mech Add to configure-networking section, installation and configuration of networking-baremetal plugin. Related-Bug: #1658964 Change-Id: Ic9a5d1de959cbeedb0e56ab5447042ce29028a8d --- doc/source/install/configure-networking.rst | 29 ++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/doc/source/install/configure-networking.rst b/doc/source/install/configure-networking.rst index 18cd92afa1..6904ffa733 100644 --- a/doc/source/install/configure-networking.rst +++ b/doc/source/install/configure-networking.rst @@ -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 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 `_. + 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 information to Networking service for DHCP and PXE boot configuration. 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: .. code-block:: ini @@ -20,7 +28,7 @@ An example of this is shown in the :ref:`enrollment` section. [ml2] type_drivers = flat tenant_network_types = flat - mechanism_drivers = openvswitch + mechanism_drivers = openvswitch,baremetal [ml2_type_flat] 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 # 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 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