No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S1720, S2700, S5700, and S6720 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
IP Service Compatible Commands

IP Service Compatible Commands

ARP Compatible Commands

arp learning ip-network-cross enable (upgrade-compatible command)

Function

The arp learning ip-network-cross enable command enables inter-network segment ARP learning on interfaces.

Format

arp learning ip-network-cross enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In V200R010C00 and later versions, inter-network segment ARP learning is disabled on interfaces by default. If the system software of a switch is upgraded from V200R005C00 or a later version to V200R010C00SPC600 or a later version, inter-network segment ARP learning is enabled on interfaces. If you run the display this include-default command in the system view after the configuration is restored, the command output includes arp learning ip-network-cross enable.

Precautions

This command can be used only in the configuration restoration stage. After the configuration is restored, you cannot configure this command manually.

DHCP Upgrade-compatible Commands

expired (upgrade-compatible command)

Function

The expired command sets the lease for IP addresses in a global IP address pool.

By default, the lease of IP addresses is one day.

Format

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

Parameters

Parameter

Description

Value

day day

Specifies the number of days in the IP address lease.

The value is an integer ranging from 0 to 999, in days. The default value is 1.

hour hour

Specifies the number of hours in the IP address lease.

The value is an integer ranging from 0 to 23, in hours. The default value is 0.

minute minute

Specifies the number of minutes in the IP address lease.

The value is an integer ranging from 0 to 59, in minutes. The default value is 0.

unlimited

Indicates that the IP address lease is unlimited.

-

Views

IP address pool view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The expired-hide command applies to DHCP servers. To meet different client requirements, DHCP supports dynamic, automatic, and static address assignment. Different hosts require different IP address leases. For example, if some hosts such as a DNS server need to use certain IP addresses for a long time, configure expired as unlimited to set the IP address lease of the specified global address pool to unlimited. If some hosts such as a portable computer just need to user temporary IP addresses, set the IP address lease of the specified global address pool to the required time so that the expired IP addresses can be released and assigned to other clients.

When a DHCP client starts or half of its IP address lease has passed, the DHCP client sends a DHCP Request packet to the DHCP server to renew the lease. If the IP address can still be assigned to the client, the DHCP server informs a renewed IP address lease to the client. If the IP address can no longer be assigned to this client, the DHCP server informs the client that the IP address lease cannot be renewed and it needs to apply for another IP address.

Prerequisites

Run the ip pool command to create a global IP address pool and the dhcp enable command to globally enable the DHCP server function.

Precautions

Different IP address leases can be specified for different global IP address pools on a DHCP server. In a global IP address pool, all addresses have the same lease.

Example

# Specify the IP address lease of the global address pool global1 to 1 day 2 hours and 30 minutes.

<HUAWEI> system-view 
[HUAWEI] ip pool global1 
[HUAWEI-ip-pool-global1] expired  day 1 hour 2 minute 30

dhcp server expired (upgrade-compatible command)

Function

The dhcp server expired command sets the lease for IP addresses in an interface IP address pool.

By default, the lease of IP addresses is one day.

Format

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

Parameters

Parameter

Description

Value

day

Specifies the number of days in the IP address lease.

The value is an integer ranging from 0 to 999, in days. The default value is 1.

hour

Specifies the number of hours in the IP address lease.

The value is an integer ranging from 0 to 23, in hours. The default value is 0.

minute

Specifies the number of minutes in the IP address lease.

The value is an integer ranging from 0 to 59, in minutes. The default value is 0.

unlimited

Indicates that the IP address lease is unlimited.

-

Views

VLANIF interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dhcp server expired command applies to DHCP servers. To meet different client requirements, DHCP supports dynamic, automatic, and static address assignment. Different hosts require different IP address leases. For example, if some hosts such as a DNS server need to use certain IP addresses for a long time, run the dhcp server expired unlimited command to set the IP address lease of the specified VLANIF interface address pool to unlimited. If some hosts such as a portable computer just need to user temporary IP addresses, run the dhcp server expired command to set the IP address lease of the specified VLANIF interface address pool to the required time so that the expired IP addresses can be released and assigned to other clients.

When a DHCP client starts or half of its IP address lease has passed, the DHCP client sends a DHCP Request packet to the DHCP server to renew the lease. If the IP address can still be assigned to the client, the DHCP server informs the client of a renewed IP address lease. If the IP address can no longer be assigned to this client, the DHCP server informs the client that the IP address lease cannot be renewed.

Prerequisites

Run the dhcp enable command to globally enable the DHCP function. Run the dhcp select interface command in the VLANIF interface view to enable the interface IP address pool.

Precautions

Different IP address leases can be specified for different interface IP address pools on a DHCP server. In an interface IP address pool, all IP addresses have the same lease.

Example

# Set the IP address lease of the IP address pool on VLANIF 100 to 2 days 2 hours and 30 minutes.

<HUAWEI> system-view
[HUAWEI] dhcp enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] ip address 10.1.1.1 24
[HUAWEI-Vlanif100] dhcp select interface
[HUAWEI-Vlanif100] dhcp server expired day 2 hour 2 minute 30

dhcp server forbidden-ip (upgrade-compatible command)

Function

The dhcp server forbidden-ip command specifies the range of IP addresses that cannot be assigned to clients by the DHCP server.

By default, the system does not configure the range of IP addresses that cannot be assigned to clients by the DHCP server.

Format

dhcp server forbidden-ip start-ip-address [ end-ip-address ]

Parameters

Parameter

Description

Value

start-ip-address

Specifies the start IP address that cannot be automatically assigned.

The value is in dotted decimal notation.

end-ip-address

Specifies the end IP address that cannot be automatically assigned. If end-ip-address is not specified, only start-ip-address cannot be assigned to clients.

The value is in dotted decimal notation. end-ip-address and start-ip-address must be on the same network segment and end-ip-address must be larger than start-ip-address.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dhcp server forbidden-ip command applies to DHCP servers. In an IP address pool, some IP addresses need to be reserved for other services, and some IP addresses are statically assigned to certain hosts (such as the DNS server) and cannot be automatically assigned to clients. You can run the dhcp server forbidden-ip command to specify the range of the IP addresses that cannot be automatically assigned to clients from the IP address pool.

Precautions

  • The excluded IP address must be in the IP address pool range.
  • The excluded IP address or IP address segment cannot be automatically assigned to clients from a local address pool.
  • If you run the dhcp server forbidden-ip command multiple times, you can specify multiple IP addresses or IP address segments that cannot be automatically assigned to clients from the specified address pool.

Example

# Configure that IP addresses in the address pool 10.10.10.10 to 10.10.10.20 cannot be automatically assigned to clients.

<HUAWEI> system-view 
[HUAWEI] dhcp server forbidden-ip 10.10.10.10 10.10.10.20

dhcp server ip-pool (upgrade-compatible command)

Function

The dhcp server ip-pool command creates a global IP address pool.

The undo dhcp server ip-pool command delete a global IP address pool.

By default, no IP address pool is created.

Format

dhcp server ip-pool pool-name

undo dhcp server ip-pool pool-name

Parameters

Parameter

Description

Value

pool-name

Specifies the name of a global IP address pool.

The value is a string of 1 to 64 characters without spaces. A combination of digits, letters, underscores (_), and dots (.) is allowed.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The dhcp server ip-pool command applies to DHCP servers. When configuring a DHCP server, run the dhcp server ip-pool command to create an IP address pool and set parameters for the IP address pool, including a gateway address, the IP address lease, and a VPN instance. Then the configured DHCP server can assign IP addresses in the IP address pool to clients. If IP addresses in a global IP address pool are in use, this global address pool cannot be deleted.

Example

# Create a global IP address pool pool1.

<HUAWEI> system-view
[HUAWEI] dhcp server ip-pool pool1

dhcp server ping (upgrade-compatible command)

Function

Using the dhcp server ping command, you can configure the maximum number of ping packets and the longest response-wait time for each ping packet.

By default, the DHCP server sends 2 ping packets and the maximum response time is 500 ms.

Format

dhcp server ping packets packets-number

dhcp server ping packets packets-number timeout milliseconds

dhcp server ping timeout milliseconds packets packets-number

Parameters

Parameter Description Value
packets packets-number Specifies the maximum number of ping packets to be sent. The value is an integer that ranges from 0 to 10.
timeout milliseconds Specifies the maximum response time of a ping packet. The value is an integer that ranges from 0 to 10000, in milliseconds. The value 0 indicates that no ping operation is performed.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The DHCP server detects the address usage by sending ping packets. This avoids address collision caused by the repeated allocation of IP addresses.

Example

# Set the maximum number of ping packets to be sent to 5.

<HUAWEI> system-view
[HUAWEI] dhcp server ping packets 5

dns-suffix (upgrade-compatible command)

Function

The dns-suffix command configures the domain name suffix to be assigned by the DHCP server to a DHCP client.

By default, no domain name suffix is configured for a DHCP client.

Format

dns-suffix domain-name

Parameters

Parameter

Description

Value

domain-name

Specifies the domain name suffix to be assigned to a DHCP client.

The value is a string of 1 to 50 characters without spaces. A combination of digits, letters, underscores (_), and dots (.) is allowed.

Views

IP address pool view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The dns-suffix command applies to DHCP servers. Each client has a domain name. To enable DHCP clients to communicate by using their domain names and prevent IP address conflicts, the DHCP server needs to specify domain name suffixes for these clients when allocating IP addresses to them. On the DHCP server, the dns-suffix command specifies a domain name suffix for each global address pool. When allocating IP addresses to clients, the DHCP server also sends the domain name suffixes to the clients. During domain name resolution, users only need to enter a part of the domain name, and then the system uses a complete domain name suffix for resolution.

Precautions

If no domain name suffix is configured for a global IP address pool, the DHCP server cannot send a domain name suffix to clients. In this situation, the clients cannot communicate.

Example

# Configure mydomain.com.cn as the domain name suffix of the IP address pool pool1.

<HUAWEI> system-view
[HUAWEI] ip pool pool1
[HUAWEI-ip-pool-pool1] dns-suffix mydomain.com.cn

ip relay address (upgrade-compatible command)

Function

Using the ip relay address command, you can configure DHCP server addresses on a VLANIF interface enabled with DHCP relay.

Using the undo ip relay address command, you can delete the configured DHCP server addresses.

By default, no DHCP server address is configured on a VLANIF interface enabled with DHCP relay.

Format

ip relay address ip-address

undo ip relay address { ip-address | all }

Parameters

Parameter

Description

Value

ip-address

Specifies the IP address of a DHCP server.

The value is in dotted decimal notation.

all

Deletes all the DHCP server addresses configured on an interface.

-

Views

VLANIF interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The ip relay address command is applicable to DHCP relay agents. When a DHCP client needs to send a DHCP request packet to a DHCP server on a different network segment by using a DHCP relay agent, run the ip relay address command on the DHCP relay agent to configure a DHCP server address.

Prerequisites

DHCP relay has been enabled on the VLANIF interface by using the dhcp select relay command.

Precautions

If you run the ip relay address command multiple times, multiple DHCP server addresses are configured.

Example

# Configure DHCP server addresses 10.2.2.2 on VLANIF100 enabled with DHCP relay.

<HUAWEI> system-view
[HUAWEI] dhcp enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] dhcp select relay
[HUAWEI-Vlanif100] ip relay address 10.2.2.2

lease (upgrade-compatible command)

Function

The lease command sets the lease for IP addresses in a global IP address pool.

By default, the lease of IP addresses is one day.

Format

lease day [ hour [ minute ] ]

Parameters

Parameter

Description

Value

day

Specifies the number of days in the IP address lease.

The value is an integer ranging from 0 to 999, in days. The default value is 1.

hour

Specifies the number of hours in the IP address lease.

The value is an integer ranging from 0 to 23, in hours. The default value is 0.

minute

Specifies the number of minutes in the IP address lease.

The value is an integer ranging from 0 to 59, in minutes. The default value is 0.

Views

IP address pool view

Default Level

2: Configuration level

Usage Guidelines

After the upgrade, it is replaced by the lease { day day [ hour hour [ minute minute ] ] | unlimited } command.

Example

# Specify the IP address lease of the global address pool global1 to 1 day.

<HUAWEI> system-view
[HUAWEI] ip pool global1
[HUAWEI-ip-pool-global1] lease 1

static-bind mac-address (upgrade-compatible command)

Function

The static-bind mac-address command binds a MAC address to a global IP address pool.

Format

static-bind mac-address mac-address

Parameters

Parameter

Description

Value

mac-address

Specifies the user MAC address.

The value is in H-H-H format. An H is a hexadecimal number of 1 to 4 digits.

Views

IP address pool view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The static-bind mac-address command applies to DHCP servers. If some special clients such as the DNS server need to be statically assigned fixed IP addresses, run the static-bind mac-address command to bind fixed IP addresses to MAC addresses of these clients. When receiving a request for applying for an IP address from a special client, a DHCP server assigns the fixed IP address bound to the client's MAC address to this client.

Prerequisites

Run the ip pool command to create a global IP address pool and the dhcp enable command to globally enable the DHCP server function.

Example

# Bind a MAC address 2020-e2f3-2a3b to the global IP address pool global1.

<HUAWEI> system-view 
[HUAWEI] ip pool global1 
[HUAWEI-ip-pool-global1] static-bind mac-address 2020-e2f3-2a3b

dhcpv6 relay destination (upgrade-compatible command)

Function

The dhcpv6 relay destination command enables the DHCPv6 relay function on interfaces and configures the IPv6 address of the DHCPv6 server or next-hop relay agent.

By default, the DHCPv6 relay function is disabled on an interface.

Format

dhcpv6 relay destination ipv6-address interface interface-type interface-number

Parameters

Parameter

Description

Value

ipv6-address

Specifies the destination address of relay messages, which can be the IPv6 address of the DHCPv6 server or next hop relay agent.

The value is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.

interface interface-type interface-number

Specifies the type and number of the outbound interface of relay messages.

-

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

When a client applies to a DHCPv6 server on a different network segment for an IPv6 address, you need to deploy a relay agent between the client and the DHCPv6 server. In this manner, the relay agent transmits DHCPv6 messages exchanged between the client and the DHCPv6 server.

Translation
Download
Updated: 2019-04-18

Document ID: EDOC1000178165

Views: 42373

Downloads: 1107

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next