7.3. Configure the DHCP Agent


Configure the DHCP agent. All steps in this procedure must be performed on the server hosting OpenStack Networking, while logged in as the root user.

Procedure 7.12. Configuring the DHCP Agent

  1. Configure the DHCP agent to use the Identity service for authentication.
    1. Set the authentication strategy to keystone:
      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         DEFAULT auth_strategy keystone
      Copy to Clipboard Toggle word wrap
    2. Set the Identity service host that the DHCP agent must use:
      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         keystone_authtoken auth_host IP
      Copy to Clipboard Toggle word wrap
      Replace IP with the IP address or host name of the server hosting the Identity service.
    3. Set the DHCP agent to authenticate as the correct tenant:
      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         keystone_authtoken admin_tenant_name services
      Copy to Clipboard Toggle word wrap
      Replace services with the name of the tenant created for the use of OpenStack Networking. Examples in this guide use services.
    4. Set the DHCP agent to authenticate using the neutron administrative user account:
      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         keystone_authtoken admin_user neutron
      Copy to Clipboard Toggle word wrap
    5. Set the DHCP agent to use the correct neutron administrative user account password:
      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         keystone_authtoken admin_password PASSWORD
      Copy to Clipboard Toggle word wrap
      Replace PASSWORD with the password set when the neutron user was created.
  2. Set the interface driver in the /etc/neutron/dhcp_agent.ini file based on the OpenStack Networking plug-in being used. If you are using ML2, select either driver. Use the command that applies to the plug-in used in your environment:
    • Open vSwitch Interface Driver

      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         DEFAULT interface_driver neutron.agent.linux.interface.OVSInterfaceDriver
      Copy to Clipboard Toggle word wrap
    • Linux Bridge Interface Driver

      # openstack-config --set /etc/neutron/dhcp_agent.ini \
         DEFAULT interface_driver \
         neutron.agent.linux.interface.BridgeInterfaceDriver
      Copy to Clipboard Toggle word wrap
  3. Start the neutron-dhcp-agent service and configure it to start at boot time:
    # systemctl start neutron-dhcp-agent.service
    # systemctl enable neutron-dhcp-agent.service
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat