- Table of Contents
-
- H3C S3610[S5510] Series Ethernet Switches Command Manual-Release 0001-(V1.02)
- 00-1Cover
- 01-Login Command
- 02-VLAN Command
- 03-IP Address and Performance Command
- 04-QinQ-BPDU Tunnel Command
- 05-Port Correlation Configuration Command
- 06-MAC Address Table Management Command
- 07-MAC-IP-Port Binding Command
- 08-MSTP Command
- 09-Routing Overview Command
- 10-IPv4 Routing Command
- 11-IPv6 Routing Command
- 12-IPv6 Configuration Command
- 13-Multicast Protocol Command
- 14-802.1x-HABP-MAC Authentication Command
- 15-AAA-RADIUS-HWTACACS Command
- 16-ARP Command
- 17-DHCP Command
- 18-ACL Command
- 19-QoS Command
- 20-Port Mirroring Command
- 21-Cluster Management Command
- 22-UDP Helper Command
- 23-SNMP-RMON Command
- 24-NTP Command
- 25-DNS Command
- 26-File System Management Command
- 27-Information Center Command
- 28-System Maintenance and Debugging Command
- 29-NQA Command
- 30-VRRP Command
- 31-SSH Command
- 32-Appendix
- Related Documents
-
Title | Size | Download |
---|---|---|
17-DHCP Command | 278 KB |
Table of Contents
Chapter 1 DHCP Server Configuration Commands
1.1 DHCP Server Configuration Commands
1.1.4 dhcp select server global-pool
1.1.6 dhcp server forbidden-ip
1.1.8 dhcp server ping packets
1.1.9 dhcp server ping timeout
1.1.10 dhcp server relay information enable
1.1.11 display dhcp server conflict
1.1.12 display dhcp server expired
1.1.13 display dhcp server free-ip
1.1.14 display dhcp server ip-in-use
1.1.15 display dhcp server statistics
1.1.16 display dhcp server tree
1.1.25 reset dhcp server conflict
1.1.26 reset dhcp server ip-in-use
1.1.27 reset dhcp server statistics
1.1.28 static-bind client-identifier
1.1.30 static-bind mac-address
1.1.31 tftp-server domain-name
Chapter 2 DHCP Relay Agent Configuration Commands
2.1 DHCP Relay Agent Configuration Commands
2.1.2 dhcp relay address-check
2.1.3 dhcp relay information enable
2.1.4 dhcp relay information format
2.1.5 dhcp relay information strategy
2.1.7 dhcp relay security static
2.1.8 dhcp relay security tracker
2.1.9 dhcp relay server-detect
2.1.10 dhcp relay server-group
2.1.11 dhcp relay server-select
2.1.14 display dhcp relay security
2.1.15 display dhcp relay security statistics
2.1.16 display dhcp relay security tracker
2.1.17 display dhcp relay server-group
2.1.18 display dhcp relay statistics
2.1.19 reset dhcp relay statistics
Chapter 3 DHCP Snooping Configuration Commands
3.1 DHCP Snooping Configuration Commands
3.1.4 display dhcp-snooping trust
Chapter 4 DHCP Client Configuration Commands
4.1 DHCP Client Configuration Commands
Chapter 5 BOOTP Client Configuration Commands
5.1 BOOTP Client Configuration Commands
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
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
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