sharekey key: Specifies the shared key of the remote BIMS server. The key argument is a string containing 1 to 16 characters. It cannot be null.

Description

Use the bims-server command to configure the connection between a DHCP global address pool and a BIMS server.

Use the undo bims-server command to remove the configuration of the connection between a DHCP global address pool and a BIMS server.

By default, no connection is configured.

Related command: dhcp server bims-server.

& Note:

Branch intelligent management system (BIMS) is a network management software provided by H3C Technologies Co., Ltd.

Example

# Set the IP address of the remote BIMS server in the DHCP global address pool to 192.168.0.1, the port number to 651, and the shared key to aaa.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool test

[H3C-dhcp-pool-test] bims-server ip 192.168.0.1 port 651 sharekey aaa

1.1.2 dhcp enable

Syntax

dhcp enable

undo dhcp enable

View

System view

Parameter

None

Description

Use the dhcp enable command to enable DHCP.

Use the undo dhcp enable command to disable DHCP.

By default, DHCP is enabled.

You must first enable DHCP before performing other DHCP-related configurations. This configuration is necessary for both DHCP servers and DHCP relays.

& Note:

To improve security and avoid malicious attack to the unused SOCKETs, S3600 Ethernet switches provide the following functions:

l UDP 67 and UDP 68 ports used by DHCP are enabled only when DHCP is enabled.

l UDP 67 and UDP 68 ports are disabled when DHCP is disabled.

The corresponding implementation is as follows:

l After DHCP is enabled by executing the dhcp enable command, if the DHCP server and DHCP relay functions are not configured, UDP 67 and UDP 68 ports is kept disabled; if the DHCP server and DHCP relay functions are configured, UDP 67 and UDP 68 ports are enabled.

l After DHCP is disabled by executing the undo dhcp enable command, even if the DHCP server and DHCP relay functions are configured, UDP 67 and UDP 68 ports will be disabled.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enable DHCP.

[H3C] dhcp enable

1.1.3 dhcp select global

Syntax

VLAN interface view:

dhcp select global

undo dhcp select

System view:

