30.1. DHCP resource

30.1. DHCP resource
	Chapter 30. DHCP - Dynamic Host Configuration Protocol

The Abilis DHCP module implements three working modes:

BOOTP relay agent (Relay mode): internet host or router that passes DHCP messages between DHCP clients and DHCP servers.
DHCP Server: internet host that returns configuration parameters to DHCP clients.
DHCP Client: internet host which retrieves configuration parameters from a server.

30.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
	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\

30.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: Operation activation [NO, YES].
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: DHCP mode [SERVER, RELAY].

Parameters for mode:RELAY only:

MAX-HOPS: Maximum allowed DHCP Relay Agent hops in forwarded requests [1..16].
SRV: DHCP Server to which requests must be forwarded: IP address or IP list name [#, ListName, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
LOCIPADD: Source IP address used for the requests relayed to the server(s) [R-ID, OUT-IP, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

Parameters for mode:SERVER only:

max-clients: Maximum number of serviceable clients [100..1000].
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).
MAC-LIST: Selects which list, of MAC/RU/MR type, to use [#, ListName].
MAC-RULE: Selects how to use the list [DENY, PERMIT].
WDIR: Selects the directory where DHCP.BND (BND stays for binding) file are stored. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\"). 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
	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).


Chapter 30. DHCP - Dynamic Host Configuration Protocol		30.2. DHCP Relay Mode