- Table of Contents
-
- 05-Layer 3 - IP Services Command Reference
- 00-Preface
- 01-ARP commands
- 02-IP addressing commands
- 03-DHCP commands
- 04-DNS commands
- 05-IP forwarding basics commands
- 06-Adjacency table commands
- 07-IP performance optimization commands
- 08-UDP helper commands
- 09-IPv6 basics commands
- 10-DHCPv6 commands
- 11-IPv6 fast forwarding commands
- 12-Fast forwarding commands
- 13-Tunnel commands
- 14-GRE commands
- Related Documents
-
Title | Size | Download |
---|---|---|
10-DHCPv6 commands | 186.47 KB |
display ipv6 dhcp server conflict
display ipv6 dhcp server expired
display ipv6 dhcp server ip-in-use
display ipv6 dhcp server pd-in-use
display ipv6 dhcp server statistics
ipv6 dhcp server forbidden-address
ipv6 dhcp server forbidden-prefix
reset ipv6 dhcp server conflict
reset ipv6 dhcp server expired
reset ipv6 dhcp server ip-in-use
reset ipv6 dhcp server pd-in-use
reset ipv6 dhcp server statistics
display ipv6 dhcp relay server-address
display ipv6 dhcp relay statistics
ipv6 dhcp relay server-address
reset ipv6 dhcp relay statistics
ipv6 dhcp select
Use ipv6 dhcp select to enable the DHCPv6 server or DHCPv6 relay agent on an interface.
Use undo ipv6 dhcp select to restore the default.
Syntax
ipv6 dhcp select { relay | server }
undo ipv6 dhcp select
Default
An interface discards DHCPv6 packets from DHCPv6 clients.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
relay: Enables the DHCPv6 relay agent on the interface.
server: Enables the DHCPv6 server on the interface.
Usage guidelines
Before changing the DHCPv6 server mode to the DHCPv6 relay agent mode on an interface, use the reset ipv6 dhcp server ip-in-use and reset ipv6 dhcp server pd-in-use commands to remove IPv6 address/prefix bindings.
An interface cannot serve as the DHCPv6 relay agent and the DHCPv6 server at the same time. Do not enable the DHCPv6 relay agent, the DHCPv6 server, and the DHCPv6 client on the same interface.
Examples
# Enable the DHCPv6 server on VLAN-interface 10.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] ipv6 dhcp select server
# Enable the DHCPv6 relay agent on VLAN-interface 20.
<Sysname> system-view
[Sysname] interface vlan-interface 20
[Sysname-Vlan-interface20] ipv6 dhcp select relay
Related commands
· display ipv6 dhcp relay server-address
· display ipv6 dhcp server
display ipv6 dhcp duid
Use display ipv6 dhcp duid to display the DUID of the local device.
Syntax
display ipv6 dhcp duid
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Usage guidelines
A DHCP unique identifier (DUID) uniquely identifies a DHCPv6 device (DHCPv6 client, server, or relay agent). A DHCPv6 device adds its DUID in a sent packet.
Examples
# Display the DUID of the local device.
<Sysname> display ipv6 dhcp duid
The DUID of this device: 0003-0001-00e0-fc00-5552.
address range
Use address range to specify a non-temporary IPv6 address range in a DHCPv6 address pool for dynamic allocation.
Use undo address range to remove the non-temporary IPv6 address range in the address pool.
Syntax
address range start-ipv6-address end-ipv6-address [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]
undo address range
Default
No non-temporary IPv6 address range is configured.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
start-ipv6-address: Specifies the start IPv6 address.
end-ipv6-address: Specifies the end IPv6 address.
preferred-lifetime preferred-lifetime: Specifies the preferred lifetime for the non-temporary IPv6 addresses. The value ranges from 60 to 4294967295 seconds and defaults to 604800 seconds (seven days).
valid-lifetime valid-lifetime: Specifies the valid lifetime for the non-temporary IPv6 addresses. The value ranges from 60 to 4294967295 seconds and defaults to 2592000 seconds (30 days). The valid lifetime cannot be shorter than the preferred lifetime.
Usage guidelines
When no non-temporary IPv6 address range is specified, all unicast addresses on the subnet specified by the network command in address pool view are assignable. If a non-temporary IPv6 address range is specified, only the IPv6 addresses in the IPv6 address range are assignable.
You can specify only one non-temporary IPv6 address range in an address pool. If you use the address range command multiple times, the most recent configuration takes effect.
The non-temporary IPv6 address range specified by the address range command must be on the subnet specified by the network command.
Examples
# Configure a non-temporary IPv6 address range from 3ffe:501:ffff:100::10 through 3ffe:501:ffff:100::31 in address pool 1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] network 3ffe:501:ffff:100::/64
[Sysname-dhcp6-pool-1] address range 3ffe:501:ffff:100::10 3ffe:501:ffff:100::31
Related commands
· display ipv6 dhcp pool
· network
· temporary address range
display ipv6 dhcp pool
Use display ipv6 dhcp pool to display information about a DHCPv6 address pool.
Syntax
display ipv6 dhcp pool [ pool-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
pool-name: Displays information about the specified DHCPv6 address pool. The pool name is a case-insensitive string of 1 to 63 characters. If you do not specify any pool name, the command displays information about all DHCPv6 address pools.
Examples
# Display information about DHCPv6 address pool 1.
<Sysname> display ipv6 dhcp pool 1
DHCPv6 pool: 1
Network: 3FFE:501:FFFF:100::/64
Preferred lifetime 604800, valid lifetime 2592000
Prefix pool: 1
Preferred lifetime 24000, valid lifetime 36000
Addresses:
Range: from 3FFE:501:FFFF:100::1
to 3FFE:501:FFFF:100::99
Preferred lifetime 70480, valid lifetime 200000
Total address number: 153
Available: 153
In-use: 0
Temporary addresses:
Range: from 3FFE:501:FFFF:100::200
to 3FFE:501:FFFF:100::210
Preferred lifetime 60480, valid lifetime 259200
Total address number: 17
Available: 17
In-use: 0
Static bindings:
DUID: 0003000100e0fc000001
IAID: 0000003f
Prefix: 3FFE:501:FFFF:200::/64
Preferred lifetime 604800, valid lifetime 2592000
DUID: 0003000100e0fc00cff1
IAID: 00000001
Address: 3FFE:501:FFFF:2001::1/64
Preferred lifetime 604800, valid lifetime 2592000
DNS server addresses:
2::2
Domain name:
aaa.com
SIP server addresses:
5::1
SIP server domain names:
bbb.com
Table 1 Command output
Field |
Description |
DHCPv6 pool |
Name of the DHCPv6 address pool. |
Network |
IPv6 subnet for dynamic IPv6 address allocation. |
Prefix pool |
Prefix pool referenced by the address pool. |
Preferred lifetime |
Preferred lifetime in seconds. |
valid lifetime |
Valid lifetime in seconds. |
Addresses |
Non-temporary IPv6 address range. |
Range |
IPv6 address range for dynamic allocation. |
Total address number |
Total number of IPv6 addresses. |
Available |
Total number of available IPv6 addresses. |
In-use |
Total number of assigned IPv6 addresses. |
Temporary addresses |
Temporary IPv6 address range for dynamic allocation. |
Static bindings |
Static bindings configured in the address pool. |
DUID |
Client DUID. |
IAID |
Client IAID. If no IAID is configured, this field displays Not configured. |
Prefix |
IPv6 address prefix. |
Address |
Static IPv6 address. |
DNS server addresses |
DNS server address. |
Domain name |
Domain name. |
SIP server addresses |
SIP server address. |
SIP server domain names |
Domain name of the SIP server. |
display ipv6 dhcp prefix-pool
Use display ipv6 dhcp prefix-pool to display information about a prefix pool.
Syntax
display ipv6 dhcp prefix-pool [ prefix-pool-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
prefix-pool-number: Displays detailed information about a prefix pool specified by its number in the range of 1 to 128. If you do not specify any prefix pool, the command displays brief information about all prefix pools.
Examples
# Display brief information about all prefix pools.
<Sysname> display ipv6 dhcp prefix-pool
Prefix-pool Prefix Available In-use Static
1 5::/64 64 0 0
# Display detailed information about prefix pool 1.
<Sysname> display ipv6 dhcp prefix-pool 1
Prefix: 5::/64
Assigned length: 70
Total prefix number: 64
Available: 64
In-use: 0
Static: 0
Table 2 Command output
Field |
Description |
Prefix-pool |
Prefix pool number. |
Prefix |
Prefix specified in the prefix pool. |
Available |
Number of available prefixes. |
In-use |
Number of assigned prefixes. |
Static |
Number of statically bound prefixes. |
Assigned length |
Length of assigned prefixes. |
Total prefix number |
Number of prefixes. |
display ipv6 dhcp server
Use display ipv6 dhcp server to display DHCPv6 server configuration information.
Syntax
display ipv6 dhcp server [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface interface-type interface-number: Displays DHCPv6 server configuration information on the specified interface. If you do not specify any interface, the command displays DHCPv6 server configuration information on all interfaces.
Examples
# Display DHCPv6 server configuration information on all interfaces.
<Sysname> display ipv6 dhcp server
Interface Pool
Vlan-interface2 1
Vlan-interface3 global
# Display DHCPv6 server configuration information on the interface VLAN-interface 2.
<Sysname> display ipv6 dhcp server interface vlan-interface 2
Using pool: 1
Preference value: 0
Allow-hint: Enabled
Rapid-commit: Disabled
Table 3 Command output
Field |
Description |
Interface |
Interface enabled with DHCPv6 server. |
Pool |
Address pool applied to the interface. If no address pool is applied to the interface, global is displayed. The DHCPv6 server selects a global address pool to assign a prefix, an address, and other configuration parameters to a client. |
Using pool |
Address pool applied to the interface. If no address pool is applied to the interface, global is displayed. The DHCPv6 server selects a global address pool to assign a prefix, an address, and other configuration parameters to a client. |
Preference value |
Server preference in the DHCPv6 Advertise message. The value ranges from 0 to 255. The bigger the value is, the higher preference the server has. |
Allow-hint |
Indicates whether desired address/prefix assignment is enabled. |
Rapid-commit |
Indicates whether rapid address/prefix assignment is enabled. |
display ipv6 dhcp server conflict
Use display ipv6 dhcp server conflict to display information about IPv6 address conflicts.
Syntax
display ipv6 dhcp server conflict [ address ipv6-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
address ipv6-address: Displays conflict information for the specified IPv6 address. If you do not specify any IPv6 address, this command displays information about all IPv6 address conflicts.
Usage guidelines
The DHCPv6 server creates IP address conflict information in the following conditions:
· The DHCPv6 client sends a DECLINE packet to the DHCPv6 server to inform the server of an IPv6 address conflict.
· The DHCPv6 server discovers that the only assignable address in the address pool is its own IPv6 address.
Examples
# Display information about all address conflicts.
<Sysname> display ipv6 dhcp server conflict
IPv6 address Detect time
2001::1 Apr 25 16:57:20 2007
1::1:2 Apr 25 17:00:10 2007
Table 4 Command output
Field |
Description |
IPv6 address |
Conflicted IPv6 address. |
Detect time |
Time when the conflict was discovered. |
Related commands
reset ipv6 dhcp server conflict
display ipv6 dhcp server expired
Use display ipv6 dhcp server expired to display lease expiration information.
Syntax
display ipv6 dhcp server expired [ address ipv6-address | pool pool-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
address ipv6-address: Displays lease expiration information for the specified IPv6 address.
pool pool-name: Displays lease expiration information for the address pool specified by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
If you do not specify any parameter, the command displays lease expiration information for all IPv6 address pools.
DHCPv6 assigns the expired IPv6 addresses to DHCPv6 clients when all available addresses have been assigned.
Examples
# Display all lease expiration information.
<Sysname> display ipv6 dhcp server expired
IPv6 address DUID Lease expiration
2001:3eff:fe80:4caa: 3030-3066-2e65-3230-302e- Apr 25 17:10:47 2007
37ee:7:1 3130-3234-2d45-7468-6572-
6e65-7430-2f31
Table 5 Command output
Field |
Description |
IPv6 address |
Expired IPv6 address. |
DUID |
Client DUID bound to the expired IPv6 address. |
Lease expiration |
Time when the lease expired. |
Related commands
reset ipv6 dhcp server expired
display ipv6 dhcp server ip-in-use
Use display ipv6 dhcp server ip-in-use to display binding information for assigned IPv6 addresses.
Syntax
display ipv6 dhcp server ip-in-use [ address ipv6-address | pool pool-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
address ipv6-address: Displays binding information for the specified IPv6 address.
pool pool-name: Displays binding information for the IPv6 address pool specified by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
If you do not specify any parameter, the command displays binding information for all assigned IPv6 addresses.
Examples
# Display binding information for all assigned IPv6 address.
<Sysname> display ipv6 dhcp server ip-in-use
Pool: 1
IPv6 address Type Lease expiration
2:1::1 Auto(O) Jul 10 19:45:01 2008
Pool: 2
IPv6 address Type Lease expiration
1:1::2 Static(F) Not available
Pool: 3
IPv6 address Type Lease expiration
1:2::1f1 Static(O) Oct 9 09:23:31 2008
# Display binding information about all assigned IPv6 addresses for the specified DHCPv6 address pool.
<Sysname> display ipv6 dhcp server ip-in-use pool 1
Pool: 1
IPv6 address Type Lease expiration
2:1::1 Auto(O) Jul 10 22:22:22 2008
3:1::2 Static(C) Jan 1 11:11:11 2008
# Display binding information for the specified IPv6 address.
<Sysname> display ipv6 dhcp server ip-in-use address 2:1::3
Pool: 1
Client: FE80::C800:CFF0:FE18:0
Type: Auto(O)
DUID: 00030001CA000C180000
IAID: 0x00030001
IPv6 address: 2:1::3
Preferred lifetime 400, valid lifetime 500
Expires at Jul 10 09:45:01 2008 (288 seconds left)
Table 6 Command output
Field |
Description |
Pool |
DHCPv6 address pool. |
IPv6 address |
IPv6 address assigned. |
Type |
IPv6 address binding types: · Static(F)—Free static binding whose IPv6 address has not been assigned. · Static(O)—Offered static binding whose IPv6 address has been selected and sent by the DHCPv6 server in a DHCP-OFFER packet to the client. · Static(C)—Committed static binding whose IPv6 address has been assigned to the client. · Auto(O)—Offered dynamic binding whose IPv6 address has been dynamically selected by the DHCPv6 server and sent in a DHCP-OFFER packet to the DHCPv6 client. · Auto(C)—Committed dynamic binding, whose IP address has been dynamically assigned to the DHCPv6 client. |
Lease-expiration |
Time when the lease of the IPv6 address will expire. If the lease expires after the year 2100, this field displays Expires after 2100. For an unassigned static binding, this field displays Not available. |
Client |
IPv6 address of the DHCPv6 client. For an unassigned static binding, this field is blank. |
DUID |
Client DUID. |
IAID |
Client IAID. For an unassigned static binding without IAID specified, this field displays N/A. |
Preferred lifetime |
Preferred lifetime in seconds of the IPv6 address. |
valid lifetime |
Valid lifetime in seconds of the IPv6 address. |
Expires at |
Time when the lease of an IPv6 address will expire. If the lease expires after the year 2100, this field displays Expires after 2100. |
Related commands
reset ipv6 dhcp server ip-in-use
display ipv6 dhcp server pd-in-use
Use display ipv6 dhcp server pd-in-use to display binding information for the assigned IPv6 prefixes.
Syntax
display ipv6 dhcp server pd-in-use [ pool pool-name | prefix prefix/prefix-len ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
pool pool-name: Displays IPv6 prefix binding information for the DHCPv6 address pool specified by its name, a case-insensitive string of 1 to 63 characters.
prefix prefix/prefix-len: Displays binding information for the specified IPv6 prefix. The value for the prefix length ranges from 1 to 128.
Usage guidelines
If you do not specify any parameter, the command displays all IPv6 prefix binding information.
Examples
# Display all IPv6 prefix binding information.
<Sysname> display ipv6 dhcp server pd-in-use
Pool: 1
IPv6 prefix Type Lease expiration
2:1::/24 Auto(O) Jul 10 19:45:01 2008
Pool: 2
IPv6 prefix Type Lease expiration
1:1::/64 Static(F) Not available
Pool: 3
IPv6 prefix Type Lease expiration
1:2::/64 Static(O) Oct 9 09:23:31 2008
# Display IPv6 prefix binding information for DHCPv6 address pool 1.
<Sysname> display ipv6 dhcp server pd-in-use pool 1
Pool: 1
IPv6 prefix Type Lease expiration
2:1::/24 Auto(O) Jul 10 22:22:22 2008
3:1::/64 Static(C) Jan 1 11:11:11 2008
# Display binding information for the IPv6 prefix 2:1::3/24.
<Sysname> display ipv6 dhcp server pd-in-use prefix 2:1::3/24
Pool: 1
Client: FE80::C800:CFF:FE18:0
Type: Auto(O)
DUID: 00030001CA000C180000
IAID: 0x00030001
IPv6 prefix: 2:1::/24
Preferred lifetime 400, valid lifetime 500
Expires at Jul 10 09:45:01 2008 (288 seconds left)
Table 7 Command output
Field |
Description |
IPv6 prefix |
IPv6 prefix assigned. |
Type |
Prefix binding types: · Static(F)—Free static binding whose IPv6 prefix has not been assigned. · Static(O)—Offered static binding whose IPv6 prefix has been selected and sent by the DHCPv6 server in a DHCP-OFFER packet to the client. · Static(C)—Committed static binding whose IPv6 prefix has been assigned to the client. · Auto(O)—Offered dynamic binding whose IPv6 prefix has been dynamically selected by the DHCPv6 server and sent in a DHCP-OFFER packet to the DHCPv6 client. · Auto(C)—Committed dynamic binding whose IPv6 prefix has been dynamically selected by the DHCPv6 server and sent in a DHCP-OFFER packet to the DHCPv6 client. |
Pool |
Address pool. |
Lease-expiration |
Time when the lease of the IPv6 prefix will expire. If the lease will expire after the year 2100, this field displays Expires after 2100. For an unassigned static binding, this field displays Not available. |
Client |
IPv6 address of the DHCPv6 client. For an unassigned static binding, this field is blank. |
DUID |
Client DUID. |
IAID |
Client IAID. For an unassigned static binding without IAID, this field displays N/A. |
Preferred lifetime |
Preferred lifetime in seconds of the IPv6 prefix. |
valid lifetime |
Valid lifetime in seconds of the IPv6 prefix. |
Expires at |
Time when the lease of the prefix will expire.If the lease expires after the year 2100, this field displays Expires after 2100. |
Related commands
reset ipv6 dhcp server pd-in-use
display ipv6 dhcp server statistics
Use display ipv6 dhcp server statistics to display DHCPv6 packet statistics on the DHCPv6 server.
Syntax
display ipv6 dhcp server statistics [ pool pool-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
pool pool-name: Displays DHCPv6 packet statistics for the DHCPv6 address pool specified by its name, a case-insensitive string of 1 to 63 characters. If you do not specify any pool, the command displays DHCPv6 packet statistics for all address pools.
Examples
# Display all DHCPv6 packet statistics on the DHCPv6 server.
<Sysname> display ipv6 dhcp server statistics
Bindings:
Ip-in-use : 1
Pd-in-use : 0
Expired : 0
Conflict : 0
Packets received : 1
Solicit : 1
Request : 0
Confirm : 0
Renew : 0
Rebind : 0
Release : 0
Decline : 0
Information-request : 0
Relay-forward : 0
Packets dropped : 0
Packets sent : 0
Advertise : 0
Reconfigure : 0
Reply : 0
Relay-reply : 0
Table 8 Command output
Field |
Description |
Bindings |
Number of bindings: · Ip-in-use—Total number of address bindings. · Pd-in-use—Total number of prefix bindings. · Expired—Total number of expired address bindings. |
Conflict |
Total number of conflicted addresses. If statistics about a specific address pool are displayed, this field is not displayed. |
Packets received |
Number of messages received by the DHCPv6 server. The message types include: · Solicit. · Request. · Confirm. · Renew. · Rebind. · Release. · Decline. · Information-request. · Relay-forward. If statistics about a specific address pool are displayed, this field is not displayed. |
Packets dropped |
Number of packets discarded. If statistics about a specific address pool are displayed, this field is not displayed. |
Packets sent |
Number of messages sent by the DHCPv6 server. The message types include: · Advertise. · Reconfigure. · Reply. · Relay-reply. If statistics about a specific address pool are displayed, this field is not displayed. |
Related commands
reset ipv6 dhcp server statistics
dns-server
Use dns-server to specify a DNS server in a DHCPv6 address pool.
Use undo dns-server to remove the specified DNS server from a DHCPv6 address pool.
Syntax
dns-server ipv6-address
undo dns-server ipv6-address
Default
No DNS server address is specified.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
ipv6-address: Specifies the IPv6 address of a DNS server.
Usage guidelines
You can use the dns-server command to specify up to eight DNS servers in an address pool. A DNS server specified earlier has a higher preference.
Examples
# Specify the DNS server address 2:2::3 in DHCPv6 address pool 1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] dns-server 2:2::3
Related commands
display ipv6 dhcp pool
domain-name
Use domain-name to specify a domain name suffix in a DHCPv6 address pool.
Use undo domain-name to remove the domain name suffix.
Syntax
domain-name domain-name
undo domain-name
Default
No domain name suffix is specified.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
domain-name: Specifies a domain name suffix, a case-insensitive string of 1 to 50 characters.
Usage guidelines
You can configure only one domain name suffix in an address pool.
If you use the domain-name command multiple times, the most recent configuration takes effect.
Examples
# Specify the domain name aaa.com in DHCPv6 address pool 1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] domain-name aaa.com
Related commands
display ipv6 dhcp pool
ipv6 dhcp pool
Use ipv6 dhcp pool to create a DHCPv6 address pool and enter its view. If the pool has been created, you directly enter its view.
Use undo ipv6 dhcp pool to remove the specified DHCPv6 address pool.
Syntax
ipv6 dhcp pool pool-name
undo ipv6 dhcp pool pool-name
Default
No DHCPv6 address pool is configured.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
pool-name: Specifies a name for the DHCPv6 address pool, a case-insensitive string of 1 to 63 characters.
Usage guidelines
A DHCPv6 address pool stores IPv6 address/prefix and other configuration parameters to be assigned to DHCPv6 clients.
When you remove a DHCPv6 address pool, the binding information for the assigned IPv6 addresses and prefixes in the address pool is also removed.
Examples
# Create a DHCPv6 address pool named pool1 and enter its view.
<Sysname> system-view
[Sysname] ipv6 dhcp pool pool1
Related commands
· display ipv6 dhcp pool
· ipv6 dhcp server apply pool
ipv6 dhcp prefix-pool
Use ipv6 dhcp prefix-pool to create a prefix pool, specify the prefix/prefix length for the pool, and specify the assigned prefix length.
Use undo ipv6 dhcp prefix-pool to remove the specified prefix pool.
Syntax
ipv6 dhcp prefix-pool prefix-pool-number prefix prefix/prefix-len assign-len assign-len
undo ipv6 prefix-pool prefix-pool-number
Default
No prefix pool is configured.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
prefix-pool-number: Specifies a prefix pool number in the range of 1 to 128.
prefix prefix/prefix-len: Specifies a prefix/prefix length for the pool. The value for the prefix-len argument ranges from 1 to 128.
assign-len assign-len: Specifies the assigned prefix length. The value ranges from 1 to 128, and must be greater than or equal to prefix-len. The difference between assign-len and prefix-len must be greater than 16.
Usage guidelines
Different prefix pools cannot overlap.
You cannot modify an existing prefix pool. To change the prefix pool settings, you must delete the prefix pool first.
Removing a prefix pool clears all prefix bindings from the prefix pool.
Examples
# Create prefix pool named 1, and specify the prefix 2001:0410::/32 with assigned prefix length being 42. Prefix pool 1 contains 1024 prefixes from 2001:0410::/42 to 2001:0410:FFC0::/42.
<Sysname> system-view
[Sysname] ipv6 dhcp prefix-pool 1 prefix 2001:0410::/32 assign-len 42
Related commands
· display ipv6 dhcp prefix-pool
· prefix-pool
ipv6 dhcp server
Use ipv6 dhcp server to configure global address assignment on an interface. The server on the interface uses a global address pool to assign configuration information to a client.
Use undo ipv6 dhcp server to restore the default.
Syntax
ipv6 dhcp server { allow-hint | preference preference-value | rapid-commit } *
undo ipv6 dhcp server
Default
The server does not support desired address/prefix assignment or rapid address/prefix assignment. The server preference is set to 0.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
allow-hint: Enables desired address/prefix assignment.
preference preference-value: Specifies the server preference in Advertise messages, in the range of 0 to 255. The default value is 0. A greater value specifies a higher preference.
rapid-commit: Enables rapid address/prefix assignment involving two messages.
Usage guidelines
The allow-hint keyword enables the server to assign the desired address or prefix to the requesting client. If the desired address or prefix is not included in any global address pool or any prefix pool, or is already assigned to another client, the server assigns the client a free address or a prefix. If the allow-hint keyword is not specified, the server ignores the desired address or prefix, and selects an address or prefix from a global address pool.
If you use the ipv6 dhcp server and ipv6 dhcp server apply pool commands on the same interface, the ipv6 dhcp server apply pool command takes effect.
Examples
# Configure global address assignment on the interface VLAN-interface 2 to support desired address/prefix assignment and rapid address/prefix assignment and set the server preference to the highest 255.
<Sysname> system-view
[Sysname] interface vlan-interface 2
[Sysname-Vlan-interface2] ipv6 dhcp server allow-hint preference 255 rapid-commit
Related commands
· display ipv6 dhcp server
· ipv6 dhcp select
ipv6 dhcp server apply pool
Use ipv6 dhcp server apply pool to apply a DHCPv6 address pool to an interface.
Use undo ipv6 dhcp server apply pool to remove the DHCPv6 address pool from the interface.
Syntax
ipv6 dhcp server apply pool pool-name [ allow-hint | preference preference-value | rapid-commit ] *
undo ipv6 dhcp server apply pool
Default
No address pool is applied to an interface.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
pool-name: Specifies a DHCPv6 address pool by its name, a case-insensitive string of 1 to 63 characters.
allow-hint: Enables desired address/prefix assignment.
preference preference-value: Specifies the server preference in Advertise messages, in the range of 0 to 255. The default value is 0. A greater value specifies a higher preference.
rapid-commit: Enables rapid address/prefix assignment involving two messages.
Usage guidelines
Upon receiving a DHCPv6 request, the DHCPv6 server selects an IPv6 address or prefix from the address pool applied to the receiving interface. If no address pool is applied, the server selects an IPv6 address or prefix from a global address pool that matches the IPv6 address of the receiving interface or the DHCPv6 relay agent.
The allow-hint keyword enables the server to assign the desired address or prefix to the client. If the desired address or prefix does not exist or is already assigned to another client, the server assigns a free address or prefix. If allow-hint is not specified, the server ignores the desired address or prefix, and assigns a free address or prefix.
Only one address pool can be applied to an interface. If you use the command multiple times, the most recent configuration takes effect.
A non-existing address pool can be applied to an interface, but the server cannot assign any prefix, address, or other configuration information from the address pool until the address pool is created.
Examples
# Apply address pool 1 to VLAN-interface 2, configure the address pool to support desired address/prefix assignment and address/prefix rapid assignment, and set the preference to 255.
<Sysname> system-view
[Sysname] interface vlan-interface 2
[Sysname-Vlan-interface2] ipv6 dhcp server apply pool 1 allow-hint preference 255 rapid-commit
Related commands
· display ipv6 dhcp server
· ipv6 dhcp pool
· ipv6 dhcp select
ipv6 dhcp server forbidden-address
Use ipv6 dhcp server forbidden-address to exclude specifiec IPv6 addresses from dynamic allocation.
Use undo ipv6 dhcp server forbidden-address to remove the configuration.
Syntax
ipv6 dhcp server forbidden-address start-ipv6-address [ end-ipv6-address ]
undo ipv6 dhcp server forbidden-address start-ipv6-address [ end-ipv6-address ]
Default
Except for the DHCPv6 server address, all IPv6 addresses in a DHCPv6 address pool are assignable.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
start-ipv6-address: Specifies the start IPv6 address.
end-ipv6-address: Specifies the end IPv6 address, which cannot be lower than start-ipv6-address. If no end IPv6 address is specified, only the start IPv6 address is excluded from dynamic allocation. If it is specified, the IP addresses from start-ipv6-address through end-ipv6-address are all excluded from dynamic allocation.
Usage guidelines
You can exclude multiple IP address ranges from dynamic allocation.
The IPv6 addresses of some devices such as the gateway and FTP server cannot be assigned to clients. Use this command to exclude such addresses from dynamic allocation.
If the excluded IPv6 address is in a static binding, the address can still be assigned to the client.
The address or address range specified in the undo form of the command must be the same as the address or address range specified in the command. To remove an IP address that has been specified as part of an address range, you must remove the entire address range.
Examples
# Exclude IPv6 addresses of 2001:10:110::1 through 2001:10:110::20 from dynamic assignment.
<Sysname> system-view
[Sysname] ipv6 dhcp server forbidden-address 2001:10:110::1 2001:10:110::20
Related commands
· ipv6 dhcp server forbidden-prefix
· static-bind
ipv6 dhcp server forbidden-prefix
Use ipv6 dhcp server forbidden-prefix to exclude specific IPv6 prefixes from dynamic allocation.
Use undo ipv6 dhcp server forbidden-prefix to remove the configuration.
Syntax
ipv6 dhcp server forbidden-prefix start-prefix/prefix-len [ end-prefix/prefix-len ]
undo ipv6 dhcp server forbidden-prefix start-prefix/prefix-len [ end-prefix/prefix-len ]
Default
No IPv6 prefixes in the DHCPv6 prefix pool are excluded from dynamic allocation.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
start-prefix/prefix-len: Specifies the start IPv6 prefix. The prefix-len argument specifies the prefix length, ranging from 1 to 128.
end-prefix/prefix-len: Specifies the end IPv6 prefix. The prefix-len argument specifies the prefix length, ranging from 1 to 128. The value for end-prefix cannot be lower than that for start-prefix. If this argument is not specified, only the start-prefix/prefix-len is excluded from dynamic allocation. If it is specified, the prefixes from start-prefix/prefix-len to end-prefix/prefix-len are all excluded.
Usage guidelines
You can exclude multiple IPv6 prefix ranges from dynamic allocation.
If the excluded IPv6 prefix is in a static binding, the prefix can still be assigned to the client.
The prefix or prefix range specified in the undo form of the command must be the same as the prefix or prefix range specified in the command. To remove a prefix that has been specified as part of a prefix range, you must remove the entire prefix range.
Examples
# Exclude IPv6 prefixes from 2001:3e11::/32 through 2001:3eff::/32 from dynamic allocation.
<Sysname> system-view
[Sysname] ipv6 dhcp server forbidden-prefix 2001:3e11::/32 2001:3eff::/32
Related commands
· ipv6 dhcp server forbidden-address
· static-bind
network
Use network to specify an IPv6 subnet for dynamic allocation in a DHCPv6 address pool.
Use undo network to remove the specified IPv6 subnet.
Syntax
network prefix/prefix-length [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]
undo network
Default
No IPv6 subnet is specified in an address pool.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
prefix/prefix-length: Specifies the IPv6 subnet for dynamic allocation. The value for prefix-length ranges from 1 to 128.
preferred-lifetime preferred-lifetime: Specifies the preferred lifetime. The value ranges from 60 to 4294967295 seconds and defaults to 604800 seconds (seven days).
valid-lifetime valid-lifetime: Specifies the valid lifetime. The value ranges from 60 to 4294967295 seconds and defaults to 2592000 seconds (30 days). The valid lifetime must be longer than or equal to the preferred lifetime.
Usage guidelines
You can specify only one subnet for a DHCPv6 address pool. If you use the network command multiple times, the most recent configuration takes effect.
You cannot modify or remove the network configuration after using the address range temporary and address range commands.
Modifying or removing the network configuration removes the addresses in the current address pool.
Examples
# Specify the subnet 3ffe:501:ffff:100::/64 in DHCPv6 address pool 1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] network 3ffe:501:ffff:100::/64
Related commands
· address range
· display ipv6 dhcp pool
· temporary address range
option
Use option to configure a self-defined DHCPv6 option in a DHCPv6 address pool.
Use undo option to remove a self-defined DHCPv6 option from a DHCPv6 address pool.
Syntax
option code hex hex-string
undo option code
Default
No self-defined DHCPv6 option is configured in a DHCPv6 address pool.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
code: Specifies a number for the self-defined option, in the range of 21 to 65535, excluding 25 through 26, 37 through 40, and 43 through 48.
hex hex-string: Specifies the content of the option, a hex string of even numbers from 2 to 256.
Usage guidelines
The DHCPv6 server fills the self-defined option with the specified hex string and sends it in a response to the client.
If you use the option command multiple times with the same code specified, the most recent configuration takes effect.
You can self-define options for the following purposes:
· Add newly released options.
· Add options for which the vendor defines the contents, for example, Option 43.
· Add options for which the CLI does not provide a dedicated configuration command like dns-server. For example, you can use the option 31 hex 00c80000000000000000000000000001 command to define the NTP server address 200::1 for DHCP clients.
· Add all option values if the actual requirement exceeds the limit for a dedicated option configuration command. For example, the dns-server command can specify up to eight DNS servers. To specify more than eight DNS servers, you must use the option 23 command to define all DNS servers.
If a DHCPv6 option is specified by both the dedicated command and the option command, the DHCPv6 server preferentially assigns the content specified by the dedicated command. For example, if a DNS server address is specified by the dns-server command and the option 23 command, the server uses the address specified by dns-server command.
Examples
# Configure Option 23 that specifies a DNS server address 2001:f3e0::1 in DHCPv6 address pool 1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] option 23 hex 2001f3e0000000000000000000000001
Related commands
· display ipv6 dhcp pool
· dns-server
· domain-name
· sip-server
prefix-pool
Use prefix-pool to apply a prefix pool to a DHCPv6 address pool, so the DHCPv6 server can dynamically select a prefix from the prefix pool for a client.
Use undo prefix-pool to remove the configuration.
Syntax
prefix-pool prefix-pool-number [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]
undo prefix-pool prefix-pool-number
Default
No prefix pool is applied to an address pool.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
prefix-pool-number: Specifies a prefix pool by its number in the range of 1 to 128.
preferred-lifetime preferred-lifetime: Specifies the preferred lifetime in the range of 60 to 4294967295 seconds. The default value is 604800 seconds (seven days).
valid-lifetime valid-lifetime: Specifies the valid lifetime in the range of 60 to 4294967295 seconds. The default value is 2592000 seconds (30 days). The valid lifetime must be longer than or equal to the preferred lifetime.
Usage guidelines
Only one prefix pool can be applied to an address pool.
You can apply a prefix pool that has not been created to an address pool. The setting takes effect after the prefix pool is created.
You cannot modify prefix pools that have been applied. To change the prefix pool for an address pool, you must remove the prefix pool application first.
Examples
# Apply prefix pool 1 to address pool 1, and use the default preferred lifetime and valid lifetime.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] prefix-pool 1
# Apply prefix pool 2 to address pool 2, and set the preferred lifetime to one day and the valid lifetime to three days.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 2
[Sysname-dhcp6-pool-2] prefix-pool 2 preferred-lifetime 86400 valid-lifetime 259200
Related commands
· display ipv6 dhcp pool
· ipv6 dhcp prefix-pool
reset ipv6 dhcp server conflict
Use reset ipv6 dhcp server conflict to clear IPv6 address conflict information.
Syntax
reset ipv6 dhcp server conflict [ address ipv6-address ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
address ipv6-address: Clears conflict information for the specified IPv6 address. If no IPv6 address is specified, the command clears all IPv6 address conflict information.
Usage guidelines
Address conflicts occur when dynamically assigned IP addresses have been statically configured for other hosts. After the conflicts are resolved, you can use the reset ipv6 dhcp server conflict command to clear conflict information so that the conflicted addresses can be assigned to clients.
Examples
# Clear all IPv6 address conflict information.
<Sysname> reset ipv6 dhcp server conflict
Related commands
display ipv6 dhcp server conflict
reset ipv6 dhcp server expired
Use reset ipv6 dhcp server expired to clear binding information for lease-expired IPv6 addresses.
Syntax
reset ipv6 dhcp server expired [ address ipv6-address | pool pool-name ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
address ipv6-address: Clears binding information for the specified lease-expired IPv6 address.
pool pool-name: Clears binding information for lease-expired IPv6 addresses in the address pool specified by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
Using this command without any parameter clears binding information for all lease-expired IPv6 addresses.
Examples
# Clear binding information for expired IPv6 address 2001:f3e0::1.
<Sysname> reset ipv6 dhcp server expired address 2001:f3e0::1
Related commands
display ipv6 dhcp server expired
reset ipv6 dhcp server ip-in-use
Use reset ipv6 dhcp server ip-in-use to clear binding information for assigned IPv6 addresses.
Syntax
reset ipv6 dhcp server ip-in-use [ address ipv6-address | pool pool-name ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
address ipv6-address: Clears binding information for the assigned IPv6 address.
pool pool-name: Clears binding information for assigned IPv6 addresses in the address pool specified by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
Using this command without any parameter clears binding information for all IPv6 addresses.
If you use this command to clear information for an assigned static binding, the static binding becomes an unassigned static binding.
Examples
# Clear binding information for all assigned IPv6 addresses.
<Sysname> reset ipv6 dhcp server ip-in-use
# Clears binding information for assigned IPv6 addresses in DHCPv6 address pool 1.
<Sysname> reset ipv6 dhcp server ip-in-use pool 1
# Clears binding information for the assigned IPv6 address 2001:0:0:1::1.
<Sysname> reset ipv6 dhcp server ip-in-use address 2001:0:0:1::1
Related commands
display ipv6 dhcp server ip-in-use
reset ipv6 dhcp server pd-in-use
Use reset ipv6 dhcp server pd-in-use to clear binding information for assigned IPv6 prefixes.
Syntax
reset ipv6 dhcp server pd-in-use [ pool pool-name | prefix prefix/prefix-len ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
pool pool-name: Clears binding information for assigned IPv6 prefixes in the address pool specified by its name, a case-insensitive string of 1 to 63 characters.
prefix prefix/prefix-len: Clears binding information for the specified IPv6 prefix. The value for the prefix length ranges from 1 to 128.
Usage guidelines
Using this command without any parameter clears binding information for all assigned IPv6 prefixes.
If you use this command to clear information for an assigned static binding, the static binding becomes an unassigned static binding.
Examples
# Clear binding information for all assigned IPv6 prefixes.
<Sysname> reset ipv6 dhcp server pd-in-use
# Clears binding information for assigned IPv6 prefixes in DHCPv6 address pool 1.
<Sysname> reset ipv6 dhcp server pd-in-use pool 1
# Clears binding information for the assigned IPv6 prefix 2001:0:0:1::/64.
<Sysname> reset ipv6 dhcp server pd-in-use prefix 2001:0:0:1::/64
Related commands
display ipv6 dhcp server pd-in-use
reset ipv6 dhcp server statistics
Use reset ipv6 dhcp server statistics to clear DHCPv6 server statistics.
Syntax
reset ipv6 dhcp server statistics
Views
User view
Predefined user roles
network-admin
mdc-admin
Examples
# Clear DHCPv6 server statistics.
<Sysname> reset ipv6 dhcp server statistics
Related commands
display ipv6 dhcp server statistics
sip-server
Use sip-server to specify the IPv6 address or domain name of a SIP server in the DHCPv6 address pool.
Use undo sip-server to remove a SIP server.
Syntax
sip-server { address ipv6-address | domain-name domain-name }
undo sip-server { address ipv6-address | domain-name domain-name }
Default
No SIP server address or domain name is specified.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
address ipv6-address: Specifies the IPv6 address of a SIP server.
domain-name domain-name: Specifies the domain name of a SIP server, a case-insensitive string of 1 to 50 characters.
Usage guidelines
You can specify up to eight SIP server addresses and eight SIP server domain names in an address pool. A SIP server that is specified earlier has a higher preference.
Examples
# Specify the SIP server address 2:2::4 in DHCPv6 address pool 1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] sip-server address 2:2::4
# Specify the SIP server domain name bbb.com in DHCPv6 address pool 1.
[Sysname-dhcp6-pool-1] sip-server domain-name bbb.com
Related commands
display ipv6 dhcp pool
static-bind
Use static-bind to statically bind a client DUID or client IAID to an IPv6 address or prefix in the DHCPv6 address pool.
Use undo static-bind to remove a static binding.
Syntax
static-bind { address ipv6-address/addr-prefix-length | prefix prefix/prefix-len } duid duid [ iaid iaid ] [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]
undo static-bind { address ipv6-address/addr-prefix-length | prefix prefix/prefix-len }
Default
No static binding is configured in a DHCPv6 address pool.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
address ipv6-address/addr-prefix-length: Specifies the IPv6 address and prefix length. The prefix length ranges from 1 to 128.
prefix prefix/prefix-len: Specifies the prefix and prefix length. The prefix length ranges from 1 to 128.
duid duid: Specifies a client DUID. The value is an even hexadecimal number in the range of 2 to 256.
iaid iaid: Specifies a client IAID. The value is a hexadecimal number in the range of 0 to FFFFFFFF. If no IAID is specified, the server does not match against the client IAID for prefix assignment.
preferred-lifetime preferred-lifetime: Specifies the preferred lifetime of the address or prefix. The value ranges from 60 to 4294967295 seconds and defaults to 604800 seconds (seven days).
valid-lifetime valid-lifetime: Specifies the valid lifetime of the address or prefix. The value ranges from 60 to 4294967295 seconds and defaults to 2592000 seconds (30 days). The valid lifetime cannot be shorter than the preferred lifetime.
Usage guidelines
You can specify multiple static bindings in a DHCPv6 address pool.
An IPv6 address or prefix can be bound to only one DHCPv6 client. You cannot modify bindings that have been created. To change the binding for a DHCPv6 client, you must delete the existing binding first.
Examples
# In address pool 1, bind IPv6 address 2001:0410::/35 to the client DUID 0003000100e0fc005552 and IAID A1A1A1A1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] static-bind address 2001:0410::/35 duid 0003000100e0fc005552 iaid A1A1A1A1
# In address pool 1, bind prefix 2001:0410::/35 to the client DUID 00030001CA0006A400 and IAID A1A1A1A1.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] static-bind prefix 2001:0410::/35 duid 00030001CA0006A400 iaid A1A1A1A1
Related commands
display ipv6 dhcp pool
temporary address range
Use temporary address range to configure a temporary IPv6 address range in a DHCPv6 address pool for dynamic allocation.
Use undo temporary address range to remove the temporary IPv6 address range from the address pool.
Syntax
temporary address range start-ipv6-address end-ipv6-address [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]
undo temporary address range
Default
No temporary IPv6 address range is configured in an address pool.
Views
DHCPv6 address pool view
Predefined user roles
network-admin
mdc-admin
Parameters
start-ipv6-address: Specifies the start IPv6 address.
end-ipv6-address: Specifies the end IPv6 address.
preferred-lifetime preferred-lifetime: Specifies the preferred lifetime. The value ranges from 60 to 4294967295 seconds and defaults to 604800 seconds (seven days).
valid-lifetime valid-lifetime: Specifies the valid lifetime. The value ranges from 60 to 4294967295 seconds, and defaults to 2592000 seconds (30 days). The valid lifetime cannot be shorter than the preferred lifetime.
Usage guidelines
If you do not execute the temporary address range command, the DHCPv6 server does not support temporary address assignment.
You can configure only one temporary IPv6 address range in an address pool. If you use the command multiple times, the most recent configuration takes effect.
Examples
# In DHCPv6 address pool 1, configure a temporary IPv6 address range from 3ffe:501:ffff:100::50 to 3ffe:501:ffff:100::60.
<Sysname> system-view
[Sysname] ipv6 dhcp pool 1
[Sysname-dhcp6-pool-1] network 3ffe:501:ffff:100::/64
[Sysname-dhcp6-pool-1] temporary address range 3ffe:501:ffff:100::50 3ffe:501:ffff:100::60
Related commands
· display ipv6 dhcp pool
· address range
· network
display ipv6 dhcp relay server-address
Use display ipv6 dhcp relay server-address to display DHCPv6 server addresses specified on the DHCPv6 relay agent.
Syntax
display ipv6 dhcp relay server-address [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify any interface, the command displays DHCPv6 server addresses on all interfaces enabled with DHCPv6 relay agent.
Examples
# Display DHCPv6 server addresses on all interfaces enabled with DHCPv6 relay agent.
<Sysname> display ipv6 dhcp relay server-address
Interface: Vlan-interface2
Server address Outgoing Interface
2::3
3::4 Vlan-interface4
Interface: Vlan-interface3
Server address Outgoing Interface
2::3
3::4 Vlan-interface4
# Display DHCPv6 server addresses on VLAN-interface 2.
<Sysname> display ipv6 dhcp relay server-address interface vlan-interface 2
Interface: Vlan-interface2
Server address Outgoing Interface
2::3
3::4 Vlan-interface4
Table 9 Command output
Field |
Description |
Interface |
Interface enabled with DHCPv6 relay agent. |
Server address |
DHCPv6 server address specified on the DHCP relay agent. |
Outgoing Interface |
Output interface of DHCPv6 packets. If no output interface is specified, the device searches the routing table for the output interface. |
Related commands
· ipv6 dhcp relay server-address
· ipv6 dhcp select
display ipv6 dhcp relay statistics
Use display ipv6 dhcp relay statistics to display DHCPv6 packet statistics on the DHCPv6 relay agent.
Syntax
display ipv6 dhcp relay statistics [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify any interface, the command displays DHCPv6 packets statistics on all interfaces enabled with DHCPv6 relay agent.
Examples
# Display DHCPv6 packet statistics on all interfaces enabled with DHCPv6 relay agent.
<Sysname> display ipv6 dhcp relay statistics
Packets dropped : 4
Packets received : 14
Solicit : 0
Request : 0
Confirm : 0
Renew : 0
Rebind : 0
Release : 0
Decline : 0
Information-request : 7
Relay-forward : 0
Relay-reply : 7
Packets sent : 14
Advertise : 0
Reconfigure : 0
Reply : 7
Relay-forward : 7
Relay-reply : 0
# Display DHCPv6 packet statistics on the DHCPv6 relay agent on VLAN-interface 2.
<Sysname> display ipv6 dhcp relay statistics interface vlan-interface 2
Packets dropped : 4
Packets received : 16
Solicit : 0
Request : 0
Confirm : 0
Renew : 0
Rebind : 0
Release : 0
Decline : 0
Information-request : 8
Relay-forward : 0
Relay-reply : 8
Packets sent : 16
Advertise : 0
Reconfigure : 0
Reply : 8
Relay-forward : 8
Relay-reply : 0
Table 10 Command output
Field |
Description |
Packets dropped |
Number of discarded packets. |
Packets received |
Number of received packets. |
Solicit |
Number of received solicit packets. |
Request |
Number of received request packets. |
Confirm |
Number of received confirm packets. |
Renew |
Number of received renew packets. |
Rebind |
Number of received rebind packets. |
Release |
Number of received release packets. |
Decline |
Number of received decline packets. |
Information-request |
Number of received information request packets. |
Relay-forward |
Number of received relay-forward packets. |
Relay-reply |
Number of received relay-reply packets. |
Packets sent |
Number of sent packets. |
Advertise |
Number of sent advertise packets. |
Reconfigure |
Number of sent reconfigure packets. |
Reply |
Number of sent reply packets. |
Relay-forward |
Number of sent Relay-forward packets. |
Relay-reply |
Number of sent Relay-reply packets. |
Related commands
reset ipv6 dhcp relay statistics
ipv6 dhcp relay server-address
Use ipv6 dhcp relay server-address to specify a DHCPv6 server on the DHCPv6 relay agent.
Use undo ipv6 dhcp relay server-address to remove DHCPv6 server addresses.
Syntax
ipv6 dhcp relay server-address ipv6-address [ interface interface-type interface-number ]
undo ipv6 dhcp relay server-address [ ipv6-address [ interface interface-type interface-number ] ]
Default
No DHCPv6 server address is specified on the DHCPv6 relay agent.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
ipv6-address: Specifies the IPv6 address of a DHCPv6 server.
interface interface-type interface-number: Specifies an output interface through which the relay agent forwards the DHCPv6 requests to the DHCPv6 server. If you do not specify any output interface, the relay agent looks up the routing table for an output interface.
Usage guidelines
Upon receiving a request from a DHCPv6 client, the interface encapsulates the request into a Relay-forward message and forwards the message to the specified DHCPv6 server.
You can specify a maximum of eight DHCPv6 servers on an interface. The DHCPv6 relay agent forwards DHCP requests to all the specified DHCPv6 servers.
If the DHCPv6 server address is a link-local address or link-scoped multicast address on the local link, you must specify an output interface. If no output interface is specified, DHCPv6 packets might fail to reach the DHCPv6 server.
If you do not specify any IPv6 address, the undo ipv6 dhcp relay server-address command removes all DHCPv6 server addresses specified on the interface.
Do not enable the DHCPv6 client and the DHCPv6 relay agent/DHCPv6 server on the same interface.
Examples
# Enable the DHCPv6 relay agent on VLAN-interface 2 and specify the DHCPv6 server address 2001:1::3.
<Sysname> system-view
[Sysname] interface vlan-interface 2
[Sysname-Vlan-interface2] ipv6 dhcp select relay
[Sysname-Vlan-interface2] ipv6 dhcp relay server-address 2001:1::3
Related commands
· display ipv6 dhcp relay server-address
· ipv6 dhcp select
reset ipv6 dhcp relay statistics
Use reset ipv6 dhcp relay statistics to clear packets statistics on the DHCPv6 relay agent.
Syntax
reset ipv6 dhcp relay statistics [ interface interface-type interface-number ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify any interface, the command clears all relay agent statistics.
Examples
# Clear packet statistics on the DHCPv6 relay agent.
<Sysname> reset ipv6 dhcp relay statistics
Related commands
display ipv6 dhcp relay statistics