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.

[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.

[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