local-dhcp-server server-name [create]
no local-dhcp-server server-name
config>router>dhcp
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command instantiates a local DHCP server. A local DHCP server can serve multiple interfaces but is limited to the routing context it was which it was created.
Specifies the name of local DHCP server.
Specifies that the local DHCP server is created. The create keyword requirement can be enabled or disabled in the environment>create context.
[no] force-renews
config>router>dhcp>server
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command enables the sending of force-renew messages.
The no form of this command disables the sending of force-renew messages.
no force-renews
lease-hold-time [lease-hold-time]
no lease-hold-time
config>router>dhcp>server
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the time to remember this lease. This lease-hold-time is for unsolicited release conditions such as lease timeout and normal solicited release from DHCP client.
The no form of this command reverts to the default.
sec 0
Specifies the amount of time to remember the lease.
pool pool-name [create]
no pool pool-name
config>router>dhcp>server
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures a DHCP address pool on the router.
Specifies the name of this IP address pool. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters.
Specifies that the pool is created. The create keyword requirement can be enabled or disabled in the environment>create context.
max-lease-time [max-lease-time]
no max-lease-time
config>router>dhcp>server>pool
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the maximum lease time.
The no form of this command reverts the value to the default.
10 days
Specifies the maximum lease time.
min-lease-time [min-lease-time]
no min-lease-time
config>router>dhcp>server>pool
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the minimum lease time.
The no form of this command returns the value to the default.
10 minutes
Specifies the minimum lease time.
minimum-free minimum-free [percent] [event-when-depleted]
no minimum-free
config>router>dhcp>server>pool
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command specifies the minimum number of free addresses in this pool.
The no form of this command reverts to the default.
1
Specifies the minimum number of free addresses.
0 to 255
Specifies that the value indicates a percentage.
Enables a system-generate event when all available addresses in the pool or subnet of local DHCP server are depleted.
[no] nak-non-matching-subnet
config>router>dhcp>server>pool
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the system to return a DHCP NAK message if the following conditions are met:
the local DHCPv4 server receives a DHCP request with option 50 (meaning the client is trying to request a previously allocated message as described in section 3.2 of RFC 2131, Dynamic Host Configuration Protocol)
the address allocation algorithm uses a pool and the address in option 50 is not in the pool
If the conditions are not met, the system drops the DHCP packet.
no nak-non-matching-subnet
offer-time [min minutes] [sec seconds]
no offer-time
config>router>dhcp>server>pool
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the offer time.
The no form of this command reverts the value to the default.
1 minute
Specifies the offer time.
options
config>router>dhcp>server>pool
config>router>dhcp>server>pool>subnet
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
Commands in this context configure pool options. The options defined here can be overruled by defining the same option in the local user database.
custom-option option-number address [ip-address...(up to 4 max)]
custom-option option-number hex hex-string
custom-option option-number string ascii-string
no custom-option option-number
config>router>dhcp>server>pool>options
config>router>dhcp>server>pool>subnet>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures specific DHCP options. The options defined here can overrule options in the local user database.
The no form of this command removes the option from the configuration.
Specifies the option number that the DHCP server uses to send the identification strings to the DHCP client.
Specifies the IP address of this host.
Specifies the hex value of this option.
Specifies the value of this option, up to 127 characters.
dns-server address [ip-address...(up to 4 max)]
no dns-server
config>router>dhcp>server>pool>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the IP address of the DNS server.
Specifies the IP address of the DNS server in dotted-decimal notation. Up to four addresses can be entered.
domain-name domain-name
no domain-name
config>router>dhcp>server>pool>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the default domain for a DHCP client that the router uses to complete unqualified hostnames (without a dotted-decimal domain name).
The no form of this command removes the name from the configuration.
Specifies the domain name for the client.
lease-rebind-time [lease-rebind-time]
no lease-rebind-time
config>router>dhcp>server>pool>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the time the client transitions to a rebinding state.
The no form of this command removes the time from the configuration.
Specifies the lease rebind time.
lease-renew-time [lease-renew-time]
no lease-renew-time
config>router>dhcp>server>pool>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the time the client transitions to a renew state.
The no form of this command removes the time from the configuration.
Specifies the lease renew time.
lease-time [lease-time]
no lease-time
config>router>dhcp>server>pool>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the amount of time that the DHCP server grants to the DHCP client permission to use a particular IP address.
The no form of this command removes the lease time parameters from the configuration.
Specifies the lease time.
subnet {ip-address/mask | ip-address netmask} [create]
no subnet {ip-address/mask | ip-address netmask}
config>router>dhcp>server>pool
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command creates a subnet of IP addresses to be served from the pool. The subnet cannot include any addresses that were assigned to subscribers without those addresses specifically excluded. When the subnet is created no IP addresses are made available until a range is defined.
Specifies the base IP address of the subnet. This address must be unique within the subnet and specified in dotted decimal notation.
Specifies the subnet mask in Classless Inter-Domain Routing (CIDR) notation, expressed as a decimal integer.
Specifies a string of 0s and 1s that mask or screen out the network part of an IP address so that only the host computer part of the address remains.
Specifies that the subnet is created. The create keyword requirement can be enabled or disabled in the environment>create context.
[no] address-range start-ip-address end-ip-address [failover {local | remote}]
config>router>dhcp>server>pool>subnet
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures a range of IP addresses to be served from the pool. All IP addresses between the start and end IP addresses are included (other than specific excluded addresses).
Specifies the start address of this range to include. This address must be unique within the subnet and specified in dotted decimal notation.
Specifies the end address of this range to include. This address must be unique within the subnet and specified in dotted decimal notation.
Specifies that the DHCP server failover control type is in control under normal operation.
Specifies that the remote DHCP server failover system is in control under normal operation.
[no] exclude-addresses start-ip-address [end-ip-address]
config>router>dhcp>server>pool>subnet
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command specifies a range of IP addresses that excluded from the pool of IP addresses in this subnet.
Specifies the start address of this range to exclude. This address must be unique within the subnet and specified in dotted decimal notation.
Specifies the end address of this range to exclude. This address must be unique within the subnet and specified in dotted decimal notation.
maximum-declined maximum-declined
no maximum-declined
config>router>dhcp>server>pool>subnet
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the maximum number of declined addresses allowed.
64
Specifies the maximum number of declined addresses allowed.
minimum-free minimum-free [percent] [event-when-depleted]
no minimum-free
config>router>dhcp>server>pool>subnet
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the minimum number of free addresses in this subnet. If the actual number of free addresses in this subnet falls below this configured minimum, a notification is generated.
1
Specifies the minimum number of free addresses in this subnet.
Specifies that the value indicates a percentage.
This parameter enables a system-generate event when all available addresses in the pool or subnet of local DHCP server are depleted.
default-router ip-address [ip-address...(up to 4 max)]
no default-router
config>router>dhcp>server>pool>subnet>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures the IP address of the default router for a DHCP client. Up to four IP addresses can be specified.
The no form of this command removes the address or addresses from the configuration.
Specifies the IP address of the default router. This address must be unique within the subnet and specified in dotted decimal notation.
subnet-mask ip-address
no subnet-mask
config>router>dhcp>server>pool>subnet>options
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command specifies the subnet-mask option to the client. The mask can either be defined (for super-netting) or taken from the pool address.
The no form of this command removes the address from the configuration.
Specifies the IP address of the subnet mask. This address must be unique within the subnet and specified in dotted decimal notation.
use-gi-address [scope scope]
config>router>dhcp>local-dhcp-server
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command enables the use of gi-address matching. If the gi-address flag is enabled, a pool can be used even if a subnet is not found. If the local-user-db-name is not used, the gi-address flag is used and addresses are handed out by GI only. If a user must be blocked from getting an address, the server maps to a local user database and configures the user with no address.
A pool can include multiple subnets. Because the GI is shared by multiple subnets in a subscriber interface, the pool may provide IP addresses from any of the subnets included when the GI is matched to any of its subnets. This allows a pool to be created that represents a sub-int.
no use-gi-address
Specifies if addresses are assigned for a specific subnet where the GI address belongs to only or for all subnets part of the pool.
user-db local-user-db-name [create]
no user-db
config>router>dhcp>server
7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C
This command configures a local user database for authentication.
no user-db
Specifies the name of a local user database.
Specifies that the local user database is created. The create keyword requirement can be enabled or disabled in the environment>create context.