---
title: "Auto Discovery: Configure DHCP Clients"
slug: "auto-discovery-configure-dhcp-clients"
updated: 2023-03-29T13:40:24Z
published: 2023-03-29T13:40:24Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zpesystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Auto Discovery: Configure DHCP Clients

The Nodegrid Platform can be used as a DHCP Server for Clients within the management network. These devices can be automatically discovered and added to the Nodegrid platform. This feature only supports DHCP Clients that receive DHCP lease from the local Nodegrid Platform.

### Step 1 – Create a Template Device

1. Go to *Managed Devices :: Devices.*
2. Click **Add** .
3. Enter **Name** (of the template).
4. For **IP Address**, enter **127.0.0.1**
5. On **Type** drop-down, select one (device_console, ilo, imm, drac, idrac6, ipmi1.5, impi2.0, ilom, cimc_ucs, netapp, infrabox, pdu*).
6. Enter **Username**,  **Password** and **Confirm Password.**Alternatively, **Ask During Login** checkbox (user credentials are entered during login).
7. Select **Mode Disabled** checkbox (ensures device is not displayed on *Access* page).
8. Click **Save**.

#### CLI Procedure

1. Go to /settings/devices
2. Use the add command to create a new device,
3. Use the set command to define the following settings:  
name  
type (device_console, ilo, imm, drac, idrac6, ipmi1.5, impi2.0, ilom, cimc_ucs, netapp, infrabox, pdu*)  
ip_address as 127.0.0.1  
username and password (of the device)  
   or set credential ask_during_login  
set mode to disabled
4. Save the changes with commit.

```none
[admin@nodegrid /]# cd /settings/devices
[admin@nodegrid devices]# add
[admin@nodegrid {devices}]# set name=Network_Template
[admin@nodegrid {devices}]# set type=device_console
[admin@nodegrid {devices}]# set ip_address=127.0.0.1
[admin@nodegrid {devices}]# set credential=ask_during_login

or

[admin@nodegrid {devices}]# set credential=set_now
[admin@nodegrid {devices}]# set username=admin password=admin

[admin@nodegrid {devices}]# set mode=disabled
[admin@nodegrid {devices}]# commit
```

### Step 2 – Create a Discovery Rule

1. Go to *Managed Devices :: Auto Discovery :: Discovery Rules*
2. Click **Add**.
3. On *Add* dialog, enter **Name**.
4. On **Status** drop-down, select (Enabled, Disabled).
5. On *Discovery Method* menu, select **DHCP** checkbox.
6. (optional) To filter specific entries, enter **MAC Address.**
7. (optional) In *Host or VM Identifier* menu, enter parameter to further filter (if provided, part of port name must match value).
8. On **Action** drop-down, select what to do when a new device is discovered - Clone (Mode: Enabled), Clone (Mode: On-Demand), Clone (Mode: Discovered), Discard Discovered Devices.
9. On **Clone from** drop-down, select template device created earlier.
10. Click **Save**.

After the rule is created, the device is automatically added to the system as soon as it receives a DHCP address or renews its DHCP address lease. The default for the address lease renewal is every 10 minutes.

#### CLI Procedure

1. Go to /settings/auto_discovery/discovery_rules/
2. Use the add command to create a Discovery Rule.
3. Use the set command to define the following settings:  
rule_name for the Discovery Rule  
status for the discovered rule (enabled, disabled)  
method set to dhcp  
(optional) use the mac_address field to filter to these specific entries  
host_identifier parameter can be used to further apply a filter if a value is provided then part of the port name has to match the value  
action - select what should be performed when a new device is discovered (clone_mode_enabled, clone_mode_on-demand, clone_mode_discovered, discard_device)
4. clone_from set to the template device created earlier.
5. Save the changes with commit.

```none
[admin@nodegrid /]# cd /settings/auto_discovery/discovery_rules/
[admin@nodegrid discovery_rules]# add
[admin@nodegrid {discovery_rules}]# set rule_name=Network_Scan
[admin@nodegrid {discovery_rules}]# set status=enabled
[admin@nodegrid {discovery_rules}]# set method=dhcp
[admin@nodegrid {discovery_rules}]# set mac_address=00:0C:29
[admin@nodegrid {discovery_rules}]# set action=clone_mode_enabled
[admin@nodegrid {discovery_rules}]# set clone_from=Network_Template
[admin@nodegrid {discovery_rules}]# commit
```