dhcp select global { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp select { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view and VLAN interface view

Parameter

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s) to operate in global address pool mode. The interface-type and interface-number arguments are the type and number of an interface. The to keyword separates the start and the end of an interface range.

all: Specifies all ports to operate in global address pool mode.

Description

Use the dhcp select global command to configure the specified interface(s) or all interfaces to operate in global DHCP address pool mode. Upon receiving a DHCP packet from a DHCP client through an interface operating in global DHCP address pool mode, the DHCP server chooses an IP address from a global DHCP address pool of the local DHCP server and assigns the address to the DHCP client.

Use the undo dhcp select command to restore the default DHCP packet processing mode.

By default, an interface operates in local DHCP server global address pool mode.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure all interfaces to operate in global DHCP address pool mode, so that when a DHCP packet is received from a DHCP client through any interface, the DHCP server assigns an IP address in local global DHCP address pools to the DHCP client.

[H3C] dhcp select global all

1.1.4 dhcp select interface

Syntax

VLAN interface view:

dhcp select interface

undo dhcp select

System view:

dhcp select interface { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp select { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view and VLAN interface view

Parameter

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s) to operate in interface address pool mode.

all: Specifies all interfaces to operate in interface address pool mode.

Description

Use the dhcp select interface command to configure the specified interface(s) to operate in DHCP interface address pool mode. Upon receiving a DHCP packet from a DHCP client through an interface operating in interface address pool mode, the DHCP server chooses an IP address from the interface address pool of the local DHCP server and assigns the address to the DHCP client.

Use the undo dhcp select command to restore the default DHCP packet processing mode.

By default, an interface operates in local DHCP server global address pool mode.

& Note:

To improve security and avoid malicious attack to the unused SOCKETs, S3600 Ethernet switches provide the following functions:

l UDP 67 and UDP 68 ports used by DHCP are enabled only when DHCP is enabled.

l UDP 67 and UDP 68 ports are disabled when DHCP is disabled.

The corresponding implementation is as follows:

l After a DHCP interface address pool is created by executing the dhcp select interface command, UDP 67 and UDP 68 ports used by DHCP are enabled.

l After a DHCP interface address pool is deleted by executing the undo dhcp select interface command and all other DHCP functions are disabled, UDP 67 and UDP 68 ports used by DHCP are disabled accordingly.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure all interfaces to operate in interface DHCP address pool mode, so that when a DHCP packet is received from a DHCP client through any interface, the DHCP server assigns an IP address in the local interface DHCP address pool to the DHCP client.

[H3C] dhcp select interface all

1.1.5 dhcp server bims-server

Syntax

dhcp server bims-server ip ip-address [ port port-number ] sharekey key { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server bims-server { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view

Parameter

port port-number: Specifies the port number of the remote BIMS server.

sharekey key: Specifies the shared key of the remote BIMS server. The key argument is a string containing 1 to 16 characters. It cannot be null.

interface interface-type interface-number [ to interface-type interface-number ]: Specifies an interface operating in the interface address pool mode.

all: Specifies all interfaces.

Description

Use the dhcp server bims-server command to configure the connection between a DHCP interface address pool and a remote BIMS server.

Use the undo dhcp server bims-server command to remove the configuration of the connection between a DHCP interface global address pool and a BIMS server.

Related command: bims-server.

& Note:

Branch intelligent management system (BIMS) is a network management software provided by H3C Technologies Co., Ltd.

Example

# Set the IP address of the remote BIMS server in DHCP interface address pool 2 to 192.168.0.2, the port number to 111, and the shared key to aaa.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server bims-server ip 192.168.0.2 port 111 sharekey aaa interface

Vlan-interface 2

1.1.6 dhcp server detect

Syntax

dhcp server detect

undo dhcp server detect

View

System view

Parameter

None

Description

Use the dhcp server detect command to enable the private DHCP server detecting function.

Use the undo dhcp server detect command to disable the private DHCP server detecting function.

By default, the private DHCP server detecting function is disabled.

With the private DHCP server detecting function enabled, a DHCP server tracks the information (such as the IP addresses and interfaces) of DHCP servers to enable the administrator to detect private DHCP servers in time and take proper measures.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enable the private DHCP server detecting function.

[H3C] dhcp server detect

1.1.7 dhcp server dns-list

Syntax

In VLAN interface view, use the following commands to configure DNS server IP address(es) for the current DHCP interface address pool.

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

undo dhcp server dns-list { ip-address | all }

In system view, use the following commands to configure DNS server IP address(es) for multiple DHCP interface address pools.

dhcp server dns-list ip-address&<1-8> { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server dns-list { ip-address | all } { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view/VLAN interface view

Parameter

ip-address&<1-8>: IP address of a DNS server. &<1-8> means you can provide up to eight DNS server IP addresses. When inputting more than one DNS server IP address, separate two neighboring IP addresses with a space.

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s), through which you can specify the corresponding interface address pools.

all: (In comparison with the ip-address argument) Specifies all DNS server IP addresses.

all: (In comparison with the interface keyword) Specifies all interface address pools.

Description

Use the dhcp server dns-list command to configure DNS server IP address(es) for the DHCP address pool(s) of specified interface(s).

Use the undo dhcp server dns-list command to remove the DNS server IP address(es) configured for the DHCP address pool(s) of the specified interface(s).

By default, no DNS server IP address is configured for a DHCP interface address pool.

If you execute the dhcp server dns-list command repeatedly, the new configuration overwrites the previous one.

Related command: dns-list.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enter VLAN-interface1 view.

[H3C] interface Vlan-interface 1

# Configure the DNS server IP address 1.1.1.254 for the DHCP address pool of the VLAN-interface1.

[H3C-Vlan-interface1] dhcp server dns-list 1.1.1.254

1.1.8 dhcp server domain-name

Syntax

In VLAN interface view, use the following commands to configure a domain name for the DHCP clients whose IP addresses are from the current interface address pool.

dhcp server domain-name domain-name

undo dhcp server domain-name

In system view, use the following commands to configure a domain name for the DHCP clients whose IP addresses are from multiple interface address pools.

dhcp server domain-name domain-name { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server domain-name { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view/VLAN interface view

Parameter

domain-name: Domain name of the DHCP clients whose IP addresses are from the specified interface address pool(s). This argument is a string of 3 to 50 characters.

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s), through which you can specify the corresponding interface address pool(s).

all: Specifies all interface address pools.

Description

Use the dhcp server domain-name command to configure a domain name for the DHCP clients whose IP addresses are from the specified interface address pool(s).

Use the undo dhcp server domain-name command to remove the configured domain name.

By default, no domain name is configured for the DHCP clients.

Related command: domain-name.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enter VLAN-interface1 view.

[H3C] interface Vlan-interface 1

# Configure the domain name aabbcc.com for the DHCP clients whose IP addresses are from the DHCP address pool of the current VLAN interface.

[H3C-Vlan-interface1] dhcp server domain-name aabbcc.com

1.1.9 dhcp server expired

Syntax

In VLAN interface view, use the following commands to configure the lease time of the IP addresses in the current interface address pool.

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

undo dhcp server expired

In system view, use the following commands to configure the lease time of the IP addresses in multiple interface address pools.

dhcp server expired { day day [ hour hour [ minute minute ] ] | unlimited } { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server expired { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view/VLAN interface view

Parameter

day day: Specifies the number of days. The day argument ranges from 0 to 365.

hour hour: Specifies the number of hours. The hour argument ranges from 0 to 23.

minute minute: Specifies the number of minutes. The minute argument ranges from 0 to 59.

unlimited: Specifies that the lease time is unlimited. (But actually, the system limits the maximum lease time to about 25 years.)

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s), through which you can specify the corresponding interface address pool(s).

all: Specifies all interface address pools.

Description

Use the dhcp server expired command to configure the lease time of the IP addresses in the specified interface address pool(s).

Use the undo dhcp server expired command to restore the default lease time.

The default lease time is one day.

Note that an IP address is considered to be expired if its lease time is after the year 2106.

Related command: expired.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Set the lease time of the IP addresses in all interface address pools to be 1 day, 2 hours and 3 minutes.

[H3C] dhcp server expired day 1 hour 2 minute 3 all

1.1.10 dhcp server forbidden-ip

Syntax

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

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

View

System view

Parameter

low-ip-address: IP address that is not available for being assigned to DHCP clients automatically (An IP address of this kind is known as a forbidden IP address). This argument also marks the lower end of the range of the forbidden IP addresses.

high-ip-address: IP address that is not available for being assigned to DHCP clients. This argument also marks the higher end of the range of the forbidden IP addresses. Note that this argument cannot be less than the low-ip-address argument. If you do not provide this argument, only the IP address specified by the low-ip-address argument is forbidden.

Description

Use the dhcp server forbidden-ip command to forbid the specified IP addresses in a DHCP address pool to be automatically assigned.

Use the undo dhcp server forbidden-ip command to cancel the forbiddance.

By default, all IP addresses in an address pool are allowed to be automatically assigned.

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

& Note:

l When you execute the undo dhcp server forbidden-ip command, make sure that the specified address range does not contain any statically-bound IP address.

l You can configure multiple IP address segments that are not to be automatically configured by executing the dhcp server forbidden-ip command several times.

l If an IP address that is not to be automatically assigned has been configured as a statically-bound IP address, the DHCP server still assigns this IP address to the client whose MAC address has been bound.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Forbid the IP addresses in the range 10.110.1.1 to 10.110.1.63 to be automatically assigned.

[H3C] dhcp server forbidden-ip 10.110.1.1 10.110.1.63

1.1.11 dhcp server ip-pool

Syntax

dhcp server ip-pool pool-name

undo dhcp server ip-pool pool-name

View

System view

Parameter

pool-name: Name of a DHCP address pool, which uniquely identifies the address pool. This argument is a string of 1 to 35 characters.

Description

Use the dhcp server ip-pool command to create a global DHCP address pool and enter DHCP address pool view. If the address pool identified by the pool-name argument already exists, this command leads you to DHCP address pool view.

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

By default, no global DHCP address pool is created.

Related command: dhcp enable.

& Note:

To improve security and avoid malicious attack to the unused SOCKETs, S3600 Ethernet switches provide the following functions:

l UDP 67 and UDP 68 ports used by DHCP are enabled only when DHCP is enabled.

l UDP 67 and UDP 68 ports are disabled when DHCP is disabled.

The corresponding implementation is as follows:

l After a DHCP address pool is created by executing the dhcp server ip-pool command, the UDP 67 and UDP 68 ports used by DHCP are enabled.

l After a DHCP address pool is deleted by executing the undo dhcp server ip-pool command and all other DHCP functions are disabled, UDP 67 and UDP 68 ports used by DHCP are disabled.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Create DHCP address pool 0.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-pool-0]

1.1.12 dhcp server nbns-list

Syntax

In VLAN interface view, use the following commands to configure NetBIOS server IP address(es) for the current DHCP interface address pool.

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

undo dhcp server nbns-list { ip-address | all }

In system view, use the following commands to configure NetBIOS server IP addresses for multiple DHCP interface address pools.

dhcp server nbns-list ip-address&<1-8> { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server nbns-list { ip-address | all } { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view/VLAN interface view

Parameter

ip-address&<1-8>: IP address of a NetBIOS server. &<1-8> means you can provide up to eight NetBIOS server IP addresses. When inputting more than one NetBIOS server IP address, separate two neighboring IP addresses with a space.

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s), through which you can specify the corresponding interface address pool(s).

all: (In comparison with the ip-address argument) Specifies all NetBIOS server IP addresses.

all: (In comparison with the interface keyword) Specifies all interface address pools.

Description

Use the dhcp server nbns-list command to configure NetBIOS server IP address(es) for the specified DHCP interface address pool(s).

Use the undo dhcp server nbns-list command to remove the NetBIOS server IP address(es) configured for the specified DHCP interface address pool(s).

By default, no NetBIOS server IP address is configured for a DHCP interface address pool.

If you execute the dhcp server nbns-list command repeatedly, the new configuration overwrites the previous one.

Related command: nbns-list and dhcp server netbios-type.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the NetBIOS server IP address 10.12.1.99 for all the DHCP interface address pools.

[H3C] dhcp server nbns-list 10.12.1.99 all

1.1.13 dhcp server netbios-type

Syntax

In VLAN interface view, use the following commands to configure the NetBIOS node type of the DHCP clients whose IP addresses are from the current interface address pool.

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

undo dhcp server netbios-type

In system view, use the following commands to configure the NetBIOS node type of the DHCP clients whose IP addresses are from multiple interface address pools.

dhcp server netbios-type { b-node | h-node | m-node | p-node } { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server netbios-type { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view/VLAN interface view

Parameter

b-node: Specifies the broadcast type. Nodes of this type acquire host name-to-IP address mapping by broadcasting.

p-node: Specifies the peer-to-peer type. Nodes of this type acquire host name-to-IP address mapping by communicating with the NetBIOS server.

m-node: Specifies the m-typed mixed type. Nodes of this type are p-nodes with some broadcasting features. (The character m here stands for mixed.)

h-node: Specifies the hybrid type. Nodes of this type are b-nodes with peer-to-peer communicating features.

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s), through which you can specify the corresponding interface address pools.

all: Specifies all interface address pools.

Description

Use the dhcp server netbios-type command to configure the NetBIOS node type of the DHCP clients whose IP addresses are from the specified interface address pool(s).

Use the undo dhcp server netbios-type command to restore the default NetBIOS node type.

By default, no NetBIOS node type is specified and the default NetBIOS node type is hybrid node (h-node).

Related command: netbios-type and dhcp server nbns-list.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Specify p-node as the NetBIOS node type of the DHCP clients whose IP addresses are from the DHCP address pool of VLAN-interface1.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server netbios-type p-node

1.1.14 dhcp server option

Syntax

In VLAN interface view, use the following commands to customize DHCP options for the current DHCP interface address pool.

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

undo dhcp server option code

In system view, use the following commands to customize DHCP options for multiple DHCP interface address pools.

dhcp server option code { ascii ascii-string | hex hex-string&<1-10> | ip-address ip-address&<1-8> } { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server option code { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view/VLAN interface view

Parameter

code: Customized option number ranging from 2 to 254. Note that this argument cannot be 3, 6, 15, 44, 46, 50 through 55, 57 through 61, 82, 184, or 217. For commands related to option 184, refer to 1.1.18 dhcp server voice-config command and the 1.1.19 dhcp server voice-config interface command. You cannot configure option 184 by executing the dhcp server option command.

ascii ascii-string: Specifies a string that is of 1 to 63 characters. Note that each character of the string must be an ASCII character.

hex hex-string&<1-10>: Specifies strings, each of which comprises 1 to 8 hexadecimal digits. &<1-10> means you can provide up to 10 such strings. When inputting more than one string, separate two neighboring strings with a space. Note that the total number of the hexadecimal digits (spaces not included) cannot exceed 64.

ip-address ip-address&<1-8>: Specifies IP addresses. &<1-8> means you can provide up to eight IP addresses. When inputting more than one IP address, separate two neighboring IP addresses with a space.

interface interface-type interface-number [ to interface-type interface-number ]: Specifies the interface(s), through which you can specify the corresponding interface address pools.

all: Specifies all interface address pools.

Description

Use the dhcp server option command to customize DHCP options for the specified DHCP interface address pool(s).

Use the undo dhcp server option command to remove the customized DHCP options.

If you execute the dhcp server option command repeatedly, the new configuration overwrites the previous one.

Related command: option.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure option 100 to be 0x11 and 0x22 for all DHCP interface address pools.

[H3C] dhcp server option 100 hex 11 22 all

1.1.15 dhcp server ping

Syntax

dhcp server ping { packets number | timeout milliseconds }

undo dhcp server ping { packets | timeout }

View

System view

Parameter

packets number: Specifies the number of the ping operation. The number argument ranges from 0 to 10 and defaults to 2. Value 0 means no ping operation will be performed.

timeout milliseconds: Specifies the timeout time (in milliseconds) of each ping operation. The milliseconds argument ranges from 0 to 10,000 and defaults to 500.

Description

Use the dhcp server ping command to set the maximum number of the ping operations and the maximum response timeout time of each ping operation.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Set the maximum number of the ping operations to 10, and the timeout time of a ping operation to 300 milliseconds.

[H3C] dhcp server ping packets 10

[H3C] dhcp server ping timeout 300

1.1.16 dhcp server relay information enable

Syntax

dhcp server relay information enable

undo dhcp server relay information enable

View

System view

Parameter

None

Description

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

Use the undo dhcp server relay information enable command to disable the DHCP server from supporting option 82.

By default, the DHCP server supports option 82.

Example

# Disable the DHCP server from supporting option 82.

<H3C>system-view

System View: return to User View with Ctrl+Z.

[H3C] undo dhcp server relay information enable

1.1.17 dhcp server static-bind

Syntax

dhcp server static-bind ip-address ip-address { client-identifier client-identifier | mac-address mac-address }

undo dhcp server static-bind { client-identifier client-identifier | ip-address ip-address | mac-address mac-address }

View

VLAN interface view

Parameter

ip-address: IP address to be statically bound. Note that the specified IP address must belong to the same network segment as that of the VLAN interface.

client-identifier: Client ID to be statically bound, in the format of H-H-H. It contains 3 to 160 hexadecimal numbers.

mac-address: MAC address to which the IP address is statically bound.

Description

Use the dhcp server static-bind command to statically bind an IP address of the current address pool to a MAC address.

Use the undo dhcp server static-bind command to cancel an IP-MAC address binding.

By default, no IP address in an address pool is statically bound.

It should be noted that:

l An IP address can be statically bound to only one MAC address or one client ID. A MAC address or client ID can be bound with only one IP address statically.

l The IP address to be statically bound cannot be an interface IP address of the device. Otherwise the static binding does not take effect; the bound MAC address can still obtain another IP address.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Statically bind the client ID aaaa-bbbb to the IP address 10.1.1.1 (Assume that the interface address pool of VLAN-interface1 already exists and the IP address belongs to the address pool).

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server static-bind ip-address 10.1.1.1 client-identifier aaaa-bbbb

# Statically bind the IP address 10.1.1.1 to the MAC address 0000-e03f-0305. (Assume that the interface address pool of VLAN-interface1 already exists and the IP address belongs to the address pool.)

[H3C-Vlan-interface1] dhcp server static-bind ip-address 10.1.1.1 mac-address 0000-e03f-0305

1.1.18 dhcp server voice-config

Syntax

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

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

View

VLAN interface view

Parameter

ncp-ip: Specifies the IP address of the network call processor (NCP).

as-ip: Specifies the IP address of the alternative NCP server.

voice-vlan: Specifies the voice VLAN.

fail-over: Specifies a fail-over call routing.

ip-address: IP address of the NCP, alternate server, or fail-over.

vlan-id: ID of the voice VLAN, in the range of 2 to 4,094.

enable: Enables a VLAN.

disable: Disables a VLAN.

dialer-string: Fail-over dialer string. The value contains 0 to 9 and the wildcard asterisk (*).

Description

Use the dhcp server voice-config command to enable the DHCP server to assign IP addresses with option 184 and its sub-options from the current interface address pool.

Use the undo dhcp server voice-config command to disable the DHCP server from assigning IP addresses with option 184 and its sub-options from the current interface address pool.

The DHCP server answers option 184 and the corresponding sub-options only after the DHCP client requests for option 184.

Before configuring other sub-options, you must configure the sub-option ncp-ip; otherwise other sub-options do not take effect.

By default, the DHCP server does not support option 184 and the corresponding sub-options.

Related command: voice-config.

Example

# Enter system view

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enter VLAN-interface1 view.

[H3C] interface Vlan-interface 1

# Enable the DHCP server to support all the sub-options of option 184 in VLAN-interface1. The NCP IP address is 1.1.1.1 and the IP address of the alternate server is 2.2.2.2. The voice VLAN is enabled, with the ID being 3. The fail-over IP address is 3.3.3.3 and the dial number string is 99*.

[H3C-Vlan-interface1] dhcp select interface

[H3C-Vlan-interface1] dhcp server voice-config ncp-ip 1.1.1.1

[H3C-Vlan-interface1] dhcp server voice-config as-ip 2.2.2.2

[H3C-Vlan-interface1] dhcp server voice-config voice-vlan 3 enable

[H3C-Vlan-interface1] dhcp server voice-config fail-over 3.3.3.3 99*

1.1.19 dhcp server voice-config interface

Syntax

dhcp server voice-config { ncp-ip ip-address | as-ip ip-address | voice-vlan vlan-id { enable | disable } | fail-over ip-address dialer-string } { interface interface-type interface-number [ to interface-type interface-number ] | all }

undo dhcp server voice-config [ ncp-ip | as-ip | voice-vlan | fail-over ] { interface interface-type interface-number [ to interface-type interface-number ] | all }

View

System view

Parameter

ncp-ip: Specifies the IP address of the network call processor (NCP).

as-ip: Specifies the IP address of the alternate server (AS).

voice-vlan: Specifies the voice VLAN.

fail-over: Specifies the Fail-over call routing.

ip-address: IP address of the NCP, alternate server, or Fail-over.

vlan-id: ID of the voice VLAN. This argument ranges from 2 to 4094.

enable: Enables the voice VLAN.

disable: Disables the voice VLAN.

dialer-string: Dial number string. This argument comprises of number 0 through 9 and the * character (acting as the wildcard).

interface-type interface-number [ to interface-type interface-number ]: Specifies all interfaces in the interface range identified by the two interface indexes separated by the to keyword (including the end interfaces). The interfaces must be VLAN interfaces.

all: Specifies that the sub-options apply to all VLAN interfaces.

Description

Use the dhcp server voice-config interface command to configure option 184 and its sub-options, which will be sent to DHCP clients by a DHCP server as well when the DHCP server assigns IP addresses of specified address pools to DHCP clients.

Use the undo dhcp server voice-config interface command to disable a DHCP server from sending option 184 and the specified sub-option to DHCP clients when the DHCP server assigns IP addresses to DHCP clients.

A DHCP server sends Option 184 and the corresponding sub-options to a DHCP client only when the latter requests for option 184.

The NCP-IP sub-option is necessary for all other sub-options. You need to configure the NCP-IP sub-option first to enable other sub-options.

By default, option 184 and its sub-options are not supported by a DHCP server.

Related command: voice-config.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the DHCP server to support option 184 and all its sub-options when the DHCP server assigns IP addresses to DHCP clients through VLAN-interface1, with the sub-options being set as follows:

l NCP-IP: 1.1.1.1

l AS-IP: 2.2.2.2

l Voice VLAN configuration: voice VLAN: Enabled; voice VLAN ID: 3

l Fail-over call routing: IP address 3.3.3.3; dialer-string: 99*

[H3C] dhcp select interface Vlan-interface1

[H3C] dhcp server voice-config ncp-ip 1.1.1.1 interface Vlan-interface1

[H3C] dhcp server voice-config as-ip 2.2.2.2 interface Vlan-interface1

[H3C] dhcp server voice-config voice-vlan 3 enable interface Vlan-interface1

[H3C] dhcp server voice-config fail-over 3.3.3.3 99* interface Vlan-interface1

1.1.20 display dhcp server conflict

Syntax

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

View

Any view

Parameter

all: Specifies all IP addresses.

ip ip-address: Specifies one IP address.

Description

Use the display dhcp server conflict command to display the statistics of IP address conflicts on the DHCP server.

Related command: reset dhcp server conflict.

Example

# Display the statistics of IP address conflicts.

<H3C> display dhcp server conflict all

Address Discover Time

10.110.1.2 Jan 11 2003 11:57:07 PM

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

Field	Description
Address	Conflicting IP address
Discover Time	Time when the conflict is detected

1.1.21 display dhcp server expired

Syntax

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

View

Any view

Parameter

ip ip-address: Specifies an IP address.

pool [ pool-name ]: Specifies a global address pool. The pool-name argument, a string of 1 to 35 characters, is the name of an address pool. If you do not provide this argument, this command applies to all global address pools.

interface [ interface-type interface-number ]: Specifies a VLAN interface. If you do not specify a VLAN interface, this command applies to all VLAN interfaces.

all: Specifies all DHCP address pools.

Description

Use the display dhcp server expired command to display the lease expiration information about one IP address, or the lease expiration information about all IP addresses in one or all DHCP address pools. When all the IP addresses in an address pool are assigned, the DHCP server assigns the expired IP addresses to DHCP clients.

Example

# Display the lease expiration information about the IP addresses in all DHCP address pools.

<H3C> display dhcp server expired all

Global pool:

IP address Client-identifier/ Lease expiration Type

Hardware address

Interface pool:

IP address Client-identifier/ Lease expiration Type

Hardware address

--- total 0 entry ---

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

Field	Description
Global pool	The information about the expired IP addresses of global address pools
Interface pool	The information about the expired IP addresses of interface address pools
IP address	Bound IP addresses
Client-identifier/Hardware address	User ID or MAC addresses to which IP addresses are bound
Lease expiration	The time when a lease time expires
Type	Address binding type

1.1.22 display dhcp server free-ip

Syntax

display dhcp server free-ip

View

Any view

Parameter

None

Description

Use the display dhcp server free-ip command to display the free (that is, unassigned) IP addresses.

Example

# Display the free IP addresses.

<H3C> display dhcp server free-ip

IP Range from 1.0.0.0 to 2.2.2.1

IP Range from 2.2.2.3 to 2.255.255.255

IP Range from 4.0.0.0 to 4.255.255.255

IP Range from 5.5.5.0 to 5.5.5.0

IP Range from 5.5.5.2 to 5.5.5.255

1.1.23 display dhcp server ip-in-use

Syntax

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

View

Any view

Parameter

ip ip-address: Specifies an IP address.

interface [ interface-type interface-number ]: Specifies a VLAN interface. If you do not specify a VLAN interface, this command applies to all VLAN interfaces.

all: Specifies all address pools.

Description

Use the display dhcp server ip-in-use command to display the address binding information of one IP address, the specified DHCP address pool(s) or all DHCP address pools.

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

Example

# Display the address binding information of all DHCP address pools.

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

Global pool:

IP address Client-identifier/ Lease expiration Type

Hardware address

2.2.2.2 4444-4444-4444 NOT Used Manual

Interface pool:

IP address Client-identifier/ Lease expiration Type

Hardware address

5.5.5.1 0050-ba28-930a Jun 5 2003 10:56: 7 AM Auto:COMMITED

--- total 2 entry ---

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

Field	Description
Global pool	Address binding information of global DHCP address pools
Interface pool	Address binding information of interface DHCP address pools
IP address	Bound IP address
Client-identifier/Hardware address	User ID or MAC address to which the IP address is bound
Lease expiration	Time when the lease expires
Type	Address binding type

1.1.24 display dhcp server statistics

Syntax

display dhcp server statistics

View

Any view

Parameter

None

Description

Use the display dhcp server statistics command to display the statistics on a DHCP server.

Related command: reset dhcp server statistics.

Example

# Display the statistics on a DHCP server.

<H3C> display dhcp server statistics

Global Pool:

Pool Number: 5

Binding

Auto: 0

Manual: 1

Expire: 0

Interface Pool:

Pool Number: 1

Binding

Auto: 1

Manual: 0

Expire: 0

Boot Request: 6

Dhcp Discover: 1

Dhcp Request: 4

Dhcp Decline: 0

Dhcp Release: 1

Dhcp Inform: 0

Boot Reply: 4

Dhcp Offer: 1

Dhcp Ack: 3

Dhcp Nak: 0

Bad Messages: 0

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

Field	Description
Global Pool	Statistics about global address pools
Interface Pool	Statistics about interface address pools
Pool Number	Number of address pools
Auto	Number of the automatically bound IP addresses
Manual	Number of the manually bound IP addresses
Expire	Number of the expired IP addresses
Boot Request: 6 Dhcp Discover: 1 Dhcp Request: 4 Dhcp Decline: 0 Dhcp Release: 1 Dhcp Inform: 0	Statistics about the DHCP packets received from DHCP clients
Boot Reply: 4 Dhcp Offer: 1 Dhcp Ack: 3 Dhcp Nak: 0	Statistics about the DHCP packets sent to DHCP clients
Bad Messages	Number of the error DHCP packets

1.1.25 display dhcp server tree

Syntax

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

View

Any view

Parameter

interface [ interface-type interface-number ]: Specifies a VLAN interface. If you do not specify a VLAN interface, this command applies to all VLAN interfaces.

all: Specifies all address pools.

Description

Use the display dhcp server tree command to display information about address pool tree.

Example

# Display the information about address pool tree.

<H3C> display dhcp server tree all

Global pool:

Pool name: 5

network 10.10.1.0 mask 255.255.255.0

Child node:6

Sibling node:7

option 1 ip-address 255.0.0.0

expired 1 0 0

Pool name: 6

static-bind ip-address 10.10.1.2 mask 255.0.0.0

static-bind mac-address 000f-e2fc-0001

Parent node:5

option 1 ip-address 255.255.0.0

expired 1 0 0

Pool name: 7

network 10.10.1.64 mask 255.255.255.192

PrevSibling node:5

option 1 ip-address 255.0.0.0

gateway-list 2.2.2.2

dns-list 1.1.1.1

domain-name 444444

nbns-list 3.3.3.3

expired 1 0 0

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

Field	Description
Global pool	Information about global address pools
Interface pool	Information about interface address pools
Pool name	Address pool name
network	Assignable IP address range
static-bind ip-address 10.10.1.2 mask 255.0.0.0 static-bind mac-address 000f-e2fc-0001	Statically bound IP and MAC addresses
Child node:6	The address pool 6 is the child node of this node. This field can display the information about the following types of node: Child node: Displays the information about an address pool that is a child of the current address pool. Parent node: Displays the information about the address pool that is the parent of the current address pool. Sibling node: Displays the information about the next sibling address pool of the current address pool. (The order of sibling address pools are determined by the time when they are configured.) PrevSibling node: Displays the information about the previous sibling address pool of the current address pool.
option	Customized DHCP options
expired	The address lease time (in terms of number of days, hours, and minutes)
gateway-list	List of the gateways configured for the DHCP clients
dns-list	List of the DNS servers configured for the DHCP clients
domain-name	The domain name configured for the DHCP clients
nbns-list	List of the NetBIOS servers configured for the DHCP clients

1.1.26 dns-list

Syntax

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

undo dns-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address&<1-8>: IP address of a DNS server. &<1-8> string means you can provide up to eight DNS server IP addresses. When inputting more than one IP address, separate two neighboring IP addresses with a space.

all: Specifies all configured DNS server IP addresses.

Description

Use the dns-list command to configure one or multiple DNS server IP addresses for a global DHCP address pool.

Use the undo dns-list command to remove one or all DNS server IP addresses configured for the DHCP address pool.

By default, no DNS server IP address is configured.

If you execute the dns-list command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the DNS server IP address 1.1.1.254 for global DHCP address pool 0.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-pool-0] dns-list 1.1.1.254

1.1.27 domain-name

Syntax

domain-name domain-name

undo domain-name

View

DHCP address pool view

Parameter

domain-name: Domain name for the DHCP clients of a global DHCP address pool, a string of 3 to 50 characters.

Description

Use the domain-name command to configure a domain name for the DHCP clients of a global DHCP address pool.

Use the undo domain-name command to remove the domain name.

By default, no domain name is configured for the DHCP clients of a global DHCP address pool.

Related command: dhcp server ip-pool and dhcp server domain-name.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the domain name mydomain.com for the DHCP clients of the global DHCP address pool 0.

[H3C] dhcp server ip-pool 0

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

1.1.28 expired

Syntax

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

undo expired

View

DHCP address pool view

Parameter

day day: Specifies the number of days. The day argument ranges from 0 to 365.

hour hour: Specifies the number of hours. The hour argument ranges from 0 to 23.

minute minute: Specifies the number of minutes. The minute argument ranges from 0 to 59.

unlimited: Specifies that the lease time is unlimited. (But actually, the system limits the maximum lease time to about 25 years.)

Description

Use the expired command to configure the lease time of the IP addresses in a global DHCP address pool.

Use the undo expired command to restore the default lease time.

The default lease time is one day.

Note that an IP address is considered to be expired if its lease time is after the year 2106.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Set the lease time of the IP addresses in the global DHCP address pool 0 to 1 day, 2 hours and 3 minutes.

[H3C] dhcp server ip-pool 0

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

1.1.29 gateway-list

Syntax

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

undo gateway-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address&<1-8>: IP address of a gateway. &<1-8> means you can provide up to eight gateway IP addresses. When inputting more than one IP address, separate two neighboring IP addresses with a space.

all: Specifies all configured gateway IP addresses.

Description

Use the gateway-list command to configure one or multiple gateway IP addresses for the DHCP clients of a DHCP address pool.

Use the undo gateway-list command to remove one or all the configured gateway IP addresses configured for the DHCP address pool.

By default, no gateway IP address is configured.

If you execute the gateway-list command repeatedly, the new configuration overwrites the previous one.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the gateway IP address 10.110.1.99 for the global DHCP address pool 0.

[H3C] dhcp server ip-pool 0

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

1.1.30 nbns-list

Syntax

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

undo nbns-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address&<1-8>: IP address of a NetBIOS server. &<1-8> means you can provide up to eight NetBIOS server IP addresses. When inputting more than one IP address, separate two neighboring IP addresses with a space.

all: Specifies all configured NetBIOS server IP addresses.

Description

Use the nbns-list command to configure one or multiple NetBIOS server IP addresses for the DHCP clients of a global DHCP address pool.

Use the undo nbns-list command to remove one or all NetBIOS server IP addresses configured for the DHCP clients.

By default, no NetBIOS server IP address is configured.

If you execute the nbns-list command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the NetBIOS server IP address 10.12.1.99 for the global DHCP address pool 0.

[H3C] dhcp server ip-pool 0

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

1.1.31 netbios-type

Syntax

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

undo netbios-type

View

DHCP address pool view

Parameter

b-node: Specifies the broadcast type. Nodes of this type acquire host name-to-IP address mapping by broadcasting.

p-node: Specifies the peer-to-peer type. Nodes of this type acquire host name-to-IP address mapping by communicating with the NetBIOS server.

m-node: Specifies the mixed type. Nodes of this type are p-nodes with some broadcasting features.

h-node: Specifies the hybrid type. Nodes of this type are b-nodes with peer-to-peer communicating features.

Description

Use the netbios-type command to configure the DHCP clients of a global address pool to be of specified NetBIOS node type.

Use the undo netbios-type command to restore the default NetBIOS node type.

By default, no NetBIOS node type is specified. In this case, the client uses h-node.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the DHCP clients of the global DHCP address pool 0 to be of b-node type.

[H3C] dhcp server ip-pool 0

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

1.1.32 network

Syntax

network ip-address [ mask mask ]

undo network

View

DHCP address pool view

Parameter

ip-address: IP address of a network segment, used to specify an IP address range.

mask mask: Specifies a subnet mask in dotted decimal notation, in the form of x.x.x.x. When no mask is provided, the default natural mask is used.

Description

Use the network command to configure a dynamically assigned IP address range (where IP addresses will be dynamically assigned to DHCP clients).

Use the undo network command to remove a dynamically assigned IP address range.

By default, no such IP address range is configured for a DHCP address pool.

Note that you can configure only one such IP address range for a DHCP address pool. If you execute the network command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure the dynamically assigned IP address range 192.168.8.0/24 for the global DHCP address pool 0.

[H3C] dhcp server ip-pool 0

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

1.1.33 option

Syntax

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

undo option code

View

DHCP address pool view

Parameter

code: Customized option number ranging from 2 to 254. Note that this argument cannot be 3, 6, 15, 44, 46, 50 through 55, 57 through 61, 82, 184, or 217. For commands related to option 184, refer to dhcp server voice-config command and the dhcp server voice-config interface command. You cannot configure option 184 by executing the option command.

ascii ascii-string: Specifies a string that is of 1 to 63 characters. Note that each character of the string needs to be an ASCII character.

hex hex-string&<1-10>: Specifies strings, each of which comprises of 1 to 8 hexadecimal digits. The &<1-10> means that you can provide up to 10 such strings. When entering more than one strings, separate two neighboring strings with a space. Note that the total number of hexadecimal digits (spaces not included) cannot exceed 64.

ip-address ip-address&<1-8>: Specifies IP addresses. The &<1-8> string means that you can provide up to eight IP addresses. When entering more than one IP addresses, separate two neighboring IP addresses with a space.

Description

Use the option command to customize DHCP options for a global DHCP address pool.

Use the undo option command to remove the customized DHCP options.

If you execute the option command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure option 100 to be 0x11 and 0x22 for the global DHCP address pools.

[H3C] dhcp server ip-pool 0

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

1.1.34 reset dhcp server conflict

Syntax

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

View

User view

Parameter

ip ip-address: Specifies an IP address, whose conflict statistics will be cleared.

all: Clears all address conflict statistics.

Description

Use the reset dhcp server conflict command to clear address conflict statistics.

Related command: display dhcp server conflict.

Example

# Clear all address conflict statistics.

<H3C> reset dhcp server conflict all

1.1.35 reset dhcp server ip-in-use

Syntax

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

View

User view

Parameter

all: Clears the dynamic address binding information about all IP addresses.

interface [ interface-type interface-number ]: Clears the dynamic address binding information about a specified interface address pool. If you do not specify the interface-number argument, this command clears the dynamic address binding information about all interface address pools.

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

pool [ pool-name ]: Clears the dynamic address binding information about a specified address pool. The pool-name argument, a string of 1 to 35 characters, is the name of an address pool. If you do not provide this argument, this command clears the dynamic address binding information about all global address pools.

Description

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

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

Example

# Clear the dynamic address binding information about the IP address 10.110.1.1.

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

1.1.36 reset dhcp server statistics

Syntax

reset dhcp server statistics

View

User view

Parameter

None

Description

Use the reset dhcp server statistics command to clear the statistics on a DHCP server, such as the number of DHCP unrecognized packets/request packets/response packets.

Related command: display dhcp server statistics.

Example

# Clear the statistics on a DHCP server.

<H3C> reset dhcp server statistics

1.1.37 static-bind client-identifier

Syntax

static-bind client-identifier client-identifier

undo static-bind client-identifier

View

DHCP address pool view

Parameter

client-identifier: Client ID to be bound, a string of 3 to 160 characters. The string only contains hexadecimal numbers and “-“, and in the format of “H-H-H…”.

Description

Use the static-bind client-identifier command to configure a client ID to be statically bound.

Use the undo static-bind client-identifier command to delete a client ID that is statically bound.

By default, no client ID is statically bound.

Note that:

l The static-bind client-identifier command must be used together with the static-bind ip-address command, to respectively specify a statically bound client ID and an IP address.

l If you execute this command or the static-bind mac-address command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Bind the host aaaa-bbbb with the IP address 10.1.1.1. The mask is 255.255.255.0.

[H3C] dhcp server ip-pool 0

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

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

1.1.38 static-bind ip-address

Syntax

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

undo static-bind ip-address

View

DHCP address pool view

Parameter

ip-address: IP address to be bound.

mask mask: Subnet mask of the specified IP address. If you do not specify the mask argument, the default subnet mask is used.

Description

Use the static-bind ip-address command to specify an IP address which will be bound statically to a MAC address.

Use the undo static-bind ip-address command to remove a statically bound IP address.

By default, no IP address is statically bound.

Note that:

l The static-bind ip-address command must be used together with the static-bind mac-address command or the static-bind client-identifier command, to respectively specify a statically bound IP address, MAC address, or client ID.

l If you execute the static-bind ip-address command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Bind the IP address 10.1.1.1 (with the subnet mask 255.255.255.0) to the MAC address 0000-e03f-0305.

[H3C] dhcp server ip-pool 0

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

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

1.1.39 static-bind mac-address

Syntax

static-bind mac-address mac-address

undo static-bind mac-address

View

DHCP address pool view

Parameter

mac-address: MAC address of the host to which the IP address is to be bound. You need to provide this argument in the form of H-H-H.

Description

Use the static-bind mac-address command to specify a MAC address to which an IP address will be bound statically.

Use the undo static-bind mac-address command to remove such a MAC address.

By default, no such MAC address is specified.

Note that:

l The static-bind ip-address command must be used together with the static-bind mac-address command, to respectively specify a statically bound IP address and MAC address.

l If you execute the static-bind mac-address command or the static-bind client-identifier command repeatedly, the new configuration overwrites the previous one.

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

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Bind the IP address 10.1.1.1 (with the subnet mask 255.255.255.0) to the MAC address 0000-e03f-0305.

[H3C] dhcp server ip-pool 0

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

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

1.1.40 voice-config

Syntax

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

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

View

DHCP address pool view

Parameter

ncp-ip: Specifies the IP address of the network call processor (NCP).

as-ip: Specifies the IP address of the alternate server.

voice-vlan: Specifies the voice VLAN.

fail-over: Specifies the Fail-over call routing.

ip-address: IP address of the NCP, alternate server, or fail-over.

vlan-id: ID of the voice VLAN, in the range of 2 to 4,094.

enable: Enables a VLAN.

disable: Disables a VLAN.

dialer-string: Fail-over dialer string. The value range is 0 to 9 and the wildcard (*).

Description

Use the voice-config command to configure option 184 and its sub-options in the global address pool.

Use the undo voice-config command to remove option 184 and its sub-options from the global address pool.

The DHCP server answers option 184 and the corresponding sub-options only after the DHCP client requests option 184.

By default, the DHCP server does not support option 184 and the corresponding sub-options.

Related command: dhcp server voice-config.

Example

# Enter system view

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enable the DHCP server to support option 184 in global address pool 123. The NCP IP address is 1.1.1.1 and the IP address of the alternate server is 2.2.2.2. The voice VLAN is enabled, with the ID being 3. The fail-over IP address is 3.3.3.3 and the dialer string is 99*.

[H3C] dhcp select global all

[H3C] dhcp server ip-pool 123

[H3C-dhcp-pool-123] voice-config ncp-ip 1.1.1.1

[H3C-dhcp-pool-123] voice-config as-ip 2.2.2.2

[H3C-dhcp-pool-123] voice-config voice-vlan 3 enable

[H3C-dhcp-pool-123] voice-config fail-over 3.3.3.3 99*

Chapter 2 DHCP Relay Configuration Commands

2.1 DHCP Relay Configuration Commands

2.1.1 address-check

Syntax

address-check enable

address-check disable

View

VLAN interface view

Parameter

None

Description

Use the address-check enable command to enable DHCP relay security on a VLAN interface, so as to start the validity check on user addresses under the VLAN interface.

Use the address-check disable command to disable DHCP relay security, so as to stop the validity check on user addresses under the VLAN interface.

By default, DHCP relay security is disabled on a VLAN interface.

Note that among S3600 series switches, only S3600-EI series switches support the two commands.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enter VLAN-interface1 view.

[H3C] interface vlan-interface 1

# Enable DHCP relay security on VLAN-interface1.

[H3C-Vlan-interface1] address-check enable

2.1.2 dhcp-relay hand

Syntax

dhcp-relay hand { enable | disable }

View

System view

Parameter

None

Description

Use the dhcp relay hand enable command to enable the DHCP relay handshake function.

Use the dhcp relay hand disable command to disable the DHCP relay handshake function.

By default, the DHCP relay handshake function is enabled.

Note that among S3600 series switches, only S3600-EI series switches support the two commands.

Example

# Disable the DHCP relay handshake function.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp relay hand disable

2.1.3 dhcp relay information enable

Syntax

dhcp relay information enable

undo dhcp relay information enable

View

System view

Parameter

None

Description

Use the dhcp relay information enable command to enable option 82 supporting on a DHCP relay.

Use the undo dhcp relay information enable command to disable option 82 supporting on a DHCP relay.

By default, this function is disabled.

& Note:

By default, with the option 82 supporting function enabled on the DHCP relay, the DHCP relay will adopt the replace strategy to process the request packets containing option 82. However, if other strategies are configured before, then enabling the 82 supporting on the DHCP relay will not change the configured strategies.

Related command: dhcp relay information strategy.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enable option 82 supporting on a DHCP relay, through which you can enable the DHCP relay to insert option 82 into DHCP request packets sent to a DHCP server.

[H3C] dhcp relay information enable

# Disable option 82 supporting on a DHCP relay, through which you can disable the DHCP relay from inserting option 82 into DHCP request packets sent to a DHCP server.

[H3C] undo dhcp relay information enable

2.1.4 dhcp relay information strategy

Syntax

dhcp relay information strategy { drop | keep | replace }

undo dhcp relay information strategy

View

System view

Parameter

drop: Specifies to discard the DHCP request packets that carry option 82.

keep: Specifies to remain the DHCP request packets that carry option 82 unchanged.

replace: Specifies to replace the option 82 carried by a DHCP request packet with that of the DHCP relay.

Description

Use the dhcp relay information strategy command to instruct a DHCP relay to perform specified operations to DHCP request packets that carry option 82.

Use the undo dhcp relay information strategy command to instruct a DHCP relay to perform the default operations to DHCP request packets that carry option 82.

By default, the DHCP relay replaces the option 82 carried by a DHCP request packet with its own option 82.

Related command: dhcp relay information enable

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Instruct the DHCP relay to discard the DHCP request packets that carry option 82.

[H3C] dhcp relay information strategy drop

# Instruct the DHCP relay to perform the default operations to DHCP request packets that carry option 82.

[H3C] undo dhcp relay information strategy

2.1.5 dhcp-security static

Syntax

dhcp-security static ip-address mac-address

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

View

System view

Parameter

ip-address: User IP address.

mac-address: User MAC address.

all: Removes all user address entries.

dynamic: Removes dynamic user address entries.

static: Removes static user address entries.

Description

Use the dhcp-security static command to configure a static user address entry.

Use the undo dhcp-security command to remove one or all user address entries, or all user address entries of a specified type.

Note that among S3600 series switches, only S3600-EI series switches support the two commands.

Related Command: display dhcp-security.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z

# Configure a user address entry for the DHCP server group, with the user IP address being 1.1.1.1 and the user MAC address being 0005-5D02-F2B3.

[H3C] dhcp-security static 1.1.1.1 0005-5D02-F2B3

2.1.6 dhcp-security tracker

Syntax

dhcp-security tracker { interval | auto }

undo dhcp-security tracker [ interval ]

View

System view

Parameter

interval: Interval (in seconds) to refresh DHCP security entries. This argument ranges from 1 to 120 seconds.

auto: Specifies that the interval to refresh DHCP security entries is automatically determined by the number of the DHCP security entries. A larger number corresponds to a longer interval.

Description

Use the dhcp-security tracker command to set the interval to refresh DHCP security entries.

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

By default, the refresh interval is determined automatically according to the number of the DHCP security entries.

Note that among S3600 series switches, only S3600-EI series switches support these two commands.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Set the interval to refresh dynamic address entries to 60 seconds.

[H3C] dhcp-security tracker 60

2.1.7 dhcp-server

Syntax

dhcp-server groupNo

undo dhcp-server

View

VLAN interface view

Parameter

groupNo: DHCP server group number. This argument ranges from 0 to 19.

Description

Use the dhcp-server command to map the current VLAN interface to a DHCP server group.

Use the undo dhcp-server command to cancel the mapping.

Related command: dhcp-server ip, display dhcp-server, and display dhcp-server interface vlan-interface.

& Note:

To improve security and avoid malicious attack to the unused SOCKETs, S3600 Ethernet switches provide the following functions:

l UDP 67 and UDP 68 ports used by DHCP are enabled only when DHCP is enabled.

l UDP 67 and UDP 68 ports are disabled when DHCP is disabled.

The corresponding implementation is as follows.

l When a VLAN interface is mapped to a DHCP server group with the dhcp-server command, the DHCP relay agent is enabled. At the same time, UDP 67 and UDP 68 ports used by DHCP are enabled.

l When the mapping between a VLAN interface and a DHCP server group is removed with the undo dhcp-server command, DHCP services are disabled. At the same time, UDP 67 and UDP 68 ports used by DHCP are disabled.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enter VLAN-interface1 view.

[H3C] interface vlan-interface 1

# Specify that VLAN-interface1 corresponds to DHCP server group 1.

[H3C-Vlan-interface1] dhcp-server 1

2.1.8 dhcp-server detect

Syntax

dhcp-server detect

undo dhcp-server detect

View

System view

Parameter

None

Description

Use the dhcp-server detect command to enable the switch serving as a DHCP relay to detect private DHCP servers.

Use the undo dhcp-server detect command to disable the private DHCP server detection function.

By default, the private DHCP server detection function is disabled

Related command: dhcp server and display dhcp-server.

Example

# Enter system view

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enable the private-DHCP server detection function on the DHCP relay.

[H3C] dhcp-server detect

2.1.9 dhcp-server ip

Syntax

dhcp-server groupNo ip ip-address&<1-8>

undo dhcp-server groupNo

View

System view

Parameter

groupNo: DHCP server group number, ranging from 0 to 19.

ip-address&<1-8>: IP address of the DNS server. &<1-8> indicates that up to eight IP addresses can be input, with any two IP addresses separated by a space.

Description

Use the dhcp-server ip command to configure the DHCP server IP address(es) in a specified DHCP server group.

Use the undo dhcp-server command to remove all DHCP server IP addresses in a DHCP server group.

Related command: dhcp-server, and display dhcp-server.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Configure three DHCP server IP addresses 1.1.1.1, 2.2.2.2, and 3.3.3.3 for DHCP server group 1, so that this group contains three DHCP servers (server 1, server 2 and server 3).

[H3C] dhcp-server 1 ip 1.1.1.1 2.2.2.2 3.3.3.3

2.1.10 display dhcp-security

Syntax

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

View

Any view

Parameter

ip-address: IP address. This argument is used to display the user address entry with the specified IP address.

dynamic: Displays the dynamic user address entries.

static: Displays the static user address entries.

tracker: Displays the interval to update the user address entries of a DHCP-security table.

Description

Use the display dhcp-security command to display one or all user address entries, or a specified type of user address entries in the valid user address table of a DHCP server group.

Note that among S3600 series switches, only S3600-EI series switches support this command.

Example

# Display all user address entries contained in the valid user address table of the DHCP server group.

<H3C> display dhcp-security

IP Address MAC Address IP Address Type

2.2.2.3 0005-5d02-f2b2 Static

3.3.3.3 0005-5d02-f2b3 Dynamic

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

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

Field	Description
IP Address	IP address of a user of the DHCP server group
MAC Address	MAC address of the user of the DHCP server group
IP Address Type	Type of the user address entry (static/dynamic)

2.1.11 display dhcp-server

Syntax

display dhcp-server groupNo

View

Any view

Parameter

groupNo: DHCP server group number, ranging from 0 to 19.

Description

Use the display dhcp-server command to display information about a specified DHCP server group.

Related command: dhcp-server ip, dhcp-server, and display dhcp-server interface vlan-interface.

Example

# Display information about DHCP server group 0.

<H3C> display dhcp-server 0

IP address of DHCP server group 0: 1.1.1.1

IP address of DHCP server group 0: 2.2.2.2

IP address of DHCP server group 0: 3.3.3.3

IP address of DHCP server group 0: 4.4.4.4

IP address of DHCP server group 0: 5.5.5.5

IP address of DHCP server group 0: 6.6.6.6

IP address of DHCP server group 0: 7.7.7.7

IP address of DHCP server group 0: 8.8.8.8

Messages from this server group: 0

Messages to this server group: 0

Messages from clients to this server group: 0

Messages from this server group to clients: 0

DHCP_OFFER messages: 0

DHCP_ACK messages: 0

DHCP_NAK messages: 0

DHCP_DECLINE messages: 0

DHCP_DISCOVER messages: 0

DHCP_REQUEST messages: 0

DHCP_INFORM messages: 0

DHCP_RELEASE messages: 0

BOOTP_REQUEST messages: 0

BOOTP_REPLY messages: 0

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

Field	Description
IP address of DHCP server group 0:	DHCP server IP addresses of DHCP server group 0
Messages from this server group	Number of the packets the DHCP relay receives from the DHCP server group
Messages to this server group	Number of the packets the DHCP relay sends to the DHCP server group
Messages from clients to this server group	Number of the packets the DHCP relay receives from the DHCP clients
Messages from this server group to clients	Number of the packets the DHCP relay sends to the DHCP clients
DHCP_OFFER messages	Number of the DHCP-OFFER packets received by the DHCP relay
DHCP_ACK messages	Number of the DHCP-ACK packets received by the DHCP relay
DHCP_NAK messages	Number of the DHCP-NAK packets received by the DHCP relay
DHCP_DECLINE messages	Number of the DHCP-DECLINE packets received by the DHCP relay
DHCP_DISCOVER messages	Number of the DHCP-DISCOVER packets received by the DHCP relay
DHCP_REQUEST messages	Number of the DHCP-REQUEST packets received by the DHCP relay
DHCP_INFORM messages	Number of the DHCP-INFORM packets received by the DHCP relay
DHCP_RELEASE messages	Number of the DHCP-RELEASE packets received by the DHCP relay
BOOTP_REQUEST messages	Number of the BOOTP request packets
BOOTP_REPLY messages	Number of the BOOTP response packets

2.1.12 display dhcp-server interface

Syntax

display dhcp-server interface Vlan-interface vlan-id

View

Any view

Parameter

vlan-id: VLAN ID.

Description

Use the display dhcp-server interface command to display information about the DHCP server group to which a VLAN interface is mapped.

Related command: dhcp-server and display dhcp-server.

Example

# Display information about the DHCP server group to which VLAN-interface2 is mapped.

<H3C> display dhcp-server interface vlan-interface 2

Dhcp-group 0 is configured on this interface

The above display information indicates the VLAN-interface2 is mapped to DHCP server group 0.

2.1.13 reset dhcp-server

Syntax

reset dhcp-server groupNo

View

User view

Parameter

groupNo: DHCP server group number, ranging from 0 to 19.

Description

Use the reset dhcp-server command to clear the statistics information of the specified DHCP server group.

Related command: dhcp server and display dhcp-server.

Example

# Clear the statistics information of DHCP server group 2.

<H3C> reset dhcp-server 2

Chapter 3 DHCP Snooping Configuration Commands

3.1 DHCP Snooping Configuration Commands

3.1.1 dhcp-snooping

Syntax

dhcp-snooping

undo dhcp-snooping

View

System view

Parameter

None

Description

Use the dhcp-snooping command to enable the DHCP snooping function.

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

By default, the DHCP snooping function is disabled.

Related command: display dhcp-snooping.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enable the DHCP snooping function.

[H3C] dhcp-snooping

3.1.2 dhcp-snooping trust

Syntax

dhcp-snooping trust

undo dhcp-snooping trust

View

Ethernet port view

Parameter

None

Description

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

Use the undo dhcp-snooping trust command to restore an Ethernet port to an untrusted port.

DHCP snooping security allow you to set a port to a trusted port or an untrusted port, so that DHCP clients can obtain IP addresses from only valid DHCP servers.

l Trusted ports can be used to connect DHCP servers or ports of other switches. Untrusted ports can be used to connect DHCP clients or networks.

l Trusted ports forward any received DHCP packets to ensure that DHCP clients can obtain IP addresses from valid DHCP servers. Untrusted ports discard the DHCP-ACK and DHCP-OFFER responses received from DHCP servers.

By default, all the ports of a switch are untrusted ports.

Related command: display dhcp-snooping trust.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Set the Ethernet1/0/1 port to a trusted port.

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

3.1.3 display dhcp-snooping

Syntax

display dhcp-snooping [ unit unit-id ]

View

Any view

Parameter

unit unit-id: Displays the DHCP-snooping information on other devices in fabric when the switch is in fabric. unit-id indicates the number of the device whose DHCP-snooping information needs to be viewed.

Description

Use the display dhcp-snooping command to display the user IP-MAC address mapping entries recorded by the DHCP snooping function.

Related command: dhcp-snooping.

Example

# Display the user IP-MAC address mapping entries recorded by the DHCP snooping function.

<H3C> display dhcp-snooping

DHCP-Snooping is enabled.

The client binding table for all untrusted ports.

Type : D--Dynamic , S--Static

Unit ID : 1

Type IP Address MAC Address Lease VLAN Interface

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

--- 0 dhcp-snooping item(s) of unit 1 found ---

3.1.4 display dhcp-snooping trust

Syntax

display dhcp-snooping trust

View

Any view

Parameter

None

Description

Use the display dhcp-snooping trust command to display the (enabled/disabled) state of the DHCP snooping function and the trusted ports.

Related command: dhcp-snooping trust.

Example

# Display the state of the DHCP snooping function and the trusted ports.

<H3C> display dhcp-snooping trust

DHCP-Snooping is enabled.

DHCP-Snooping trust become effective.

Interface Trusted

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

Ethernet1/0/10 Trusted

The above display information indicates that the DHCP snooping function is enabled, and the Ethernet1/0/10 port is a trusted port.

Chapter 4 DHCP Accounting Configuration Commands

4.1 DHCP Accounting Configuration Commands

4.1.1 accounting domain

Syntax

accounting domain domain-name

undo accounting domain

View

DHCP address pool view

Parameter

domain-name: Name of a domain, a string of 1 to 24 characters. (You can use the domain command to create a domain.)

Description

Use the accounting domain command to enable the DHCP accounting function.

Use the undo accounting domain command to disable the DHCP accounting function.

Example

# Enter system view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

# Enter DHCP address pool view.

[H3C] dhcp server ip-pool test

# Enable the DHCP accounting function (assuming that domain 123 already exists).

[H3C-dhcp-pool-test] accounting domain 123

H3C S3600 Series Ethernet Switches Command Manual-Release 1510(V1.04)

2.1.2 dhcp-relay hand

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