H3C S3610[S5510] Series Ethernet Switches Command Manual-Release 0001-(V1.02)

HomeSupportSwitchesH3C S3610[S5510] Switch SeriesReference GuidesCommand ReferencesH3C S3610[S5510] Series Ethernet Switches Command Manual-Release 0001-(V1.02)
17-DHCP Command
Title Size Download
17-DHCP Command 278 KB

Table of Contents

Chapter 1 DHCP Server Configuration Commands. 1-1

1.1 DHCP Server Configuration Commands. 1-1

1.1.1 bims-server 1-1

1.1.2 bootfile-name. 1-2

1.1.3 dhcp enable. 1-2

1.1.4 dhcp select server global-pool 1-3

1.1.5 dhcp server detect 1-4

1.1.6 dhcp server forbidden-ip. 1-4

1.1.7 dhcp server ip-pool 1-5

1.1.8 dhcp server ping packets. 1-6

1.1.9 dhcp server ping timeout 1-7

1.1.10 dhcp server relay information enable. 1-7

1.1.11 display dhcp server conflict 1-8

1.1.12 display dhcp server expired. 1-9

1.1.13 display dhcp server free-ip. 1-10

1.1.14 display dhcp server ip-in-use. 1-10

1.1.15 display dhcp server statistics. 1-11

1.1.16 display dhcp server tree. 1-13

1.1.17 dns-list 1-15

1.1.18 domain-name. 1-15

1.1.19 expired. 1-16

1.1.20 gateway-list 1-17

1.1.21 nbns-list 1-17

1.1.22 netbios-type. 1-18

1.1.23 network. 1-19

1.1.24 option. 1-20

1.1.25 reset dhcp server conflict 1-21

1.1.26 reset dhcp server ip-in-use. 1-22

1.1.27 reset dhcp server statistics. 1-22

1.1.28 static-bind client-identifier 1-23

1.1.29 static-bind ip-address. 1-24

1.1.30 static-bind mac-address. 1-25

1.1.31 tftp-server domain-name. 1-26

1.1.32 tftp-server ip-address. 1-26

1.1.33 voice-config. 1-27

Chapter 2 DHCP Relay Agent Configuration Commands. 2-1

2.1 DHCP Relay Agent Configuration Commands. 2-1

2.1.1 dhcp enable. 2-1

2.1.2 dhcp relay address-check. 2-2

2.1.3 dhcp relay information enable. 2-2

2.1.4 dhcp relay information format 2-3

2.1.5 dhcp relay information strategy. 2-4

2.1.6 dhcp relay release. 2-5

2.1.7 dhcp relay security static. 2-6

2.1.8 dhcp relay security tracker 2-6

2.1.9 dhcp relay server-detect 2-7

2.1.10 dhcp relay server-group. 2-8

2.1.11 dhcp relay server-select 2-9

2.1.12 dhcp select relay. 2-9

2.1.13 display dhcp relay. 2-10

2.1.14 display dhcp relay security. 2-11

2.1.15 display dhcp relay security statistics. 2-12

2.1.16 display dhcp relay security tracker 2-12

2.1.17 display dhcp relay server-group. 2-13

2.1.18 display dhcp relay statistics. 2-14

2.1.19 reset dhcp relay statistics. 2-15

Chapter 3 DHCP Snooping Configuration Commands. 3-1

3.1 DHCP Snooping Configuration Commands. 3-1

3.1.1 dhcp-snooping. 3-1

3.1.2 dhcp-snooping trust 3-2

3.1.3 display dhcp-snooping. 3-2

3.1.4 display dhcp-snooping trust 3-4

Chapter 4 DHCP Client Configuration Commands. 4-1

4.1 DHCP Client Configuration Commands. 4-1

4.1.1 display dhcp client 4-1

4.1.2 ip address dhcp-alloc. 4-3

Chapter 5 BOOTP Client Configuration Commands. 5-1

5.1 BOOTP Client Configuration Commands. 5-1

5.1.1 display bootp client 5-1

5.1.2 ip address bootp-alloc. 5-2

 


Chapter 1  DHCP Server Configuration Commands

 

l      Currently, the interface-related DHCP server configurations can only be made on VLAN interfaces..

l      DHCP Snooping must be disabled on the DHCP server.

 

1.1  DHCP Server Configuration Commands

1.1.1  bims-server

Syntax

bims-server ip ip-address [ port port-number ] sharekey key

undo bims-server

View

DHCP address pool view

Parameter

ip ip-address: BIMS server IP address.

port port-number: BIMS server port number, a string of 1 to 65534.

sharekey key: BIMS server shared key, a string of 1 to 16 characters.

Description

Use the bims-server command to specify the IP address, port number, and shared key of a BIMS server in the DHCP address pool for the client.

Use the undo bims-server command to remove specified BIMS server information from the DHCP address pool.

By default, the related information of the BIMS server is not specified.

If you execute the bims-server command repeatedly, the latest configuration will overwrite the previous one.

Related commands: dhcp server ip-pool.

Example

# Specify the IP address 1.1.1.1, port number 80, shared key aabbcc of the BIMS server in DHCP address pool 0 for the client.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] bims-server ip 1.1.1.1 port 80 sharekey aabbcc

1.1.2  bootfile-name

Syntax

bootfile-name bootfile-name

undo bootfile-name

View

DHCP address pool view

Parameter

bootfile-name: Boot file name, a string of 1 to 63 characters.

Description

Use the bootfile-name command to specify a bootfile name in the DHCP address pool for the client.

Use the undo bootfile-name command to remove the specified bootfile name from the DHCP address pool.

By default, no bootfile name is specified.

If you execute the bootfile-name command repeatedly, the latest configuration will overwrite the previous one.

Example

# Specify the bootfile name aaa in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] bootfile-name aaa

1.1.3  dhcp enable

Syntax

dhcp enable

undo dhcp enable

View

System view

Parameter

None

Description

Use the dhcp enable command to enable DHCP.

Use the undo dhcp enable command to disable DHCP.

By default, DHCP is disabled.

 

&  Note:

l      Before performing DHCP server and relay agent configurations, enable DHCP.

l      You cannot enable the DHCP and DHCP snooping on the same device. If DHCP snooping is enabled, enabling DHCP will fail.

 

Example

# Enable DHCP.

<Sysname> system-view

[Sysname] dhcp enable

1.1.4  dhcp select server global-pool

Syntax

dhcp select server global-pool [ subaddress ]

undo dhcp select server global-pool subaddress

View

VLAN interface view

Parameter

subaddress: Supports subaddress allocation. That is, the DHCP server and clients are on the same network segment, and the server allocates IP addresses from the address pool containing the network segment of the first subaddress if several subaddresses exist.

Description

Use the dhcp select server global-pool command to enable the DHCP server on specified interface(s). After the interface receives a DHCP request, the DHCP server will allocate an IP address from the address pool.

Use the undo dhcp select server global-pool subaddress command to cancel the support for subaddress allocation.

By default, the DHCP server is enabled on an interface.

Example

# Enable the DHCP server on VLAN-interface 1.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp select server global-pool

1.1.5  dhcp server detect

Syntax

dhcp server detect

undo dhcp server detect

View

System view

Parameter

None

Description

Use the dhcp server detect command to enable pseudo DHCP server detection.

Use the undo dhcp server detect command to disable the function.

By default, the function is disabled.

Example

# Enable pseudo DHCP server detection.

<Sysname> system-view

