server

DHCP server configuration.

vsr running config# vrf <vrf> dhcp server

enabled (pushed)

Enable/Disable DHCP server on this VRF.

vsr running config# vrf <vrf> dhcp server
vsr running server# enabled true|false
Default value
true

default-lease-time

Default network address lease time assigned to DHCP clients (in seconds, at least 180s).

vsr running config# vrf <vrf> dhcp server
vsr running server# default-lease-time <180-31536000>
Default value
43200

max-lease-time

Maximum network address lease time assigned to DHCP clients (in seconds, at least 180s or the default-lease value).

vsr running config# vrf <vrf> dhcp server
vsr running server# max-lease-time <180-31536000>
Default value
86400

ping-check

Enable sending an ICMP Echo request to the picked client address before the DHCP server actually allocates this address to a client.

vsr running config# vrf <vrf> dhcp server
vsr running server# ping-check true|false
Default value
true

dhcp-options

Default DHCP options configuration.

vsr running config# vrf <vrf> dhcp server dhcp-options

dhcp-server-identifier

DHCP server identifier (IPv4 address) used in DHCP messages to allow the client to distinguish between lease offers.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# dhcp-server-identifier DHCP-SERVER-IDENTIFIER

DHCP-SERVER-IDENTIFIER

An IPv4 address.

domain-name

Name of the domain.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# domain-name <string>

domain-name-server

Domain name server (IPv4 address) listed in order of preference.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# domain-name-server DOMAIN-NAME-SERVER

DOMAIN-NAME-SERVER

An IPv4 address.

ntp-server

NTP server (IPv4 address) listed in order of preference.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# ntp-server NTP-SERVER

NTP-SERVER

An IPv4 address.

interface-mtu

Minimum Transmission Unit (MTU) of the interface.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# interface-mtu <0-65535>

netbios-name-server

NETBIOS name server listed in order of preference.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# netbios-name-server NETBIOS-NAME-SERVER

NETBIOS-NAME-SERVER values

Description

<ipv4-address>

An IPv4 address.

<ipv6-address>

An IPv6 address.

netbios-node-type

NETBIOS node type.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# netbios-node-type NETBIOS-NODE-TYPE

NETBIOS-NODE-TYPE values

Description

B-node

Broadcast - no WINS.

P-node

Peer - WINS only.

M-node

Mixed - broadcast, then WINS.

H-node

Hybrid - WINS, then broadcast.

netbios-scope

NETBIOS over TCP/IP scope parameter for the client as specified in RFC 1001/1002.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# netbios-scope <string>

subnet-mask

Specify the client’s subnet mask as per RFC 950.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# subnet-mask <A.B.C.D>

time-offset

Time offset in seconds from UTC.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# time-offset <int32>

dns-search-domain-name

Domain names that the DHCP client should use for its DNS search.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# dns-search-domain-name DNS-SEARCH-DOMAIN-NAME

DNS-SEARCH-DOMAIN-NAME

The domain-name type represents a DNS domain name. Fully quallified left to the models which utilize this type. Internet domain names are only loosely specified. Section 3.5 of RFC 1034 recommends a syntax (modified in Section 2.1 of RFC 1123). The pattern above is intended to allow for current practice in domain name use, and some possible future expansion. It is designed to hold various types of domain names, including names used for A or AAAA records (host names) and other records, such as SRV records. Note that Internet host names have a stricter syntax (described in RFC 952) than the DNS recommendations in RFCs 1034 and 1123, and that systems that want to store host names in schema nodes using the domain-name type are recommended to adhere to this stricter standard to ensure interoperability. The encoding of DNS names in the DNS protocol is limited to 255 characters. Since the encoding consists of labels prefixed by a length bytes and there is a trailing NULL byte, only 253 characters can appear in the textual dotted notation. Domain-name values use the US-ASCII encoding. Their canonical format uses lowercase US-ASCII characters. Internationalized domain names MUST be encoded in punycode as described in RFC 3492.

vendor-class-identifier

Vendor class identifier sent by the DHCP client to tailor configurations for specific types of devices.

vsr running config# vrf <vrf> dhcp server dhcp-options
vsr running dhcp-options# vendor-class-identifier <string>

option

Specify a custom DHCP option.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>

<0-254>

DHCP option identifier code.

name (mandatory)

A name to identify the option.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># name <string>

