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

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>

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>

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>

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