[Sysname] dhcp server detect

1.1.6  dhcp server forbidden-ip

Syntax

dhcp server forbidden-ip low-ip-address [ high-ip-address ]

undo dhcp server forbidden-ip low-ip-address [ high-ip-address ]

View

System view

Parameter

low-ip-address: Specifies the start IP address of the IP address range to be excluded from dynamic allocation.

high-ip-address: Specifies the end IP address of the IP address range to be excluded from dynamic allocation. The end IP address must have a higher sequence than the start one.

Description

Use the dhcp server forbidden-ip command to exclude IP addresses from dynamic allocation.

Use the undo dhcp server forbidden-ip command to remove the configuration.

All IP addresses in DHCP address pools are assignable by default.

When you use the dhcp server forbidden-ip command to exclude an IP address that is statically bound to a user from dynamic assignment, the address can be still assigned to the user.

Related command: dhcp server ip-pool, network, and static-bind ip-address.

Example

# Exclude the IP address range 10.110.1.1 to 10.110.1.63 from dynamic allocation.

<Sysname> system-view

[Sysname] dhcp server forbidden-ip 10.110.1.1 10.110.1.63

1.1.7  dhcp server ip-pool

Syntax

dhcp server ip-pool pool-name

undo dhcp server ip-pool pool-name

View

System view

Parameter

pool-name: Specifies a global address pool name, which is a unique pool identifier, a string of 1 to 35 characters.

Description

Use the dhcp server ip-pool command to create a DHCP address pool and enter its view. If the pool was created, you will directly enter its view.

Use the undo dhcp server ip-pool command to remove specified DHCP address pool.

By default, no DHCP address pool is created.

Related command: dhcp enable.

Example

# Create the DHCP address pool identified by 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0]

1.1.8  dhcp server ping packets

Syntax

dhcp server ping packets number

undo dhcp server ping packets

View

System view

Parameter

number: Specifies the number of ping packets, a string of 0 to 10. 0 means no ping operation.

Description

Use the dhcp server ping packets command to specify the maximum number of ping packets on the DHCP server.

Use the undo dhcp server ping packets command to restore the default.

The number defaults to 1.

Example

# Specify the maximum number of ping packets as 1.

<Sysname> system-view

[Sysname] dhcp server ping packets 10

1.1.9  dhcp server ping timeout

Syntax

dhcp server ping timeout milliseconds

undo dhcp server ping timeout

View

System view

Parameter

milliseconds: Specifies the response timeout value for ping packets in milliseconds, a string of 0 to 10000. 0 means no ping operation.

Description

Use the dhcp server ping timeout command to configure response timeout time of the ping packet on the DHCP server.

Use the undo dhcp server ping timeout command to restore the default.

The time defaults to 500.

Example

# Specify the response timeout time as 1000ms.

<Sysname> system-view

[Sysname] dhcp server ping timeout 1000

1.1.10  dhcp server relay information enable

Syntax

dhcp server relay information enable

undo dhcp server relay information enable

View

System view.

Parameter

None.

Description

Use the dhcp server relay information enable command to enable the DHCP server to support option 82.

Use the undo dhcp server relay information enable command to disable the option 82 support on the DHCP server.

By default, the DHCP server supports Option 82.

Example

# Disable the option 82 support on the DHCP server.

<Sysname> system-view

[Sysname] undo dhcp server relay information enable

1.1.11  display dhcp server conflict

Syntax

display dhcp server conflict { all | ip ip-address }

View

Any view

Parameter

all: Specifies all IP addresses.

ip-address: Specifies an IP address

Description

Use the display dhcp server conflict command to display information about IP address conflicts.

Related command: reset dhcp server conflict.

Example

# Display information about all IP address conflicts.

<Sysname> display dhcp server conflict all

    Address             Discover time

    201.43.1.8          May  4 2000 10:50:31

 --- total 1 entry ---

Table 1-1 Description on fields of the display dhcp server conflict command

Field

Description

Address

Conflicted IP address

Discover Time

Time when the conflict was discovered

 

1.1.12  display dhcp server expired

Syntax

display dhcp server expired { all | ip ip-address | pool [ pool-name ] }

View

Any view

Parameter

all: Displays the lease expiration information of all DHCP address pools.

ip ip-address: Displays the lease expiration information of a specified IP address.

pool [ pool-name ]: Displays the lease expiration information of a specified address pool. The pool name is a string of 1 to 35 characters. If the pool name is not specified, the lease expiration information of all address pools is displayed.

Description

Use the display dhcp server expired command to display the lease expiration information of specified DHCP address pool(s) or an IP address.

DHCP will assign these expired IP addresses to DHCP clients after all addresses have been assigned.

Example

# Display information about lease expirations in all DHCP address pools.

<Sysname> display dhcp server expired all

 Global pool:

 IP address       Client-identifier/    Lease expiration           Type

                    Hardware address

 1.1.1.4        0001-0001-0003        Feb 21 2006 18:07:26 PM   Release

 1.1.1.5        0001-0001-0004        Feb 21 2006 18:07:26 PM   Release

 --- total 2 entry ---

Table 1-2 Description on fields of the display dhcp server expired command

Field

Description

Global pool

Information about lease expiration of a DHCP address pool

IP address

Expired IP addresses

Client-identifier/Hardware address

IDs or MACs of clients whose IP addresses were expired

Lease expiration

The lease expiration time

Type

Types of lease expirations. Currently, this field is set to Release.

 

1.1.13  display dhcp server free-ip

Syntax

display dhcp server free-ip

View

Any view

Parameter

None

Description

Use the display dhcp server free-ip command to display information about assignable IP addresses, which have never been assigned.

Example

# Display information about assignable IP addresses.

<Sysname> display dhcp server free-ip

IP Range from 10.0.0.0              to  10.0.0.255

1.1.14  display dhcp server ip-in-use

Syntax

display dhcp server ip-in-use { all | ip ip-address | pool [ pool-name ] }

View

Any view

Parameter

all: Displays the binding information of all DHCP address pools.

ip ip-address: Displays the binding information of an IP address.

pool [ pool-name ]: Displays the binding information of a specified address pool. The pool name is a string of 1 to 35 characters. If no pool name is specified, the binding information of all address pools is displayed.

Description

Use the display dhcp server ip-in-use command to display the binding information of DHCP address pool(s) or an IP address.

Related command: reset dhcp server ip-in-use.

Example

# Display the binding information of all DHCP address pools.

<Sysname> display dhcp server ip-in-use all

 Global pool:

 IP address    Client-identifier/    Lease expiration        Type

                 Hardware address

 10.1.1.1      4444-4444-4444        NOT Used                  Manual

 

 --- total 1 entry ---

Table 1-3 Description on fields of the display dhcp server ip-in-use command

Field

Description

Global pool

Binding information of a DHCP address pool

IP address

Bound IP address

Client-identifier/Hardware address

Client’s ID or MAC of the binding

Lease expiration

Lease expiration time.

Type

Binding types, including Manual, Auto:OFFERED and Auto:COMMITTED.

l      Manual: manual binding

l      Auto:OFFERED: The binding sent in the DHCP-OFFER message from the server to the client.

l      Auto:COMMITTED: The binding sent in the DHCP-ACK message from the server to the client.

 

1.1.15  display dhcp server statistics

Syntax

display dhcp server statistics

View

Any view

Parameter

None

Description

Use the display dhcp server statistics command to display the statistics of the DHCP server.

