option-group-number: Specifies a DHCPv6 option group by its ID in the range of 1 to 100. If you do not specify any option group, the command displays information about all DHCPv6 option groups.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

DHCPv6 option groups can be static or dynamic:

· A static DHCPv6 option group is created by the ipv6 dhcp option-group command.

· A dynamic group is automatically created by a DHCPv6 client when the client obtains and IPv6 address/prefix and network parameters. Dynamic option groups cannot be manually modified or removed.

Examples

# Display information about all DHCPv6 option groups.

<Sysname> display ipv6 dhcp option-group

DHCPv6 option group: 1

Type: Static

DNS server addresses:

1::1

Domain names:

aaa.com

SIP server addresses:

2::1

SIP server domain names:

bbb.com

DS-Lite addresses:

2::3

Options:

Code: 23

Length: 2 bytes

Hex: ABCD

Code: 33

Length: 2 bytes

Hex: DEFA

Table 1 Command output

Field	Description
DHCPv6 option group	DHCPv6 option group number.
Type	DHCPv6 option group type, Static or Dynamic.
DNS server addresses	IP address of the DNS server.
Domain names	Domain name suffix.
SIP server addresses	IP address of the SIP server.
SIP server domain names	Domain name of the SIP server.
DS-Lite addresses	IP address of the Address Family Transition Router (AFTR).
Options	User-defined options.
Code	Code of the self-defined option.
Length	Self-defined option string length in bytes.
Hex	Self-defined option content represented by a hexadecimal string.

Related commands

· ipv6 address dhcp-alloc

· ipv6 dhcp client pd

DHCPv6 server configuration commands

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

Default command level

2: System level

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 (7 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 execute 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.

The non-temporary and temporary IPv6 address ranges cannot overlap.

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 DHCPv6 address pool information.

Syntax

display ipv6 dhcp pool [ pool-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

pool-number: Displays information about the DHCPv6 address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References. If you do not specify any pool number, this command displays all DHCPv6 address pool information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display all DHCPv6 address pool information.

<Sysname> display ipv6 dhcp pool 1

Pool: 1

Network: 3FFE:501:FFFF:100::/64

Preferred lifetime 604800 sec, valid lifetime 2592000 sec

Static bindings:

Prefix: 3FFE:501:FFFF:100::/64

DUID: 0003000100E0FC000001

IAID: 0x3F

Preferred lifetime 604800 sec, valid lifetime 2592000 sec

Address: 3FFE:501:FFFF:100::2345/64

DUID: 0003000100E0FC000002

IAID: 0x30

Preferred lifetime 604800 sec, valid lifetime 2592000 sec

Prefix pool: 1

Preferred lifetime 201600 sec, valid lifetime 864000 sec

Address range:

From 3FFE:501:FFFF:100::10

To 3FFE:501:FFFF:100::20

Preferred lifetime 3600 sec, valid lifetime 7200 sec

Total: 17

Available: 17

In-use: 0

Temporary address range:

From 3FFE:501:FFFF:100::21

To 3FFE:501:FFFF:100::30

Preferred lifetime 3600 sec, valid lifetime 7200 sec

Total: 16

Available: 16

In-use: 0

DNS server addresses:

2::2

2::3

Domain names:

aaa.com

SIP server addresses:

5::1

SIP server domain names:

bbb.com

DS-Lite addresses:

6::6

Options:

Code: 88

Length: 4 bytes

Hex: AABBCCDD

Option group: 1

Table 2 Command output

Field	Description
Pool	DHCPv6 address pool number.
Network	IPv6 subnet for dynamic IPv6 address assignment. If the subnet is not valid, Not-available is displayed.
Preferred lifetime	Preferred lifetime in seconds.
valid lifetime	Valid lifetime in seconds.
Static bindings	Static IPv6 address or prefix information configured in the address pool. If no static prefix is configured, this field is not displayed.
Prefix	IPv6 address prefix in the binding.
Address	IPv6 address in the binding.
DUID	Client DUID.
IAID	Client IAID. If no IAID is configured, this field displays Not configured.
Prefix pool	Prefix pool referenced by the address pool. If no referenced prefix pool is specified, this field displays Not configured.
Address range	Non-temporary address ranges for dynamic allocation. If no non-temporary address range is configured, this field is not displayed.
Temporary address range	Temporary address range for dynamic allocation. If no temporary address range is configured, this field is not displayed.
From	Start IPv6 address of the address range.
To	End IPv6 address of the address range.
Total	Total number of assignable addresses.
Available	Number of idle addresses.
In-use	Number of assigned addresses.
DNS server addresses	DNS server address. If no DNS server address is configured, this field is not displayed.
Domain names	Domain name suffix. If no domain name suffix is configured, this field is not displayed.
SIP server addresses	SIP server address. If no SIP server address is configured, this field is not displayed.
SIP server domain names	Domain name of the SIP server. If no domain name of the SIP server is configured, this field is not displayed.
DS-Lite address	AFTR address. If no AFTR address is configured, this field is not displayed.
Options	Self-defined option. If no self-defined option is configured, this field is not displayed.
Code	Self-defined option code.
Length	Self-defined option length in bytes.
Hex	Self-defined option content, represented by a hexadecimal string.
Option group	Option group ID. If no option group is configured, this field is not displayed.

display ipv6 dhcp prefix-pool

Use display ipv6 dhcp prefix-pool to display prefix pool information.

Syntax

display ipv6 dhcp prefix-pool [ prefix-pool-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

prefix-pool-number: Displays details about the prefix pool specified by the prefix pool number. The value range for the prefix-pool-number varies by device model. For more information, see About the H3C Access Controllers Command References. If you do not specify any prefix pool number, this command displays brief information about all prefix pools.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

This command does not display information about the prefix pools that are not applied to any address pool.

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 details 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 3 Command output

Field	Description
Prefix-pool	Prefix pool number.
Prefix	Prefix contained in the prefix pool. If the prefix pool is not valid, Not-available is displayed.
Available	Number of idle prefixes.
In-use	Number of assigned prefixes.
Static	Number of static prefixes.
Assigned length	Length of prefixes to be assigned.
Total prefix number	Total number of prefixes.

display ipv6 dhcp server

Use display ipv6 dhcp server to display DHCPv6 server information.

Syntax

display ipv6 dhcp server [ interface interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

interface interface-type interface-number: Displays the DHCPv6 server information about the interface specified by interface type and number. If you do not specify any interface, this command displays DHCPv6 server information about all interfaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display DHCPv6 server information about all interfaces.

<Sysname> display ipv6 dhcp server

DHCPv6 server status: Enabled

Interface Pool

Vlan-interface2 1

Vlan-interface3 2

# Display DHCPv6 server information about the specified interface.

<Sysname> display ipv6 dhcp server interface vlan-interface 2

Using pool: 1

Preference value: 0

Allow-hint: Enabled

Rapid-commit: Disabled

Table 4 Command output

Field	Description
DHCPv6 server status	DHCPv6 server status, Enabled or Disabled.
Interface	Interface on which the DHCPv6 server is enabled.
Pool	Address pool applied to the interface. Global indicates that no address pool is applied to the interface. The DHCPv6 server searches all address pools and selects one address pool to assign a prefix or an address to the client.
Using pool	Address pool applied to the interface. If no address pool is applied, Global is displayed.
Preference value	Server priority in the DHCPv6 Advertise message. The value ranges from 0 to 255. The higher the value is, the higher priority the server has.
Allow-hint	Whether desired address/prefix assignment is enabled.
Rapid-commit	Whether rapid address/prefix assignment is enabled.

display ipv6 dhcp server conflict

Use display ipv6 dhcp server conflict to display IPv6 address conflict information.

Syntax

display ipv6 dhcp server conflict [ address ipv6-address | pool pool-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

address ipv6-address: Displays conflict information about a specific IPv6 address.

pool pool-number: Displays IPv6 address conflict information about the DHCPv6 address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display all IPv6 address conflict information.

<Sysname> display ipv6 dhcp server conflict

Total number: 4

Address Detect time

1:2::1 Nov 23 2010 16:37:08

1:2::2 Nov 23 2010 16:37:08

1:2::3 Nov 23 2010 16:37:08

1:2::4 Nov 23 2010 16:37:08

--- total 4 entries ---

Table 5 Command output

Field	Description
Total number	Total number of conflicted addresses.
Address	IPv6 address that conflicted with another IPv6 address.
Detect time	Time when the conflict was detected.

Related commands

reset ipv6 dhcp server conflict

display ipv6 dhcp server expired

Use display ipv6 dhcp server expired to display information about expired IPv6 addresses.

Syntax

display ipv6 dhcp server expired [ address ipv6-address | pool pool-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

address ipv6-address: Displays information about an expired IPv6 address.

pool pool-number: Displays information about expired IPv6 addresses in the address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display information about all expired IPv6 addresses.

<Sysname> display ipv6 dhcp server expired

Total number: 4

Address DUID Expiration time

1:2::4 00010006498D332 Nov 23 2010 16:12:43

2000102030405

1:2::3 00010006498D332 Nov 23 2010 16:12:43

2000102030405

1:2::2 00010006498D332 Nov 23 2010 16:12:43

2000102030405

1:2::1 00010006498D332 Nov 23 2010 16:12:43

2000102030405

--- total 4 entries ---

Table 6 Command output

Field	Description
Total number	Total number of expired addresses.
Address	Expired IPv6 address.
DUID	Client DUID bound to the expired IPv6 address.
Expiration time	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 IPv6 address binding information.

Syntax

display ipv6 dhcp server ip-in-use [ address ipv6-address | pool pool-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

address ipv6-address: Displays binding information about a specific IPv6 address.

pool pool-number: Displays IPv6 address binding information about the address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display all IPv6 address binding information.

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

Total number: 4

Address Type Pool Expiration time

2:1::1 Auto(O) 1 Jul 10 2011 19:45:01

3:1::2 Static(C) 1 Jan 1 2011 11:11:11

1:1::2 Static(F) 2 Not-available

1:2::1f1 Static(O) 3 Oct 9 2011 09:23:31

# Display IPv6 address binding information about address pool 1.

<Sysname> display ipv6 dhcp server ip-in-use pool 1

Total number: 2

Address Type Pool Expiration time

2:1::1 Auto(O) 1 Jul 10 2011 22:22:22

3:1::2 Static(C) 1 Jan 1 2011 11:11:11

# Display binding information about IPv6 address 2:1::1.

<Sysname> display ipv6 dhcp server ip-in-use address 2:1::1

Pool: 1

Client: FE80::C800:CFF0:FE18:0

Type: Auto(O)

DUID: 00030001CA000C180000

IAID: 0x30001

Address: 2:1::1

Preferred lifetime 400 sec, valid lifetime 500 sec

Will expire at Jul 10 2008 09:45:01 (288 seconds left)

Table 7 Command output

Field	Description
Total number	Total number of IPv6 address bindings.
Address	Assigned IPv6 address.
Type	Type of an IPv6 address binding: · Static(F)—Free static binding, indicating the static address has not been assigned to the client. · Static(O)—Offered static binding. If the server replies with an Advertise message to the client during the four-step message exchange, the server sets the type of the static binding configured for the client to Static(O). · Static(C)—Committed static binding, indicating the static IPv6 address has been assigned to the client in a Reply message. · Auto(O)—Offered dynamic binding. If the server selects a dynamic IPv6 address and replies with an Advertise message to the client during the four-step message exchange, the server sets the type of the dynamic IPv6 address binding to Auto(O). · Auto(C)—Committed dynamic binding, indicating the dynamic IPv6 address has been assigned to the client in a Reply message.
Pool	Address pool to which the binding belongs.
Expiration time	Time when the lease of an IPv6 address expires. If the lease expires after the year 2100, this field displays after 2100. For a free static binding, this field displays Not-available.
Client	Link-local address of a DHCPv6 client. For a free static binding, this field is blank.
DUID	Client DUID.
IAID	Client IAID. For a free static binding without IAID specified, this field is blank.
Will expire at	Time when the lease of an IPv6 address will expire. If the lease expires after the year 2100, this field displays Will expire 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 IPv6 prefix binding information.

Syntax

display ipv6 dhcp server pd-in-use [ pool pool-number | prefix prefix/prefix-len | prefix-pool prefix-pool-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

pool pool-number: Displays prefix binding information about the DHCPv6 address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

prefix prefix/prefix-len: Displays binding information about the specified prefix. The prefix/prefix-len indicates the IPv6 prefix and prefix length. The value range for the prefix length is 1 to 128.

prefix-pool prefix-pool-number: Displays prefix binding information about the prefix pool specified by the prefix pool number. The value range for the prefix pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

The binding information generated for static prefixes is not displayed when you display the prefix binding information about a specific prefix pool.

Examples

# Display all IPv6 prefix binding information.

<Sysname> display ipv6 dhcp server pd-in-use

Total number: 3

Prefix Type Pool Expiration time

2:1::/24 Auto(O) 1 Jul 10 2011 19:45:01

1:1::/64 Static(F) 2 Not-available

1:2::/64 Static(O) 3 Oct 9 2011 09:23:31

# Display prefix binding information about the specified DHCPv6 address pool.

<Sysname> display ipv6 dhcp server pd-in-use pool 1

Total number: 2

Prefix Type Pool Expiration time

2:1::/24 Auto(O) 1 Jul 10 2011 22:22:22

3:1::/64 Static(C) 1 Jan 1 2011 11:11:11

# Display prefix binding information about the specified prefix pool.

<Sysname> display ipv6 dhcp server pd-in-use prefix-pool 1

Total number: 1

Prefix Type Pool Expiration time

2:1:1:2::/64 Auto(C) 2 Jan 1 2011 14:45:56

# Display prefix binding information about the specified prefix.

<Sysname> display ipv6 dhcp server pd-in-use prefix 2:1::3/24

Pool: 1

Prefix pool: 1

Client: FE80::C800:CFF:FE18:0

Type: Auto(O)

DUID: 00030001CA000C180000

IAID: 0x30001

Prefix: 2:1::/24

Preferred lifetime 400 sec, valid lifetime 500 sec

Will expire at Jul 10 2008 09:45:01 (288 seconds left)

Table 8 Command output

Field	Description
Total number	Total number of prefix bindings.
Prefix	Assigned IPv6 prefix.
Type	Type of a prefix binding: · Static(F)—Free static binding, indicating the static prefix has not been assigned to the client. · Static(O)—Offered static binding. If the server replies with an Advertise message to the client during the four-step message exchange, the server sets the type of the static binding configured for the client to Static(O). · Static(C)—Committed static binding, indicating the static IPv6 prefix has been assigned to the client in a Reply message. · Auto(O)—Offered dynamic binding. If the server selects a dynamic IPv6 prefix and replies with an Advertise message to the client during the four-step message exchange, the server sets the type of the dynamic IPv6 prefix binding to Auto(O). · Auto(C)—Committed dynamic binding, indicating the dynamic IPv6 prefix has been assigned to the client in a Reply message.
Pool	Address pool to which the prefix binding belongs.
Expiration time	Time when the prefix lease expires. If the lease expires after the year 2100, this field displays after 2100. For a free static binding, this field displays Not-available.
Prefix Pool	Prefix pool to which the prefix binding belongs. For a free static binding, this field is blank.
Client	IPv6 address of the DHCPv6 client. For a free static binding, this field is blank.
DUID	Client DUID.
IAID	Client IAID. For a free static binding without IAID configured, this field is blank.
Preferred lifetime	Preferred lifetime of the prefix, in seconds.
valid lifetime	Valid lifetime of the prefix, in seconds.
Will expire at	Time when the prefix lease will expire. If the lease expires after the year 2100, this field displays Will expire after 2100.

display ipv6 dhcp server statistics

Use display ipv6 dhcp server statistics to display packet statistics on the DHCPv6 server.

Syntax

display ipv6 dhcp server statistics [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display packet statistics on the DHCPv6 server.

<Sysname> display ipv6 dhcp server statistics

Packets received : 0

SOLICIT : 0

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 9 Command output

Field	Description
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.
Packets dropped	Number of packets discarded.
Packets sent	Number of messages sent out from the DHCPv6 server. The message types include: · ADVERTISE. · RECONFIGURE. · REPLY. · RELAY-REPLY.

dns-server

Use dns-server to specify a DNS server for the client.

Use undo dns-server to remove the specified DNS server.

Syntax

dns-server ipv6-address

undo dns-server ipv6-address

Default

No DNS server address is specified.

Views

DHCPv6 address pool view, DHCPv6 option group view

Default command level

2: System level

Parameters

ipv6-address: IPv6 address of a DNS server.

Usage guidelines

You can configure multiple DNS server addresses.

You can configure up to eight DNS servers in an address pool.

The precedence of the specified DNS servers depends on the configuration sequence. The formerly specified DNS server takes precedence over the latter one.

Examples

# Specify the DNS server address to be assigned to the client as 2:2::3.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] dns-server 2:2::3

domain-name

Use domain-name to configure the domain name suffix for the client.

Use undo domain-name to remove the configuration.

Syntax

domain-name domain-name

undo domain-name

Default

No domain name suffix is configured for the client.

Views

DHCPv6 address pool view, DHCPv6 option group view

Default command level

2: System level

Parameters

domain-name: Domain name suffix, a 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

# Configure the domain name suffix to be assigned to the client as aaa.com.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] domain-name aaa.com

ds-lite address

Use ds-lite address to specify the address of the AFTR.

Use undo ds-lite address to delete the address of the AFTR.

Syntax

ds-lite address ipv6-address

undo ds-lite address

Default

The address of the AFTR is not specified.

Views

DHCPv6 address pool view, DHCPv6 option group view

Default command level

2: System level

Parameters

ipv6-address: IPv6 address of the AFTR.

Usage guidelines

When you configure a DS-lite tunnel, the Customer Premises Equipment (CPE) sends a DHCPv6 request to obtain the address of the AFTR. Upon receiving the request, the DHCPv6 server sends the address of the AFTR to the CPE.

You can specify only one AFTR address for an address pool. The latest setting overrides the previous one.

Examples

# Specify the AFTR address as 2::1.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] ds-lite address 2::1

network

Use network to specify an IPv6 subnet in a DHCPv6 address pool for dynamic address assignment.

Use undo network to remove an IPv6 subnet from a DHCPv6 address pool.

Syntax

network { network-address/prefix-length | prefix prefix-number [ sub-prefix/sub-prefix-length ] } [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]

undo network

Default

No IPv6 subnet is configured for dynamic address assignment.

Views

DHCPv6 address pool view

Default command level

2: System level

Parameters

network-address/prefix-length: IPv6 subnet for dynamic assignment. The network-address argument is the IPv6 address and the prefix-length argument is the prefix length. The prefix length ranges from 1 to 128.

prefix: Specifies a prefix for dynamic prefix assignment.

prefix-number: Specifies the ID of an IPv6 prefix, in the range of 1 to 1024.

sub-prefix/sub-prefix-length: Specifies the IPv6 sub-prefix and sub-prefix length. The value for sub-prefix-length ranges from 1 to 128. If the ipv6 prefix command specifies a prefix longer than the sub-prefix, the prefix is used for prefix assignment.

preferred-lifetime preferred-lifetime: Specifies the preferred lifetime for IPv6 addresses assigned from the subnet. The value ranges from 60 to 4294967295 seconds and defaults to 604800 seconds (7 days).

valid-lifetime valid-lifetime: Specifies the valid lifetime for IPv6 addresses assigned from the subnet. 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

Only one subnet can be specified in an address pool. You cannot execute the network command multiple times in the same address pool.

The network command cannot be used to specify a subnet where all addresses are link-local or multicast addresses. The network command can be used to specify a subnet where some of the addresses are link-local or multicast addresses, but these addresses are not assignable.

You cannot use the network network-address/prefix-length command to configure the same subnet in different address pools, or cannot use the network prefix command in to specify the same prefix in different address pools.

You can specify a non-existing IPv6 prefix for the network prefix command, but the command takes effect only after you create the IPv6 prefix.

If the prefix used by the network prefix command changes, the assignable network changes, and information about assigned prefix and addresses is removed.

Examples

# Specify IPv6 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

# Create an IPv6 prefix 88:99::/32 with the ID 3. Specify the IPv6 prefix in address pool 1 for prefix assignment.

<Sysname> system-view

[Sysname] ipv6 prefix 3 88:99::/32

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] network prefix 3

# Create an IPv6 prefix 88:99::/32 with the ID 3. Specify the IPv6 prefix in address pool 1 and specify the sub-prefix and sub-prefix length as 3ffe:501:ffff:100::/64. The DHCPv6 server assigns addresses in the subnet 88:99:ffff:100::/64 with the prefix length 64. The first 32-bit prefix is determined by the prefix 3 and the last 2-bit prefix is determined by the sub-prefix.

<Sysname> system-view

[Sysname] ipv6 prefix 3 88:99::/32

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] network prefix 3 3ffe:501:ffff:100::/64

Related commands

· display ipv6 dhcp pool

· ipv6 dhcp client pd

· ipv6 prefix

ipv6 dhcp option-group

Use ipv6 dhcp option-group to create a static DHCPv6 option group, and enter its view.

Use undo ipv6 dhcp option-group to delete the specified static DHCPv6 option group.

Syntax

ipv6 dhcp option-group option-group-number

undo ipv6 dhcp option-group option-group-number

Default

No DHCPv6 option group is configured on the device.

Views

System view

Default command level

2: System level

Parameters

option-group-number: Assign an ID to the static option group, in the range of 1 to 100.

Usage guidelines

The DHCPv6 option group ID must be globally unique on the device. Do not assign the ID of a dynamic DHCPv6 option group to a static option group.

Examples

# Create a static DHCPv6 option group 1, and enter its view.

<Sysname> system-view

[Sysname] ipv6 dhcp option-group 1

[Sysname-dhcp6-option-group1]

Related commands

· ipv6 address dhcp-alloc

· ipv6 dhcp client pd

ipv6 dhcp pool

Use ipv6 dhcp pool to create a DHCPv6 address pool and enter DHCPv6 address pool view, or enter DHCPv6 address pool view if the specified address pool already exists.

Use undo ipv6 dhcp pool to remove the address pool.

Syntax

ipv6 dhcp pool pool-number

undo ipv6 dhcp pool pool-number

Default

No DHCPv6 address pool is configured.

Views

System view

Default command level

2: System level

Parameters

pool-number: Assigns a number to the address pool. The value range for the this argument varies by device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Create DHCPv6 address pool 1 and enter its view.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1]

ipv6 dhcp prefix-pool

Use ipv6 dhcp prefix-pool to create a prefix pool and specify the prefix and the length of the prefix assigned.

Use undo ipv6 dhcp prefix-pool to remove the prefix pool.

Syntax

ipv6 dhcp prefix-pool prefix-pool-number prefix { prefix-number | prefix/prefix-len } assign-len assign-len

undo ipv6 dhcp prefix-pool prefix-pool-number

Default

No prefix pool is configured.

Views

System view

Default command level

2: System level

Parameters

prefix-pool-number: Assigns a number to the prefix pool. The value range for this argument varies by device model. For more information, see About the H3C Access Controllers Command References.

prefix: Specifies a prefix by specifying its ID or the prefix.

prefix-number: Specifies the ID of the IPv6 prefix, in the range of 1 to 1024.

prefix/prefix-len: Specifies the IPv6 prefix and prefix length. The value range for the prefix-len argument is 1 to 128.

assign-len assign-len: Specifies the length of the prefix assigned. The value ranges from 1 to 128. The assign-len must be higher than or equal to the prefix-len, and the difference between them must be less than or equal to 16.

Usage guidelines

The prefix ranges of the prefix pools cannot overlap. Otherwise, the prefix pools configured later does not take effect.

You cannot modify an existing prefix pool.

Removing a prefix pool clears all bindings of prefixes assigned from the prefix pool.

You can specify a non-existing IPv6 prefix for the ipv6 dhcp prefix-pool command, but the command takes effect only after you create the IPv6 prefix.

You cannot specify the same IPv6 prefix for different prefix pools.

When the IPv6 prefix used by the ipv6 dhcp prefix-pool command changes, the assignable prefix range changes accordingly.

Examples

# Create prefix pool 1 that contains the prefix 2001:0410::/32 and specify the length of prefixes to be assigned as 42. Prefix pool 1 can assign 1024 prefixes in the range of 2001:0410::/42 to 2001:0410:FFC0::/42.

<Sysname> system-view

[Sysname] ipv6 dhcp prefix-pool 1 prefix 2001:0410::/32 assign-len 42

# Create IPv6 prefix with the ID 3. Create prefix pool 2, and specify the prefix 3 and the length of the prefixes to be assigned as 42. Prefix pool 2 can assign 1024 prefixes in the range of 88:99::/42 to 88:99:FFC0::/42.

<Sysname> system-view

[Sysname] ipv6 prefix 3 88:99::/32

[Sysname] ipv6 dhcp prefix-pool 2 prefix 3 assign-len 42

ipv6 dhcp server

Use ipv6 dhcp server to enable the DHCPv6 server on the interface.

Use undo ipv6 dhcp server to remove the configuration.

Syntax

ipv6 dhcp server [ allow-hint | apply pool pool-number | preference preference-value | rapid-commit ] *

undo ipv6 dhcp server

Default

The DHCPv6 server is not enabled on an interface.

Views

Interface view

Default command level

2: System level

Parameters

allow-hint: Enables desired address and prefix assignment.

apply pool pool-number: Applies an address pool to the interface. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References. If this option is specified, the DHCPv6 server assigns an IPv6 address or prefix from the address pool applied on the interface to the client. If not, the server searches all DHCPv6 address pools to assign an appropriate one to the client.

preference preference-value: Specifies the server priority in Advertise messages, in the range of 0 to 255. The default value is 0. A higher value indicates a higher priority.

rapid-commit: Enables rapid address and prefix assignment.

Usage guidelines

Upon receiving a request, the interface enabled with the DHCPv6 server selects an IPv6 address or a prefix from the address pool and assigns it to the client.

With the allow-hint keyword specified, the server assigns the desired address or prefix to the requesting client. If the desired address or prefix is not included in the assignable address pool of the interface, or is already assigned to another client, the server ignores the desired address or prefix and assigns the client an address or a prefix from the free addresses or prefixes.

An interface cannot serve as a DHCPv6 server and DHCPv6 relay agent at the same time. H3C recommends not enabling the DHCPv6 server and DHCPv6 client on the same interface.

Only one address pool can be applied to an interface.

You can apply a non-existing address pool to an interface. However, the server cannot assign any address, prefix, or other configuration information from the address pool until the address pool is created.

If you execute the command multiple times on the same interface, the most recent configuration takes effect.

Examples

# Enable DHCPv6 server on interface VLAN-interface 2, apply prefix pool 1 to VLAN-interface 2, configure the server to support desired address and prefix assignment, and rapid address and prefix assignment, and set the highest priority of 255.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ipv6 dhcp server apply pool 1 allow-hint preference 255 rapid-commit

ipv6 dhcp server enable

Use ipv6 dhcp server enable to enable the DHCPv6 server.

Use undo ipv6 dhcp server enable to disable the DHCPv6 server.

Syntax

ipv6 dhcp server enable

undo ipv6 dhcp server enable

Default

The DHCPv6 server is disabled.

Views

System view

Default command level

2: System level

Usage guidelines

Other DHCPv6 server related configuration is effective only when the DHCPv6 server is enabled.

Examples

# Enable the DHCPv6 server.

<Sysname> system-view

[Sysname] ipv6 dhcp server enable

ipv6 nd ra separate-delegation dhcp-pool

Use ipv6 nd ra separate-delegation dhcp-pool to configure the DHCPv6 server to assign IPv6 prefixes to clients for stateless address autoconfiguration.

Use undo ipv6 nd ra separate-delegation dhcp-pool to restore the default.

Syntax

ipv6 nd ra separate-delegation dhcp-pool prefix-pool-number

undo ipv6 nd ra separate-delegation dhcp-pool

Default

The DHCPv6 server does not assign IPv6 prefixes to clients for stateless address autoconfiguration.

Views

Interface view

Default command level

2: System level

Parameters

prefix-pool-number: Specifies a DHCPv6 prefix pool by its number. The value range for this argument varies by device model. For more information, see About the H3C Access Controllers Command References.

Usage guidelines

When receiving an RS message from a client , the DHCPv6 server sends back an IPv6 prefix in an RA message to the client for stateless address autoconfiguration.

Examples

# Configure the DHCPv6 server to assign prefixes from IPv6 prefix pool 1 to clients for stateless address autoconfiguration.

<Sysname> system-view

[Sysname] interface vlan 1

[Sysname-Vlan-interface1] ipv6 nd ra separate-delegation dhcp-pool 1

option

Use option to configure a self-defined DHCPv6 option.

Use to undo option delete a self-defined DHCPv6 option.

Syntax

option code hex hex-string

undo option code

Default

No self-defined DHCPv6 option is configured.

Views

DHCPv6 address pool view, DHCPv6 option group view

Default command level

2: System level

Parameters

code: Self-defined option code in the range of 21 to 65535, excluding 25, 26, 37 to 40, and 43 to 48.

hex hex-string: Specifies a hexadecimal string. The number of hexadecimal digits must be an even number in the range of 2 to 256.

Usage guidelines

If you use the option command multiple times with the same code, the most recent configuration takes effect.

You can configure a maximum of 256 self-defined options.

Use the option command to specify a hexadecimal string for the padding content of the option with the code argument so that the server can assigns the option to clients.

Some DHCPv6 options can be specified by the option command or other dedicated commands. For example, to specify the DNS server address, you can use the dns-server command or the option 23 command. If both commands are configured, the dns-server command takes precedence.

Examples

# Configure the hexadecimal string 020202 for the self-defined DHCP Option 23 in DHCPv6 address pool 1. The DHCPv6 server assigns the DNS server address 2.2.2.2 to clients.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] option 23 hex 02020202

option-group

Use option-group to apply a DHCPv6 option group to the address pool so that the DHCPv6 server assigns parameters in the option group to DHCP6 clients.

Use undo option-group to remove the DHCPv6 option group application.

Syntax

option-group option-group-number

undo option-group

Default

No DHCPv6 option group is configured.

Views

DHCPv6 address pool view

Default command level

2: System level

Parameters

option-group-number: Specifies a DHCPv6 option group by its ID in the range of 1 to 100.

Usage guidelines

Only one DHCPv6 option group can be applied to one DHCPv6 address pool. You cannot execute the command multiple times in the same address pool.

Configuration parameters in the address pool take precedence over these in the DHCPv6 option group.

Examples

# Apply DHCPv6 option group 1 to DHCPv6 address pool 1.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] option-group 1

prefix-pool

Use prefix-pool to apply a prefix pool to the DHCPv6 address pool, so that the DHCPv6 server can dynamically select a prefix from the prefix pool and assign it to the 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

Default

No prefix pool is referenced by an address pool.

Views

DHCPv6 address pool view

Default command level

2: System level

Parameters

prefix-pool-number: Specifies a prefix pool by its number. The value range for this argument varies by device model. For more information, see About the H3C Access Controllers Command References.

preferred-lifetime preferred-lifetime: Specifies the preferred lifetime of prefixes to be assigned. The value ranges from 60 to 4294967295, in seconds. The default value is 604800 seconds (7 days).

valid-lifetime valid-lifetime: Specifies the valid lifetime of the prefixes to be assigned. 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

Only one prefix pool can be referenced by an address pool.

A non-existing prefix pool can be referenced by an address pool. However, no prefix is available in the prefix pool for dynamic prefix assignment until the prefix pool is created.

You cannot modify the prefix pool referenced by an address pool, or the preferred lifetime or valid lifetime by using the prefix-pool command. You need to remove the configuration before you can have another prefix pool referenced by the address pool, or modify the preferred lifetime and valid lifetime.

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 1 to address pool 1, and set the valid lifetime to three days, the preferred lifetime to one day.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] prefix-pool 1 preferred-lifetime 86400 valid-lifetime 259200

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 | pool pool-number ] ]

Views

User view

Default command level

2: System level

Parameters

address ipv6-address: Clears conflict information about a specific IPv6 address.

pool pool-number: Clears IPv6 address conflict information about the address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

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 about lease-expired IPv6 addresses.

Syntax

reset ipv6 dhcp server expired [ address ipv6-address | pool pool-number ] ]

Views

User view

Default command level

2: System level

Parameters

address ipv6-address: Clears binding information about the specified lease-expired IPv6 address.

pool pool-number: Clears binding information about lease-expired IPv6 addresses in the address pool specified by its number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Clears binding information about lease-expired IPv6 addresses in address pool 1.

<Sysname> reset ipv6 dhcp server expired pool 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 IPv6 address binding information.

Syntax

reset ipv6 dhcp server ip-in-use [ address ipv6-address | pool pool-number ]

Views

User view

Default command level

2: System level

Parameters

address ipv6-address: Clears binding information about a specific IPv6 address.

pool pool-number: Clears IPv6 address binding information about the address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

Usage guidelines

This command only clears offered and committed static bindings but not free static bindings.

This command changes offered and committed static bindings to free static bindings.

Examples

# Clear all IPv6 address binding information.

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

# Clear IPv6 address binding information about address pool 1.

<Sysname> reset ipv6 dhcp server ip-in-use pool 1

# Clear the binding information about 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 IPv6 prefix binding information.

Syntax

reset ipv6 dhcp server pd-in-use [ pool pool-number | prefix prefix/prefix-len | prefix-pool prefix-pool-number ]

Views

User view

Default command level

2: System level

Parameters

pool pool-number: Clears IPv6 prefix binding information about the address pool specified by the pool number. The value range for the pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

prefix prefix/prefix-len: Clears binding information about the specified IPv6 prefix. The prefix/prefix-len indicates the IPv6 prefix and prefix length. The value range for the prefix length is 1 to 128.

prefix-pool prefix-pool-number: Clears prefix binding information about the prefix pool specified by its prefix pool number. The value range for the prefix pool number varies by device model. For more information, see About the H3C Access Controllers Command References.

Usage guidelines

This command only clears offered and committed static bindings but not free static bindings.

This command changes offered and committed static bindings to free static bindings.

Examples

# Clear IPv6 prefix binding information about address pool 1.

<Sysname> reset ipv6 dhcp server pd-in-use pool 1

# Clear binding information about IPv6 prefix 2001:0:0:1::/64.

<Sysname> reset ipv6 dhcp server pd-in-use prefix 2001:0:0:1::/64

reset ipv6 dhcp server statistics

Use reset ipv6 dhcp server statistics to clear packet statistics on the DHCPv6 server.

Syntax

reset ipv6 dhcp server statistics

Views

User view

Default command level

1: Monitor level

Examples

# Clear packet statistics on the DHCPv6 server.

<Sysname> reset ipv6 dhcp server statistics

sip-server

Use sip-server to configure the IPv6 address or domain name of a SIP server for the client.

Use undo sip-server to remove the configuration.

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, DHCPv6 option group view

Default command level

2: System level

Parameters

address ipv6-address: Specifies the IPv6 address of a SIP server.

domain-name domain-name: Specifies the domain name of a SIP server. The domain name is a string of 1 to 50 characters.

Usage guidelines

You can configure up to eight SIP server addresses and eight SIP server domain names in an address pool. The priorities of the specified SIP servers depend on the configuration sequence. The formerly specified SIP server takes precedence over the latter one.

If you use the sip-server command multiple times, the latest configuration does not overwrite the previous one.

Examples

# Specify the SIP server address as 2:2::4 for the client.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] sip-server address 2:2::4

# Specify the domain name of the SIP server as bbb.com for the client.

[Sysname-dhcp6-pool-1] sip-server domain-name bbb.com

static-bind address

Use static-bind address to configure a static IPv6 address binding in an address pool.

Use undo static-bind address to remove a static IPv6 address binding.

Syntax

static-bind address ipv6-address/addr-prefix-length duid duid [ iaid iaid ] [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]

undo static-bind address ipv6-address/addr-prefix-length

Default

No static IPv6 address binding is configured in an address pool.

Views

DHCPv6 address pool view

Default command level

2: System level

Parameters

ipv6-address/addr-prefix-length: Static IPv6 address 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 during address assignment.

preferred-lifetime preferred-lifetime: Specifies the preferred lifetime of the static IPv6 address. The value ranges from 60 to 4294967295 seconds and defaults to 604,800 seconds (7 days).

valid-lifetime valid-lifetime: Specifies the valid lifetime of the static IPv6 address. 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 configure multiple static IPv6 address bindings.

An IPv6 address can be bound to only one DHCPv6 client. You cannot use the static-bind address command to modify the DUID, IAID, preferred lifetime and valid lifetime of a static IPv6 address binding. To do so, remove the static binding first.

Examples

# In address pool 1, bind static address 2001:0410::2/35 to the client with DUID 00030001CA0006A400 and IAID A1A1A1A1, and use the default settings of the preferred lifetime and valid lifetime.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] static-bind address 2001:0410::2/35 duid 00030001CA0006A400 iaid A1A1A1A1

Related commands

display ipv6 dhcp pool

static-bind prefix

Use static-bind prefix to configure a static prefix.

Use undo static-bind prefix to remove a static prefix.

Syntax

static-bind prefix prefix/prefix-len duid duid [ iaid iaid ] [ preferred-lifetime preferred-lifetime valid-lifetime valid-lifetime ]

undo static-bind prefix prefix/prefix-len

Default

No static prefix is configured.

Views

DHCPv6 address pool view

Default command level

2: System level

Parameters

prefix/prefix-len: Static 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 you do not specify an IAID, the server does not match against the client IAID for prefix assignment.

preferred-lifetime preferred-lifetime: Specifies the preferred lifetime of the prefix to be assigned. The value ranges from 60 to 4294967295, in seconds. The default value is 604800 seconds, that is, 7 days.

valid-lifetime valid-lifetime: Specifies the valid lifetime of the prefix to be assigned. The value ranges from 60 to 4294967295 seconds and defaults to 2592000 seconds, that is, 30 days. The valid lifetime cannot be shorter than the preferred lifetime.

Usage guidelines

An IPv6 prefix can be bound to only one DHCPv6 client. You cannot use the static-bind prefix command to modify the DUID, IAID, preferred lifetime, and valid lifetime of an existing static IPv6 prefix binding. To do so, remove the static IPv6 prefix binding first.

Examples

# In address pool 1, bind static prefix 2001:0410::/35 to the client with DUID 00030001CA0006A400 and IAID A1A1A1A1, and set the preferred lifetime to one day, and the valid lifetime to three days.

<Sysname> system-view

[Sysname] ipv6 dhcp pool 1

[Sysname-dhcp6-pool-1] static-bind prefix 2001:0410::/35 duid 00030001CA0006A400 iaid A1A1A1A1 preferred-lifetime 86400 valid-lifetime 259200

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

Default command level

2: System level

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 (7 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 execute the command multiple times, the most recent configuration takes effect.

The temporary IPv6 address range specified by the temporary address range command must be on the subnet specified by the network command.

The non-temporary and temporary IPv6 address ranges cannot overlap.

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

· network

· address range

DHCPv6 relay agent configuration commands

display ipv6 dhcp relay server-address

Use display ipv6 dhcp relay server-address to display information about DHCPv6 server addresses specified on the DHCPv6 relay agent.

Syntax

display ipv6 dhcp relay server-address { all | interface interface-type interface-number } [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

all: Displays all DHCPv6 server address information.

interface interface-type interface-number: Displays DHCPv6 server address information about the specified interface.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display all DHCPv6 server address information.

<Sysname> display ipv6 dhcp relay server-address all

Interface: Vlan2

Server address(es) Output Interface

1::1

FF02::1:2 Vlan4

Interface: Vlan3

Server address(es) Output Interface

1::1

FF02::1:2 Vlan4

# Display DHCPv6 server addresses on VLAN-interface 2.

<Sysname> display ipv6 dhcp relay server-address interface vlan-interface 2

Interface: Vlan2

Server address(es) Output Interface

1::1

FF02::1:2 Vlan4

Table 10 Command output

Field	Description
Interface	Interface that serves as the DHCPv6 relay agent.
Server address(es)	DHCPv6 server addresses specified on the interface.
Output Interface	Outgoing interface of DHCPv6 packets.

display ipv6 dhcp relay statistics

Use display ipv6 dhcp relay statistics to display packet statistics on the DHCPv6 relay agent.

Syntax

display ipv6 dhcp relay statistics [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display packet statistics on the DHCPv6 relay agent.

<Sysname> display ipv6 dhcp relay statistics

Packets dropped : 4

Error : 4

Excess of rate limit : 0

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

Table 11 Command output

Field	Description
Packets dropped	Number of discarded packets.
Error	Number of discarded error packets.
Excess of rate limit	Number of packets discarded due to excess of rate limit.
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 enable DHCPv6 relay agent on the interface and specify a DHCPv6 server.

Use undo ipv6 dhcp relay server-address to remove the DHCPv6 server from the interface.

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

DHCPv6 relay agent is disabled and no DHCPv6 server is specified on the interface.

Views

Interface view

Default command level

2: System level

Parameters

ipv6-address: IPv6 address of the DHCPv6 server.

interface interface-type interface-number: Specifies an outgoing interface for DHCPv6 packets.

Usage guidelines

Upon receiving a request from a DHCPv6 client, the interface that operates as a DHCPv6 relay agent encapsulates the request into a Relay-forward message and forwards the message to the specified DHCPv6 server, which then assigns an IPv6 address and other configuration parameters to the DHCPv6 client.

You can specify up to eight DHCP servers for an interface. After receiving requests from DHCPv6 clients, the DHCPv6 relay agent forwards the 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, specify an outgoing interface. If no outgoing interface is specified, DHCPv6 packets may fail to be forwarded to the DHCPv6 server.

After you remove all the specified DHCPv6 servers from an interface with the undo ipv6 dhcp relay server-address command, DHCPv6 relay agent is disabled on the interface.

An interface cannot serve as a DHCPv6 client and DHCPv6 relay agent at the same time.

Examples

# Enable DHCPv6 relay agent on VLAN-interface 2, and specify the DHCPv6 server address as 2001:1::3.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ipv6 dhcp relay server-address 2001:1::3

Related commands

display ipv6 dhcp relay server-address

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

Views

User view

Default command level

1: Monitor level

Usage guidelines

After this command is executed, the packets statistics are displayed as 0 for the output from the display ipv6 dhcp relay statistics command.

Examples

# Clear packet statistics on the DHCPv6 relay agent.

<Sysname> reset ipv6 dhcp relay statistics

Related commands

display ipv6 dhcp relay statistics

DHCPv6 client configuration commands

display ipv6 dhcp client

Use display ipv6 dhcp client to display DHCPv6 client information.

Syntax

display ipv6 dhcp client [ interface interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

interface interface-type interface-number: Displays DHCPv6 client information about a specific interface.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify any parameters, the command displays DHCPv6 client information about all interfaces.

Examples

# Display the DHCPv6 client information about VLAN-interface 2.

<Sysname> display ipv6 dhcp client interface vlan-interface 2

Vlan-interface2 is in stateless DHCPv6 client mode

State is OPEN

Preferred Server:

Reachable via address : FE80::213:7FFF:FEF6:C818

DUID : 0003000100137ff6c818

DNS servers : 1:2:3::5

1:2:4::7

Domain names : abc.com

Table 12 Command output

Field	Description
in stateless DHCPv6 client mode	The client is in the stateless DHCPv6 configuration mode.
State is OPEN	Current state of the DHCPv6 client: · INIT—After enabled, the DHCPv6 client enters INIT state. · IDLE—After receiving an RA message with the "M" flag set to 0 and "O" flag set to 1 and enabled with stateless DHCPv6, the DHCPv6 client enters IDLE state. · INFO-REQUESTING—The DHCPv6 client is requesting configuration information. · OPEN—The DHCPv6 client successfully obtained configuration parameters and completed stateless configuration based on the obtained parameters.
Preferred Server	Information about the DHCPv6 server selected by the DHCPv6 client.
Reachable via address	Reachable address, which is the link local address of the DHCPv6 server or relay agent.
DUID	DUID of the DHCPv6 server.
DNS servers	DNS server address sent by the DHCPv6 server.
Domain names	Domain name information sent by the DHCPv6 server.

display ipv6 dhcp client statistics

Use display ipv6 dhcp client statistics to display DHCPv6 client statistics.

Syntax

display ipv6 dhcp client statistics [ interface interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

interface interface-type interface-number: Displays the DHCPv6 client statistics of a specific interface.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify any parameters, the command displays DHCPv6 client statistics of all interfaces.

Examples

# Display DHCPv6 client statistics of VLAN-interface 2.

<Sysname> display ipv6 dhcp client statistics interface vlan-interface 2

Interface : Vlan-interface2

Packets Received : 1

Reply : 1

Advertise : 0

Reconfigure : 0

Invalid : 0

Packets Sent : 5

Solicit : 0

Request : 0

Confirm : 0

Renew : 0

Rebind : 0

Information-request : 5

Release : 0

Decline : 0

Table 13 Command output

Field	Description
Interface	Interface that serves as the DHCPv6 client.
Packets Received	Number of received packets.
Reply	Number of received reply packets.
Advertise	Number of received advertise packets.
Reconfigure	Number of received reconfigure packets.
Invalid	Number of invalid packets.
Packets Sent	Number of sent packets.
Solicit	Number of sent solicit packets.
Request	Number of sent request packets.
Confirm	Number of sent confirm packets.
Renew	Number of sent renew packets.
Rebind	Number of sent rebind packets.
Information-request	Number of sent information request packets.
Release	Number of sent release packets.
Decline	Number of sent decline packets.

Related commands

reset ipv6 dhcp client statistics

ipv6 address dhcp-alloc

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

Use the undo ipv6 address dhcp-alloc command to cancel an interface from using DHCPv6.

Syntax

ipv6 address dhcp-alloc [ option-group group-number | rapid-commit ] *

undo ipv6 address dhcp-alloc

Default

An interface does not use DHCPv6 for IP address acquisition.

Views

Interface view

Default command level

2: System level

Parameters

option-group option-group-number: Enables the DHCPv6 client to create a dynamic DHCPv6 option group for saving the network parameters, and assigns an ID to the dynamic DHCPv6 option group in the range of 1 to 100. If you do not specify any option group ID, the DHCPv6 client does not create any dynamic DHCPv6 option group.

rapid-commit: Enables rapid address and prefix assignment.

Examples

# Configure VLAN-interface 10 to use DHCPv6 for address acquisition, enable rapid address assignment, and specify the ID for the DHCPv6 option group as 1. When the client obtains network parameters, it creates an option group and saves the parameters in the group.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] ipv6 address dhcp-alloc rapid-commit option-group 1

ipv6 dhcp client pd

Use ipv6 dhcp client pd to configure an interface to use DHCPv6 for IPv6 prefix acquisition.

Use undo ipv6 dhcp client pd to cancel an interface from using DHCPv6.

Syntax

ipv6 dhcp client pd prefix-number [ option-group group-number | rapid-commit ] *

undo ipv6 dhcp client pd

Default

An interface does not use DHCPv6 for IPv6 prefix acquisition.

Views

Interface view

Default command level

2: System level

Parameters

prefix-number: Specifies an IPv6 prefix ID in the range of 1 to 1024. The client, after obtaining an IPv6 prefix, automatically assigns it the specified ID.

option-group option-group-number: Enables the DHCPv6 client to create a dynamic DHCPv6 option group for saving the network parameters, and assigns an ID to the dynamic DHCPv6 option group in the range of 1 to 100. If no option group ID is specified, the DHCPv6 client does not create any dynamic DHCPv6 option group.

rapid-commit: Enables rapid address and prefix assignment.

Examples

# Configure VLAN-interface10 to use DHCPv6 for IPv6 prefix acquisition. Specify the prefix ID as 1, enable the DHCPv6 client to create a dynamic DHCPv6 option group with the ID 1, and enable rapid address and prefix assignment.

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] ipv6 dhcp client pd 1 rapid-commit option-group 1

reset ipv6 dhcp client statistics

Use reset ipv6 dhcp client statistics to clear DHCPv6 client statistics.

Syntax

reset ipv6 dhcp client statistics [ interface interface-type interface-number ]

Views

User view

Default command level

1: Monitor level

Parameters

interface interface-type interface-number: Clears DHCPv6 client statistics of a specific interface.

Usage guidelines

If you do not specify any parameters, the command clears DHCPv6 client statistics of all interfaces.

After this command is executed, the packets statistics are displayed as 0 for the display ipv6 dhcp client statistics command output.

Examples

# Clear DHCPv6 client statistics of all interfaces.

<Sysname> reset ipv6 dhcp client statistics

Related commands

display ipv6 dhcp client statistics

DHCPv6 snooping configuration commands

display ipv6 dhcp snooping trust

Use display ipv6 dhcp snooping trust to display DHCPv6 snooping trusted ports.

Syntax

display ipv6 dhcp snooping trust [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display DHCPv6 snooping trusted ports.

<Sysname> display ipv6 dhcp snooping trust

Trusted ports include:

Ten-GigabitEthernet1/0/1

Ten-GigabitEthernet1/0/2

display ipv6 dhcp snooping user-binding

Use display ipv6 dhcp snooping user-binding to display DHCPv6 snooping entries.

Syntax

display ipv6 dhcp snooping user-binding { ipv6-address | dynamic } [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

ipv6-address: Displays DHCPv6 snooping entries of the specified IPv6 address.

dynamic: Displays all DHCPv6 snooping entries.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display all DHCPv6 snooping entries.

<Sysname> display ipv6 dhcp snooping user-binding dynamic

IPv6 Address MAC Address Lease VLAN Interface

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

2::1 00e0-fc00-0006 286 1 Ten-GigabitEthernet1/0/1

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

Table 14 Command output

Field	Description
IPv6 Address	IPv6 address in the DHCPv6 snooping entry.
MAC Address	MAC address in the DHCPv6 snooping entry.
Lease	Remaining lease of the DHCPv6 snooping entry, in seconds.
VLAN	VLAN to which the interface belongs.
Interface	Interface through which the DHCPv6 client is connected.

ipv6 dhcp snooping enable

Use ipv6 dhcp snooping enable to enable DHCPv6 snooping globally.

Use undo ipv6 dhcp snooping enable to disable DHCPv6 snooping globally.

Syntax

ipv6 dhcp snooping enable

undo ipv6 dhcp snooping enable

Default

Global DHCPv6 snooping is disabled.

Views

System view

Default command level

2: System level

Usage guidelines

After DHCPv6 snooping is enabled in system view, the DHCPv6 snooping device discards DHCPv6 reply messages received by an untrusted port if any, and does not record these DHCPv6 snooping entries.

Examples

# Enable DHCPv6 snooping globally.

<Sysname> system-view

[Sysname] ipv6 dhcp snooping enable

ipv6 dhcp snooping max-learning-num

Use ipv6 dhcp snooping max-learning-num to configure the maximum number of DHCPv6 snooping entries an interface can learn.

Use undo ipv6 dhcp snooping max-learning-num to restore the default.

Syntax

ipv6 dhcp snooping max-learning-num number

undo ipv6 dhcp snooping max-learning-num

Default

The number of DHCPv6 snooping entries learned by an interface is not limited.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view

Default command level

2: System level

Parameters

number: Maximum number of DHCPv6 snooping entries an interface can learn, in the range of 0 to 4096.

Examples

# Set the maximum number of DHCPv6 snooping entries Layer 2 Ethernet interface GigabitEthernet 1/0/1 can learn to 1000.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 dhcp snooping max-learning-num 1000

ipv6 dhcp snooping trust

Use ipv6 dhcp snooping trust to configure a DHCPv6 trusted port.

Use undo ipv6 dhcp snooping trust to restore the default.

Syntax

ipv6 dhcp snooping trust

undo ipv6 dhcp snooping trust

Default

All interfaces of a device with DHCPv6 snooping enabled globally are untrusted ports.

Views

Layer 2 Ethernet interface view, Layer 2 aggregate interface view

Default command level

2: System level

Usage guidelines

After DHCPv6 snooping is enabled, to make sure DHCPv6 clients can obtain IPv6 addresses from an authorized DHCPv6 server, you must configure the port that connects to the authorized DHCPv6 server as a trusted port.

Examples

# Configure Ethernet interface GigabitEthernet 1/0/1 as a trusted port.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 dhcp snooping trust

ipv6 dhcp snooping vlan enable

Use ipv6 dhcp snooping vlan enable to enable DHCPv6 snooping for a specific VLAN.

Use undo ipv6 dhcp snooping vlan enable to disable DHCPv6 snooping for a specific VLAN.

Syntax

ipv6 dhcp snooping vlan enable

undo ipv6 dhcp snooping vlan enable

Default

DHCPv6 snooping is disabled for a VLAN.

Views

VLAN view

Default command level

2: System level

Usage guidelines

After DHCPv6 snooping is enabled globally and then enabled for a VLAN, the DHCPv6 snooping device records DHCPv6 snooping entries according to the DHCPv6 packets received in the VLAN. Meanwhile, upon receiving a DHCPv6 request from a client in the VLAN, the device forwards the packet through trusted ports rather than any untrusted port in the VLAN, thus reducing network traffic.

Examples

# Enable DHCPv6 snooping for VLAN 1.

<Sysname> system-view

[Sysname] vlan 1

[Sysname-vlan1] ipv6 dhcp snooping vlan enable

reset ipv6 dhcp snooping user-binding

Use reset ipv6 dhcp snooping user-binding to clear DHCPv6 snooping entries.

Syntax

reset ipv6 dhcp snooping user-binding { ipv6-address | dynamic }

Views

User view

Default command level

2: System level

Parameters

ipv6-address: Clears DHCPv6 snooping entries of the specified IPv6 address.

dynamic: Clears all DHCPv6 snooping entries.

Examples

# Clear all DHCPv6 snooping entries.

<Sysname> reset ipv6 dhcp snooping user-binding dynamic

04-Layer 3 Command Reference

DHCPv6 configuration commands

domain-name

display ipv6 dhcp client

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us