boolean

Boolean value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># boolean true|false

int8

Int8 value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># int8 <int8>

int16

Int16 value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># int16 <int16>

int32

Int32 value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># int32 <int32>

uint8

Uint8 value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># uint8 <uint8>

uint16

Uint16 value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># uint16 <uint16>

uint32

Uint32 value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># uint32 <uint32>

ipv4-address

IP address or hostname value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># ipv4-address IPV4-ADDRESS

IPV4-ADDRESS values

Description

<ipv4-address>

An IPv4 address.

<domain-name>{1,253}

The domain-name type represents a DNS domain name. Fully quallified left to the models which utilize this type. Internet domain names are only loosely specified. Section 3.5 of RFC 1034 recommends a syntax (modified in Section 2.1 of RFC 1123). The pattern above is intended to allow for current practice in domain name use, and some possible future expansion. It is designed to hold various types of domain names, including names used for A or AAAA records (host names) and other records, such as SRV records. Note that Internet host names have a stricter syntax (described in RFC 952) than the DNS recommendations in RFCs 1034 and 1123, and that systems that want to store host names in schema nodes using the domain-name type are recommended to adhere to this stricter standard to ensure interoperability. The encoding of DNS names in the DNS protocol is limited to 255 characters. Since the encoding consists of labels prefixed by a length bytes and there is a trailing NULL byte, only 253 characters can appear in the textual dotted notation. Domain-name values use the US-ASCII encoding. Their canonical format uses lowercase US-ASCII characters. Internationalized domain names MUST be encoded in punycode as described in RFC 3492.

text

Text value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># text <string>{1,254}

hex

Hexadecimal string value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254>
vsr running option <0-254># hex HEX

HEX

A hexadecimal string with octets represented as hex digits separated by colons. The canonical representation uses lowercase characters.

array

Array value.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
int8

Array of int8.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# int8 <int8>
int16

Array of int16.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# int16 <int16>
int32

Array of int32.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# int32 <int32>
uint8

Array of uint8.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# uint8 <uint8>
uint16

Array of uint16.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# uint16 <uint16>
uint32

Array of uint32.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# uint32 <uint32>
ipv4-address

Array of IPv4 addresses or domain name.

vsr running config# vrf <vrf> dhcp server dhcp-options option <0-254> array
vsr running array# ipv4-address IPV4-ADDRESS

IPV4-ADDRESS values

Description

<ipv4-address>

An IPv4 address.

<domain-name>{1,253}

The domain-name type represents a DNS domain name. Fully quallified left to the models which utilize this type. Internet domain names are only loosely specified. Section 3.5 of RFC 1034 recommends a syntax (modified in Section 2.1 of RFC 1123). The pattern above is intended to allow for current practice in domain name use, and some possible future expansion. It is designed to hold various types of domain names, including names used for A or AAAA records (host names) and other records, such as SRV records. Note that Internet host names have a stricter syntax (described in RFC 952) than the DNS recommendations in RFCs 1034 and 1123, and that systems that want to store host names in schema nodes using the domain-name type are recommended to adhere to this stricter standard to ensure interoperability. The encoding of DNS names in the DNS protocol is limited to 255 characters. Since the encoding consists of labels prefixed by a length bytes and there is a trailing NULL byte, only 253 characters can appear in the textual dotted notation. Domain-name values use the US-ASCII encoding. Their canonical format uses lowercase US-ASCII characters. Internationalized domain names MUST be encoded in punycode as described in RFC 3492.

subnet

Subnet configuration.

vsr running config# vrf <vrf> dhcp server subnet <subnet>

<subnet>

An IPv4 prefix: address and CIDR mask.

interface

Interface on which the DHCP server should listen.

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># interface INTERFACE

INTERFACE

An interface name.

default-gateway

IPv4 address of the gateway listed in order of preference.

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># default-gateway DEFAULT-GATEWAY

DEFAULT-GATEWAY

An IPv4 address.

default-lease-time

Default network address lease time assigned to DHCP clients for this subnet (in seconds, at least 180s).

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># default-lease-time <180-31536000>

max-lease-time

Maximum network address lease time assigned to DHCP clients for this subnet (in seconds, at least 180s or the default-lease value).

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># max-lease-time <180-31536000>

ping-check

Enable sending an ICMP Echo request to the picked client address before the DHCP server actually allocates this address to a client.

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># ping-check true|false
Default value
true