Related command: reset dhcp server statistics.

Example

# Display the statistics on the DHCP server.

<Sysname> display dhcp server statistics

    Global Pool:

     Pool Number:            5

     Binding:

      Auto:              0

      Manual:                1

      Expire:                0

    BOOTP Request:           7

     DHCPDISCOVER:           1

     DHCPREQUEST:            4

     DHCPDECLINE:            0

     DHCPRELEASE:            1

     DHCPINFORM:         0

     BOOTPREQUEST            1

    BOOTPREPLY:          5

     DHCPOFFER:          1

     DHCPACK:                3

     DHCPNAK:                0

     BOOTPREPLY:         1

    Bad Messages:            0

Table 1-4 Description on fields of the display dhcp server statistics command

Field

Description

Global Pool

Statistics of a DHCP address pool

Pool Number

The number of address pools

Auto

The number of dynamic bindings

Manual

The number of static bindings

Expire

The number of expired bindings

BOOTP Request:                 7

     DHCPDISCOVER:          1

     DHCPREQUEST:            4

     DHCPDECLINE:             0

     DHCPRELEASE:            1

     DHCPINFORM:        0

    BOOTPREQUEST           1

The number of DHCP requests sent from DHCP clients to the DHCP server.

BOOTP Reply:                            5

     DHCPOFFER:                1

     DHCPACK:                    3

     DHCPNAK:                    0

   BOOTPREPLY                 1

The number of DHCP replies sent from the DHCP server to DHCP clients.

Bad Messages

 The number of erroneous messages

 

1.1.16  display dhcp server tree

Syntax

display dhcp server tree { all | pool [ pool-name ] }

View

Any view

Parameter

all: Displays the tree organization information of all DHCP address pools.

pool [ pool-name ]: Displays the tree organization information of a specified address pool. The pool name is a string of 1 to 35 characters. If no pool name is specified, the tree organization information of all address pools will be displayed.

Description

Use the display dhcp server tree command to display the tree organization information of DHCP address pool(s).

Example

# Display the tree organization information of all DHCP address pools.

<Sysname> display dhcp server tree all

Global pool:

 

Pool name: 0

 network 20.1.1.0 mask 255.255.255.0

 Sibling node:1

 option 2 ip-address 1.1.1.1

 expired 1 0 0

 

Pool name: 1

 static-bind ip-address 10.10.1.2 mask 255.0.0.0

 static-bind mac-address 00e0-00fc-0001

PrevSibling node:0

 expired unlimited

Table 1-5 Description on fields of the display dhcp server tree command

Field

Description

Global pool

Information of a address pool

Pool name

Address pool name

network

Network segment for address allocation

static-bind ip-address 10.10.1.2 mask 255.0.0.0

static-bind mac-address 00e0-00fc-0001

The IP address and MAC address of the static binding

Sibling node

The sibling node of the current node, nodes of this kind in the output are:

l      Child node: The child node(subnet segment) address pool of the current node

l      Parent node: The parent node(nature network segment) address pool of the current node

l      Sibling node: The latter sibling node of the current node (another subnet of the same nature network). The earlier the sibling node is configured, the higher selection priority the sibling node has.

l      PrevSibling node: The previous sibling node of the current node

option

Self-defined DHCP options

expired

The lease duration, in the format of day, hour, minute

 

1.1.17  dns-list

Syntax

dns-list ip-address&<1-8>

undo dns-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address&<1-8>: Up to eight DNS server addresses to be specified separated by spaces.

all: Specifies all DNS server addresses to remove.

Description

Use the dns-list command to specify DNS server addresses in a DHCP address pool.

Use the undo dns-list command to remove DNS server addresses from a DHCP address pool.

By default, no DNS server address is specified.

If you repeatedly use the dns-list command, the latest configuration will overwrite the previous one.

Related command: dhcp server ip-pool.

Example

# Specify the DNS server address 10.1.1.254 in DHCP address pool 0.

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] dns-list 10.1.1.254

1.1.18  domain-name

Syntax

domain-name domain-name

undo domain-name

View

DHCP address pool view

Parameter

domain-name: The DHCP client domain name to be specified in a DHCP address pool, a string of 1 to 50 characters.

Description

Use the domain-name command to specify the DHCP client domain name in a DHCP address pool.

Use the undo domain-name command to remove the domain name from a DHCP address pool.

The domain name is not specified by default.

Related command: dhcp server ip-pool.

Example

# Specify the client domain name as mydomain.com in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] domain-name mydomain.com

1.1.19  expired

Syntax

expired { day day [ hour hour [ minute minute ] ] | unlimited }

undo expired

View

DHCP address pool view

Parameter

day day: Specifies the number of days, a string of 0 to 365.

hour hour: Specified the number of hours, a string of 0 to 23.

minute minute: Specifies the number of minutes, a string of 0 to 59.

unlimited: Specifies the infinite duration, which is actually 136 years.

Description

Use the expired command to specify the lease duration in a DHCP address pool.

Use the undo expired command to restore the default lease duration in a DHCP address pool.

The lease duration defaults to one day.

Notice that if the lease duration you specified is beyond the year 2106, the system regards the lease as expired.

Related command: dhcp server ip-pool.

Example

# Specify the lease duration as one day, two hours and three minutes in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] expired day 1 hour 2 minute 3

1.1.20  gateway-list

Syntax

gateway-list ip-address&<1-8>

undo gateway-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address&<1-8>: Gateway IP address. &<1-8> means you can specify up to eight gateway addresses separated by spaces.

all: Specifies all gateway IP addresses to be removed.

Description

Use the gateway-list command to specify gateway address(es) in a DHCP address pool.

Use the undo gateway-list command to remove specified gateway address(es) from a DHCP address pool.

By default, no gateway address is specified.

If you use the gateway-list command repeatedly, the latest configuration will overwrite the previous one.

Example

# Specify the gateway address 10.110.1.99 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] gateway-list 10.110.1.99

1.1.21  nbns-list

Syntax

nbns-list ip-address&<1-8>

undo nbns-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address&<1-8>: WINS server IP address, &<1-8> means you can specify up to eight WINS server addresses separated by spaces.

all: Specifies all WINS server addresses to be removed.

Description

Use the nbns-list command to specify WINS server address(es) in a DHCP address pool.

Use the undo nbns-list command to remove WINS server address(es) from a DHCP address pool.

By default, no WINS server address is specified.

If you use the nbns-list command repeatedly, the latest configuration will overwrite the previous one.

Related command: dhcp server ip-pool and netbios-type.

Example

# Specify WINS server address 10.12.1.99 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] nbns-list 10.12.1.99

1.1.22  netbios-type

Syntax

netbios-type { b-node | h-node | m-node | p-node }

undo netbios-type

View

DHCP address pool view

Parameter

b-node: Broadcast node. A b-node client sends the destination name in a broadcast message. The destination returns the name-to-IP mapping to the client after receiving the message.

p-node: Peer-to-peer node. A p-node client sends the destination name in a unicast message to the WINS server, and the WINS server returns the mapping to the client.

m-node: Mixed node, a combination of a b-node first and p-node second. An m-node client broadcasts the destination name, if there is no response, and then unicasts the destination name to the WINS server to get the mapping.

h-node: Hybrid node, a combination of a p-node first and b-node second. An h-node is a p-node with the peer-to-peer communication mechanism. An h-node client unicasts the destination name to the WINS server, if there is no response, and then broadcasts it to get the mapping from the destination.

Description

Use the netbios-type command to specify the client NetBIOS node type in a DHCP address pool.

Use the undo netbios-type command to remove the client NetBIOS node type from a DHCP address pool.

No NetBIOS node type is specified by default.

Related command: dhcp server ip-pool and nbns-list.

Example

# Specify the NetBIOS node type as b-node in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] netbios-type b-node

1.1.23  network

Syntax

network network-address [ mask-length | mask mask ]

undo network

View

DHCP address pool view

Parameter

network-address: IP address range for dynamic allocation. If no mask length and mask is specified, the natural mask will be used.

mask-length: The mask length, a string of 1 to 30.

mask mask: Specifies the IP address network mask, in the format x.x.x.x.

Description

Use the network command to specify the IP address range for dynamic allocation in a DHCP address pool.

Use the undo network command to remove the specified address range.

No IP address range is specified by default.

Notice that you can specify only one network segment for each DHCP address pool. If you use the network command repeatedly, the latest configuration will overwrite the previous one.

Related command: dhcp server ip-pool and dhcp server forbidden-ip.

Example

# Specify 192.168.8.0/24 as the address range for dynamic allocation in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] network 192.168.8.0 mask 255.255.255.0

1.1.24  option

Syntax

option code { ascii ascii-string | hex hex-string&<1-16> | ip-address ip-address&<1-8> }

undo option code

View

DHCP address pool view

Parameter

code: Specifies a self-defined option number, a string of 2 to 254, excluding 3, 6, 15, 44, 46, 50 through 55, 57 through 61, 66, 67, 82, 150, 184, and 217.

ascii ascii-string: Specifies an ASCII string with 1 to 63 characters.

hex hex-string&<1-16>: Specifies up to 16 hex digit strings separated by spaces, and each string contains 2, 4, 6 or 8 hex digits. The device currently supports total 128 hex digits, not including spaces.

ip-address ip-address&<1-8>: Specifies IP addresses, &<1-8> indicates you can specify up to eight IP addresses, separated by spaces.

Description

Use the option command to configure a self-defined DHCP option in a DHCP address pool.

Use the undo option command to remove a self-defined DHCP option from a DHCP address pool.

The option command is not configured by default.

If you use the option command repeatedly, the latest configuration will overwrite the previous one.

Related command: dhcp server ip-pool.

Example

# Configure the hex digits 0x11 and 0x22 for the self-defined DHCP option 100 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] option 100 hex 11 22

1.1.25  reset dhcp server conflict

Syntax

reset dhcp server conflict { all | ip ip-address }

View

User view

Parameter

all: Clears the statistics of all IP address conflicts.

ip ip-address: Clears the conflict statistics of a specified IP address.

Description

Use the reset dhcp server conflict command to clear statistics of IP address conflict(s).

Related command: display dhcp server conflict.

Example

# Clears the statistics of all IP address conflicts.

<Sysname> reset dhcp server conflict all

1.1.26  reset dhcp server ip-in-use

Syntax

reset dhcp server ip-in-use { all | ip ip-address | pool [ pool-name ] }

View

User view

Parameter

all: Clears the IP address dynamic binding information of all DHCP address pools.

ip ip-address: Clears the dynamic binding information of a specified IP address.

pool [ pool-name ]: Clears the dynamic binding information of a specified address pool. The pool name is a string of 1 to 35 characters. If no pool name is specified, the dynamic binding information of all address pools is cleared.

Description

Use the reset dhcp server ip-in-use command to clear dynamic IP address binding information.

Related command: display dhcp server ip-in-use

Example

# Clear the binding information of IP address 10.110.1.1.

<Sysname> reset dhcp server ip-in-use ip 10.110.1.1

1.1.27  reset dhcp server statistics

Syntax

reset dhcp server statistics

View

User view

Parameter

None

Description

Use the reset dhcp server statistics command to clear the statistics of the DHCP server, including the number of DHCP address pools, number of manual, dynamic and expired bindings, number of unrecognized messages, and number of DHCP requests and replies.

Related command: display dhcp server statistics.

Example

# Clear the statistics of the DHCP server.

<Sysname> reset dhcp server statistics

1.1.28  static-bind client-identifier

Syntax

static-bind client-identifier client-identifier

undo static-bind client-identifier

View

DHCP address pool view

Parameter

client-identifier: The client ID of a static binding, a string with 4 to 160 characters in the format H-H-H…, each H indicates 4 hex digits except the last H indicates 2 or 4 hex digits. For example, aabb-cccc-dd is a valid ID, while aabb-c-dddd and aabb-cc-dddd are invalid.

Description

Use the static-bind client-identifier command to specify the client ID of a static binding in a DHCP address pool.

Use the undo static-bind client-identifier command to remove the client ID of a static binding from a DHCP address pool.

By default, no client ID is specified.

Notice that:

l           Use the static-bind client-identifier command together with the static-bind ip-address command to accomplish a static binding configuration.

l           The ID of the static binding of a client must be identical to the ID displayed by using the display dhcp client verbose command on the client. Otherwise, the client cannot obtain an IP address.

l           If you use the static-bind client-identifier or static-bind mac-address command repeatedly, the latest configuration will overwrite the previous one.

Related command: dhcp server ip-pool, static-bind ip-address, static-bind mac-address, and display dhcp client verbose.

Example

# Bind the client ID aaaa-bbbb to the IP address 10.1.1.1 with the mask 255.255.255.0 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] static-bind ip-address 10.1.1.1 mask 255.255.255.0

[Sysname-dhcp-pool-0] static-bind client-identifier aaaa-bbbb

1.1.29  static-bind ip-address

Syntax

static-bind ip-address ip-address [ mask-length | mask mask ]

undo static-bind ip-address

View

DHCP address pool view

Parameter

ip-address: IP address of a static binding, if no mask and mask length is specified, the natural mask is used.

mask-length: The mask length of the IP address, that is, the number of digit 1 in the mask.

mask mask: Specifies the IP address mask, in dotted decimal format.

Description

Use the static-bind ip-address command to specify the IP address of a static binding in a DHCP address pool.

Use the undo static-bind ip-address command to remove the IP address of a static binding from a DHCP address pool.

By default, no IP address of a static binding in a DHCP address pool is specified.

Notice that:

l           Use the static-bind ip-address command together with the static-bind mac-address or static-bind client-identifier command to accomplish a static binding configuration.

l           If the IP address of a static binding is an interface address of the DHCP server, the static binding does not take effect.

l           If you use the static-bind ip-address command repeatedly, the latest configuration will overwrite the previous one.

Related command: dhcp server ip-pool, static-bind client-identifier and static-bind mac-address.

Example

# Bind the client MAC address 0000-e03f-0305 to the IP address 10.1.1.1 with the mask 255.255.255.0 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] static-bind ip-address 10.1.1.1 mask 255.255.255.0

Info:Please configure a client-identifier/MAC for the binding.

[Sysname-dhcp-pool-0] static-bind mac-address 0000-e03f-0305

1.1.30  static-bind mac-address

Syntax

static-bind mac-address mac-address

undo static-bind mac-address

View

DHCP address pool view

Parameter

mac-address: The MAC address of a static binding, in the format H-H-H.

Description

Use the static-bind mac-address command to specify the MAC address of a static binding in a DHCP address pool.

Use the undo static-bind mac-address command to remove the MAC address of a static binding from a DHCP address pool.

