H3C MSR810-LUS, MSR810-LM-HK, MSR810-W, MSR2600-10-X1, MSR810-W-DB Command Reference Manual

...

Download

H3C MSR Router Series

Document version: 6W200-20170608

New H3C Technologies Co., Ltd. http://www.h3c.com.hk

Software version: MSR-CMW710-R0605

Comware 7 Layer 2 - WAN Access

Command Reference

No part of this manual may be reproduced or transmitted in any form or by any means without prior written consent of New H3C Technologies Co., Ltd.

Trademarks

H3C, , H3CS, H3CIE, H3CNE, Aolynk, , H

Care, , IRF, NetPilot, Netflow, SecEngine, SecPath, SecCenter, SecBlade, Comware, ITCMM and HUASAN are trademarks of New H3C Technologies Co., Ltd.

All other trademarks that may be mentioned in this manual are the property of their respective owners

Notice

The information in this document is subject to change without notice. Every effort has been made in the preparation of this document to ensure accuracy of the contents, but all statements, information, and recommendations in this document do not constitute the warranty of any kind, express or implied.

Preface

Convention

Description

Convention

Description

This command reference describes the configuration commands for PPP, HDLC, L2TP, and so on.

This preface includes the following topics about the documentation:

• Audience.

• Conventions

• Obtaining documentation

• Technical support

• Documentation feedback

Audience

This documentation is intended for:

• Network planners.

• Field technical support and servicing engineers.

• Network administrators working with the H3C MSR Router series.

Conventions

The following information describes the conventions used in the documentation.

Command conventions

Boldface Bold

Italic

[ ] Square brackets enclose syntax choices (keywords or arguments) that are optional.

{ x | y | ... }

[ x | y | ... ]

{ x | y | ... } *

[ x | y | ... ] *

&<1-n>

# A line that starts with a pound (#) sign is comments.

GUI conventions

text represents commands and keywords that you enter literally as shown.

Italic text represents arguments that you replace with actual values.

Braces enclose a set of required syntax choices separated by vertical bars, from which you select one.

Square brackets enclose a set of optional syntax choices separated by vertical bars, from which you select one or none.

Asterisk marked braces enclose a set of required syntax choices separated by vertical bars, from which you select a minimum of one.

Asterisk marked square brackets enclose optional syntax choices separated by vertical bars, from which you select one choice, multiple choices, or none.

The argument or keyword and argument combination before the ampersand (&) sign can be entered 1 to n times.

Boldface

Window names, button names, field names, and menu items are in Boldface. For example, the

Multi-level menus are separated by angle brackets. For

New User

window opens; click OK.

Convention

Description

example,

File

Create

Folder

Symbols

Convention

Description

IMPORTANT:

TIP:

Convention

Description

WARNING!

CAUTION:

NOTE:

Network topology icons

An alert that calls attention to important information that if not understood or followed can result in personal injury.

An alert that calls attention to important information that if not understood or followed can result in data loss, data corruption, or damage to hardware or software.

An alert that calls attention to essential information.

An alert that contains additional or supplementary information.

An alert that provides helpful information.

Represents a generic network device, such as a router, switch, or firewall.

Represents a routing-capable device, such as a router or Layer 3 switch.

Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that supports Layer 2 forwarding and other Layer 2 features.

Represents an access controller, a unified wired-WLAN module, or the access controller engine on a unified wired-WLAN switch.

Represents an access point.

Wireless terminator unit.

Wireless terminator.

Represents a mesh access point.

Represents omnidirectional signals.

Represents directional signals.

Represents a security product, such as a firewall, UTM, multiservice security gateway, or load balancing device.

Represents a security module, such as a firewall, load balancing, NetStream, SSL VPN, IPS, or ACG module.

Examples provided in this document

Examples in this document might use devices that differ from your device in hardware model, configuration, or software version. It is normal that the port numbers, sample output, screenshots, and other information in the examples differ from what you have on your device.

Obtaining documentation

To a ccess the most up-to-date H3C product documentation, go to the H3C website at

http://www.h3c.com.hk

To obtain information about installation, configuration, and maintenance, click

http://www.h3c.com.hk/Technical_Documents

To obtain software version information such as release notes, click

http://www.h3c.com.hk/Software_Download

Technical support

service@h3c.com

http://www.h3c.com.hk

Documentation feedback

You can e-mail your comments about product documentation to info@h3c.com.

We appreciate your comments.

PPP and MP commands ···································································· 1

PPP commands ························································································································· 1

display ip pool ····················································································································· 1 display ppp access-user ······································································································· 3 display ppp compression iphc ································································································ 8 ip address ppp-negotiate ······································································································· 9 ip pool ····························································································································· 10 ip pool gateway ················································································································· 11 link-protocol ppp ················································································································ 12 nas-port-type ···················································································································· 12 ppp accm ························································································································· 14 ppp account-statistics enable ······························································································· 14 ppp acfc local-request ········································································································ 15 ppp acfc remote-reject ········································································································ 15 ppp authentication-mode ····································································································· 16 ppp chap password ············································································································ 17 ppp chap user ··················································································································· 18 ppp compression iphc enable ······························································································· 19 ppp compression iphc rtp-connections ··················································································· 19 ppp compression iphc tcp-connections ··················································································· 20 ppp ipcp dns ····················································································································· 21 ppp ipcp dns admit-any ······································································································· 22 ppp ipcp dns request ·········································································································· 23 ppp ipcp remote-address match ··························································································· 23 ppp ip-pool route ··············································································································· 24 ppp lcp delay ···················································································································· 25 ppp lqm ··························································································································· 25 ppp lqm lcp-echo ··············································································································· 26 ppp pap local-user ············································································································· 27 ppp pfc local-request ·········································································································· 28 ppp pfc remote-reject ········································································································· 28 ppp timer negotiate ············································································································ 29 remote address ················································································································· 29 remote address dhcp client-identifier ····················································································· 30 reset ppp compression iphc ································································································· 31 timer-hold ························································································································ 31 timer-hold retry ················································································································· 32 reset ppp access-user ········································································································ 33

MP commands ························································································································ 34

bandwidth ························································································································ 34 default ····························································································································· 34 description ······················································································································· 35 display interface mp-group ·································································································· 36 display interface virtual-access ····························································································· 39 display interface virtual-template ··························································································· 42 display ppp mp ················································································································· 44 interface mp-group ············································································································ 45 interface virtual-template ····································································································· 46 mtu································································································································· 47 ppp mp ···························································································································· 48 ppp mp binding-mode ········································································································· 48 ppp mp endpoint ··············································································································· 49 ppp mp fragment disable ····································································································· 50 ppp mp lfi delay-per-frag ····································································································· 51 ppp mp lfi enable ··············································································································· 51 ppp mp lfi size-per-frag ······································································································· 52

ppp mp max-bind ·············································································································· 53 ppp mp min-bind ··············································································································· 54 ppp mp min-fragment ········································································································· 54 ppp mp mp-group ·············································································································· 55 ppp mp short-sequence ······································································································ 56 ppp mp sort-buffer-size ······································································································· 56 ppp mp timer lost-fragment ·································································································· 57 ppp mp user ····················································································································· 58 ppp mp virtual-template ······································································································ 59 reset counters interface mp-group ························································································· 60 reset counters interface virtual-access ··················································································· 60 service ···························································································································· 61 service standby ················································································································· 63 shutdown ························································································································· 65

PPPoE commands ········································································· 66

PPPoE server commands ·········································································································· 66

display pppoe-server session packet ····················································································· 66 display pppoe-server session summary ·················································································· 68 display pppoe-server throttled-mac ······················································································· 70 display pppoe-server va-pool ······························································································· 71 ppp lcp echo mru verify ······································································································· 72 pppoe-server access-delay ·································································································· 73 pppoe-server access-line-id bas-info ····················································································· 73 pppoe-server access-line-id circuit-id parse-mode ···································································· 75 pppoe-server access-line-id circuit-id trans-format ···································································· 76 pppoe-server access-line-id content ······················································································ 77 pppoe-server access-line-id remote-id trans-format ·································································· 78 pppoe-server access-line-id trust ·························································································· 79 pppoe-server bind ············································································································· 80 pppoe-server session-limit ··································································································· 81 pppoe-server session-limit per-mac ······················································································· 82 pppoe-server session-limit per-vlan ······················································································· 83 pppoe-server session-limit total ···························································································· 84 pppoe-server tag ac-name ·································································································· 85 pppoe-server tag ppp-max-payload ······················································································· 86 pppoe-server tag service-name ···························································································· 87 pppoe-server throttle per-mac ······························································································ 88 pppoe-server virtual-template va-pool ···················································································· 89 reset pppoe-server ············································································································ 90

PPPoE client commands ··········································································································· 91

dialer diagnose ················································································································· 91 display pppoe-client session packet······················································································· 91 display pppoe-client session summary ··················································································· 93 pppoe-client ····················································································································· 93 reset pppoe-client ·············································································································· 94 reset pppoe-client session packet ························································································· 95

L2TP commands ············································································ 96

allow l2tp ························································································································· 96 bandwidth ························································································································ 97 default ····························································································································· 98 description ······················································································································· 98 display interface virtual-ppp ································································································· 99 display l2tp session ·········································································································· 102 display l2tp session temporary ··························································································· 103 display l2tp tunnel ············································································································ 104 display l2tp va-pool ·········································································································· 105 interface virtual-ppp ········································································································· 105 ip dscp ·························································································································· 106 l2tp enable ····················································································································· 107

l2tp tsa-id ······················································································································· 107 l2tp virtual-template va-pool ······························································································· 108 l2tp-auto-client ················································································································ 109 l2tp-group ······················································································································ 110 lns-ip ···························································································································· 110 mandatory-chap ·············································································································· 111 mandatory-lcp ················································································································· 112 mtu······························································································································· 113 ppp access-control enable ································································································· 113 ppp lcp imsi accept ·········································································································· 114 ppp lcp imsi request ········································································································· 115 ppp lcp imsi string ············································································································ 115 ppp lcp sn accept ············································································································ 116 ppp lcp sn request ··········································································································· 116 ppp lcp sn string ·············································································································· 117 ppp user accept-format imsi-sn split ···················································································· 118 ppp user attach-format imsi-sn split ····················································································· 118 ppp user replace ············································································································· 119 reset counters interface virtual-ppp······················································································ 120 reset l2tp tunnel ·············································································································· 121 service ·························································································································· 121 service standby ··············································································································· 123 shutdown ······················································································································· 124 source-ip ······················································································································· 124 timer-hold ······················································································································ 125 timer-hold retry ··············································································································· 126 tunnel authentication ········································································································ 126 tunnel avp-hidden ············································································································ 127 tunnel flow-control ··········································································································· 128 tunnel name ··················································································································· 129 tunnel password ·············································································································· 129 tunnel timer hello ············································································································· 130 user ······························································································································ 131 vpn-instance ··················································································································· 131

HDLC commands ········································································· 133

link-protocol hdlc ············································································································· 133 timer-hold ······················································································································ 134 timer-hold retry ··············································································································· 135

HDLC link bundling commands ······················································· 137

bandwidth ······················································································································ 137 bundle id ······················································································································· 137 bundle load-balance ········································································································· 138 bundle max-active links ···································································································· 139 bundle member-priority ····································································································· 139 bundle min-active bandwidth ······························································································ 140 bundle min-active links ····································································································· 140 default ··························································································································· 141 description ····················································································································· 142 display bundle hdlc-bundle ································································································ 142 display interface hdlc-bundle ······························································································ 144 interface hdlc-bundle ········································································································ 148 mtu······························································································································· 148 reset counters interface ···································································································· 149 service ·························································································································· 149 service standby ··············································································································· 151 shutdown ······················································································································· 152

ISDN commands ·········································································· 154

display isdn active-channel ································································································ 154

iii

display isdn call-info ········································································································· 155 display isdn call-record ····································································································· 158 display isdn parameters ···································································································· 159 display isdn spid ·············································································································· 161 isdn bch-local-manage ····································································································· 163 isdn bch-select-way ········································································································· 164 isdn bri-slipwnd-size ········································································································· 165 isdn caller-number ··········································································································· 165 isdn calling ····················································································································· 166 isdn carry calling-name ····································································································· 167 isdn carry connected-name ······························································································· 167 isdn check-called-number ································································································· 168 isdn crlength ··················································································································· 169 isdn ignore connect-ack ···································································································· 169 isdn ignore hlc ················································································································ 170 isdn ignore llc ················································································································· 171 isdn ignore sending-complete ···························································································· 172 isdn l3-timer ··················································································································· 172 isdn leased-line ··············································································································· 174 isdn link-mode p2p ·········································································································· 174 isdn number-property ······································································································· 175 isdn overlap-sending ········································································································ 180 isdn pri-slipwnd-size ········································································································· 180 isdn progress-indicator ····································································································· 181 isdn progress-to-alerting enable ························································································· 182 isdn protocol-mode ·········································································································· 183 isdn protocol-type ············································································································ 184 isdn q921-permanent ······································································································· 185 isdn spid auto-trigger ········································································································ 186 isdn spid nit ···················································································································· 186 isdn spid resend ·············································································································· 187 isdn spid service ············································································································· 188 isdn spid timer ················································································································ 189 isdn spid1 ······················································································································ 189 isdn spid2 ······················································································································ 190 isdn two-tei ···················································································································· 191 permanent-active ············································································································ 192 power-source ················································································································· 193

ATM commands ··········································································· 194

