This mandatory parameter specifies a symbolic name for this AddressAllocator clause. It must exactly match the Allocator parameter in an AuthBy DYNADDRESS in order for it to be used to allocate addresses.

Identifier        DHCPallocator

The host name or IP address of the DHCP server. The address may be either a single host address or a broadcast address. If a broadcast address is specified, Radiator will allocate an address from the first DHCP host to answer a discover request.

Host 1.2.3.4

The DHCP port number on the DHCP host. Defaults to port 67.

Port 67

The local IP address to bind to. Defaults to the main IP address of the Radiator host.

LocalAddress 1.1.1.1

The Client Identifier to be used by the DHCP server to track allocations. Defaults to the user name in the current request.

DHCPClientIdentifier %{User-Name}

Specifies the default lease period requested. Defaults to one day (86400 seconds).

DefaultLease 86400

The DHCP RFC specifies timeout and retry behaviour while attempting to contact a DHCP server. The TimeoutMinimum specifies the initial timeout in seconds. Defaults to 2 seconds.

TimeoutMinimum 4

The TimeoutMaximum specifies how long to keep retrying a request in seconds. Defaults to 16 seconds.

TimeoutMaximum 64

The TimeoutFactor indicates how to recalculate the timeout for each attempt. Defaults to multiplying the timeout by 2 for each attempt.

TimeoutFactor 2

Specifies the local DHCP server port. Defaults to port 67.

ServerPort 67

Normally DHCP requests are processed asynchronously. This optional parameter can be used to make the requests synchronous.

Synchronous

This is an optional integer parameter that is used to enable the DHCP "Subnet Selection Option". The official RFC option number is 118 which is used as the default if this parameter does not specify other value. Early versions of the ISC DHCP server used option 211.

If the SubnetSelectionOption parameter is not defined, no Subnet Selection Option is added and any PoolHint value provided is used in the giaddr field in the DHCP request, instead of LocalAddress.

Here are examples of using SubnetSelectionOption:

# This sets the value to 211.
SubnetSelectionOption 211

# If the parameter is set but no value is defined, 118 is used.
SubnetSelectionOption

# Do not add any Subnet Selection Option.
#SubnetSelectionOption

This optional parameter can be used to specify a User Class to be passed to the DHCP server to assist with address allocation. Any text and/or Radiator special characters are permitted. Refer to the DHCP server documentation for further details regarding the use of classes.

UserClass %{Client:Identifier}

ClientHardwareAddress is an attribute in the incoming address which contains the hex encoded MAC address of the client. If present, it will be used as CHADDR in the DHCP request. If not present, and fake CHADDR based on the request XID will be used. The DHCP server may use this when allocating an address for the client. The MAC address can contain extraneous characters such as ‘.’ or ‘:’ as long as it contains the 12 hex characters (case insensitive) of the MAC address. Special characters are permitted.

# Use contents of an attribute to tell the DHCP server the
# hardware address of the client
ClientHardwareAddress %{Unisphere-Dhcp-Mac-Addr}

When this optional parameter is set, information about the allocation is stored in reply attribute Class instead of in memory. Required for server farm where different farm members are likely to handle the allocation and deallocation. Defaults to off.

This string sets the value for DHCP option 12 "Host name". This has no default value and no Host Name is sent with DHCP request by default.

Here is an example of using DHCPHostName:

DHCPHostName Radiator-%{Calling-Station-Id}

This string parameter sets the value that is used for DHCP option 61 "Class Identifier", also known as "Vendor class identifier". This has no default value and no Class Identifier is sent with DHCP request by default.

Here is an example of using DHCPVendorClass:

DHCPVendorClass RadiatorAllocations