By default, no MAC address is specified.

Note that:

l           Use the static-bind mac-address command together with the static-bind ip-address command to complete a static binding configuration.

l           If you use the static-bind mac-address or static-bind client-identifier command repeatedly, the latest configuration will overwrite the previous one.

Relate command: dhcp server ip-pool, static-bind client-identifier and static-bind ip-address.

Example

# Bind the client MAC address 0000-e03f-0305 to the IP address 10.1.1.1 with the mask 255.255.255.0 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] static-bind ip-address 10.1.1.1 mask 255.255.255.0

[Sysname-dhcp-pool-0] static-bind mac-address 0000-e03f-0305

1.1.31  tftp-server domain-name

Syntax

tftp-server domain-name domain-name

undo tftp-server domain-name

View

DHCP address pool view

Parameter

domain-name: TFTP server name, a string of 1 to 63 characters.

Description

Use the tftp-server domain-name command to specify a TFTP server name in a DHCP address pool.

Use the undo tftp-server domain-name command to remove the TFTP server name from a DHCP address pool.

By default, no TFTP server name is specified.

Using the tftp-server domain-name command repeatedly will overwrite the previous configuration.

Example

# Specify the TFTP server name as aaa in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] tftp-server domain-name aaa

1.1.32  tftp-server ip-address

Syntax

tftp-server ip-address ip-address

undo tftp-server ip-address

View

DHCP address pool view

Parameter

ip-address: TFTP server IP address

Description

Use the tftp-server ip-address command to specify the TFTP server IP address in a DHCP address pool.

Use the undo tftp-server ip-address command to remove the TFTP server IP address from a DHCP address pool.

By default, no TFTP server address is specified.

Using the tftp-server ip-address command repeatedly will overwrite the previous configuration.

Example

# Specify the TFTP server address 10.1.1.1 in DHCP address pool 0.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] tftp-server ip-address 10.1.1.1

1.1.33  voice-config

Syntax

voice-config { as-ip ip-address | fail-over ip-address dialer-string | ncp-ip ip-address | voice-vlan vlan-id { disable | enable } }

undo voice-config [ as-ip | fail-over | ncp-ip | voice-vlan ]

View

DHCP address pool view.

Parameter

as-ip ip-address: Specifies the backup network calling processor IP address.

fail-over ip-address dialer-string: Specifies the failover IP address and dialer string. The dialer-string is a string of 1 to 39 characters, which can be 0 to 9, and “*”.

ncp-ip ip-address: Specifies the primary network calling processor IP address.

voice-vlan vlan-id: Specifies the voice VLAN ID, a string of 1 to 4094.

l           disable: Disables the specified voice VLAN ID, meaning DHCP clients will not take this ID as their voice VLAN.

l           enable: Enables the specified voice VLAN ID, meaning DHCP clients will take this ID as their voice VLAN.

Description

Use the voice-config command to configure specified Option 184 contents in a DHCP address pool.

Use the undo voice-config command to remove specified option 184 contents from a DHCP address pool.

By default, no Option 184 content is configured.

Notice that specifying the IP address of a network calling processor first is necessary to make other configured parameters take effect.

Example

# Configure Option 184 in DHCP address pool 0: the primary network calling processor 10.1.1.1, backup network calling processor 10.2.2.2, voice VLAN ID 1 that is enabled, the failover IP address 10.3.3.3 and dialer string 99*.

<Sysname> system-view

[Sysname] dhcp server ip-pool 0

[Sysname-dhcp-pool-0] voice-config ncp-ip 10.1.1.1

[Sysname-dhcp-pool-0] voice-config as-ip 10.2.2.2

[Sysname-dhcp-pool-0] voice-config voice-vlan 1 enable

[Sysname-dhcp-pool-0] voice-config fail-over 10.3.3.3 99*

 


Chapter 2  DHCP Relay Agent Configuration Commands

 

l      Currently, the interface-related DHCP relay agent configurations can only be made on VLAN interfaces.

l      DHCP Snooping cannot be configured on the DHCP relay agent.

 

2.1  DHCP Relay Agent Configuration Commands

2.1.1  dhcp enable

Syntax

dhcp enable

undo dhcp enable

View

System view

Parameter

None

Description

Use the dhcp enable command to enable DHCP.

Use the undo dhcp enable command to disable DHCP.

By default, DHCP is disabled.

 

&  Note:

For both DHCP server and relay agent configuration, enabling DHCP first is necessary to make other configurations take effect.

 

Example

# Enable DHCP.

<Sysname> system-view

[Sysname] dhcp enable

2.1.2  dhcp relay address-check

Syntax

dhcp relay address-check { disable | enable }

View

VLAN interface view

Parameter

disable: Disables IP address match checking on the relay agent.

enable: Enables IP address match checking on the relay agent.

Description

Use the dhcp relay address-check enable command to enable IP address match checking on the relay agent.

Use the dhcp relay address-check disable command to disable IP address match checking on the relay agent.

By default, the function is disabled.

Example

# Enable IP address match checking on the DHCP relay agent.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp relay address-check enable

2.1.3  dhcp relay information enable

Syntax

dhcp relay information enable

undo dhcp relay information enable

View

VLAN interface view

Parameter

None

Description

Use the dhcp relay information enable command to enable the relay agent to support option 82.

Use the undo dhcp relay information enable command to disable option 82 support.

By default, option 82 support is disabled on DHCP relay agent.

Example

# Enable option 82 support on the relay agent.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp relay information enable

2.1.4  dhcp relay information format

Syntax

dhcp relay information format { normal | verbose [ node-identifier { mac | sysname | user-defined node-identifier } ] }

undo dhcp relay information format [ verbose node-identifier ]

View

VLAN Interface view

Parameter

normal: Specifies the normal padding format.

verbose: Specifies the verbose padding format.

node-identifier { mac | sysname | user-defined node-identifier }: Specifies access node identifier, mac indicates using MAC address as the node identifier, sysname indicates using a node name as the node identifier, user-defined node-identifier indicates using a specified character string as the node identifier, in which node-identifier is a string with 1 to 50 characters.

Description

Use the dhcp relay information format command to specify a padding format for option 82.

Use the undo dhcp relay information format command to restore the default padding format.

The option 82 padding format defaults to normal.

 

&  Note:

l      Using the undo dhcp relay information format command without the keyword verbose node-identifier restores the default normal padding format, or with the keyword verbose node-identifier restores the mac mode of the verbose padding format.

l      If configuring the handling strategy of the DHCP relay agent as replace, you need to configure a padding format of option 82. If the handling strategy is keep or drop, you need not configure any padding format.

 

Example

# Specify the padding format for option 82 as verbose.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp relay information strategy replace

[Sysname-Vlan-interface1] dhcp relay information format verbose

2.1.5  dhcp relay information strategy

Syntax

dhcp relay information strategy { drop | keep | replace }

undo dhcp relay information strategy

View

VLAN interface view

Parameter

drop: Specifies to drop messages containing option 82.

keep: Specifies to forward messages containing option 82 without any change.

replace: Specifies to forward messages containing option 82 after replacing the original option 82 with the option 82 padded in the specified padding format.

Description

Use the dhcp relay information strategy command to configure DHCP relay agent handling strategy for messages containing option 82.

Use the undo dhcp relay information strategy command to restore the default handling strategy.

The handling strategy for messages containing option 82 defaults to replace.

Example

