27.1. DHCP resource

The Abilis DHCP module implements three working mode:

27.1.1. Activating DHCP resource

Add the resource to the Abilis system with the following command.

[17:14:59] ABILIS_CPX:a res:dhcp

RES:DHCP ALREADY EXISTS

The DHCP resource may already exist in the system, but may not yet be active: set it active with the command:

[17:15:17] ABILIS_CPX:s act res:dhcp

COMMAND EXECUTED
[Caution]Caution

After adding or setting the DHCP active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

[17:14:59] ABILIS_CPX:s p dhcp act:yes

COMMAND EXECUTED

[17:15:17] ABILIS_CPX:d p dhcp

RES:Dhcp - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
       ------------------------------------------------------------------------
Run    DESCR:Dynamic_Host_Configuration_Protocol
       LOG:DS           ACT:YES       srv-udp-locport:67   cli-udp-locport:68
       msg-len:1472     mode:RELAY    MAX-HOPS:4     SRV:#
       LOCIPADD:R-ID (192.168.001.001)
       WDIR:C:\APP\DHCP\

27.1.2. DHCP resource parameters

Use the following command to display the parameters of the resource; by typing d p dhcp ? command, the meaning of all parameters is shown.

[17:15:17] ABILIS_CPX:d p dhcp

RES:Dhcp ----------------------------------------------------------------------
Run    DESCR:Dynamic_Host_Configuration_Protocol
       LOG:DS           ACT:YES       srv-udp-locport:67   cli-udp-locport:68
       msg-len:1472     mode:RELAY    MAX-HOPS:4     SRV:#
       LOCIPADD:R-ID (192.168.001.001)
       WDIR:C:\APP\DHCP\

Meaning of the most important parameters:

LOG

Logging functionalities activation/deactivation.

ACT

Runtime DHCP activation/deactivation.

srv-udp-locport

Server side UDP port [default is 67].

cli-udp-port

Client side UDP port [default is 68].

msg-len

Maximum length of DHCP message, actually the UDP payload [548..2048];

mode

It specifies the mode of DHCP port working [SERVER, RELAY].

Parameters for mode:RELAY only:

MAX-HOPS

It specifies the maximum number of DHCP relay agent hops.

SRV

It specifies the DHCP Server to which requests must be forwarded; it can be set to an IP address, in Dotted Decimal Notation, or the name of an IP list;

LOCIPADD

It specifies the IP address that DHCP relay agent will use as “source address” in the requests relayed to the server.

Parameters for mode:SERVER only:

max-clients

Maximum number of supported DHCP clients; it actually determines the size of the binding database on disk and in memory.

ICMPCHK

Enables ICMP checking of IP address. When it is set to YES, ICMP checking is enabled. Before sending the DHCPOFFER message, the server sends two ICMP ping requests to check the IP address which was allocated. If both timeouts expire, the server will send the DHCP offer message, otherwise it will mark this IP address as abandoned and will not send response.

MAC-FILTER

Enables/disables the selection of serviceable clients based on their MAC address. When it is set to YES, MAC filtering is enabled. When DHCP receives an incoming request and before processing it, the DHCP verifies that the sender's MAC address is allowed by using MAC-LIST and MAC-RULE parameters current setting (MAC-LIST and MAC-RULE appear when MAC-FILTER is set to YES).

WDIR

Selects the directory where DHCP.BND (BND stays for binding) file is saved. A binding is a collection of configuration parameters, including at least an IP address, associated with or “bound to” a DHCP client. Bindings are managed by DHCP servers.

The following command allows the administrator to change the configuration of the resource:

s p dhcp parameter:value...

[Caution]Caution

To activate the changes made on the upper case parameters, execute the initialization command init res:dhcp; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. with warm start command).