Creating DHCP Profiles
When the SAE receives a DHCP discover request from the router, it uses the client's MAC address to find a DHCP profile in cache or in the directory. If it finds a DHCP profile, the SAE uses the information in the profile to create a discover decision that it returns to the router. The discover decision includes information to select an IP address and DHCP options to configure the DHCP client.
When a DHCP subscriber logs in to the SAE through a Web portal, the SAE registers the subscriber's equipment and creates a cached DHCP profile in the o=AuthCache directory. These profiles are keyed by the MAC address of the DHCP client device. They are created by the grantPublicIp or the registerEquipment methods.
You can also create DHCP profiles manually with SDX Admin or by adding DHCP profile entries to the directory. DHCP profiles are stored in the o=AuthCache directory in the dhcpProfile object class. The dhcpProfile object class is subordinate to the cachedAuthenticationProfles object class. Manually created profiles are keyed by the cn (common name) attribute.
For more information about how the SAE handles DHCP subscribers, see:
To create a DHCP profile with SDX Admin:
The New Cached DHCP Profile dialog box appears.
The Cached DHCP Profile pane appears.
![]()
MAC Address
- Naming attribute for system-created DHCP profiles. When a DHCP subscriber first logs in to the SAE, the subscriber's equipment is registered, and the SAE caches the MAC address in the o=AuthCache directory. System-created profiles are keyed by MAC address.
- Value—SAE fills in the MAC address
- Default—No value
- Attribute name—macAddress
Name
- Naming attribute for manually created DHCP profiles. Manually created profiles are keyed by MAC address.
- Value—String
- Default—No value
- Attribute name—cn
Description
DHCP Pool Name
- Name of the IP address pool on the JUNOSe router from which a DHCP address is selected.
- Value—String, optional
- Default—No value
- Attribute name—radiusFramedPool
DHCP IP Address
- Fixed IP address that is offered to the DHCP client if the client is part of a network in the configured DHCP pool.
- Value—String, optional
- Default—No value
- Attribute name—radiusFramedIPAddress
DHCP Virtual Router
- Name of the JUNOSe virtual router that holds the IP address pool.
- Value—String, optional
- Default—No value
- Attribute name—virtualRouterName
DHCP Options
- Defines DHCP options that are used to configure DHCP clients. See Setting DHCP Parameters with DHCP Options for more information.
- Value—You define DHCP options in the format:
option = value [, value...]where option is the option name or number (see Table 15) and values are entered based on the type of option:
- int32, int16, int8—Decimal or hex prefixed by "0x"
- string—Optionally surrounded by double quotes
- ip-address—Dotted decimal
- data-string—Sequence of hex-encoded bytes separated by ":" or a string surrounded by double quotes
To include nonstandard options in a DHCP profile, use the name "option-nnn", where nnn is the option number, and the value is of type "data-string." That is, either a string surrounded in double quotes, or a sequence of hex-encoded bytes, separated by ":".
Boot Server Name
- Name of the server used to boot the DHCP client.
- Value—String, length < 64
- Default—No value
- Attribute name—dhcpServer
Boot File Name
- Name of a boot file used to boot the DHCP client.
- Value—String, length < 128
- Default—No value
- Attribute name—bootFileName
Virtual Router
- Name of the JUNOSe virtual router that is used to check the validity of system-created DHCP profiles.
- Value—Name of the virtual router in the format vrname@hostname. An * (asterisk) means that the values for the virtual router are ignored when the cached profile is used. Use an * if you do not know the virtual router to which the subscriber will connect.
- Default—* (asterisk)
- Attribute name—checkVrName
Local Interface
- Name of the JUNOSe interface that is used to check the validity of system-created DHCP profiles.
- Value—Name of interface in JUNOSe CLI syntax (for example, fastethernet6/0). An * (asterisk) means that the values for the local interface are ignored when the cached profile is used. Use an * if you do not know the interface to which the subscriber will connect, or you want to allow the subscriber to connect through multiple interfaces. You can also enter expressions of the form @expr=value.
- Default—* (asterisk)
- Attribute name—localInterface
Lease Time
- Length of time the supplied IP address is valid.
NOTE: This parameter is not currently implemented on the JUNOSe router. The DHCP lease time that the SAE sends to the JUNOSe router is ignored.
- Value—Number of seconds
- Default—No value
- Attribute name—leaseTime
User Name
- Name of DHCP user without the domain name.
- Value—String that specifies the information to the left of the @ character in <userName>@<domainName>.
- Default—No value
- Attribute name—userName
Service Bundle
- Vendor-specific RADIUS attribute that specifies the SDX service bundle to use.
- Value—String
- Default—No value
- Attribute name—serviceBundle
Radius Class