# Configure the DHCP relay agent handling strategy for messages containing option 82 as keep.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp relay information strategy keep

2.1.6  dhcp relay release

Syntax

dhcp relay release client-ip client-mac [ server-ip ]

View

System view/VLAN interface view

Parameter

client-ip: DHCP client IP address.

client-mac: DHCP client MAC address in the format H-H-H.

server-ip: DHCP server IP address.

Description

Use the dhcp relay release command to send a release request to a specified DHCP server or server groups for releasing a specified client IP address.

If the server-ip argument is not specified in system view, the relay agent will send the request to the DHCP server groups corresponding to all interfaces working in DHCP relay agent mode; if the server-ip argument is not specified in interface view, the relay agent will send the request to the DHCP server group corresponding to the current interface.

If the server-ip argument is specified, the relay agent will send the request to the specified DHCP server.

Example

# Send a release request to the DHCP server correlated to VLAN-interface 1 for releasing the IP address 1.1.1.1 that was obtained by the client whose MAC is 000f-e200-0001.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp relay release 1.1.1.1 000f-e200-0001

# Send a release request to all correlated DHCP servers for releasing the IP address 1.1.1.1 that was obtained by the client whose MAC is 000f-e200-0001.

<Sysname> system-view

[Sysname] dhcp relay release 1.1.1.1 000f-e200-0001

2.1.7  dhcp relay security static

Syntax

dhcp relay security static ip-address mac-address

undo dhcp relay security { ip-address | all | dynamic | static }

View

System view

Parameter

ip-address: Specifies a client IP address for creating a static binding.

mac-address: Specifies a client MAC address for creating a static binding, in the format H-H-H.

all: Specifies all IP-to-MAC binding entries.

dynamic: Specifies dynamic IP-to-MAC binding entries.

static: Specifies static IP-to-MAC binding entries.

Description

Use the dhcp relay security static command to configure a static IP-to-MAC binding on the relay agent.

Use the undo dhcp relay security command to remove specified IP-to-MAC binding entries from the relay agent.

No static IP-to-MAC binding is configured on the DHCP relay agent by default.

Related command: display dhcp relay security.

Example

# Configure a static binding between IP address 1.1.1.1 to MAC address 0005-5d02-f2b3.

[Sysname] dhcp relay security static 1.1.1.1 0005-5d02-f2b3

2.1.8  dhcp relay security tracker

Syntax

dhcp relay security tracker { interval | auto }

undo dhcp relay security tracker [ interval ]

View

System view

Parameter

interval: Sets a refreshing interval value a string of 1 to 120 seconds.

auto: Specifies the auto refreshing interval, which is the value of 60 seconds divided by the number of binding entries. Thus, the more entries are, the shorter interval is, but the shortest interval is no less than 500 ms.

Description

Use the dhcp relay security tracker command to set a refreshing interval at which the relay agent contacts the DHCP server for refreshing dynamic bindings.

Use the undo dhcp relay security tracker command to restore the default interval.

The default handshake interval is auto, the value of 60 seconds divided by the number of binding entries.

Example

# Set the handshake interval as 100 seconds.

<Sysname> system-view

[Sysname] dhcp relay security tracker 100

2.1.9  dhcp relay server-detect

Syntax

dhcp relay server-detect

undo dhcp relay server-detect

View

System view

Parameter

None

Description

Use the dhcp relay server-detect command to enable pseudo DHCP server detection on the DHCP relay agent.

Use the undo dhcp relay server-detect command to disable pseudo DHCP server detection.

By default, pseudo DHCP server detection is disabled.

Example

# Enable pseudo DHCP server detection.

<Sysname> system-view

[Sysname] dhcp relay server-detect

2.1.10  dhcp relay server-group

Syntax

dhcp relay server-group group- ip ip-address

undo dhcp relay server-group group-id [ ip ip-address ]

View

System view

Parameter

group-id: Specifies a DHCP server group number, a string of 0 to 19.

ip-address: Specifies a DHCP server IP address.

Description

Use the dhcp relay server-group command to specify a DHCP server for a DHCP server group.

Use the undo dhcp relay server-group command to remove a DHCP server from a DHCP server group, if no ip ip-address is specified, all servers in the DHCP server group and the server group itself will be removed.

By default, no DHCP server is specified for a DHCP server group.

Note that:

l           You can configure up to 20 DHCP server groups on the device, and configure up to eight external DHCP server addresses for each DHCP server group.

l           The IP addresses of DHCP servers in a DHCP server group cannot be on the same network segment with that of the relay agent interface correlated to the server group. Otherwise, clients may fail to obtain IP addresses through this interface.

l           If a server group has been correlated to multiple interfaces, you need to cancel these correlations before you can remove the server group.

Related command: display dhcp relay server-group.

Example

# Specify DHCP server 1.1.1.1 for DHCP server group 1 on the relay agent.

<Sysname> system-view

[Sysname] dhcp relay server-group 1 ip 1.1.1.1

2.1.11  dhcp relay server-select

Syntax

dhcp relay server-select group-id

undo dhcp relay server-select

View

VLAN interface view

Parameter

group-id: Specifies a DHCP group number to be correlated, a string of 0 to 19. The specified group must be an existing group containing at least a DHCP server.

Description

Use the dhcp relay server-select command to correlate specified interface(s) to a specified DHCP server group.

Use the undo dhcp relay server-select command to remove a configured correlation.

By default, no HDCP server group is correlated with an interface on the relay agent.

Note that an interface on the relay agent can only be correlated to one DHCP server group, and a newly configured correlation overwrites the previous one. If the server group in the new correlation does not exist, the new configuration will not work. The interface still maintains the previous correlation.

Example

# Correlate VLAN-interface 1 to DHCP server group 1.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp relay server-select 1

2.1.12  dhcp select relay

Syntax

dhcp select relay

undo dhcp select relay

View

VLAN interface view

Parameter

None

Description

Use the dhcp select relay command to enable the relay agent on the current interface. Upon receiving requests from an enabled interface, the relay agent will forward these requests to DHCP servers for IP address allocation.

Use the undo dhcp select relay command to restore the default on interface(s).

After DHCP is enabled, the DHCP server is enabled on an interface by default. That is, upon receiving a client’s request from the interface, the DHCP server allocates an IP address from the DHCP address pool to the client.

Example

# Enable the DHCP relay agent on VLAN-interface 1.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] dhcp select relay

2.1.13  display dhcp relay

Syntax

display dhcp relay { all | interface interface-type interface-number }

View

Any view

Parameter

all: Specifies all interfaces correlated to which to display information about DHCP server groups.

interface interface-type interface-number: Specifies an interface correlated to which to display information about DHCP server groups.

Description

Use the display dhcp relay command to display information about DHCP server groups correlated to an interface or all interfaces.

Example

# Display information about DHCP server groups correlated to all interfaces.

[Sysname] display dhcp relay all

    Interface name            Server-group

    Vlan-interface2                   2   

Table 2-1 Description on fields of the display dhcp relay all command

Field

Description

Interface name

Interface name

Server-group

DHCP server group number correlated to the interface.

 

2.1.14  display dhcp relay security

Syntax

display dhcp relay security [ ip-address | dynamic | static ]

View

Any view

Parameter

ip-address: Displays the binding information of an IP address.

dynamic: Displays information about dynamic bindings.

static: Displays information about static bindings.

Description

Use the display dhcp relay security command to display information about bindings of DHCP relay agents. If no parameter is specified, information about all bindings will be displayed.

Example

# Display information about all bindings.

[Sysname] display dhcp relay security

IP Address      MAC Address     Type

 10.1.1.1       000f-e20f-0001  Static

 10.1.1.5       000f-e20f-0000  Static

---   2 dhcp-security item(s) found   ---

Table 2-2 Description on fields of the display dhcp relay security command

Field

Description

IP Address

Client IP address

MAC Address

Client MAC address

Type

Type of binding, including dynamic and static

 

2.1.15  display dhcp relay security statistics

Syntax

display dhcp relay security statistics

View

Any view

Parameter

None

Description

Use the display dhcp relay security statistics command to display statistics information about bindings of DHCP relay agents.

Example

# Display statistics about client address binding entries.

<Sysname> display dhcp relay security statistics

Static Items     :0

Dynamic Items        :0

Temporary Items  :0

All Items            :0

Table 2-3 Description on fields of the display dhcp relay security statistics command

Field

Description

Static Items

Static client address binding items

Dynamic Items

Dynamic client address binding items

Temporary Items

Temporary client address binding items

All Items

All client address binding items

 

2.1.16  display dhcp relay security tracker

Syntax

display dhcp relay security tracker

View

Any view

Parameter

None

Description

Use the display dhcp relay security tracker command to display the interval for refreshing dynamic bindings on the relay agent.

Example

# Display the interval for refreshing dynamic bindings on the relay agent.

[Sysname] display dhcp relay security tracker

Current tracker interval: 10s (Specified by user)

The interval is 10 seconds.

2.1.17  display dhcp relay server-group

Syntax

display dhcp relay server-group { group-id | all }

View

Any view

Parameter

group-id: Displays the information of the specified DHCP server group numbered from 0 to 19.

all: Displays the information of all DHCP server groups.

Description

Use the display dhcp relay server-group command to display the configuration information of a specified or all DHCP server groups.

Example

# Display IP addresses of DHCP servers in DHCP server group 1.

<Sysname> display dhcp relay server-group 1

    No.            Group IP

    1              1.1.1.1

    2              1.1.1.2

Table 2-4 Description on fields of the display dhcp relay server-group command

Field

Description

No.

Sequence number

Group IP

IP address in the server group

 

2.1.18  display dhcp relay statistics

Syntax

display dhcp relay statistics [ server-group { group-id | all } ]

View

Any view

Parameter

group-id: Specifies a server group number a string of 0 to 19 about which to display DHCP packet statistics.

all: Specifies all server groups about which to display DHCP packet statistics. Information for each group will be displayed.

Description

Use the display dhcp relay statistics command to display DHCP packet statistics related to a specified or all DHCP server groups.

Note that if no parameter (server-group and all) is specified, all DHCP packet statistics on the relay agent will be displayed.

Example

# Display all DHCP packet statistics on the relay agent.

<Sysname> display dhcp relay statistics

     Bad packets received:                   0

     DHCP packets received from clients: 20

         DHCPDISCOVER packets received:      10

         DHCPREQUEST packets received:       10

         DHCPINFORM packets received:        0

         DHCPRELEASE packets received:       0

         DHCPDECLINE packets received:       0

         BOOTPREQUEST packets:               0

     DHCP packets received from servers: 20

         DHCPOFFER packets received:     10

         DHCPACK packets received:           10

         DHCPNAK packets received:           0

         BOOTPREPLY packets:             0

     DHCP packets sent to servers:           20

     DHCP packets sent to clients:           20

# Display DHCP packet statistics related to every server group on the relay agent.

<Sysname> display dhcp relay statistics server-group all

DHCP relay server-group           #2

     Packet type               Packet number

 Client -> Server:

     DHCPDISCOVER                   5

     DHCPREQUEST                5

     DHCPINFORM                         0

     DHCPRELEASE                    0

     DHCPDECLINE                    0

     BOOTPREQUEST                   0

 Server -> Client:

     DHCPOFFER                      5

     DHCPACK                        5

     DHCPNAK                        0

     BOOTPREPLY                     0

 

DHCP relay server-group           #3

     Packet type               Packet number

 Client -> Server:

     DHCPDISCOVER                   5

     DHCPREQUEST                5

     DHCPINFORM                         0

     DHCPRELEASE                    0

     DHCPDECLINE                    0

     BOOTPREQUEST                   0

 Server -> Client:

     DHCPOFFER                      5

     DHCPACK                        5

     DHCPNAK                        0

     BOOTPREPLY                     0

2.1.19  reset dhcp relay statistics

Syntax

reset dhcp relay statistics [ server-group group-id ]

View

User view

Parameter

server-group group-id: Specifies a server group number a string of 0 to 19 about which to remove statistics from the relay agent.

Description

Use the reset dhcp relay statistics command to remove statistics from the relay agent.

If no server-group is specified, all statistics will be removed from the relay agent.

Related command: display dhcp relay statistics.

Example

# Remove all statistics from the DHCP relay agent.

<Sysname> reset dhcp relay statistics

 


Chapter 3  DHCP Snooping Configuration Commands

 

&  Note:

l      DHCP Snooping does not support link aggregation. If an Ethernet port is added into an aggregation group, DHCP Snooping configuration on it will not take effect. After the port is removed from the group, DHCP Snooping configuration on the port will take effect.

l      The DHCP snooping enabled device does not work if it is between the DHCP relay agent and DHCP server, and it can work when it is between the DHCP client and relay agent or between the DHCP client and server.

l      The DHCP Snooping enabled device cannot be a DHCP server or DHCP relay agent.

l      You are not recommended to enable DHCP/BOOTP client and DHCP Snooping on the same device. Otherwise, DHCP Snooping entries may fail to be generated, and the DHCP/BOOTP client may fail to obtain an IP address.

 

3.1  DHCP Snooping Configuration Commands

3.1.1  dhcp-snooping

Syntax

dhcp-snooping

undo dhcp-snooping

View

System view

Parameter

None

Description

Use the dhcp-snooping command to enable DHCP Snooping.

Use the undo dhcp-snooping command to disable DHCP Snooping.

With DHCP Snooping disabled, the DHCP server responses received on all ports will be forwarded and no IP-to-MAC binding of DHCP client will be recorded.

By default, DHCP snooping is disabled.

Related command: display dhcp-snooping.

Example

# Enable DHCP snooping.

[Sysname] dhcp-snooping

3.1.2  dhcp-snooping trust

Syntax

dhcp-snooping trust

undo dhcp-snooping trust

View

Ethernet port view

Parameter

None

Description

Use the dhcp-snooping trust command to set a port as trusted.

Use the undo dhcp-snooping trust command to restore the default state of a port.

All ports are untrusted by default.

Related command: display dhcp-snooping trust.

Example

# Set port Ethernet 1/0/1 as trusted.

<Sysname> system-view

[Sysname] interface ethernet 1/0/1

[Sysname-Ethernet1/0/1] dhcp-snooping trust

3.1.3  display dhcp-snooping

Syntax

display dhcp-snooping

View

Any view

Parameter

None

Description

Use the display dhcp-snooping command to display the binding information recorded by DHCP Snooping.

Related command: dhcp-snooping.

 

&  Note:

Using the display dhcp-snooping command displays IP-to-MAC bindings that are present in both DHCP-ACK and DHCP-REQUEST messages.

 

Example

# Display DHCP Snooping address binding information.

<Sysname> display dhcp-snooping

DHCP Snooping is enabled.