state (state only)

Subnet state.

vsr> show state vrf <vrf> dhcp server subnet <subnet> state

range

IPv4 range.

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># range <start-ip> <end-ip>

<start-ip>

An IPv4 address.

<end-ip>

An IPv4 address.

host

Mapping from MAC address to IP address.

vsr running config# vrf <vrf> dhcp server subnet <subnet>
vsr running subnet <subnet># host <string> MAC-ADDRESS IP-ADDRESS

<string>

Host name for static MAC to IP address mapping.

MAC-ADDRESS (mandatory)

MAC address of the host.

MAC-ADDRESS

MAC-ADDRESS

An IEEE 802 MAC address.

IP-ADDRESS (mandatory)

IPv4 address of the host.

IP-ADDRESS

IP-ADDRESS

An IPv4 address.

dhcp-options

DHCP options specific to this subnet.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options

dhcp-server-identifier

DHCP server identifier (IPv4 address) used in DHCP messages to allow the client to distinguish between lease offers.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# dhcp-server-identifier DHCP-SERVER-IDENTIFIER

DHCP-SERVER-IDENTIFIER

An IPv4 address.

domain-name

Name of the domain.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# domain-name <string>

domain-name-server

Domain name server (IPv4 address) listed in order of preference.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# domain-name-server DOMAIN-NAME-SERVER

DOMAIN-NAME-SERVER

An IPv4 address.

ntp-server

NTP server (IPv4 address) listed in order of preference.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# ntp-server NTP-SERVER

NTP-SERVER

An IPv4 address.

interface-mtu

Minimum Transmission Unit (MTU) of the interface.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# interface-mtu <0-65535>

netbios-name-server

NETBIOS name server listed in order of preference.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# netbios-name-server NETBIOS-NAME-SERVER

NETBIOS-NAME-SERVER values

Description

<ipv4-address>

An IPv4 address.

<ipv6-address>

An IPv6 address.

netbios-node-type

NETBIOS node type.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# netbios-node-type NETBIOS-NODE-TYPE

NETBIOS-NODE-TYPE values

Description

B-node

Broadcast - no WINS.

P-node

Peer - WINS only.

M-node

Mixed - broadcast, then WINS.

H-node

Hybrid - WINS, then broadcast.

netbios-scope

NETBIOS over TCP/IP scope parameter for the client as specified in RFC 1001/1002.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# netbios-scope <string>

subnet-mask

Specify the client’s subnet mask as per RFC 950.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# subnet-mask <A.B.C.D>

time-offset

Time offset in seconds from UTC.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# time-offset <int32>

dns-search-domain-name

Domain names that the DHCP client should use for its DNS search.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# dns-search-domain-name DNS-SEARCH-DOMAIN-NAME

DNS-SEARCH-DOMAIN-NAME

The domain-name type represents a DNS domain name. Fully quallified left to the models which utilize this type. Internet domain names are only loosely specified. Section 3.5 of RFC 1034 recommends a syntax (modified in Section 2.1 of RFC 1123). The pattern above is intended to allow for current practice in domain name use, and some possible future expansion. It is designed to hold various types of domain names, including names used for A or AAAA records (host names) and other records, such as SRV records. Note that Internet host names have a stricter syntax (described in RFC 952) than the DNS recommendations in RFCs 1034 and 1123, and that systems that want to store host names in schema nodes using the domain-name type are recommended to adhere to this stricter standard to ensure interoperability. The encoding of DNS names in the DNS protocol is limited to 255 characters. Since the encoding consists of labels prefixed by a length bytes and there is a trailing NULL byte, only 253 characters can appear in the textual dotted notation. Domain-name values use the US-ASCII encoding. Their canonical format uses lowercase US-ASCII characters. Internationalized domain names MUST be encoded in punycode as described in RFC 3492.

vendor-class-identifier

Vendor class identifier sent by the DHCP client to tailor configurations for specific types of devices.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options
vsr running dhcp-options# vendor-class-identifier <string>

option

Specify a custom DHCP option.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>

<0-254>

DHCP option identifier code.

name (mandatory)

A name to identify the option.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># name <string>
boolean

Boolean value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># boolean true|false
int8

Int8 value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># int8 <int8>
int16

Int16 value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># int16 <int16>
int32