bandwidth ······················································································································ 194 broadcast ······················································································································ 194 default ··························································································································· 195 description ····················································································································· 196 display atm map-info ········································································································ 196 display atm pvc-group ······································································································ 198 display atm pvc-info ········································································································· 202 display interface virtual-ethernet ························································································· 205 encapsulation ················································································································· 208 interface virtual-ethernet ··································································································· 209 mac-address ·················································································································· 210 map bridge ····················································································································· 210 map ip ··························································································································· 211 map ppp ························································································································ 213 mtu······························································································································· 213 oam ais-rdi ····················································································································· 214 oam loopback ················································································································· 215 oam ping ······················································································································· 216 precedence ···················································································································· 218 pvc ······························································································································· 219 pvc-group ······················································································································ 220

remark atm-clp ················································································································ 221 reset atm interface ··········································································································· 222 reset counters interface virtual-ethernet ················································································ 222 service cbr ····················································································································· 223 service ubr ····················································································································· 224 service vbr-nrt ················································································································· 225 service vbr-rt ·················································································································· 226 shutdown ······················································································································· 227 shutdown ······················································································································· 228 transmit-priority ··············································································································· 228 vp limit ·························································································································· 229

Modem management commands ····················································· 231

country-code ·················································································································· 231 modem answer-timer ······································································································· 232 modem auto-answer ········································································································ 233 modem callback ·············································································································· 233 modem caller-number resolve ···························································································· 234 modem enable ················································································································ 235 sendat ··························································································································· 236

3G/4G modem management commands ··········································· 239

Common management commands ···························································································· 239

controller cellular ············································································································· 239 description ····················································································································· 239 display cellular ················································································································ 240 display controller cellular ··································································································· 251 dm-port open ·················································································································· 253 mode ···························································································································· 253 modem reboot ················································································································ 254 modem response ············································································································ 255 pin modify ······················································································································ 255 pin unlock ······················································································································ 256 pin verification enable ······································································································· 257 pin verify ························································································································ 258 plmn search ··················································································································· 259 plmn select ···················································································································· 260 reset counters controller cellular ························································································· 261 rssi ······························································································································· 261 sendat ··························································································································· 262 shutdown ······················································································································· 263 sim switch-back enable ····································································································· 263 sim switch-to ·················································································································· 264

trust-imsi ······················································································································ 265

3G modem-specific management commands ··············································································· 266

gsm band ······················································································································ 266 profile create ·················································································································· 267 profile delete ·················································································································· 268 profile main ···················································································································· 268 serial-set ······················································································································· 269 wcdma band ··················································································································· 269

4G modem-specific management commands ··············································································· 270

apn······························································································································· 270 apn-profile ····················································································································· 271 apn-profile apply ············································································································· 272 attach-format imsi-sn split ································································································· 272 authentication-mode ········································································································ 273 bandwidth ······················································································································ 274 default ··························································································································· 274 description ····················································································································· 275 display interface eth-channel ····························································································· 276

eth-channel ···················································································································· 279 imsi bind ························································································································ 280 interface eth-channel ········································································································ 280 ip address cellular-alloc ···································································································· 281 ipv6 address cellular-alloc ································································································· 282 lte band ························································································································· 282 mtu······························································································································· 283 pdp-type ························································································································ 284 reset counters interface ···································································································· 284 shutdown ······················································································································· 285

DDR commands ·········································································· 286

bandwidth ······················································································································ 286 default ··························································································································· 287 description ····················································································································· 287 dialer bundle enable ········································································································· 288 dialer bundle-member ······································································································ 288 dialer callback-center ······································································································· 289 dialer call-in ···················································································································· 290 dialer circular enable ········································································································ 291 dialer circular-group ········································································································· 292 dialer disconnect ············································································································· 293 dialer flow-interval ··········································································································· 293 dialer number ················································································································· 294 dialer peer-name ············································································································· 295 dialer priority ·················································································································· 295 dialer queue-length ·········································································································· 296 dialer route ····················································································································· 297 dialer threshold ··············································································································· 298 dialer timer autodial ········································································································· 299 dialer timer compete ········································································································ 300 dialer timer enable ··········································································································· 300 dialer timer idle ··············································································································· 301 dialer timer wait-carrier ····································································································· 302 dialer timer warmup ········································································································· 302 dialer-group ···················································································································· 303 dialer-group rule ·············································································································· 304 display dialer ·················································································································· 305 display interface dialer ······································································································ 306 interface dialer ················································································································ 309 mtu······························································································································· 309 ppp callback ··················································································································· 310 ppp callback ntstring ········································································································ 311 reset counters interface ···································································································· 311 service ·························································································································· 312 service standby ··············································································································· 313 shutdown ······················································································································· 315 standby routing-group ······································································································ 315 standby routing-group rule ································································································· 316 standby timer routing-disable ····························································································· 317 timer-hold ······················································································································ 317 timer-hold retry ··············································································································· 318

Frame Relay commands ································································ 320

broadcast ······················································································································ 320 display fr compression iphc ······························································································· 320 display fr compression stac ······························································································· 323 display fr fragment ··········································································································· 324 display fr inarp ················································································································ 325 display fr ipv6 map ··········································································································· 326 display fr lmi ··················································································································· 327

display fr map ················································································································· 329 display fr pvc ·················································································································· 330 fr compression iphc enable ································································································ 332 fr compression iphc rtp-connections ···················································································· 333 fr compression iphc tcp-connections ···················································································· 334 fr compression stac enable ································································································ 336 fr dlci ···························································································································· 336 fr encapsulation ·············································································································· 337 fr fragment enable ··········································································································· 338 fr fragment size ··············································································································· 339 fr inarp ·························································································································· 339 fr inarp interval ················································································································ 340 fr interface-type ··············································································································· 341 fr ipv6 ind ······················································································································· 341 fr lmi n391dte ················································································································· 342 fr lmi n392dce ················································································································· 343 fr lmi n392dte ················································································································· 343 fr lmi n393dce ················································································································· 344 fr lmi n393dte ················································································································· 345 fr lmi t392dce ·················································································································· 346 fr lmi type ······················································································································· 347 fr map ··························································································································· 347 fr ipv6 ind holdtime ·········································································································· 348 fr ipv6 ind solicitation retrans-timer ······················································································ 349 link-protocol fr ················································································································· 350 reset fr compression iphc ·································································································· 350 reset fr inarp ··················································································································· 351 reset fr ipv6 ind ··············································································································· 351 reset fr pvc ····················································································································· 352 snmp-agent trap enable fr ································································································· 352 timer-hold ······················································································································ 353

Multilink Frame Relay commands ···················································· 354

bandwidth ······················································································································ 354 default ··························································································································· 354 description ····················································································································· 355 display interface mfr ········································································································· 356 display mfr ····················································································································· 359 fr mfr ····························································································································· 363 interface mfr ··················································································································· 363 link-protocol mfr ·············································································································· 364 mfr bundle-name ············································································································· 365 mfr fragment enable ········································································································· 366 mfr fragment size ············································································································ 366 mfr timer lost-fragment ····································································································· 367 mfr link-name ················································································································· 368 mfr retry ························································································································ 368 mfr timer ack ·················································································································· 369 mfr timer hello ················································································································· 370 mfr window-size ·············································································································· 371 reset counters interface ···································································································· 371 shutdown ······················································································································· 372

Index ························································································· 373

vii

PPP and MP commands

This feature is supported only on Layer 2 Ethernet ports on the following modules:

• AM.

• AS.

• ASE.

• BS.

• CE3.

• CPOS.

• E1.

• E1-F.

• POS.

• SAE.

• T1.

• T1-F.

Commands and descriptions for centralized devices apply to the following routers:

• MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-L

MS/810-LUS.

• MSR2600-10-X1.

• MSR 2630.

• MSR3600-28/3600-51.

• MSR3600-28-SI/3600-51-SI.

• MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

• MSR 3610/3620/3620-DP/3640/3660.

Commands and descriptions for distributed devices apply to the following routers:

• MSR5620.

• MSR 5660.

• MSR 5680.

IPv6-related parameters are not supported on the following routers:

• MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-L

MS/810-LUS.

• MSR3600-28-SI/3600-51-SI.

PPP commands

display ip pool

Use display ip pool to display PPP address pools.

Syntax

display ip pool [ pool-name ] [ group group-name ]

Field

Description

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

pool-name: Specifies a PPP address pool by its name, a case-sensitive string of 1 to 31 characters.

group group-name: Displays PPP address pools in a group specified by its name, a case-sensitive

string of 1 to 31 characters.

Usage guidelines

If you do not specify any parameters, the command displays brief information about all PPP address pools.

If you specify an address pool, the command displays detailed information about the specified PPP address pool.

Examples

# Display brief information about all PPP address pools.

<Sysname> display ip pool Group name: a Pool name Start IP address End IP address Free In use aaa1 1.1.1.1 1.1.1.5 5 0 aaa2 1.1.1.6 1.1.1.10 5 0 Group name: b Pool name Start IP address End IP address Free In use bbb 1.1.2.1 1.1.2.5 4 1

2.2.2.1 2.2.2.5 5 0

# Display brief information about the PPP address pools in group a.

<Sysname> display ip pool group a Group name: a Pool name Start IP address End IP address Free In use aaa1 1.1.1.1 1.1.1.5 5 0 aaa2 1.1.1.6 1.1.1.10 5 0

# Display detailed information about PPP address pool bbb.

<Sysname> display ip pool bbb Group name: b Pool name Start IP address End IP address Free In use bbb 1.1.2.1 1.1.2.5 4 1

2.2.2.1 2.2.2.5 5 0 In use IP addresses: IP address Interface

1.1.2.1 POS2/2/0

Table 1 Command output

Free Number of free IP addresses.

In use Number of IP addresses that have been assigned.

Field

Description

In use IP addresses Information about the IP addresses that have been assigned.

Interface Local interface that requests the IP address for the peer interface.

Related commands

ip pool

display ppp access-user

Use display ppp access-user to display PPP user information.

Syntax

display ppp access-user { interface interface-type interface-number [ count ]

| ip-address ip-address | ipv6-address ipv6-address | username user-name | user-type { lac | lns | pppoa | pppoe } [ count ] }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Displays brief information about PPP users on the

specified interface.

count: Displays the total number of PPP users that match the specified criteria. ip-address ip-address: Displays detailed information about the PPP user specified by its IP address. ipv6-address ipv6-address: Displays detailed information about the PPP user specified by its IPv6

address.

username user-name: Displays detailed information about the PPP user specified by its username,

a case-sensitive string of 1 to 80 characters.

user-type: Displays brief information about online users of the specified type. lac: Displays brief information about L2TP users for an LAC. lns: Displays brief information about L2TP users for an LNS. pppoa: Displays brief information about PPPoA users. pppoe: Displays brief information about PPPoE users.

Usage guidelines

Brief information about a PPP user includes the following:

• Brief name of the VA interface.

• Username.

• MAC address.

• IPv4 address, IPv6 address, or IPv6 prefix of the PPP user.

Detailed information about a PPP user includes the following:

• Brief name of the VA interface.

• User ID.

Field

Description

• Username.

• Authentication information.

• Uplink and downlink traffic.

• Access start time of the PPP user.

Examples

# Display brief information about PPP users on GigabitEthernet 1/0/1.

<Sysname> display ppp access-user interface gigabitethernet 1/0/1 Interface Username MAC address IP address IPv6 address IPv6 PDPrefix VA0 user1@h3c 0001-0101-9101 192.168.100.173 - VA1 user2@h3c 0001-0101-9101 192.168.80.173 2000::1 -

# Display the total number of PPP users on GigabitEthernet 1/0/1.

<Sysname> display ppp access-user interface gigabitethernet 1/0/1 count Total users: 2

Table 2 Command output

Interface Name of the VA interface corresponding to the user.

Username

MAC address

IP address

IPv6 address

IPv6 PDPrefix

Username of the user.

A hyphen (-) means that the user does not need authentication.

MAC address of the user.

A hyphen (-) means that the user is not a PPPoE user.

IP address of the user. A hyphen (-) means that no IP address is assigned to the user.

IPv6 address of the user. A hyphen (-) means that no IPv6 address is assigned to the user.

IPv6 prefix of the user. A hyphen (-) means that no IPv6 prefix is assigned to the user.

Total users Total number of PPP users.

# Display detailed information about the PPP user whose IP address is 50.50.50.3.

<Sysname> display ppp access-user ip-address 50.50.50.3 Basic: Interface: VA0 User ID: 0x28000002 Username: user1@hrss Domain: hrss Access interface: RAGG2 Service-VLAN/Customer-VLAN: -/ MAC address: 0000-0000-0001 IP address: 50.50.50.3 IPv6 address: IPv6 PD prefix: VPN instance: 123 Access type: PPPoE Authentication type: CHAP

Field

Description

AAA: Authentication state: Authenticated Authorization state: Authorized Realtime accounting switch: Open Realtime accounting interval: 60s Login time: 2013-1-19 2:42:3:358 Accounting start time: 2013-1-19 2:42:3:382 Accounting state: Accounting Online time(hh:mm:ss): 0:7:34 Idle cut: 0 sec 0 byte Session timeout: 12000 s Time remained: 8000 s Byte remained: 20971520 bytes Redirect WebURL: http://6.6.6.6

ACL&QoS: User profile: profile123 (active) User group profile: Inbound CAR: CIR 64000bps PIR 640000bps Outbound CAR: CIR 64000bps PIR 640000bps

NAT: Global IP address: 111.8.0.200 Port block: 28744-28748

Flow Statistic: IPv4 uplink packets/bytes: 7/546 IPv4 downlink packets/bytes: 0/0 IPv6 uplink packets/bytes: 0/0 IPv6 downlink packets/bytes: 0/0

