Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
  
[+] Expand All
[-] Collapse All

dhcp.ini File

The dhcp.ini configuration file configures DHCP address pools so that IPv4 addresses can be assigned from a back-end DHCP server, rather than from a standard Steel-Belted Radius Carrier IP address pool.

Note: Steel-Belted Radius Carrier does not support DHCP allocation of IPv6 addresses.

[Settings] Section

The [Settings] section of the dhcp.ini file (Table 77) controls DHCP address allocation.

Table 77: dhcp.ini [Settings] Syntax

Parameter

Function

Enable

  • If set to 1, DHCP address allocation is enabled.
  • If set to 0, DHCP address allocation is disabled.

Default value is 0.

Attempts

Specifies the number of times a DHCP DISCOVER or REQUEST message is sent if no response is received.

Default value is 3.

AttemptTimeout

Specifies the waiting period, in seconds, for a response to a DISCOVER or REQUEST message, before resending the message.

Default value is 5 seconds.

Note: If present, the AttemptTimeoutMs parameter overrides this setting.

AttemptTimeoutMs

Specifies the waiting period, in milliseconds, for a response to a DISCOVER or REQUEST message, before resending the message.

Default value is 5000 milliseconds (5 seconds).

Note: If present, this parameter overrides the AttemptTimeout setting.

OverallTimeout

Specifies the number of seconds for acquiring an IP address before DHCP address assignment is presumed to have failed.

This timeout applies only to the DISCOVER/REQUEST sequence used to acquire an address initially, not to address renewal or release.

Default value is 15 seconds.

Note: If present, the OverallTimeoutMs parameter overrides this setting.

OverallTimeoutMS

Specifies the number of milliseconds for acquiring an IP address before DHCP address assignment is presumed to have failed.

This timeout applies only to the DISCOVER/REQUEST sequence used to acquire an address initially, not to address renewal or release.

Default value is 15000 milliseconds. (15 seconds).

Note: If present, this parameter overrides the OverallTimeout setting.

htype

Specifies the client hardware type (0–255).

This parameter is typically omitted, because the value is generated automatically.

Hlen

Specifies the length of the client hardware address (1–16).

This parameter is typically omitted, because the value is generated automatically.

Chaddr-prefix

Specifies the string that identifies the initial bytes of the client hardware address (chaddr). This string can include escape codes, including \nnn for decimal values and \xnn for hex values.

This parameter is typically omitted, because the value is generated automatically.

ServerPort

Specifies the UDP port number on which the DHCP server(s) listen. This setting is used only for non-standard DHCP configurations.

Default value is 67, which is the standard DHCP server port.

LocalPort

Specifies the UDP port number that Steel-Belted Radius Carrier, acting as a relay agent, uses during DHCP communication. This setting is used for only non-standard DHCP configurations.

Default value is 67, which is the standard DHCP server port.

Pad

Specifies the minimum number of bytes for a DHCP request message. Messages smaller than this number are padded with 0s.

Certain DHCP servers discard messages smaller than a certain value. This option allows interoperability with such servers.

Default value is 300.

CheckDuplicate
Assignment

Checks for duplicate addresses assigned by the DHCP server.

  • Yes—Enables the checking for duplicate IP addresses assigned by the DHCP server.
  • No—Disables the checking for duplicate IP addresses assigned by the DHCP server.

Default value is Yes.

The following is a sample dhcp.ini file:

[Settings]
Enable = 1
Attempts = 3
AttemptTimeout = 2
OverallTimeout = 10

[Pools] Section

The [Pools] section lists all DHCP pool names (specified in the pool.dhc file, which is described on pool.dhc Files) in the following format:

[Pools]
pool 1
pool 2

For example:

[Pools]
DHCP_SERVER1
DHCP_SERVER_SALES

Modified: 2017-03-07