The client binding table for all untrusted ports.

Type : D--Dynamic , S--Static

Type IP Address      MAC Address        Lease          VLAN    Interface

==== =============== ===============    ========== ==== =================

D     10.1.1.1            000f-e200-0006   286            1  Ethernet1/0/1

---   1 dhcp-snooping item(s) found   ---

Table 3-1 Description on fields of the display dhcp snooping command

Field

Description

Type

Binding type

IP Address

IP address assigned to the DHCP client

MAC Address

MAC address of the DHCP client

Lease

Lease period of the IP address in seconds

VLAN

VLAN to which the port connecting the DHCP client belongs

Interface

Port to which the DHCP client is connected

 

3.1.4  display dhcp-snooping trust

Syntax

display dhcp-snooping trust

View

Any view

Parameter

None

Description

Use the display dhcp-snooping trust command to display information about trusted ports.

Related command: dhcp-snooping trust.

Example

# Display information about trusted ports.

<Sysname> display dhcp-snooping trust

DHCP Snooping is enabled.

DHCP Snooping trust becomes active.

Interface                                       Trusted

=========================                    ============

Ethernet1/0/1                                     Trusted

The above output shows that DHCP Snooping is enabled, DHCP Snooping trust is active, and port Ethernet 1/0/1 is trusted.

 


Chapter 4  DHCP Client Configuration Commands

 

l      The DHCP client configuration is supported only on VLAN interfaces.

l      You are not recommended to enable both DHCP client and DHCP Snooping on the same device. Otherwise, DHCP Snooping entries may fail to be generated, and the DHCP client may fail to obtain an IP address.

 

4.1  DHCP Client Configuration Commands

4.1.1  display dhcp client

Syntax

display dhcp client [ verbose ] [ interface interface-type interface-number ]

View

Any view

Parameter

verbose: Specifies verbose DHCP client information to be displayed.

interface interface-type interface-number: Specifies an interface of which to display DHCP client information.

Description

Use the display dhcp client command to display DHCP client information. If no interface interface-type interface-number is specified, DHCP client information of all interfaces will be displayed.

Example

# Display DHCP client information of all interfaces.

<Sysname> display dhcp client

Vlan-interface1 DHCP client information:

 Current machine state: BOUND

 Allocated IP: 40.1.1.20 255.255.255.0

 Allocated lease: 259200 seconds, T1: 129600 seconds, T2: 226800 seconds

 DHCP server: 40.1.1.2

# Display verbose DHCP client information.

<Sysname> display dhcp client verbose

Vlan-interface1 DHCP client information:

 Current machine state: BOUND

 Allocated IP: 40.1.1.20 255.255.255.0

 Allocated lease: 259200 seconds, T1: 129600 seconds, T2: 226800 seconds

 Lease from 2005.08.13 15:37:59   to   2005.08.16 15:37:59

 DHCP server: 40.1.1.2

 Transaction ID: 0x1c09322d

 Default router: 40.1.1.2

 DNS server: 44.1.1.11

 DNS server: 44.1.1.12

 Domain name: ddd.com

Client ID: 3030-3066-2e65-3234-

             392e-3830-3438-2d56-

             6c61-6e2d-696e-7465-

             7266-6163-6531

T1 will timeout in 1 day 11 hours 58 minutes 52 seconds.

Table 4-1 Description on fields of the display dhcp client command

Field

Description

VLAN-interface 1 DHCP client information

Information of the interface acting as the DHCP client

Current machine state

DHCP client current machine state

Allocated IP

The IP address allocated by the DHCP server

Allocated lease

The allocated lease time

T1

The 1/2 lease time (in seconds) of the DHCP client IP address

T2

The 7/8 lease time (in seconds) of the DHCP client IP address

Lease from….to….

The start and end time of the lease.

DHCP Server

DHCP server IP address that assigned the IP address

Transaction ID

Transaction ID, a random number chosen by the client to identify an IP address allocation.

Default router

The gateway address assigned to the client

DNS server

The DNS server address assigned to the client

Domain name

The domain name assigned to the client

Client ID

Client ID

T1 will timeout in 1 day 11 hours 58 minutes 52 seconds.

How long the T1 (1/2 lease time) timer will timeout.

 

4.1.2  ip address dhcp-alloc

Syntax

ip address dhcp-alloc [ client-identifier mac interface-type interface-number ]

undo ip address dhcp-alloc

View

VLAN interface view

Parameter

client-identifier mac interface-type interface-number: Specifies the MAC address of an interface using which as the client ID to obtain an IP address.

Description

Use the ip address dhcp-alloc command to configure an interface to use DHCP for IP address acquisition.

Use the undo ip address dhcp-alloc command to cancel an interface from using DHCP.

If no parameter is specified, the client uses a character string comprised of the current interface name and MAC address as its ID for address acquisition.

By default, an interface does not use DHCP for IP address acquisition.

Notice that:

The DHCP client sends a DHCP-RELEASE message for releasing the IP address obtained via DHCP, if the interface of the client is down, the message cannot be sent.

Example

# Configure VLAN-interface 1 to use DHCP for IP address acquisition.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] ip address dhcp-alloc

 


Chapter 5  BOOTP Client Configuration Commands

 

&  Note:

l      BOOTP client configuration can only be used on VLAN interfaces.

l      You are not recommended to enable both BOOTP client and DHCP Snooping on the same device. Otherwise, DHCP Snooping entries may fail to be generated, and the BOOTP client may fail to obtain an IP address.

 

5.1  BOOTP Client Configuration Commands

5.1.1  display bootp client

Syntax

display bootp client [ interface interface-type interface-number ]

View

Any view

Parameter

interface-type interface-number: Type and number of an interface.

Description

Use the display bootp client command to display information about BOOTP client, including client MAC and IP addresses.

Note:

l           If interface interface-type interface-number is not specified, the command will display information about BOOTP clients on all interfaces.

l           If interface interface-type interface-number is specified, the command will display information about the BOOTP client on the specified interface.

Example

# Display information about BOOTP client on VLAN-interface 1.

<Sysname> display bootp client interface vlan-interface 1

Vlan-interface1 BOOTP client information:

Allocated IP: 169.254.0.2 255.255.0.0

Transaction ID = 0x3d8a7431

Mac Address  00e0-fc0a-c3ef

Table 5-1 Description on fields of the display bootp client command

Field

Description

VLAN-interface 1 BOOTP client information

Information of the interface serving as a BOOTP client

Allocated IP

BOOTP client’s IP address allocated by the BOOTP server

Transaction ID

Value of the XID field in BOOTP message. This value is a random number generated when the BOOTP client sends BOOTP request to the BOOTP server, and is used to match the response message from the BOOTP server. If the XID field value in a BOOTP response is different from that in the BOOTP request, the BOOTP client will drop the BOOTP response.

Mac Address

MAC address of the BOOTP client

 

5.1.2  ip address bootp-alloc

Syntax

ip address bootp-alloc

undo ip address bootp-alloc

View

VLAN interface view

Parameter

None

Description

Use the ip address bootp-alloc command to enable the interface to obtain IP address through BOOTP.

Use the undo ip address bootp-alloc command to disable the interface from obtaining IP address through BOOTP.

By default, an interface cannot not obtain IP address through BOOTP.

Related command: display bootp client.

Example

# Enable VLAN-interface 1 to obtain IP address through BOOTP protocol.

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] ip address bootp-alloc

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网