ITA: Level-1 uplink packets/bytes: 100/128000 downlink packets/bytes: 200/256000 Level-2 uplink packets/bytes: 100/128000 downlink packets/bytes: 200/256000

Table 3 Command output

Basic Basic information.

Interface Brief name of the VA interface that corresponds to the user.

Username

Domain

Access interface Name of the access interface of the user.

Username of the user.

A hyphen (-) means that the user does not need authentication.

ISP domain name for authentication.

A hyphen (-) means that no ISP domain is specified for authentication.

Field

Description

Service-VLAN/Customer-VLAN

Service provider VLAN and customer VLAN information of the user.

A hyphen (-) means that no VLAN information is available.

IP address

IPv6 address

IPv6 PD prefix

VPN instance

Access type

Authentication type

Authentication state

IP address of the user. A hyphen (-) means that no IP address is assigned to the user.

IPv6 address of the user. A hyphen (-) means that no IPv6 address is assigned to the user.

Delegated IPv6 prefix of the user. A hyphen (-) means that no delegated IPv6 prefix is assigned to the user.

VPN instance to which the user belongs.

A hyphen (-) means that the user is not bound to any VPN instance.

Access type of the user:

• PPPoE.

• PPPoA.

• L2TP.

Authentication type of the user:

• PA P.

• CHAP.

• MS-CHAP.

• MS-CHAP-V2.

Authentication state of the user:

• Idle—The user has not been authenticated.

• Authenticating—The user is being authenticated.

• Authenticated—The user has been authenticated.

Authorization state of the user:

Authorization state

Realtime accounting switch

Realtime accounting interval

Accounting start time

Online time(hh:mm:ss) Online duration of the current login.

Accounting state

Idle cut

• Idle—The user has not been authorized.

• Authorizing—The user is being authorized.

• Authorized—The user has been authorized.

• Open—The switch is on.

• Closed—The switch is off.

Realtime accounting interval in seconds.

A hyphen (-) means that no real-time accounting interval is authorized.

Time when accounting started.

A hyphen (-) means that no accounting is performed on the user.

Accounting state of the user:

• Accounting—Accounting is on.

• Stop—Accounting stops.

Traffic threshold for logging off the user in idle state.

If the traffic is less than the threshold within the specified period, the user is forcibly logged off.

Field

Description

Session timeout

Time remained

Byte remained

Redirect WebURL

User profile

User group profile

Authorization time for the user, in seconds.

A hyphen (-) means that no authorization time is specified for the user.

Remaining time for the user to stay online, in seconds.

A hyphen (-) means that no authorization time is specified for the user.

Remaining traffic for the user.

A hyphen (-) means that no authorization traffic is specified for the user.

Redirect Web URL address for the user.

A hyphen (-) means that no redirect Web URL address is specified for the user.

Name of the authorized user profile. The hyphen (-) means that no user profile is authorized.

The user profile has two states:

• active—The authorized user profile is successfully issued.

• inactive—The authorized user profile fails to be issued.

Name of the authorized user group profile. The hyphen (-) means that no user group profile is authorized.

The user group profile has two states:

• active—The authorized user group profile is successfully

issued.

• inactive—The authorized user group profile fails to be issued.

Inbound CAR Authorized inbound CARs, which contain the CIR and the PIR.

Outbound CAR Authorized outbound CARs, which contain the CIR and the PIR.

Global IP address

Port block

IPv4 uplink packets/bytes Number of packets and bytes for IPv4 uplink traffic.

IPv4 downlink packets/bytes Number of packets and bytes for IPv4 downlink traffic.

IPv6 uplink packets/bytes Number of packets and bytes for IPv6 uplink traffic.

IPv6 downlink packets/bytes Number of packets and bytes for IPv6 downlink traffic.

ITA

Level-n uplink packets/bytes

downlink packets/bytes

Related commands

Global IP address of the user.

This field is displayed if NAT444 is used. For information about

NAT444, see Layer 3—IP Services Co nfiguration Guide.

Port block of the user, from the start port to the end port.

This field is displayed if NAT444 is used.

ITA statistics.

ITA statistics are displayed after ITA is enabled.

traffic-separate enable

If the statistics are not included in flow statistics. For information about ITA and the

Configuration Guide. Number of packets and bytes for uplink traffic at accounting level n.

The value for n depends on the

value range is 1 to 8.

traffic-separate enable

command is configured, ITA

command, see Security

traffic level

command, and its

reset ppp access-user

display ppp compression iphc

Use display ppp compression iphc to display IP header compression (IPHC) statistics.

Syntax