Int32 value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># int32 <int32>
uint8

Uint8 value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># uint8 <uint8>
uint16

Uint16 value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># uint16 <uint16>
uint32

Uint32 value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># uint32 <uint32>
ipv4-address

IP address or hostname value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># ipv4-address IPV4-ADDRESS

IPV4-ADDRESS values

Description

<ipv4-address>

An IPv4 address.

<domain-name>{1,253}

The domain-name type represents a DNS domain name. Fully quallified left to the models which utilize this type. Internet domain names are only loosely specified. Section 3.5 of RFC 1034 recommends a syntax (modified in Section 2.1 of RFC 1123). The pattern above is intended to allow for current practice in domain name use, and some possible future expansion. It is designed to hold various types of domain names, including names used for A or AAAA records (host names) and other records, such as SRV records. Note that Internet host names have a stricter syntax (described in RFC 952) than the DNS recommendations in RFCs 1034 and 1123, and that systems that want to store host names in schema nodes using the domain-name type are recommended to adhere to this stricter standard to ensure interoperability. The encoding of DNS names in the DNS protocol is limited to 255 characters. Since the encoding consists of labels prefixed by a length bytes and there is a trailing NULL byte, only 253 characters can appear in the textual dotted notation. Domain-name values use the US-ASCII encoding. Their canonical format uses lowercase US-ASCII characters. Internationalized domain names MUST be encoded in punycode as described in RFC 3492.

text

Text value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># text <string>{1,254}
hex

Hexadecimal string value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254>
vsr running option <0-254># hex HEX

HEX

A hexadecimal string with octets represented as hex digits separated by colons. The canonical representation uses lowercase characters.

array

Array value.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
int8

Array of int8.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# int8 <int8>
int16

Array of int16.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# int16 <int16>
int32

Array of int32.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# int32 <int32>
uint8

Array of uint8.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# uint8 <uint8>
uint16

Array of uint16.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# uint16 <uint16>
uint32

Array of uint32.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# uint32 <uint32>
ipv4-address

Array of IPv4 addresses or domain name.

vsr running config# vrf <vrf> dhcp server subnet <subnet> dhcp-options option <0-254> array
vsr running array# ipv4-address IPV4-ADDRESS

IPV4-ADDRESS values

Description

<ipv4-address>

An IPv4 address.

<domain-name>{1,253}

The domain-name type represents a DNS domain name. Fully quallified left to the models which utilize this type. Internet domain names are only loosely specified. Section 3.5 of RFC 1034 recommends a syntax (modified in Section 2.1 of RFC 1123). The pattern above is intended to allow for current practice in domain name use, and some possible future expansion. It is designed to hold various types of domain names, including names used for A or AAAA records (host names) and other records, such as SRV records. Note that Internet host names have a stricter syntax (described in RFC 952) than the DNS recommendations in RFCs 1034 and 1123, and that systems that want to store host names in schema nodes using the domain-name type are recommended to adhere to this stricter standard to ensure interoperability. The encoding of DNS names in the DNS protocol is limited to 255 characters. Since the encoding consists of labels prefixed by a length bytes and there is a trailing NULL byte, only 253 characters can appear in the textual dotted notation. Domain-name values use the US-ASCII encoding. Their canonical format uses lowercase US-ASCII characters. Internationalized domain names MUST be encoded in punycode as described in RFC 3492.

dhcp-server-leases (state only)

State of leases for DHCP server.

starts (state only)

Lease start time.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> starts

ends (state only)

Lease end time.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> ends

hw-mac-address (state only)

MAC address of the network interface on which the lease will be used.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> hw-mac-address

uid (state only)

Client identifier used by the client to acquire the lease.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> uid

client-hostname (state only)

Client host name sent using client-hostname statement.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> client-hostname

binding-state (state only)

Lease’s binding state.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> binding-state

next-binding-state (state only)

State the lease will move to when the current state expires.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> next-binding-state

option-agent-circuit-id (state only)

Circuit ID option sent by the relay agent.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> option-agent-circuit-id

option-agent-remote-id (state only)

Remote ID option sent by the relay agent.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> option-agent-remote-id

vendor-class-identifier (state only)

Client-supplied Vendor Class Identifier option.

vsr> show state vrf <vrf> dhcp server dhcp-server-leases <dhcp-server-leases> vendor-class-identifier