DHCP Relays

Infrastructure > Network > Integrations > (select Network Server) > DHCP

Overview

DHCP Relays forward DHCP requests from clients on one network segment to a DHCP server on another segment. This eliminates the need for a DHCP server on every subnet while still allowing clients to receive dynamic IP address assignments. HPE Morpheus Software supports creating, editing, and deleting DHCP relays within supported network server integrations such as VMware NSX-T.

Note

DHCP relay management is available on network server integrations that support this capability (hasDhcpRelays flag).

Viewing DHCP Relays

  1. Navigate to Infrastructure > Network > Integrations

  2. Select the desired network server integration (e.g., NSX-T)

  3. Click the DHCP tab

  4. DHCP Relays are displayed in the lower section of the tab, below DHCP Servers

Adding a DHCP Relay

  1. Navigate to Infrastructure > Network > Integrations

  2. Select the desired network server integration

  3. Click the DHCP tab

  4. Click + ADD in the DHCP Relays section

  5. Complete the required fields (fields vary by integration type):

    Name:

    A name for the DHCP relay in HPE Morpheus Software

    Server Addresses:

    The IP addresses of the DHCP server(s) to relay requests to

    Note

    Additional fields may appear based on the network integration type and its configured option types.

  6. Click SAVE

Editing a DHCP Relay

  1. Navigate to Infrastructure > Network > Integrations

  2. Select the desired network server integration

  3. Click the DHCP tab

  4. Click the pencil (edit) icon for the target DHCP relay

  5. Modify the desired fields

  6. Click SAVE

Deleting a DHCP Relay

  1. Navigate to Infrastructure > Network > Integrations

  2. Select the desired network server integration

  3. Click the DHCP tab

  4. Click the trash (delete) icon for the target DHCP relay

  5. Confirm the deletion when prompted

Warning

Deleting a DHCP relay will remove the relay from both HPE Morpheus Software and the upstream integration. Clients on segments served by this relay will lose the ability to obtain DHCP leases.

API

DHCP relays are managed through the HPE Morpheus Software API at the following endpoints:

  • GET /api/networks/servers/:serverId/dhcp-relays — List DHCP relays

  • GET /api/networks/servers/:serverId/dhcp-relays/:id — Get a specific DHCP relay

  • POST /api/networks/servers/:serverId/dhcp-relays — Create a DHCP relay

  • PUT /api/networks/servers/:serverId/dhcp-relays/:id — Update a DHCP relay

  • DELETE /api/networks/servers/:serverId/dhcp-relays/:id — Delete a DHCP relay

Required Role Permissions

Access to DHCP relay management requires the Infrastructure: Network DHCP Relay permission (infrastructure-network-dhcp-relay) with read or full access.