Configuration

Neutron DPM mechanism driver

The Neutron DPM mechanism driver itself does not require any DPM-specific configuration options.

But certain well known Neutron ML2 (Modular Layer 2) configuration options in the ML2 configuration file (typically ml2_conf.ini) are required in order to use it.

Enable the DPM mechanism driver

The DPM mechanism driver must be enabled using Neutron ML2 mechanism_drivers config option. Typically the DPM mechanism driver must be configured amongst other mechanisms (like OVS) that are used on the network node or compute nodes managing other hypervisor types (like KVM). The following example enables the ovs and the DPM mechanism driver in Neutrons ML2 config file ml2_conf.ini:

[DEFAULT]
mechanism_drivers = ovs,dpm

More details can be found in the OpenStack Configuration Reference on docs.openstack.org.

Neutron DPM agent

The Neutron DPM agent on the compute node requires DPM-specific options. But also some well known Neutron options can be set.

General Neutron options

The following common Neutron options can be set in the Neutron DPM agent’s configuration file:

  • [default] host
  • [agent] quitting_rpc_timeout
  • [agent] polling_interval

More details can be found in the OpenStack Configuration Reference on docs.openstack.org.

DPM-specific options

Those are the DPM-specific configuration options required by the Neutron DPM agent.

Note

This configuration is auto-generated from the networking-dpm project when this documentation is built. So if you are having issues with an option, please compare your version of networking-dpm with the version of this documentation.

The sample configuration can also be viewed in file form.

[DEFAULT]


[dpm]
#
# Configuration options for IBM z Systems and IBM LinuxONE in DPM (Dynamic
# Partition Manager) administrative mode. A z Systems or LinuxONE machine is
# termed "CPC" (Central Processor Complex). The CPCs are managed via the Web
# Services API exposed by the "HMC" (Hardware Management Console). One HMC can
# manage multiple CPCs.
#
#
# DPM config options for the Neutron agent on the compute node (one agent
# instance for each OpenStack hypervisor host) specify the target CPC, the HMC
# managing it, and the OpenStack physical networks for the OpenStack hypervisor
# host and their backing network adapters and ports in the target CPC.

#
# From networking_dpm
#

#
# The OpenStack physical networks that can be used by this OpenStack hypervisor
# host, and their backing network adapters and ports in the target CPC.
#
# This is a multi-line option. Each instance (line) of the option defines one
# physical network for use by this OpenStack hypervisor host, and the network
# adapter and port that is used for that physical network, using this syntax:
#
# ```
#     <physical-network-name>:<adapter-object-id>[:<port-element-id>]
# ```
#
# * `<physical-network-name>` is the name of the OpenStack physical network.
# * `<adapter-object-id>` is the object-id of the network adapter in the target
#   CPC that is used for this physical network.
# * `<port-element-id>` is the element-id of the port on that network adapter.
#   It is optional and defaults to 0.
#
# The instances (lines) of this option for a particular Neutron agent
#
# * must not specify the same physical network more than once, and
# * must not specify the same adapter and port more than once, and
# * must have all of their physical networks specified in the
#   corresponding `*mappings` config option of the Neutron L2 agent service
#   on all network nodes, and
# * must have all of their physical networks specified in the
#   `ml2.network_vlan_ranges` config option of the Neutron server, if vlan
#   self service networks should be used.
#  (multi valued)
#physical_network_adapter_mappings = physnet1:12345678-1234-1234-1234-123456789a
#physical_network_adapter_mappings = physnet2:12345678-1234-1234-1234-123456789b:1
#physical_network_adapter_mappings = physnet3:12345678-1234-1234-1234-123456789c:0

#
#     Hostname or IP address of the HMC that manages the target CPC (string
# value)
#hmc = <None>

#
#     User name for connection to the HMC (string value)
#hmc_username = <None>

#
#     Password for connection to the HMC (string value)
#hmc_password = <None>

#
#     DPM Object-id of the target CPC (string value)
#cpc_object_id = <None>