display ppp compression iphc { rtp | tcp } [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

rtp: Displays IPHC RTP header compression statistics. tcp: Displays IPHC TCP header compression statistics. interface interface-type interface-number: Specifies an interface by its type and number. If you do

not specify this option, the command displays IPHC statistics on all interfaces.

Usage guidelines

When IPHC applies to an MP link:

• If an MP template is used, such as a VT interface or a dialer interface, the associated VA

interface performs IPHC. You can view the compression information on the VA interface.

• If an MP-group interface is used, the MP-group interface performs IPHC. You can view the

compression information on the MP-group interface.

When IPHC applies to a normal PPP link, the physical interface performs IPHC. You can view the compression information on the physical interface.

Examples

# Display IPHC RTP header compression statistics.

<Sysname> display ppp compression iphc rtp

----------------------Slot1---------------------Interface: Virtual-Access0 Received: Compressed/Error/Total: 0/0/0 packets Sent: Compressed/Total: 0/0 packets Sent/Saved/Total: 0/0/0 bytes Packet-based compression ratio: 0% Byte-based compression ratio: 0% Connections: Rx/Tx: 16/16 Five-Minute-Miss: 0 (Misses/5Mins) Max-Miss: 0

# Display IPHC TCP header compression statistics.

<Sysname>display ppp compression iphc tcp

----------------------Slot1---------------------Interface: Virtual-Access0

Field

Description

Received: Compressed/Error/Total: 0/0/0 packets Sent: Compressed/Total: 0/0 packets Sent/Saved/Total: 0/0/0 bytes Packet-based compression ratio: 0% Byte-based compression ratio: 0% Connections: Rx/Tx: 16/16 Five-Minute-Miss: 0 (Misses/5Mins) Max-Miss: 0

Table 4 Command output

Statistics for received packets:

Received:

Compressed/Error/Total

Sent:

Compressed/Total

Sent/Saved/Total

Packet-based compression ratio

Byte-based compression ratio

• Compressed—Number of compressed packets.

• Error—Number of error packets.

• Total—Total number of received packets.

Statistics for sent packets:

• Compressed—Number of compressed packets.

• Total—Total number of sent packets.

• Sent—Bytes of sent packets.

• Saved—Bytes of saved packets.

• Total—Total bytes to be sent if packets are not compressed.

• Packet-based compression ratio—Ratio of compressed

packets to the total sent packets.

• Byte-based compressio n ratio—Ratio of saved bytes to the

total sent bytes.

Connections:

Rx/Tx

Five-Minute-Miss

Max-Miss

Related commands

ppp compression iphc enable reset ppp compression iphc

ip address ppp-negotiate

Use ip address ppp-negotiate to enable IP address negotiation on an interface, so that the

interface can accept the IP address allocated by the server.

Use undo ip address ppp-negotiate to restore the default.

Syntax

ip address ppp-negotiate undo ip address ppp-negotiate

Number of connections.

• Rx—Number of connections that the receiver can decompress.

• Tx—Number of connections that the sender can compress.

• Five-Minute-Miss—Number of search failures within the last 5

minutes.

• Max-Miss—Maximum number of search failures within 5

minutes.

Default

IP address negotiation is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

If you execute the ip address ppp-negotiate and ip address commands multiple times, the most

recent configuration takes effect.

Examples

# Enable IP address negotiation on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ip address ppp-negotiate

Related commands

ip address (Layer 3—IP Services Command Reference) remote address

ip pool

Use ip pool to configure a PPP address pool. Use undo ip pool to remove a PPP address pool or an IP address range of the PPP address pool.

Syntax

ip pool pool-name start-ip-address [ end-ip-address ] [ group group-name ] undo ip pool pool-name [ start-ip-address [ end-ip-address ] ]

Default

No PPP address pool is configured.

Views

System view

Predefined user roles

network-admin

Parameters

pool-name: Specifies a name for the PPP address pool to be created, a case-sensitive string of 1 to

31 characters.

start-ip-address [ end-ip-address ]: Specifies an IP address range. If you do not specify the end-ip-address argument, the PPP address pool has only the start IP address.

group group-name: Specifies a group by its name to which the PPP address pool belongs. The

group name is a c ase-sensitive string of 1 to 31 characters. If you do not specify this option, the

group name is default (the default group).

Usage guidelines

The system supports multiple address spaces that each correspond to a VPN instance. The same IP addresses can exist in different address spaces.

Each address space is represented by a group. One group can contain multiple PPP address pools, but one PPP address pool can belong to only one group.

One PPP address pool can contain multiple IP address ranges. You can execute this command multiple times to specify multiple IP address ranges for a PPP address pool. A PPP address pool can contain a maximum of 65535 IP addresses, and so can an IP address range.

IP address ranges in different groups can be overlapping, but those in the same group cannot.

Changes to a PPP address pool do not affect assigned IP addresses. For example, if you delete a PPP address pool from which an IP address has been assigned, the IP address can still be used.

When assigning IP address to users through a PPP address pool, make sure the PPP address pool excludes the gateway IP address of the PPP address pool.

Examples

# Configure PPP address pool aaa that contains IP addresses 129.102.0.1 through 129.102.0.10 for group a.

<Sysname> system-view [Sysname] ip pool aaa 129.102.0.1 129.102.0.10 group a

Related commands

display ip pool

ip pool gateway

Use ip pool gateway to configure a gateway address for a PPP address pool. Use undo ip pool gateway to remove the gateway address for the specified PPP address pool.

Syntax

ip pool pool-name gateway ip-address [ vpn-instance vpn-instance-name ] undo ip pool pool-name gateway

Default

A PPP address pool is not configured with a gateway address.

Views

System view

Predefined user roles

network-admin

Parameters

pool-name: Specifies an existing PPP address pool by its name, a case-sensitive string of 1 to 31

characters.

ip-address: Specifies a gateway address for the PPP address pool. vpn-instance vpn-instance-name: Specifies an existing MPLS L3VPN instance by its name, a

case-sensitive string of 1 to 31 characters. If you do not specify this option, the specified gateway belongs to the public network.

Usage guidelines

The IP pool gateway setting takes precedence over the DHCP pool gateway setting.

An interface on a BRAS must have an IP address before it can assign an IP address from a PPP or DHCP address pool to a client. This command enables interfaces that have no IP address to use a gateway address for IPCP negotiation and address allocation.

When you configure a gat eway address for a P PP address pool, follow these restrictions and guidelines:

• If you also specify an IP address for an interface, the interface uses its own IP address to

perform IPCP negotiation.

• You can specify only one gateway address for a PPP address pool. Different PPP address

pools must have different gateway addresses (different combinations of

and vpn-instance-name).

• You can specify any gateway address for a PPP address pool.

Examples

# Specify gateway address 1.1.1.1 and VPN instance test for PPP address pool aaa.

<Sysname> system-view [Sysname] ip pool aaa gateway 1.1.1.1 vpn-instance test

Related commands

ip pool

link-protocol ppp

Use link-protocol ppp to enable PPP encapsulation on an interface.

Syntax

ip-address

link-protocol ppp

Default

PPP encapsulation is enabled on all interfaces except Ethernet, VLAN, and ATM interfaces.

Views

Interface view

Predefined user roles

network-admin

Examples

# Enable PPP encapsulation on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] link-protocol ppp

nas-port-type

Use nas-port-type to configure the nas-port-type attribute on a VT interface. Use undo nas-port-type to restore the default.

Syntax

Default

nas-port-type { 802.11 | adsl-cap | adsl-dmt | async | cable | ethernet | g.3-fax | hdlc | idsl

| isdn-async-v110 | isdn-async-v120 | isdn-sync | piafs | sdsl | sync | virtual | wireless-other | x.25 | x.75 | xdsl }

undo nas-port-type

The nas-port-type attribute is determined by the service type and link type of the PPP user, as shown in Table 5.

Service type

Link type

Nas-port-type attribute

Table 5 Default nas-port-type attribute

PPPoE

PPPoA Any

L2TP Any

Views

VT interface view

Predefined user roles

network-admin

Parameters

802.11: Specifies IEEE 802.11. The code value is 19. adsl-cap: Specifies asymmetric DSL, Carrierless Amplitude Phase. The code value is 12. adsl-dmt: Specifies asymmetric DSL, Discrete Multi-Tone. The code value is 13. async: Specifies async. The code value is 0. cable: Specifies cable. The code value is 17. ethernet: Specifies Ethernet. The code value is 15. g.3-fax: Specifies G.3 Fax. The code value is 10.

Layer 3 virtual Ethernet interface

Other interfaces

xdsl ethernet xdsl virtual

hdlc: Specifies HDLC Clear Channel. The code value is 7. idsl: Specifies ISDN Digital Subscriber Line. The code value is 14. isdn-async-v110: Specifies ISDN Async V.110. The code value is 4. isdn-async-v120: Specifies ISDN Async V.120. The code value is 3. isdn-sync: Specifies ISDN Sync. The code value is 2. piafs: Specifies PHS Internet Access Forum Standard. The code value is 6. sdsl: Specifies symmetric DSL. The code value is 11. sync: Specifies sync. The code value is 1. virtual: Specifies virtual. The code value is 5. wireless-other: Specifies wireless–other. The code value is 18. x.25: Specifies X.25. The code value is 8. x.75: Specifies X.75. The code value is 9. xdsl: Specifies Digital Subscriber Line of unknown type. The code value is 16.

Usage guidelines

The nas-port-type attribute is used for RADIUS authentication and accounting. For more information about the nas-port-type attribute, see RFC 2865.

Examples

# Set the nas-port-type attribute to sync for Virtual-Template 1.

<Sysname> system-view [Sysname] interface virtual-template 1 [Sysname-Virtual-Template1] nas-port-type sync

ppp accm

Use ppp accm to set the ACCM value sent to the peer on an interface. Use undo ppp accm to restore the default.

Syntax

ppp accm hex-number undo ppp accm

Default

The ACCM value sent to the peer is 0x000A0000 on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

hex-number: Specifies an ACCM value in hexadecimal format, in the range of 0 to 0xFFFFFFFF.

Usage guidelines

ACCM negotiation only applies to asynchronous links.

Examples

# Set the ACCM value sent to the peer to 0x01010101 on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp accm 01010101

ppp account-statistics enable

Use ppp account-statistics enable to enable PPP accounting on an interface. Use undo ppp account-statistics enable to disable PPP accounting on an interface.

Syntax

ppp account-statistics enable [ acl { acl-number | name acl-name } ] undo ppp account-statistics enable

Default

PPP accounting is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

acl: Specifies an ACL to match traffic. If no ACL is specified, the device generates statistics for all

PPP traffic.

acl-number: Specifies an ACL by its number in the range of 2000 to 3999, where:

• 2000 to 2999 are numbers for basic IPv4 and IPv6 ACLs.

• 3000 to 3999 are numbers for advanced IPv4 and IPv6 ACLs.

If the specified ACL number corresponds to an IPv4 ACL and an IPv6 ACL, both ACLs take effect.

name acl-name: Specifies an ACL by its name, a case-insensitive string of 1 to 63 characters that start with an alphabetical character. To avoid confusion, do not use all as an ACL name.

Examples

# Enable PPP accounting on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp account-statistics enable

ppp acfc local-request

Use ppp acfc local-request to configure an interface to send ACFC requests by including the ACFC

option in outbound LCP negotiation requests.

Use undo ppp acfc local-request to restore the default.

Syntax

ppp acfc local-request undo ppp acfc local-request

Default

An interface does not include the ACFC option in outbound LCP negotiation requests.

Views

Interface view

Predefined user roles

network-admin

Examples

# Configure Serial 2/1/0 to send ACFC requests to the peer in PPP negotiation.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp acfc local-request

ppp acfc remote-reject

Use ppp acfc remote-reject to configure an interface to reject ACFC requests received from the

remote peer.

Use undo ppp acfc remote-reject to restore the default.

Syntax

Default

ppp acfc remote-reject undo ppp acfc remote-reject

An interface accepts ACFC requests received from the remote peer, and it performs ACFC on frames sent to the peer.

Views

Interface view

Predefined user roles

network-admin

Examples

# Configure Serial 2/1/0 to reject ACFC requests received from the remote peer.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp acfc remote-reject

ppp authentication-mode

Use ppp authentication-mode to configure PPP authentication on an interface. Use undo ppp authentication-mode to restore the default.

Syntax

ppp authentication-mode { chap | ms-chap | ms-chap-v2 | pap } * [ [ call-in ] domain { isp-name | default enable isp-name } ]

undo ppp authentication-mode

Default

PPP authentication is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

chap: Uses CHAP authentication. ms-chap: Uses MS-CHAP authentication. ms-chap-v2: Uses MS-CHAP-V2 authentication. pap: Uses PAP authentication. call-in: Authenticates the call-in users only. This keyword can be configured when the local end acts

as the receiving end of DDR calls. For more information about DDR, see Layer 2 Configuration Guide.

domain isp-name: Specifies the ISP domain name for authentication, a case-insensitive string of 1

to 255 characters.

default enable isp-name: Specifies the default ISP domain name for authentication, a

case-insensitive string of 1 to 255 characters.

—

WAN Access

Usage guidelines

PPP authentication includes the following categories:

• PAP—Two-way handshake authentication. The password is in plain text or cipher text.

• CHAP—Three-way handshake authentication. The password is in plain text or cipher text.

• MS-CHAP—Three-way handshake authentication. The password is in cipher text.

• MS-CHAP-V2—Three-way handshake authentication. The password is in cipher text.

You can configure multiple authentication modes.

In any PPP authentication mode, AAA determines whether a us er can pass the authentication through a l ocal authentication database or an AAA server. For more information about AAA

authentication, see Security Configuration Gui de. If you configure the ppp authentication-mode command with the domain keyword specified, you

must perform the following tasks:

• Use the specified ISP domain to authenticate the peer.

• Use a PPP address pool associated with this ISP domain for address allocation (if necessary).

You can use the display domain command to display the domain configuration.

The system can obtain ISP domains through multiple ways during user authentication. The system chooses one of the following ISP domains for authentication in descending priority order:

• ISP domain specified by the domain isp-name option. Use a PPP address pool associated with

this ISP domain for address allocation (if necessary). You can use the display domain

command to display the domain configuration.

• ISP domain contained in the username. If the ISP domain does not exist on the local device, the

user's access request is denied.

• ISP domain specified by the default enable isp-name option.

• Default ISP domain in the system. You can use the domain default command to configure the

default ISP domain. If no default ISP domain is configured, the default ISP domain (system) is

used.

For authentication on a dialup interface, configure authentication on both the physical interface and the dialer interface. When a physical interface receives a D DR call request, it first initiates PPP negotiation and authenticates the dial-in user. Then it passes the call to the upper layer protocol.

Examples

# Configure Serial 2/1/0 to authenticate the peer by using PAP.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp authentication-mode pap

# Configure Serial 2/1/0 to authenticate the peer by using PAP, CHAP, and MS-C H A P.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp authentication-mode pap chap ms-chap

Related commands

domain default (Security Command Reference) local-user (Security Command Refere nce ) ppp chap password ppp chap user ppp pap local-user

ppp chap password

Use ppp chap password to set the password for CHAP authentication on an interface. Use undo ppp chap password to restore the default.

Syntax

ppp chap password { cipher | simple } string

undo ppp chap password

Default

No password is set for CHAP authentication on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

cipher: Specifies a password in encrypted form. simple: Specifies a password in plaintext form. For security purposes, the password specified in

plaintext form will be stored in encrypted form. string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 255 characters. Its

encrypted form is a case-sensitive string of 1 to 97 characters.

Examples

# Set the password for CHAP authentication to plaintext password sysname on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp chap password simple sysname

Related commands

ppp authentication-mode chap

ppp chap user

Use ppp chap user to set the username for CHAP authentication on an interface. Use undo ppp chap user to restore the default.

Syntax

ppp chap user username undo ppp chap user

Default

The username for CHAP authentication is null on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

username: Specifies the username for CHAP authentication, a case-sensitive string of 1 to 80

characters. The username is sent to the peer for the local device to be authenticated.

Usage guidelines

To pass CHAP authentication, the username/password of one side must be the local username/password on the peer.

Examples

# Set the username for CHAP authentication to Root on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp chap user Root

Related commands

ppp authentication-mode chap

ppp compression iphc enable

Use ppp compression iphc enable to enable IPHC on an interface. Use undo ppp compression iphc enable to disable IPHC on an interface.

Syntax

ppp compression iphc enable [ nonstandard ] undo ppp compression iphc enable

Default

IPHC is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

nonstandard: Specifies the nonstandard encapsulation format. If you do not specify this keyword,

packets are encapsulated in standard format. You must specify this keyword when the device communicates with a non-H3C device. If you specify this keyword, this command enables RTP header compression.

Usage guidelines

IPHC includes RTP header compression and TCP header compression.

Enabling or disabling IPHC enables or disables both RTP header compression and T CP header compression.

To use IPHC, you must enable it on both sides of a PPP link.

When you enable IPHC on a VT, dialer, or ISDN interface, the setting does not immediately take

effect. For the setting to take effect, execute the shutdown and then undo shutdo wn commands on

the interface or its bound physical interface.

Examples

# Enable IPHC on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp compression iphc enable

ppp compression iphc rtp-connections

Use ppp compression iphc rtp-connections to set the maximum number of connections for which

an interface can perform RTP header compression.

Use undo ppp compression iphc rtp-connections to restore the default.

Syntax

ppp compression iphc tcp-connections number undo ppp compression iphc tcp-connections

Default

An interface can perform RTP header compression for a maximum of 16 connections.

Views

Interface view

Predefined user roles

network-admin

Parameters

number: Specifies the maximum number of connections for which an interface can perform RTP

header compression. The value range for this argument is 3 to 1000:

• When the number argument is set to a value less than or equal to 256, packets are compressed

in the format of COMPRESSED RTP 8.

• When the number argument is set to a value greater than 256, packets are compressed in the

format of COMPRESSED RTP 16.

Usage guidelines

RTP is a connection-oriented protocol. An interface can accommodate multiple RTP connections.

RTP header compression occupies memory resources for maintaining connection information. This command can limit memory resources used by compression. For example, if you set the limit to 3, RTP header compression only applies to a maximum of three RTP connections.

After you execute this command, you must shut down and then bring up the interface to make the command take effect.

You can configure this command only when IPHC is enabled. The configuration is removed after IPHC is disabled.

Examples

# Set the maximum number of connections for which Serial 2/1/0 can perform RTP header compression to 10.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp compression iphc enable [Sysname-Serial2/1/0] ppp compression iphc rtp-connections 10

Related commands

ppp compression iphc enable

ppp compression iphc tcp-connections

Syntax

Use ppp compression iph c tcp-connections to set the maximum number of connections for which

an interface can perform TCP header compression.

Use undo ppp compression iphc tcp-connections to restore the default.

ppp compression iphc tcp-connections number

undo ppp compression iphc tcp-connections

Default

An interface can perform TCP header compression for a maximum of 16 connections.

Views

Interface view

Predefined user roles

network-admin

Parameters

number: Specifies the maximum number of connections for which an interface can perform TCP

header compression. The value range for this argument is 3 to 256.

Usage guidelines

TCP is a connection-oriented protocol. A link can accommodate multiple TCP connections.

TCP header compression occupies memory resources for maintaining connection information. This command can limit memory resources used by compression. For example, if you set the limit to 3, TCP header compression only applies to a maximum of three TCP connections.

After you execute this command, you must shut down and then bring up the interface to make the command take effect.

You can configure this command only when IPHC is enabled and packets are encapsulated in standard format. The configuration is removed after IPHC is disabled or packets are encapsulated in nonstandard format.

Examples

# Set the maximum number of connections for which Serial 2/1/0 can perform TCP header compression to 10.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp compression iphc enable [Sysname-Serial2/1/0] ppp compression iphc tcp-connections 10

Related commands

ppp compression iphc enable

ppp ipcp dns

Use ppp ipcp dns to configure the primary and secondary DNS server IP addresses to be allocated

in PPP negotiation on an interface.

Use undo ppp ipcp dns to delete the primary and secondary DNS server IP addresses to be

allocated in PPP negotiation on an interface.

Syntax

ppp ipcp dns primary-dns-address [ secondary-dns-address ] undo ppp ipcp dns primary-dns-address [ secondary-dns-address ]

Default

Views

The DNS server IP addresses to be allocated in PPP negotiation are not configured on an interface.

Interface view

Predefined user roles

network-admin

Parameters

primary-dns-address: Specifies a primary DNS server IP address. secondary-dns-address: Specifies a secondary DNS server IP address.

Usage guidelines

A device can assign DNS server IP addresses to its peer during PPP negotiation when the peer initiates requests.

To check the allocated DNS server IP addresses, execute the winipcfg or ipconfig /all command on

the host.

Examples

# Set the primary and secondary DNS server IP addresses to 100.1.1.1 and 100.1.1.2 for the peer on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp ipcp dns 100.1.1.1 100.1.1.2

ppp ipcp dns admit-any

Use ppp ipcp dns admit-any to configure an interface to accept the DNS server IP addresses

assigned by the peer even though it does not request DNS server IP addresses from the peer.

Use undo ppp ipcp dns admit-any to restore the default.

Syntax

ppp ipcp dns admit-any undo ppp ipcp dns admit-any

Default

An interface does not accept the DNS server IP addresses assigned by the peer if it does not request DNS server IP addresses from the peer.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

You can configure an interface to accept the DNS server IP addresses assigned by the peer, through which domain names can be resolved for the device.

Typically, the server assigns a DNS server address to a client in PPP negotiation only when the client

is configured with the ppp ipcp dns request command. Some servers, however, forcibly assign DNS server addresses to clients. You must configure the ppp ipcp dns admit-any command on the

client devices to accept the DNS server addresses.

Examples

# Configure Serial 2/1/0 to accept DNS server IP addresses allocated by the peer.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp ipcp dns admit-any

Related commands

ppp ipcp dns request

Use ppp ipcp dns request to enable an interface to actively request the DNS server IP address

from its peer.

Use undo ppp ipcp dns request to restore the default.

Syntax

ppp ipcp dns request undo ppp ipcp dns request

Default

An interface does not actively request the DNS server IP address from its peer.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

If a device is connected to a provider's access server through a PPP link, you can use this command. Then, the device can obtain the specified DNS server IP address from the access server during IPCP negotiation.

You can check the DNS server IP addresses by displaying information about the interface.

Examples

# Enable Serial 2/1/0 to actively request the DNS server IP address from its peer.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp ipcp dns request

ppp ipcp remote-address match

Use ppp ipcp remote-address match to enable the IP segment match feature for PPP IPCP

negotiation on an interface.

Use undo ppp ipcp remote-address match to restore the default.

Syntax

ppp ipcp remote-address match undo ppp ipcp remote-address match

Default

The IP segment match feature is disabled for PPP IPCP negotiation on an interface.

Views

Interface view

Predefined user roles

network-admin

BRAS Core router

Host

Switch

Usage guidelines

This command enables the local interface to check whether its IP address and the IP address of the remote interface are in the same network segment. If they are not, IPCP negotiation fails.

Examples

# Enable the IP segment match feature on Virtual-Template 1.

<Sysname> system-view [Sysname] interface virtual-template 1 [Sysname-Virtual-Template1] ppp ipcp remote-address match

ppp ip-pool route

Use ppp ip-pool route to configure a PPP address pool route. Use undo ppp ip-pool route to remove a PPP address pool route.

Syntax

ppp ip-pool route ip-address { mask-length | mask } [ vpn-instance vpn-instance-name ] undo ppp ip-pool route ip-address { mask-length | mask } [ vpn-instance vpn-instance-name ]

Default

No PPP address pool route is configured.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the destination IP address of the PPP address pool route, in dotted decimal

notation.

mask-length: Specifies a mask length for the IP address, in the range of 0 to 32. mask: Specifies a mask for the IP address, in dotted decimal notation.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a

case-sensitive string of 1 to 31 characters. If you do not specify this option, the PPP address pool route applies to the public network.

Usage guidelines

The BRAS uses PPP address pool routes to control downlink traffic forwarding.

After you configure a PPP address pool route, the BRAS generates a static blackhole route destined for the specified network. All traffic matching the blackhole route is discarded. When a legal user logs in, the BRAS adds a host route destined for the specified network. In addition, the BRAS uses a dynamic routing protocol to redistribute the PPP address pool route to the upstream device.

Figure 1 Network diagram for the PPP address pool route

Make sure the destination network of the PPP address pool route includes the PPP address pool. You can execute this command multiple times to configure multiple PPP address pool routes.

Examples

# Configure the PPP address pool route as 2.2.2.2/24.

<Sysname> system-view [Sysname] ppp ip-pool route 2.2.2.2 24

ppp lcp delay

Use ppp lcp delay to set the LCP negotiation delay timer. Use undo ppp lcp delay to restore the default.

Syntax

ppp lcp delay milliseconds undo ppp lcp delay

Default

PPP starts LCP negotiation immediately after the physical layer comes up.

Views

Interface view

Predefined user roles

network-admin

Parameters

milliseconds: Specifies the LCP negotiation delay timer in the range of 1 to 10000 milliseconds.

Usage guidelines

If two ends of a PPP link vary greatly in the LCP negotiation packet processing rate, configure this command on the end with a hi gher processing rate. The LCP negotiation delay timer prevents frequent LCP negotiation packet retransmissions. After the physical layer comes up, PPP starts LCP negotiation when the delay timer expires. If PPP receives LCP negotiation packets before the delay timer expires, it starts LCP negotiation immediately.

Examples

# Set the LCP negotiation delayer timer to 130 milliseconds.

<Sysname> system-view [Sysname] interface virtual-template 1 [Sysname-Virtual-Template1] ppp lcp delay 130

ppp lqm

Use ppp lqm to enable PPP link quality Monitoring (LQM) on an interface. Use undo ppp lqm to disable PPP LQM on an interface.

Syntax

Default

Views

ppp lqm close-percentage close-percentage [ resume-percentage resume-percentage ] undo ppp lqm

PPP LQM is disabled on an interface.

Interface view

Predefined user roles

network-admin

Parameters

close-percentage close-percentage: Specifies the PPP LQM close percentage in the range of 0 to

100.

resume-percentage resume-percentage: Specifies the PPP LQM resume percentage in the range

of 0 t o 100. The resume percentage must be greater than or equal to the close percentage. The default resume percentage is equal to the close percentage.

Usage guidelines

If you enable PPP LQM on both sides of a PPP link, make sure both sides have the same PPP LQM settings. Typically, there is no need to enable PPP LQM on both sides of a PPP link.

As a best practice, do not enable PPP LQM on a DDR dial-up link because DDR tears the link down when the link is closed by LQM. Then LQM cannot send LQR packets to resume the link.

Examples

# Enable PPP LQM on Serial 2/1/0, and set the PPP LQM close percentage to 90 and r esume percentage to 95.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp lqm close-percentage 90 resume-percentage 95

ppp lqm lcp-echo

Use ppp lqm lcp-echo to configure an interface to periodically send LCP echo packets when LQM

detects a low quality link.

Use undo ppp lqm lcp-echo to restore the default.

Syntax

ppp lqm lcp-echo [ packet size ] [ interval interval ] undo ppp lqm lcp-echo

Default

An interface does not send LCP echo packets when LQM detects a low quality link.

Views

Interface view

Predefined user roles

network-admin

Parameters

packet size: Specifies the size added for the LCP echo packet, in the range of 128 to 1500 bytes. interval interval: Specifies the interval for sending LCP echo packets, in the range of 1 to 10

seconds.

Usage guidelines

This feature can avoid PPP link flapping caused by loss of large LCP packets.

Examples

# Configure Serial2/1/0 to send a LCP echo packet every 1 second. The LCP echo packet is 1400 bytes larger than the original length.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp lqm lcp-echo packet 1400 interval 1

ppp pap local-user

Use ppp pap local-user to set the local username and password for PAP authentication on an

interface.

Use undo ppp pap local-user to restore the default.

Syntax

ppp pap local-user username password { cipher | simple } string undo ppp pap local-user

Default

The local username and password for PAP authentication are blank on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

username: Specifies the username of the local device for PAP authentication, a case-sensitive string

of 1 to 80 characters.

cipher: Specifies a password in encrypted form. simple: Specifies a password in plaintext form. For security purposes, the password specified in

plaintext form will be stored in encrypted form. string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 255 characters. Its

encrypted form is a case-sensitive string of 1 to 373 characters.

Usage guidelines

For the local device to pass PAP authentication on the peer, make sure the username and password configured for the local device are also configured on t he peer. You can configure the peer's

username and password by using the local-user username and password { cipher | simple } string

commands, respectively.

Examples

# Set the local username and password for PAP authentication to user1 and plaintext pass1 on

Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp pap local-user user1 password simple pass1

Related commands

local-user (Security Command Refere nce) password (Security Command Reference)

ppp pfc local-request

Use ppp pfc local-request to configure an interface to send PFC requests by including the PFC

option in outbound LCP negotiation requests.

Use undo ppp pfc local to restore the default.

Syntax

ppp pfc local-request undo ppp pfc local-request

Default

An interface does not include the PFC option in outbound LCP negotiation requests.

Views

Interface view

Predefined user roles

network-admin

Examples

# Configure Serial 2/1/0 to send PFC requests during PPP negotiation.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp pfc local-request

ppp pfc remote-reject

Use ppp pfc remote-reject to configure an i nterface to reject PFC requests received from the

remote peer.

Use undo ppp pfc remote to restore the default.

Syntax

ppp pfc remote-reject undo ppp pfc remote-reject

Default

An interface accepts PFC requests received from the remote peer, and it performs PFC on frames sent to the peer.

Views

Interface view

Predefined user roles

network-admin

Examples

# Configure Serial 2/1/0 to reject PFC requests received from the remote peer.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp pfc remote-reject

ppp timer negotiate

Use ppp timer negotiate to set the PPP negotiation timeout time on an interface. Use undo ppp timer negotiate to restore the default.

Syntax

ppp timer negotiate seconds undo ppp timer negotiate

Default

The PPP negotiation timeout time is 3 seconds on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

seconds: Specifies the negotiation timeout time in the range of 1 to 10 seconds.

Usage guidelines

In PPP negotiation, if the local device receives no response from the peer during the timeout time after it sends a packet, the local device sends the last packet again.

Examples

# Set the PPP negotiation timeout time to 5 seconds on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp timer negotiate 5

remote address

Use remote address to configure an interface to assign an IP address to the client. Use undo remote address to restore the default.

Syntax

remote address { ip-address | pool pool-name } undo remote address

Default

An interface does not assign an IP address to the client.

Views

Interface view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IP address to be assigned to the client.

pool pool-name: Specifies a PPP or DHCP address pool by its name from which an IP address is

assigned to the client. The pool name is a case-sensitive string of 1 to 31 characters.

Usage guidelines

This command can be used when the local interface is configured with an IP address, but the peer has no IP address. To enable the peer to accept the IP address assigned by the local interface

(server), you must configure the ip address ppp-negotiate command on the peer to make the peer

act as a client.

This command enables the local interface to forcibly assign an IP address to the peer. If the peer is

not configured with the ip address ppp-negotiate command but configured with an IP address, the

peer will not accept the assigned IP address. This results in an IPCP negotiation failure.

PPP supports IP address assignment from a PPP or DHCP address pool, but the PPP address pool takes precedence over the DHCP address pool. For example, if you use a pool name that identifies both a PPP address pool and a DHCP address pool, the system uses only the PPP address pool for address assignment.

To make the configuration of the remote address command take effect, configure this command before the ip address command, which triggers IPCP negotiation. If you configure the remote address command after the ip address command, the server assigns an IP address to the client

during the next IPCP negotiation.

After you use the remote address command to assign an IP address to the client, you can configure the rem ote address command again or the undo remote address command for the peer. However,

the new configuration does not take effect until the next IPCP negotiation.

Examples

# Specify the IP address to be assigned to the client as 10.0.0.1 on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] remote address 10.0.0.1

# Configure Serial 2/1/0 to assign an IP address from address pool aaa to the client.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] remote address pool aaa

Related commands

ip address ppp-negotiate ip pool

remote address dhcp client-identifier

Use remote address dhcp client-identifier username to use the PPP usernames as the DHCP

client IDs.

Use undo remote address dhcp client-identifier to restore the default.

Syntax

remote address dhcp client-identifier username undo remote address dhcp client-identifier

Default

The PPP usernames are not used as the DHCP client IDs.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

This command uses PPP usernames as DHCP client IDs for DHCP pool address assignment. The DHCP pool can be an A AA-authorized address pool or an address pool configured by using

the remote address command.

Configure this command when different users use different PPP usernames to come online and PPP usernames are required to be used as DHCP client IDs.

Examples

# Use the PPP usernames as the DHCP client IDs on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] remote address dhcp client-identifier username

reset ppp compression iphc

Use reset ppp compression iphc to clear IPHC statistics.

Syntax

reset ppp compression iphc [ rtp | tcp ] [ interface interface-type interface-number ]

Views

User view

Predefined user roles

network-admin

Parameters

rtp: Clears IPHC RTP header compression statistics. tcp: Clears IPHC TCP header compression statistics. interface interface-type interface-number: Specifies an interface by its type and number. If you do

not specify this option, the command clears IPHC statistics on all interfaces.

Usage guidelines

If neither rtp nor tcp is specified, this command clears both RTP header compression and TCP

header compression statistics.

Examples

# Clear IPHC statistics on all interfaces.

<Sysname> reset ppp compression iphc

Related commands

display ppp compression iphc

timer-hold

Use timer-hold to set the keepalive interval on an interface. Use undo timer-hold to restore the default.

Syntax

timer-hold seconds

undo timer-hold

Default

The keepalive interval is 10 seconds on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

seconds: Specifies the interval for sending keepalive packets, in the range of 0 to 32767 seconds.

The value 0 disables keepalive packet sending.

Usage guidelines

An interface sends keepalive packets at keepalive intervals to detect the availability of the peer. If the interface fails to receive keepalive packets when the keepalive retry limit is reached, it considers the link faulty and reports a link layer down event.

To set the keepalive retry limit, use the timer-hold retry command.

On a s low link, increase the keepalive interval to prevent false shutdown of the interface. This situation might occur when keepalive packets are delayed because a large packet is being transmitted on the link.

Examples

# Set the keepalive interval to 20 seconds on Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] timer-hold 20

Related commands

timer-hold retry

Use timer-hold retry to set the keepalive retry limit on an interface. Use undo timer-hold retry to restore the default.

Syntax

timer-hold retry retries undo timer-hold retry

Default

The keepalive retry limit is 5 on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

retries: Specifies the maximum number of keepalive attempts in the range of 1 to 255.

Usage guidelines

To set the keepalive interval, use the timer-hold command.

On a s low link, increase the keepalive retry limit to prevent false shutdown of the interface. This situation might occur when keepalive packets are delayed because a large packet is being transmitted on the link.

Examples

# Set the keepalive retry limit to 10 for Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] timer-hold retry 10

Related commands

timer-hold

reset ppp access-user

Use reset ppp access-user to log off a PPP user.

Syntax

reset ppp access-user { ip-address ipv4-ip-address [ vpn-instance ipv4-vpn-instance-name ] | ipv6-address ipv6-address [ vpn-instance ipv6-vpn-instance-name ] | username user-name }

Views

User view

Predefined user roles

network-admin

Parameters

ip-address ipv4-ip-address: Specifies a PPP user by its IP address. ipv6-address ipv6-address: Specifies a PPP user by its IPv6 address. vpn-instance ipv4-vpn-instance-name: Specifies a PPP user by the VPN to which the user belongs.

The ipv4-vpn-instance-name argument specifies the name of the IPv4 MPLS L3VPN instance, a

case-sensitive string of 1 to 31 c haracters. If you do not specify this option, the specified user

belongs to the public network. vpn-instance ipv6-vpn-instance-name: Specifies a PPP user by the VPN to which the user belongs.

The ipv6-vpn-instance-name argument specifies the name of the IPv6 MPLS L3VPN instance, a

case-sensitive string of 1 to 31 c haracters. If you do not specify this option, the specified user

belongs to the public network.

username user-name

characters.

: Sp

ecifies a PPP user by username, a case-sensitive string of 1 t o 80

Usage guidelines

This command takes effect only on the current login for a PPP user. The user can come online after it is logged off.

Examples

# Log off the PPP user at 192.168.100.2.

<Sysname> reset ppp access-user ip-address 192.168.100.2

Related commands

display ppp access-user

MP commands

bandwidth

Use bandwidth to set the expected bandwidth of an interface. Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value undo bandwidth

Default

The expected bandwidth (in kbps) is the interface baud rate divided by 1000.

Views

VT interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.

Usage guidelines

The expected bandwidth of an interface affects the link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.

Examples

# Set the expected bandwidth of Virtual-Template 10 to 1000 kbps.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] bandwidth 1000

# Set the expected bandwidth of MP-group 2/0/0 to 1000 kbps.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] bandwidth 1000

default

Syntax

Views

Use default to restore the default settings for a VT or MP-group interface.

default

VT interface view

MP-group interface view

the impact of this command before using it on a live network.

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The default

command might interrupt ongoing network services. Make sure you are fully aware of

This command might fail to restore the default settings for some commands for reasons such as

command dependencies or system restrictions. Use the display this command in interface view to identify these commands. Use the undo forms of these commands or follow the command reference

to individually restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings of Virtual-Template 10.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] default

# Restore the default settings of MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-Mp-group2/0/0] default

description

Use description to set the description for a VT or MP-group interface. Use undo description to restore the default.

Syntax

description text undo description

Default

The description for a V T or MP-group interface is interface name Interface (for example, Virtual-Template1 Interface or MP-group2/0/0 Interface).

Views

VT interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.

Examples

# Set the description for Virtual-Template 10 to virtual-interface.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] description virtual-interface

# Set the description for MP-group 2/0/0 to mpgroup-interface.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] description mpgroup-interface

display interface mp-group

Use display interface mp-group to display information about a specified MP-group interface or all

MP-group interfaces.

Syntax

display interface [ mp-group [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-number: Specifies an existing MP-group interface by its number in the range of 0 to 1023.

(Centralized devices in standalone mode.)

interface-number: Specifies an existing MP-group interface by its number in the format of X/Y/Z. X

represents the slot number of the physical interface, in the range of 0 to 2. The value of Y is fixed at

0. Z represents the number of the MP-group interface, in the range of 0 to 1023. (Distributed devices in standalone mode.)

interface-number: Specifies an existing MP-group interface by its number in the format of X/Y/Z. X

represents the member ID of the IRF member device to which the physical interface belongs, in the range of 1 to 2. The value of Y is fixed at 0. Z represents the number of the MP-group interface, in the range of 0 to 1023. (Centralized devices in IRF mode.)

interface-number: Specifies an existing MP-group interface by its number in the format of R/X/Y/Z. R

represents the member ID of the IRF member device to which the physical interface belongs, in the range of 1 to 2. X represents the slot number of the physical interface, in the range of 0 to 2. The value of Y is fixed at 0. Z represents the number of the MP-group interface, in the range of 0 to 1023. (Distributed devices in IRF mode.)

brief: Displays brief interface information. If you do not specify this keyword, the command displays

detailed interface information.

description: Displays complete interface description. If you do not specify this keyword, the

command displays only the first 27 characters of the interface description if the description contains more than 27 characters.

down: Displays information about interfaces in physically down state and the causes. If you do not

specify this keyword, the command displays information about all interfaces.

Usage guidelines

If you do not specify the mp-group keyword, the command displays information about all interfaces

on the device.

If you specify the mp-group keyword without the interface-number argument, the command displays

information about all existing MP-group interfaces.

Examples

# Display detailed information about MP-group 2/0/0.

Field

Description

<Sysname> display interface mp-group 2/0/0 MP-group2/0/0 Current state: DOWN Line protocol state: DOWN Description: MP-group2/0/0 Interface Bandwidth: 2048kbps Maximum transmission unit: 1500 Hold timer: 10 seconds, retry times: 5 Internet address: 192.168.1.200/24 (primary) Link layer protocol: PPP LCP: initial Physical: MP, baudrate: 2048000 bps Output queue - Urgent queuing: Size/Length/Discards 0/100/0 Output queue - Protocol queuing: Size/Length/Discards 0/500/0 Output queue - FIFO queuing: Size/Length/Discards 0/75/0 Last clearing of counters: Never Last 300 seconds input rate: 0 bytes/sec, 0 packets/sec Last 300 seconds output rate: 0 bytes/sec, 0 packets/sec Input: 0 packets, 0 bytes, 0 drops Output: 0 packets, 0 bytes, 0 drops

# Display brief information about MP-group 2/0/0.

<Sysname> display interface mp-group 12 brief Brief information on interfaces in route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface Link Protocol Primary IP Description MP2/0/0 DOWN DOWN --

# Display brief information about the MP-group interfaces in physically down state and the causes.

<Sysname> display interface mp-group brief down Brief information on interfaces in route mode: Link: ADM - administratively down; Stby - standby Interface Link Cause MP2/0/0 ADM Administratively MP2/0/1 DOWN Not connected

Table 6 Command output

Physical and administrative states of the interface:

• DOWN (Administratively)—The interface was administratively shut down with the shutdown command.

Current state

• DOWN—The interface is administratively up but physically

down (possibly because no physical link is present or the link is faulty).

• UP—The interface is both administratively and physically up.

Line protocol state Data link layer state: UP or DOWN.

Description Interface description.

Bandwidth Expected bandwidth of the interface.

Field

Description

Hold timer Interval at which the interface sends keepalive packets.

Keepalive retry limit.

retry times

Internet protocol processing The interface cannot process IP packets currently.

The interface determines that its peer has been down if it does not receive a keepalive response when the keepalive retry limit is reached.

Internet address: 192.168.1.200/24 (primary)

LCP initial LCP negotiation is complete.

Physical Physical type of the interface.

baudrate Baud rate of the interface.

Output queue - Urgent queuing: Size/Length/Discards 0/100/0

Output queue - Protocol queuing: Size/Length/Discards 0/500/0

Output queue - FIFO queuing: Size/Length/Discards 0/75/0

Last clearing of counters: Never

Last 300 seconds input rate: 0 bytes/sec, 0 packets/sec

Last 300 seconds output rate: 0 bytes/sec, 0 packets/sec

Input: 0 packets, 0 bytes, 0 drops

Output: 0 packets, 0 bytes, 0 drops

Primary IP address of the interface.

Traffic statistics of the interface output queues.

Last time when statistics on the interface were cleared. indicates that statistics on the interface were never cleared.

Average rate of input packets and output packets in the last 300 seconds.

Total number of inbound packets of the interface (in the number of packets and in bytes), and the number of dropped incoming packets.

Total number of outbound packets of the interface (in the number of packets and in bytes), and the number of dropped outgoing packets.

Never

Brief information on interfaces in route mode

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Abbreviated interface name.

Link

Brief information about Layer 3 interfaces.

Link status:

• ADM—The interface has been administratively shut down. To recover its physical state, execute the undo shutdown

command.

• Stby—The interface is operating as a backup interface. To see the primary interface, use the display interface-backup state command in High Availability Command Reference.

Indicates the line protocol is UP, but the physical link is an on-demand link or is not present.

Physical link state of the interface:

• UP—The interface is physically up.

• DOWN—The interface is physically down.

• ADM—The interface has been administratively shut down. To

recover its physical state, use the undo shutdown command.

• Stby—The interface is a backup interface.

Field

Description

Line protocol state:

• UP—The line protocol is up.

Protocol

Primary IP Primary IP address of the interface.

• DOWN—The line protocol is down.

• UP(s)—The line protocol is up, but the physical link is an

on-demand link or is not present.

Interface description configured by using the command. If you do not specify the

display interface brief

Description

Cause

the characters of the description. If you specify the keyword, the command displays the complete description.

Causes for the physical state of the interface to be Down:

• Not connected—No physical connection exists (possibly

because the network cable is disconnected or faulty).

• Administratively—The interface was shut down with the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

Related commands

reset counters interface mp-group

display interface virtual-access

Use display interface virtual-access to display information about VA interfaces.

Syntax

display interface [ virtual-access [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

description

command displays a maximum of 27

keyword,

description

Predefined user roles

network-admin

network-operator

Parameters

interface-number: Specifies a VA interface by its number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays

detailed interface information.

description: Displays interface description information. This keyword does not apply to VA

interfaces because VA interfaces do not support description configuration.

down: Displays information about interfaces in physically down state and the causes. If you do not

specify this keyword, the command displays information about all interfaces.

Usage guidelines

If you do not specify the virtual-access keyword, the command displays information about all

interfaces on the device.

If you specify the virtual-access keyword without the interface-number argument, the command

displays information about all VA interfaces.

Field

Description

Examples

# Display information about Virtual-Access 1.

<Sysname> display interface virtual-access 1 Virtual-Access1 Current state: UP Line protocol state: UP Description: Virtual-Access1 Interface Bandwidth: 1920kbps Maximum transmission unit: 1500 Hold timer: 10 seconds, retry times: 5 Internet address: 122.1.1.1/24 (primary) Link layer protocol: PPP LCP: opened, MP: opened, IPCP: opened Physical: MP, baudrate: 1920000 bps Main interface: Virtual-Template1 Output queue - Urgent queuing: Size/Length/Discards 0/100/0 Output queue - Protocol queuing: Size/Length/Discards 0/500/0 Output queue - FIFO queuing: Size/Length/Discards 0/75/0 Last clearing of counters: Never Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec Input: 2 packets, 24 bytes, 0 drops Output: 2 packets, 24 bytes, 0 drops

# Display brief information about Virtual-Access 1.

<Sysname> display interface virtual-access 1 brief Brief information on interfaces in route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface Link Protocol Primary IP Description VA1 DOWN DOWN --

# Display brief information about VA interfaces in physically down state and the causes.

<Sysname> display interface virtual-access brief down Brief information on interfaces in route mode: Link: ADM - administratively down; Stby - standby Interface Link Cause VA1 DOWN Not connected

Table 7 Command output

Physical and administrative states of the interface:

Current state

Line protocol state Data link layer state: UP or DOWN.

• DOWN—The interface is administratively up but physically

down.

• UP—The interface is both administratively and physically up.

Description Interface description.

Bandwidth Expected bandwidth of the interface.

Hold timer Interval at which the interface sends keepalive packets.

Field

Description

Keepalive retry limit.

retry times

Internet protocol processing: Disabled The interface cannot process IP packets currently.

The interface determines that its peer has been down if it does not receive a keepalive response when the keepalive retry limit is reached.

Internet address: 122.1.1.1/24 (primary)

LCP: opened, MP: opened, IPCP: opened

Physical Physical type of the interface.

Main interface VT interface associated with the VA interface.

Output queue - Urgent queuing: Size/Length/Discards 0/100/0

Output queue - Protocol queuing: Size/Length/Discards 0/500/0

Output queue - FIFO queuing: Size/Length/Discards 0/75/0

Last clearing of counters: Never

Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Input: 2 packets, 24 bytes, 0 drops

Output: 2 packets, 24 bytes, 0 drops

Primary IP address of the interface.

The PPP connection has been successfully established.

Traffic statistics of the interface output queues.

Last time when statistics on the interface were cleared. indicates that statistics on the interface were never cleared.

Average rate of input packets and output packets in the last 300 seconds.

Total number of inbound packets of the interface (in the number of packets and in bytes), and the number of packets dropped among the inbound packets.

Total number of outbound packets of the interface (in the number of packets and in bytes), and the number of packets dropped among the outbound packets.

Never

Brief information on interfaces in route mode

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Abbreviated interface name.

Link

Brief information about Layer 3 interfaces.

Link status:

• ADM—The interface has been administratively shut down. To recover its physical state, execute the undo shutdown

command.

• Stby—The interface is a backup interface. To see the primary interface, use the display interface-backup state command in High Availability Command Reference.

Indicates the line protocol is UP, but the physical link is an on-demand link or is not present.

Physical link state of the interface:

• UP—The interface is physically up.

• DOWN—The interface is physically down.

Field

Description

Line protocol state:

• UP—The line protocol is up.

Protocol

Primary IP Primary IP address of the interface.

• DOWN—The line protocol is down.

• UP(s)—The line protocol is up, but the physical link is an

on-demand link or is not present.

Interface description configured by using the

Description

Cause

command. This field does not apply to VA interfaces because VA interfaces do not support description configuration.

Cause for the physical state of the interface to be Down.

Not connected

the network cable is disconnected or faulty).

Related commands

reset counters interface virtual-access

display interface virtual-template

Use display interface virtual-template to display information about VT interfaces.

Syntax

display interface [ virtual-template [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

description

indicates no physical link exists (possibly because

Parameters

interface-number: Specifies an existing VT interface by its number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays

detailed interface information.

description: Displays complete interface description. If you do not specify this keyword, the

command displays only the first 27 characters of the interface description if the description contains more than 27 characters.

down: Displays information about interfaces in physically down state and the causes. If you do not

specify this keyword, the command displays information about all interfaces.

Usage guidelines

If you do not specify the virtual-template keyword, the command displays information about all

interfaces on the device.

If you specify the virtual-template keyword without the interface-number argument, the command

displays information about all existing VT interfaces.

Examples

# Display detailed information about Virtual-Template 1.

<Sysname> display interface virtual-template 1 Virtual-Template1

Field

Description

Current state: DOWN Line protocol state: DOWN Description: Virtual-Template1 Interface Bandwidth: 100000kbps Maximum transmission unit: 1500 Hold timer: 10 seconds, retry times: 5 Internet address: 192.168.1.200/24 (primary) Link layer protocol: PPP LCP: initial Physical: None, baudrate: 100000000 bps Output queue - Urgent queuing: Size/Length/Discards 0/100/0 Output queue - Protocol queuing: Size/Length/Discards 0/500/0 Output queue - FIFO queuing: Size/Length/Discards 0/75/0

# Display brief information about Virtual-Template 1.

<Sysname> display interface virtual-template 1 brief Brief information on interfaces in route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface Link Protocol Primary IP Description VT1 DOWN DOWN --

# Display brief information about the VT interfaces in physically down state and the causes.

<Sysname> display interface Virtual-Template brief down Brief information on interfaces in route mode: Link: ADM - administratively down; Stby - standby Interface Link Cause VT0 DOWN Not connected VT12 DOWN Not connected VT1023 DOWN Not connected

Table 8 Command output

Current state

Line protocol state

Description Interface description.

Bandwidth Expected bandwidth of the interface.

Hold timer Interval at which the interface sends keepalive packets.

retry times

Physical state of the interface. This field for a VT interface can only

DOWN

Data link layer state. This field for a VT interface can only

DOWN

Keepalive retry limit.

The interface determines that its peer has been down if it does not receive a keepalive response when the keepalive retry limit is reached.

Internet protocol processing: Disabled The interface cannot process IP packets currently.

Internet address: 192.168.1.200/24 (primary)

Primary IP address of the interface.

LCP initial LCP initialization is complete.

Field

Description

Physical Physical type of the interface.

Output queue - Urgent queuing: Size/Length/Discards 0/100/0)

Output queue - Protocol queuing: Size/Length/Discards 0/500/0)

Output queue - FIFO queuing: Size/Length/Discards 0/75/0)

Traffic statistics of the interface output queues.

Brief information on interfaces in route mode

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Abbreviated interface name.

Link

Protocol

Primary IP Primary IP address of the interface.

Description

Cause

Brief information about Layer 3 interfaces.

Link status:

• ADM—The interface has been administratively shut down. To recover its physical state, use the un do shutdo wn command.

• Stby—The interface is operating as a backup interface. To see the primary interface, use the display interface-backup state command in High Availability Command Reference.

Indicates the line protocol is UP, but the physical link is an on-demand link or is not present.

Physical link state of the interface. This field for a VT interface can only be

Line protocol state of the interface. This field for a VT interface can only be

Interface description configured by using the command. If you do not specify the the characters of the description. If you specify the keyword, the command displays the complete description.

Causes for the physical state of the interface to be Down.

Not connected

the network cable is disconnected or faulty).

DOWN

display interface brief

indicates no physical link exists (possibly because

command displays a maximum of 27

description

keyword,

description

display ppp mp

Use display ppp mp to display MP information for MP-group interfaces.

Syntax

display ppp mp [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its number. If you do not specify

this option, the command displays MP information for all interfaces.

Field

Description

Examples

# Display MP information. (MP is configured through an MP-group interface.)

<Sysname> display ppp mp Template: MP-group2/0/0 max-bind: 20, fragment: enabled, min-fragment: 128 Master link: MP-group2/0/0, Active members: 2, Bundle Multilink Peer's endPoint descriptor: MP-group2/0/0 Sequence format: short (rcv)/long (sent) Bundle Up Time: 2012/11/05 07:29:33:612 0 lost fragments, 0 reordered, 0 unassigned, 0 interleaved Sequence: 0 (rcv)/0 (sent) Active member channels: 2 members Serial2/1/0:15 Up-Time: 2012/11/05 07:29:33:613 Serial2/1/0:16 Up-Time: 2012/11/05 07:30:10:945 Inactive member channels: 2 members Serial2/1/0:17 Serial2/1/0:18

Table 9 Command output

max-bind Maximum number of links that can be bound.

fragment Indicates whether MP fragmentation is enabled or disabled.

min-fragment Minimum size of an MP fragment.

Sequence format: short (rcv)/long (sent)

reordered Number of reassembled packets.

unassigned Number of packets waiting for being reassembled.

interleaved

Sequence: 0 (rcv)/0 (sent) Received sequence number/sent sequence number.

Up-Time Uptime of a member channel.

interface mp-group

Use interface mp-group to create an MP-group interface and enter its view, or enter the view of an

existing MP-group interface.

Use undo interface mp-group to remove an MP-group interface.

Sequence number header format of MP. The short sequence number format is used in the incoming direction, and the long sequence number format is used in the outgoing direction.

Number of interleaved fragments.

LFI breaks larger packets into fragments and interleaves the fragments between smaller packets for transmission.

Syntax

interface mp-group mp-number undo interface mp-group mp-number

Default

No MP-group interfaces exists.

Views

System view

Predefined user roles

network-admin

Parameters

mp-number: Specifies an existing MP-group interface by its number in the range of 0 t o 1023.

(Centralized devices in standalone mode.)

mp-number: Specifies an existing MP-group interface by its number in the format of X/Y/Z. X

represents the slot number of the physical interface, in the range of 0 to 2. The value of Y is fixed at

0. Z represents the number of the MP-group interface, in the range of 0 to 1023. (Distributed devices in standalone mode.)

mp-number: Specifies an existing MP-group interface by its number in the format of X/Y/Z. X

mp-number: Specifies an existing MP-group interface by its number in the format of R/X/Y/Z. R

Usage guidelines

You must use the interface mp-group command together with the ppp mp mp-group command.

You can execute the two commands in either order.

Examples

# Create interface MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0]

interface virtual-template

Use interface virtual-template to create a VT interface and enter its view, or enter the view of an

existing VT interface.

Use undo interface virtual-template to remove a VT interface.

Syntax

interface virtual-template number undo interface virtual-template number

Default

No VT interfaces exist.

Views

System view

Predefined user roles

network-admin

Hardware

Value range

Parameters

number: Specifies a VT interface by its number. The following matrix shows the value ranges for the number argument:

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-H K/810-LMS/810-LUS

MSR2600-10-X1 0 to 1023

MSR 2630 0 to 1023

MSR3600-28/3600-51 0 to 1023

MSR3600-28-SI/3600-51-SI 0 to 1023

MSR 3610 0 to 1023

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC 0 to 2047

MSR 3620/3620-DP/3640/3660 0 to 2047

MSR5620/5660/5680 0 to 4095

Usage guidelines

To remove a VT interface, make sure all the corresponding VA interfaces are removed and the VT interface is not in use.

Examples

# Create interface Virtual-Template 10.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10]

0 to 1023

mtu

Use mtu to set the MTU size of an interface. Use undo mtu to restore the default.

Syntax

mtu size undo mtu

Default

The MTU size of an interface is 1500 bytes.

Views

VT interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

size: Specifies the MTU size in the range of 128 to 1500 bytes.

Usage guidelines

The MTU size setting of an interface affects the fragmentation and reassembly of IP packets on that interface.

For the configured MTU size to take effect, you must execute the shutdown command and then the undo shutdown command on the interface.

Examples

# Set the MTU size of Virtual-Template 10 to 1400 bytes.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] mtu 1400

# Set the MTU size of MP-group 2/0/0 to 1200 bytes.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] mtu 1200

ppp mp

Use ppp mp to enable MP for an interface. Use undo ppp mp to disable MP on an interface.

Syntax

ppp mp undo ppp mp

Default

An interface is enabled with PPP.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

To obtain more bandwidth, you can bind multiple PPP links to form a logical MP interface.

Examples

# Enable MP for Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp mp

ppp mp binding-mode

Syntax

Use ppp mp binding-mode to set the MP binding mode on an interface. Use undo ppp mp binding-mode to restore the default.

ppp mp binding-mode { authentication | both | descriptor } undo ppp mp binding-mode

Default

Both the username and the descriptor are used for MP binding on an interface.

Views

VT interface view

Dialer interface view

Predefined user roles

network-admin

Parameters

authentication: Uses the username for MP binding. both: Uses both the username and the endpoint descriptor for MP binding. descriptor: Uses the endpoint descriptor for MP binding.

Usage guidelines

The username is obtained from the peer during PAP, CHAP, MS-CHAP, or MS-CHAP-V2 authentication. The endpoint descriptor, which uniquely identifies a device, is obtained from the peer during LCP negotiation. Based on the username or endpoint descriptor, the system can locate the corresponding VT interface and create an MP bundle according to the template.

The descriptor mode cannot differentiate users. To bind users to different bundles, use the both

mode.

The authentication mode cannot differentiate peer devices. When multiple peer devices exist, use the both mode.

Examples

# Specify Virtual-Template 1 to use the username for MP binding.

<Sysname> system-view [Sysname] interface virtual-template1 [Sysname-Virtual-Template1] ppp mp binding-mode authentication

ppp mp endpoint

Use ppp mp endpoint to set the endpoint option. Use undo ppp mp endpoint to restore the default.

Syntax

ppp mp endpoint endpoint undo ppp mp endpoint

Default

The endpoint option carries the device name on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

endpoint: Specifies the content of the endpoint option, a case-sensitive string of 1 to 20 characters.

Usage guidelines

The endpoint option (terminal descriptor) is negotiated during MP LCP negotiation.

When MP is configured by using a VT interface, an MP endpoint bases its link binding decisions on the remote endpoint descriptors, and assigns the links that receive the same endpoint descriptor to the same bundle. To avoid incorrect link binding on a VT interface, make sure the link descriptors used by different devices are unique. You must reconfigure an endpoint descriptor for a device if the default endpoint descriptor (device name) cannot uniquely identify the MP bundle at the remote end.

When MP is configured by using an MP-group interface, the negotiating endpoints do not base their binding decisions on the endpoint descriptor. By default, the endpoint descriptor of an interface in an MP-group is the MP-group interface name. If you configure an endpoint descriptor for the interface, the configured MP endpoint descriptor takes effect.

If the endpoint descriptor exceeds 20 bytes, the first 20 bytes are taken as the endpoint descriptor.

Examples

# Configure the endpoint descriptor of Serial 2/1/0 as 123456.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp mp endpoint 123456

ppp mp fragment disable

Use ppp mp fragment disable to disable MP fragmentation on an interface. Use undo ppp mp fragment disable to enable MP fragmentation on an interface.

Syntax

ppp mp fragment disable undo ppp mp fragment disable

Default

MP fragmentation is enabled on an interface.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Usage guidelines

If the peer device does not support fragment reassembly, you must configure the ppp mp fragment disable command to disable MP fragmentation on the local device. This enables the two devices to

communicate. After that, outgoing packets are not fragmented, but they still carry an MP sequence number and fragment tag.

After you configure the ppp mp fragment disable command on an interface, the settings configured with the ppp mp lfi enable and ppp mp min-fragment commands do n ot take effect on t he

interface.

Examples

# Disable MP fragmentation on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0

[Sysname-MP-group2/0/0] ppp mp fragment disable

Related commands

ppp mp lfi enable ppp mp min-fragment

ppp mp lfi delay-per-frag

Use ppp mp lfi delay-per-frag to set the maximum LFI fragment transmission delay on an interface. Use undo ppp mp lfi delay-per-frag to restore the default.

Syntax

ppp mp lfi delay-per-frag time undo ppp mp lfi delay-per-frag

Default

The maximum LFI fragment transmission delay is 10 ms on an interface.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

time: Specifies the maximum LFI fragment transmission delay, in the range of 1 to 1000 ms.

Examples

# Set the maximum LFI fragment transmission delay to 20 ms on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp lfi delay-per-frag 20

Related commands

ppp mp lfi enable ppp mp lfi size-per-frag

ppp mp lfi enable

Use ppp mp lfi enable to enable LFI on an interface. Use undo ppp mp lfi to disable LFI on an interface.

Syntax

Default

ppp mp lfi enable undo ppp mp lfi enable

LFI is disabled on an interface.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Usage guidelines

Disabling LFI also removes the user-configured settings of the maximum LFI fragment transmission delay and size.

Examples

# Enable LFI on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp lfi enable

Related commands

ppp mp lfi delay-per-frag ppp mp lfi size-per-frag

ppp mp lfi size-per-frag

Use ppp mp lfi size-per-frag to set the maximum LFI fragment size (in bytes) on an interface. Use undo ppp mp lfi size-per-frag to restore the default.

Syntax

ppp mp lfi size-per-frag size undo ppp mp lfi size-per-frag

Default

On an interface, the maximum LFI fragment size is derived from this formula: (Expected bandwidth of the interface x Maximum LFI fragment transmission delay)/8.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

size: Specifies the maximum LFI fragment size in the range of 40 to 1500 bytes.

Usage guidelines

When LFI is enabled and bot h this command and the ppp mp lfi delay-per-frag command are configured, the maximum LFI fragment size is the value configured with the ppp mp lfi size-per-frag

command.

performance degradation. Make sure you understand the impact of this command on your network before you use it.

Examples

# Set the maximum LFI fragment size to 80 bytes on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp lfi size-per-frag 80

Related commands

ppp mp lfi enable ppp mp lfi delay-per-frag

ppp mp max-bind

Use ppp mp max-bind to set the maximum number of PPP links in an MP bundle on an interface. Use undo ppp mp max-bind to restore the default.

Syntax

ppp mp max-bind max-bind-num undo ppp mp max-bind

Default

The maximum number of PPP links in an MP bundle is 16 on an interface.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

max-bind-num: Specifies the maximum number of PPP links in an MP bundle, in the range of 1 to

128.

Usage guidelines

IMPORTANT:

Use the default setting in most situations. Inappropriate use of this command can cause PPP

Set the maximum number of PPP links in an M P bundle to be greater than the actual number of bound links. Otherwise, MP binding fails.

The maximum number of PPP links configured for an MP bundle takes effect immediately. If the configured maximum number is smaller than the number of existing PPP links, the existing links are not affected.

Examples

# Set the maximum number of PPP links in an MP bundle to 12 on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp max-bind 12

ppp mp min-bind

Use ppp mp min-bind to set the minimum number of PPP links in an M P bundle on a dialer

interface.

Use undo ppp mp min-bind to restore the default.

Syntax

ppp mp min-bind min-bind-num undo ppp mp min-bind

Default

On a dialer interface, the minimum number of PPP links in an MP bundle is 0, which means that MP dial-up relies on traffic detection.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

min-bind-num: Specifies the minimum number of PPP links in an MP bundle, in the range of 0 to 128.

Usage guidelines

This command specifies the minimum number of PPP links in a MP bundle to ensure the minimum bandwidth for the service.

When the minimum number of PPP links is set to a non -zero value, subsequent MP dial-up operations will not depend on traffic detection, but existing dial-up connections will be removed upon timeout.

The min-bind-num argument cannot be gr eater than the maximum number set with the ppp mp

max-bind command.

Examples

# Set the minimum number of PPP links in an MP bundle to 4 on Dialer 0.

<Sysname> system-view [Sysname] interface dialer 0 [Sysname-Dialer0] ppp mp min-bind 4

Related commands

ppp mp max-bind

ppp mp min-fragment

Use ppp mp min-fragment to set the minimum MP packet fragmentation size on an interface. Use undo ppp mp min-fragment to restore the default.

Syntax

Default

ppp mp min-fragment size undo ppp mp min-fragment

The minimum MP packet fragmentation size is 128 bytes on an interface.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

size: Specifies the minimum MP packet fragmentation size in the range of 128 t o 1500 b ytes.

Outgoing MP packets less than the minimum value will not be fragmented, and those greater than or equal to the minimum value will be fragmented.

Examples

# Set the minimum MP packet fragmentation size to 500 bytes on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp min-fragment 500

ppp mp mp-group

Use ppp mp mp-group to assign an interface to an MP group, and enable MP for the interface. Use undo ppp mp to restore the default.

Syntax

ppp mp mp-group mp-number undo ppp mp

Default

An interface is enabled with PPP.

Views

Interface view

Predefined user roles

network-admin

Parameters

mp-number: Specifies an MP-group interface by its number.

Usage guidelines

This command should be used with the interface mp-group command. You can create an MP group

interface and then assign an interface to the MP group. You can also assign an interface to an MP group and then create the MP group.

Examples

# Assign Serial 2/1/0 to MP-group 2/0/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp mp mp-group 2/0/0

Related commands

interface mp-group

ppp mp short-sequence

Use ppp mp short-sequence to trigger MP short sequence number header format negotiation on

an interface. After the negotiation succeeds, the local end receives packets with short sequence numbers.

Use undo ppp mp short-sequence to restore the default.

Syntax

ppp mp short-sequence undo ppp mp short-sequence

Default

The long sequence number header format is used on an interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

This command applies to the incoming direction only. To enable the local end to transmit packets with short sequence numbers, configure this command on the remote end.

The sequence number format (long or short) of an MP bundle depends on the configuration of the first channel joining the MP bundle.

To negotiate the use of short sequence numbers on a dialer MP bundle, configure the command on the dialer interfaces and the ISDN D channels. To negotiate the use of short sequence numbers on a common MP bundle, use the command on al l its channels. The command will cause PPP re-negotiation.

Examples

# Configure the short sequence number header format of MP in the incoming direction of Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp mp mp-group 2/0/0 [Sysname-Serial2/1/0] ppp mp short-sequence

ppp mp sort-buffer-size

Use ppp mp sort-buffer-size to set the MP sort buffer size factor on an interface. Use undo ppp mp sort-buffer-size to restore the default.

Syntax

ppp mp sort-buffer-size size

Default

Views

undo ppp mp sort-buffer-size

The MP sort buffer size factor is 1 on an interface.

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

size: Specifies the MP sort buffer size factor in the range of 1 to 64.

Usage guidelines

The MP sort buffer size = the number of channels in the current MP bundle × size. You can use

the display ppp mp command to view the number of member channels in an MP bundle. If the

calculated MP sort buffer size is 20, the MP sort buffer can sort 20 packets.

When MP is used, the received packets might be out of order. The sort buffer is used to re-sort packets. A large sort buffer results in better re-sorting but increases delay. For voice packets, the transmission delay should be minimized.

Examples

# Set the MP sort buffer size factor to 64 on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp sort-buffer-size 64

ppp mp timer lost-fragment

Use ppp mp timer lost-fragment to set the timer for MP to wait for the expected fragments on an

interface.

Use undo ppp mp timer lost-fragment to restore the default.

Syntax

ppp mp timer lost-fragment seconds undo ppp mp timer lost-fragment

Default

The timer for MP to wait for the expected fragments is 30 seconds on an interface.

Views

VT interface view

Dialer interface view

MP-group interface view

Predefined user roles

network-admin

Parameters

seconds: Specifies the timer for MP to wait for the expected fragment, in the range of 1 to 255

seconds.

Usage guidelines

A receiving end puts the received fragments in the buffer and reassembles them when it receives all the packet's fragments. You can configure a timer for MP to wait for the expected fragments. When the receiving end receives the first fragment of a packet, it starts the timer. When the timer expires, the system checks whether or not all fragments have arrived. If they have all arrived, the system

Hardware

Value range

reassembles the fragments. If they have not all arrived, the system discards all received fragments to release the buffer space.

Examples

# Set the timer for MP to wait for the expected fragment to 20 seconds on MP-group 2/0/0.

<Sysname> system-view [Sysname] interface mp-group 2/0/0 [Sysname-MP-group2/0/0] ppp mp timer lost-fragment 20

ppp mp user

Use ppp mp user to associate a username with a VT interface. Use undo ppp mp user to remove the association.

Syntax

ppp mp user username bind virtual-template number undo ppp mp user username

Default

No username is associated with a VT interface.

Views

System view

Predefined user roles

network-admin

Parameters

username: Specifies a username, a case-sensitive string of 1 to 80 characters.

bind virtual-template number: Specifies a VT interface by its number. The following matrix shows the value ranges for the number argument:

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-H K/810-LMS/810-LUS

MSR2600-10-X1 0 to 1023

MSR 2630 0 to 1023

MSR3600-28/3600-51 0 to 1023

MSR3600-28-SI/3600-51-SI 0 to 1023

MSR 3610 0 to 1023

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC 0 to 2047

MSR 3620/3620-DP/3640/3660 0 to 2047

0 to 1023

MSR5620/5660/5680 0 to 4095

Usage guidelines

This command associates a username with a VT interface. After the user passes authentication, the system uses the settings on the VT interface to create an MP bundle and a VA interface to transmit data.

Hardware

Value range

You can configure the following parameters for a VT interface:

• Local IP address and the peer IP address (or address pool).

• ppp mp-commands.

Examples

# Associate username user 1 with Virtual-Template 1, and set the IP address of the VT interface to

202.38.60.1/24.

<Sysname> system-view [Sysname] ppp mp user user1 bind virtual-template 1 [Sysname] interface virtual-template 1 [Sysname-Virtual-Template1] ip address 202.38.60.1 255.255.255.0

Related commands

ppp mp

ppp mp virtual-template

Use ppp mp virtual-template to bind an interface to a VT interface and enable MP for the interface. Use undo ppp mp to restore the default.

Syntax

ppp mp virtual-template number undo ppp mp

Default

An interface is enabled with PPP.

Views

Interface view

Predefined user roles

network-admin

Parameters

number: Specifies a VT interface by its number. The following matrix shows the value ranges for the number argument:

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-H K/810-LMS/810-LUS

MSR2600-10-X1 0 to 1023

MSR 2630 0 to 1023

MSR3600-28/3600-51 0 to 1023

0 to 1023

MSR3600-28-SI/3600-51-SI 0 to 1023

MSR 3610 0 to 1023

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC 0 to 2047

MSR 3620/3620-DP/3640/3660 0 to 2047

MSR5620/5660/5680 0 to 4095

Usage guidelines

After you bind an interface to a VT interface, you can optionally enable PAP, CHAP, MS-CHAP, or MS-CHAP-V2 authentication.

The interfaces bound to the same VT interface are bound together. The ppp mp virtual-template command and the ppp mp command are mutually exclusive.

Examples

# Bind Serial 2/1/0 to Virtual-Template 1, and enable MP for Serial 2/1/0.

<Sysname> system-view [Sysname] interface serial 2/1/0 [Sysname-Serial2/1/0] ppp mp virtual-template 1

Related commands

ppp mp

reset counters interface mp-group

Use reset counters interface mp-group to clear statistics on MP-group interfaces.

Syntax

reset counters interface [ mp-group [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

mp-group: Clears traffic statistics on MP-group interfaces.

interface-number: Specifies an existing MP-group interface by its number.

Usage guidelines

Before collecting traffic statistics regularly on an MP-group interface, clear the existing statistics.

If you do not specify the mp-group keyword, the command clears statistics on all interfaces. If you specify the mp-group keyword without the interface-number argument, the command clears

statistics on all MP-group interfaces.

If you specify both mp-group and interface-number, the command clears statistics on the specified

MP-group interface.

Examples

# Clear the statistics of MP-group 2/0/0

<Sysname> reset counters interface mp-group 2/0/0

Related commands

display interface mp-group

reset counters interface virtual-access

Use reset counters interface virtual-access to clear statistics on VA interfaces.

Syntax

reset counters interface [ virtual-access [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

virtual-access: Clears statistics on VA interfaces.

interface-number: Specifies an existing VA interface by its number.

Usage guidelines

Before collecting traffic statistics regularly on a VA interface, clear the existing statistics.

If you do not specify the virtual-access keyword, the command clears statistics on all interfaces. If you specify the virtual-access keyword without the interface-number argument, the command

clears statistics on all VA interfaces.

If you specify both virtual-access and interface-number, the command clears statistics on the

specified VA interface.

Examples

# Clear statistics on Virtual-Access 10.

<Sysname> reset counters interface virtual-access 10

Related commands

display interface virtual-access

service

Use service to specify a primary traffic processing slot for an interface. Use undo service to restore the default.

Syntax

Distributed devices in standalone mode/centralized devices in IRF mode:

service slot slot-number undo service slot

Distributed devices in IRF mode:

service chassis chassis-number slot slot-number undo service chassis

Default

No primary traffic processing slot is specified for an interface.

Views

VT interface view

Default command level

network-admin

Hardware

Command compatibility

Parameters

slot slot-number: Specifies a card by its slot number. (Distributed devices in standalone mode.) slot slot-number: Specifies an IRF member device by its member ID. (Centralized devices in IRF

mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (Distributed devices in IRF

mode.)

Usage guidelines

The following matrix shows the command and hardware compatibility:

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE /810-LM-HK/810-W-LM-HK/810-LMS/810-LUS

MSR2600-10-X1 No

MSR 2630 Yes

MSR3600-28/3600-51 Yes

MSR3600-28-SI/3600-51-SI No

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC Yes

MSR 3610/3620/3620-DP/3640/3660 Yes

MSR5620/5660/5680 Yes

This command is supported on distributed devices and IRF-capable centralized devices.

Specify traffic processing slots if a feature requires that all traffic on a VA interface be processed on the same slot.

For high availability, you can specify one primary and one backup traffic processing slot by using

the service command and the service standby command, respectively.

To avoid processing slot switchover, specify the primary slot before specifying the backup slot. If you specify the backup slot before specifying the primary slot, traffic is switched over to the primary slot immediately after you specify the primary slot.

If you specify both primary and backup slots for an interface, traffic on that interface is processed as follows:

• The backup slot takes over when the primary slot becomes unavailable. The backup slot

continues to process traffic for the interface after the primary slot becomes available again. The switchover will not occur until the backup slot becomes unavailable.

• When no specified traffic processing slots are available, the traffic is processed on the slot at

which it arrives. Then, the processing slot that first becomes available again takes over.

If you do not specify a primary or a backup traffic processing slot for an interface, traffic on that interface is processed on the slot at which the traffic arrives.

Examples

# (Distributed devices in standalone mode.) Specify slot 2 as the primary traffic processing slot for VA interfaces on Virtual-Template 10.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] service slot 2

# (Centralized devices in IRF mode.) Specify slot 2 as the primary traffic processing slot for VA interfaces on Virtual-Template 10.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] service slot 2

# (Distributed devices in IRF mode.) Specify slot 2 as the primary traffic processing slot for VA interfaces on Virtual-Template 10.

<Sysname> system-view [Sysname] interface virtual-template 10 [Sysname-Virtual-Template10] service chassis 2 slot 2

Related commands

service standby

Use service standby to specify a backup traffic processing slot for an interface. Use undo service standby to restore the default.

Syntax

Distributed devices in standalone mode/centralized devices in IRF mode:

service standby slot slot-number undo service standby slot

Distributed devices in IRF mode:

service standby chassis chassis-number slot slot-number undo service standby chassis

Default

No backup traffic processing slot is specified for an interface.

Views

VT interface view

Default command level

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. (Distributed devices in standalone mode.) slot slot-number: Specifies an IRF member device by its member ID. (Centralized devices in IRF

mode.)

Usage guidelines

The following matrix shows the command and hardware compatibility: