05-Layer 2—WAN Access Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C MSR810 2600 3600 Routers Command References(V7)-R0707-6W30105-Layer 2—WAN Access Command Reference
08-DDR commands
Title Size Download
08-DDR commands 169.98 KB

DDR commands

The following compatibility matrix shows the support of hardware platforms for DDR:

 

Hardware

DDR compatibility

MSR810, MSR810-W, MSR810-W-DB, MSR810-LM, MSR810-W-LM, MSR810-10-PoE, MSR810-LM-HK, MSR810-W-LM-HK, MSR810-LMS-EA

Yes

MSR810-LMS, MSR810-LUS

Yes

MSR2600-6-X1, MSR2600-10-X1

Yes

MSR 2630

Yes

MSR3600-28, MSR3600-51

Yes

MSR3600-28-SI, MSR3600-51-SI

Yes

MSR3600-28-X1, MSR3600-28-X1-DP, MSR3600-51-X1, MSR3600-51-X1-DP

No

MSR3610-I-DP, MSR3610-IE-DP

Yes

MSR3610-X1, MSR3610-X1-DP, MSR3610-X1-DC, MSR3610-X1-DP-DC

Yes

MSR 3610, MSR 3620, MSR 3620-DP, MSR 3640, MSR 3660

Yes

MSR3610-G, MSR3620-G

Yes

bandwidth

Use bandwidth to set the expected bandwidth for a dialer 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

Dialer 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 Dialer 1 to 100 kbps.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] bandwidth 100

default

Use default to restore the default settings for a dialer interface.

Syntax

default

Views

Dialer interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impact of this command when you execute it on a live network.

 

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, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings for Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] default

description

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of a dialer interface is interface-name Interface, for example, Dialer1 Interface.

Views

Dialer 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 of Dialer 1 to dialer-intf.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] description dialer-intf

dialer bundle enable

Use dialer bundle enable to enable bundle DDR on a dialer interface.

Use undo dialer bundle enable to disable bundle DDR on a dialer interface.

Syntax

dialer bundle enable

undo dialer bundle enable

Default

Bundle DDR is disabled on a dialer interface.

Views

Dialer interface view

Predefined user roles

network-admin

Usage guidelines

DDR includes traditional DDR and bundle DDR.

Before using bundle DDR, use this command to enable bundle DDR on a dialer interface. Then assign physical interfaces to the corresponding dialer bundle by using the dialer bundle-member command. To enable bundle DDR to receive calls, configure the dialer peer-name command on the dialer interface.

After you configure this command on a dialer interface already enabled with traditional DDR, the system clears the original traditional DDR settings.

The undo dialer bundle enable command clears all bundle DDR settings on the dialer interface.

Examples

# Enable bundle DDR on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer bundle enable

Related commands

dialer bundle-member

dialer circular enable

dialer peer-name

dialer bundle-member

Use dialer bundle-member to assign a physical interface to a dialer bundle in bundle DDR.

Use undo dialer bundle-member to remove a physical interface from a dialer bundle in bundle DDR.

Syntax

dialer bundle-member number [ priority priority ]

undo dialer bundle-member number

Default

A physical interface does not belong to any dialer bundle in bundle DDR.

Views

Physical interface view

Predefined user roles

network-admin

Parameters

number: Specifies a dialer bundle by its number, which must be the same as the dialer interface number.

priority priority: Specifies the priority of the physical interface in the dialer bundle, in the range of 1 to 255. The default priority is 1. The greater the number, the higher the priority. Each time a call is placed, the highest-priority physical interface available is selected. If multiple physical interfaces with the highest priority are available, these interfaces are selected in a round-robin manner.

Usage guidelines

A physical interface can belong to multiple dialer bundles. You can configure this command multiple times to assign a physical interface to different dialer bundles.

When the specified dialer interface does not exist, this command creates one and enables bundle DDR on it.

Examples

# Assign BRI 2/4/0 to Dialer bundle 1 and Dialer bundle 2, with a priority of 50 in both dialer bundles.

<Sysname> system-view

[Sysname] interface bri 2/4/0

[Sysname-Bri2/4/0] dialer bundle-member 1 priority 50

[Sysname-Bri2/4/0] dialer bundle-member 2 priority 50

Related commands

dialer bundle enable

interface dialer

dialer callback-center

Use dialer callback-center to configure the PPP callback reference.

Use undo dialer callback-center to restore the default.

Syntax

dialer callback-center [ dial-number | user ] *

undo dialer callback-center

Default

No PPP callback reference is configured.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

dial-number: Uses the callback number configured in the authorization-attribute callback-number command in local user view to place return calls.

user: Uses the dial string configured in the dialer route command to place return calls.

Usage guidelines

This command is mandatory on the PPP callback server.

If both the dial-number and user keywords are specified, the device attempts to place return calls by using the dial string determined by the first keyword entered. If the attempt fails, the device places return calls by using the dial string determined by the second keyword entered.

If the command is configured with neither keyword, it has the same effect as the dialer callback-center user dial-number command.

Examples

# Specify the device as the PPP callback server, and set the callback reference to user mode.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] ppp callback server

[Sysname-Serial2/1/0] dialer callback-center user

[Sysname-Serial2/1/0] dialer route ip 1.1.1.2 dial-number 8810052 user Sysnameb

# Specify the device as the PPP callback server, and set the callback reference to dial number mode.

<Sysname> system-view

[Sysname] local-user usera

[Sysname-luser-usera] password simple usera

[Sysname-luser-usera] service-type ppp

[Sysname-luser-usera] authorization-attribute callback-number 8810048

[Sysname-luser-usera] quit

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] ppp callback server

[Sysname-Serial2/1/0] dialer callback-center dial-number

Related commands

ppp callback

dialer call-in

Use dialer call-in to configure a dialup interface to accept incoming calls from an ISDN calling number or enable callback for the ISDN calling number.

Use undo dialer call-in to restore the default.

Syntax

dialer call-in remote-number [ callback ]

undo dialer call-in remote-number [ callback ]

Default

Calls from ISDN calling numbers are not accepted.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

remote-number: Specifies an ISDN calling number, a case-insensitive string of 1 to 30 characters. The asterisk (*) is allowed as a wildcard that matches any character.

callback: Enables callback for the specified ISDN calling number.

Usage guidelines

A dialup interface screens an incoming call by comparing the calling number with the numbers configured in the dialer call-in command. If the remote SPCS does not provide the calling number, the call is dropped directly.

On a dialup interface configured with the dialer call-in callback command, you must configure the dialer route or dialer number command. The number configured in the dialer route or dialer number command must be the same as the remote-number configured in the dialer call-in callback command.

Examples

# Configure BRI 2/4/0 to place return calls for ISDN calling number 8810152.

<Sysname> system-view

[Sysname] interface bri 2/4/0

[Sysname-Bri2/4/0] dialer route ip 100.1.1.2 dial-number 8810152

[Sysname-Bri2/4/0] dialer call-in 8810152 callback

Related commands

dialer callback-center

dialer circular enable

Use dialer circular enable to enable traditional DDR on a dialup interface.

Use undo circular bundle enable to disable traditional DDR on a dialup interface.

Syntax

dialer circular enable

undo dialer circular enable

Default

Traditional DDR is disabled on a dialup interface.

Views

Dialup interface view

Predefined user roles

network-admin

Usage guidelines

DDR includes traditional DDR and bundle DDR.

Before using traditional DDR, you must use this command to enable traditional DDR on the dialup interface.

If you configure this command on a dialup interface already enabled with bundle DDR, the system clears the original bundle DDR settings.

The undo dialer circular enable command clears all DDR settings on the dialup interface.

Examples

# Enable traditional DDR on Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer circular enable

Related commands

dialer bundle enable

dialer circular-group

dialer circular-group

Use dialer circular-group to assign a physical interface to a dialer circular group in traditional DDR.

Use undo dialer circular-group to restore the default.

Syntax

dialer circular-group number

undo dialer circular-group

Default

A physical interface does not belong to any dialer circular group in traditional DDR.

Views

Physical interface view

Predefined user roles

network-admin

Parameters

number: Specifies a dialer circular group by its number, which must be the same as the one defined in the interface dialer command.

Usage guidelines

In traditional DDR, you can assign a physical interface to a dialer interface by assigning it to the dialer circular group associated with the dialer interface. A physical interface can belong to only one dialer circular group, but a dialer circular group can contain multiple physical interfaces. When placing a call on a dialer circular group, DDR selects the physical interface with the highest priority.

When the dialer interface does not exist, this command creates one and enables traditional DDR on it.

Examples

# Assign Serial 2/1/0 and Serial 2/1/1 to dialer circular group 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] quit

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer circular-group 1

[Sysname-Serial2/1/0] quit

[Sysname] interface serial 2/1/1

[Sysname-Serial2/1/1] dialer circular-group 1

Related commands

dialer circular enable

dialer priority

interface dialer

dialer disconnect

Use dialer disconnect to disconnect dialup links on an interface.

Syntax

dialer disconnect [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command disconnects dialup links on all interfaces.

Examples

# Disconnect dialup links on Dialer 0.

<Sysname> dialer disconnect interface dialer0

dialer flow-interval

Use dialer flow-interval to set the interval for DDR to collect traffic statistics.

Use undo dialer flow-interval to restore the default.

Syntax

dialer flow-interval interval

undo dialer flow-interval

Default

The interval for DDR to collect traffic statistics is 20 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for DDR to collect traffic statistics, in the range of 1 to 1500 seconds.

Usage guidelines

DDR provides traffic statistics for dialup links at the user-configured interval.

Examples

# Set the interval for DDR to collect traffic statistics to 3 seconds.

<Sysname> system-view

[Sysname] dialer flow-interval 3

Related commands

dialer threshold

dialer number

Use dialer number to configure a dial string for placing calls to a single remote site.

Use undo dialer number to restore the default.

Syntax

dialer number number [ autodial ]

undo dialer number

Default

No dial string is configured for calling the remote site.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

number: Specifies a dial string for calling a remote site, a case-insensitive string of 1 to 30 characters.

autodial: Enables the interface to automatically dial the remote site by using the specified dial string at specified intervals. The interval is set in the dialer timer autodial command and defaults to 300 seconds.

Usage guidelines

You must configure this command when the dialer or physical interface is the calling party.

In traditional DDR, you can also use the dialer route command to configure multiple destination addresses or dial strings for a dialer interface.

In bundle DDR, you can only use the dialer number command to configure one dial string for each dialer interface. This is because associations between dialer interfaces and call destination address are one-to-one.

Examples

# Set the dial string for placing calls to 11111 on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer number 11111

Related commands

dialer route

dialer timer autodial

dialer peer-name

Use dialer peer-name to specify the host name of the remote device for authenticating incoming calls.

Use undo dialer peer-name to remove the specified host name.

Syntax

dialer peer-name username

undo dialer peer-name [ username ]

Default

No host name of the remote device is specified for authenticating incoming calls.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

username: Specifies the host name of the remote device, a case-insensitive string of 1 to 80 characters.

Usage guidelines

The local device matches the peer names obtained in PPP authentication with the host names configured by this command to determine which dialer interface receives which call.

This command takes effect only on bundle DDR dialer interfaces. You can configure a maximum number of 255 host names for a dialer interface. This enables one dialer interface to receive calls from multiple physical interfaces.

If a bundle DDR dialer interface is not configured with any host name, this interface can place calls but cannot receive calls.

Examples

# Specify the host name of the remote device for Dialer 1 to routerb.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer peer-name routerb

dialer priority

Use dialer priority to assign a priority to a physical interface in a dialer circular group.

Use undo dialer priority to restore the default.

Syntax

dialer priority priority

undo dialer priority

Default

The priority of a physical interface in a dialer circular group is 1.

Views

Physical interface view

Predefined user roles

network-admin

Parameters

priority: Specifies the priority of the physical interface in a dialer circular group, in the range of 1 to 127. The larger the value, the higher the priority.

Usage guidelines

This command sets the order in which the available physical interfaces in a dialer circular group are used. Each time a call is placed, the highest-priority physical interface available is selected. If multiple physical interfaces with the highest priority are available, these interfaces are selected in a round-robin manner.

Examples

# Set the priority of Serial 2/1/0 in dialer circular group 1 to 5.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer circular-group 1

[Sysname-Serial2/1/0] dialer priority 5

Related commands

dialer circular-group

dialer queue-length

Use dialer queue-length to set the number of packets that can be buffered on a dialup interface.

Use undo dialer queue-length to restore the default.

Syntax

dialer queue-length packets

undo dialer queue-length

Default

No packets are buffered on a dialup interface.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

packets: Specifies the number of packets that can be buffered on the interface, in the range of 1 to 100.

Usage guidelines

If no connection is available when a dialup interface without a buffer queue receives a packet, the interface drops the packet. Configured with a buffer queue, the dialup interface buffers the packet until a connection is available for packet sending.

Examples

# Set the number of packets that can be buffered to 10 on Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer queue-length 10

dialer route

Use dialer route to configure a dialup interface to place calls to a remote site or receive calls from it.

Use undo dialer route to remove the configuration.

Syntax

dialer route ip next-hop-address [ mask network-mask-length ] [ vpn-instance vpn-instance-name ] [ dial-number dial-number [ autodial | interface interface-type interface-number ] * ] [ broadcast | user hostname ] *

undo dialer route protocol next-hop-address [ mask network-mask-length ] [ vpn-instance vpn-instance-name ] [dial-number dial-number ]

Default

No dial string is configured.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

ip: Specifies IP as the network layer protocol.

next-hop-address: Specifies the IP address of the remote site.

mask network-mask-length: Specifies a mask length for the remote IP address, in the range of 0 to 32. If no mask length is specified, a 32-bit mask applies. Setting the next-hop-address argument to 0.0.0.0 and the network-mask-length argument to 0 indicates any remote IP address.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.

dial-number dial-number: Specifies the dial string for calling the remote site, a case-insensitive string of 1 to 30 characters. If no dial string is specified, the interface can only receive calls.

autodial: Enables the interface to automatically dial the specified dial string at specified intervals. The interval is set in the dialer timer autodial command and defaults to 300 seconds.

interface interface-type interface-number: Specifies a physical interface by its type and number. When multiple physical interfaces are assigned to a dialer interface and their dialup links are connected to different SPCSs, you must associate each dial string with one physical interface. This configuration is intended for dialer interfaces in traditional DDR only.

broadcast: Enables broadcast packets to pass through the dialup link.

user hostname: Specifies a host name of the remote device, a case-insensitive string of 1 to 80 characters used to authenticate incoming calls.

Usage guidelines

To enable DDR to originate calls, you must configure the dial-number number option. Otherwise, DDR can only receive calls.

If you specify the number argument in the dialer route command, you must also include the number argument when using the undo dialer route command to remove the dial string.

To use the user keyword, you must configure PPP authentication. DDR accepts a call only when the host name obtained through PPP authentication is the same as the remote username configured by using this command.

You can configure a dialup interface to place calls to or receive calls from multiple remote sites. You can also configure multiple dial strings for one destination address for backup purposes.

Examples

# Specify a dial string of 888066 for packets destined to network 192.168.1.0/24.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer route ip 192.168.1.0 mask 24 dial-number 888066

# Specify a dial string of 888065 for packets destined to host address 191.168.1.1.

[Sysname-Serial2/1/0] dialer route ip 191.168.1.1 dial-number 888065

Related commands

dialer timer autodial

dialer threshold

Use dialer threshold to set the traffic threshold for a dialer interface.

Use undo dialer threshold to restore the default.

Syntax

dialer threshold traffic-percentage [ in | in-out | out ]

undo dialer threshold

Default

The traffic threshold is not set for a dialer interface.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

traffic-percentage: Specifies the traffic threshold as a percentage of aggregate link bandwidth, in the range of 0 to 99.

in: Calculates the actual load on incoming traffic only.

in-out: Calculates the actual load on incoming traffic or outgoing traffic, whichever is greater.

out: Calculates the actual load on outgoing traffic only.

Usage guidelines

To ensure appropriate traffic distribution on DDR links, DDR brings up links in an MP bundle until either of the following conditions is met:

·     The upper limit of links is reached.

·     The percentage of traffic to the bandwidth of all activated links is equal to or lower than the traffic threshold.

To ensure the DDR link efficiency, DDR shuts down links in an MP bundle until either of the following conditions is met:

·     The lower limit of links is reached.

·     The percentage of traffic to the bandwidth of (n-1) activated links is equal to or higher than the traffic threshold.

For more information about the upper limit and lower limit of links, see Layer 2WAN Access Configuration Guide.

If you set the traffic threshold to 0, DDR brings up all available links when triggered by auto-dial or packets. In addition, DDR does not disconnect these links based on the link idle-timeout timer.

This command must be used with the ppp mp command. To implement MP with DDR, you must use dialer interfaces.

DDR collects traffic statistics at the interval set by using the dialer flow-interval command.

Examples

# Set the traffic threshold on Dialer1 to 80%.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer threshold 80

Related commands

dialer flow-interval

dialer timer idle

ppp mp (Layer 2—WAN Access Command Reference)

dialer timer autodial

Use dialer timer autodial to set the auto-dial timer.

Use undo dialer timer autodial to restore the default.

Syntax

dialer timer autodial autodial-interval

undo dialer timer autodial

Default

The auto-dial timer is 300 seconds.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

autodial-interval: Specifies the interval between auto-dial attempts, in the range of 1 to 604800 seconds.

Usage guidelines

This command takes effect only when the autodial keyword is specified in the dialer number or dialer route command. DDR automatically dials the dial string at the specified interval until a connection is established. In the auto-dial method, dial attempts are not traffic triggered. Once a connection is established, it will not disconnect based on the idle timer mechanism.

Examples

# Set the auto-dial timer to 60 seconds on Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer timer autodial 60

Related commands

dialer number

dialer route

dialer timer compete

Use dialer timer compete to set the compete-idle timer.

Use undo dialer timer compete to restore the default.

Syntax

dialer timer compete compete-idle

undo dialer timer compete

Default

The compete-idle timer is 20 seconds.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

compete-idle: Specifies the idle time when contention occurs, in the range of 0 to 65535 seconds.

Usage guidelines

The idle-timeout timer starts when a link is established. If all physical interfaces are in use when DDR places a new call, contention occurs. DDR starts the compete-idle timer to replace the idle-timeout timer. When the compete-idle timer expires, DDR disconnects the idle links.

Examples

# Set the compete-idle timer to 10 seconds on Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer timer compete 10

dialer timer enable

Use dialer timer enable to set the link holddown timer.

Use undo dialer timer enable to restore the default.

Syntax

dialer timer enable interval

undo dialer timer enable

Default

The link holddown timer is 5 seconds.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

interval: Specifies the holddown timer value in the range of 5 to 65535 seconds.

Usage guidelines

The holddown timer starts when a link is disconnected. A call attempt to bring up this link can be made only after the timer expires. This is to prevent a remote SPCS from being overloaded.

To leave enough time for callback, set the holddown timer on the client 10 or more seconds longer than that on the server. As a best practice, set the link holddown timer to 5 seconds (the default) on the server, and 15 seconds on the client.

Examples

# Set the link holddown timer to 15 seconds for Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer timer enable 15

dialer timer idle

Use dialer timer idle to set the link idle-timeout timer.

Use undo dialer timer idle to restore the default.

Syntax

dialer timer idle idle [ in | in-out ]

undo dialer timer idle

Default

The link idle-timeout timer is 120 seconds, and only outgoing interesting packets reset this timer.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

idle: Specifies the link idle-timeout timer value in the range of 0 to 65535 seconds.

in: Allows only incoming interesting packets to reset the timer.

in-out: Allows both incoming and outgoing interesting packets to reset the timer.

Usage guidelines

The link idle-timeout timer starts when a link is established. If no interesting packets arrive before the timer expires, DDR disconnects the link.

If you do not specify the in or in-out keyword, only outgoing interesting packets reset the timer.

If the timer is set to 0, DDR will never disconnect the link. For a PPPoE client application, if the timer is set to 0, a dialup connection is created automatically and remains active permanently.

Examples

# Set the link idle-timeout timer to 50 seconds on Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer timer idle 50

dialer timer wait-carrier

Use dialer timer wait-carrier to set the wait-carrier timer.

Use undo dialer timer wait-carrier to restore the default.

Syntax

dialer timer wait-carrier wait-carrier

undo dialer timer wait-carrier

Default

The wait-carrier timer is 60 seconds.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

wait-carrier: Specifies the wait-carrier timer value in the range of 0 to 65535 seconds.

Usage guidelines

The wait-carrier timer limits the amount of time that DDR waits for a connection to be established for a call. The wait-carrier timer starts when a call is placed. If the connection is not established before the timer expires, DDR terminates the call.

Examples

# Set the wait-carrier timer to 100 seconds on Serial 2/1/0.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer timer wait-carrier 100

dialer timer warmup

Use dialer timer warmup to set the warm-up timer for dynamic route backup.

Use undo dialer timer warmup to restore the default.

Syntax

dialer timer warmup delay

undo dialer timer warmup

Default

The warm-up timer for dynamic route backup is 30 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

delay: Specifies the warm-up timer value for dynamic route backup, in the range of 0 to 65535 seconds.

Usage guidelines

The warm-up timer introduces a delay for the dynamic route backup feature to operate after a system startup. Set this delay to prevent unnecessary link switchover at startup.

Interfaces cannot come up until the device recovers the configuration during a reboot.

Without a warm-up delay, the dynamic route backup feature dials the secondary link immediately after it detects that the primary interface is down. When the primary interface comes up, the feature dials the primary link. The secondary link, if dialed up successfully, is brought down shortly after it came up.

With a warm-up delay, the dynamic route backup feature does not dial the secondary link until it detects that the primary interface is down when the delay expires.

Examples

# Set the warm-up timer to 20 seconds for dynamic route backup.

<Sysname> system-view

[Sysname] dialer timer warmup 20

dialer-group

Use dialer-group to assign a dialup interface to a dialer group.

Use undo dialer-group to restore the default.

Syntax

dialer-group group-number

undo dialer-group

Default

A dialup interface does not belong to any dialer group.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

group-number: Specifies a dialer group by its number in the range of 1 to 255. Before the assignment, you must create the dialer group by using the dialer-group rule command.

Usage guidelines

A dialup interface can belong to only one dialer group. If you configure this command multiple times, the most recent configuration takes effect.

You must configure this command for DDR to send packets.

Examples

# Assign Serial 2/1/0 to dialer group 1.

<Sysname> system-view

[Sysname] dialer-group 1 rule acl 3101

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer-group 1

Related commands

dialer-group rule

dialer-group rule

Use dialer-group rule to create a dialer group and configure a dial rule for it.

Use undo dialer-group rule to delete a dialer group.

Syntax

dialer-group group-number rule { ip | ipv6 } { deny | permit | acl { acl-number | name acl-name } }

undo dialer-group group-number rule [ ip | ipv6 ]

Default

No dialer group exists.

Views

System view

Predefined user roles

network-admin

Parameters

group-number: Specifies the number of the dialer group to be created, in the range of 1 to 255.

ip: Specifies the IPv4 protocol.

ipv6: Specifies the IPv6 protocol.

deny: Denies packets of the specified protocol.

permit: Permits packets of the specified protocol.

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

name acl-name: Specifies an ACL by its name.

Usage guidelines

A dial rule determines when an interface initiates DDR calls. You need to configure dial rules only on the initiator of DDR calls.

You can configure a dial rule to match only IP packets or use an ACL to match packets.

Permitted protocol packets or packets that match a permit statement of an ACL are interesting packets. When receiving an interesting packet, DDR performs one of the following operations:

·     Sends it out and resets the idle-timeout timer if a link is present.

·     Originates a new call to establish a link if no link is present.

Denied protocol packets or packets that match a deny statement of an ACL are uninteresting packets. When receiving an uninteresting packet, DDR performs one of the following operations:

·     Sends it out without resetting the idle-timeout timer if a link is present.

·     Drops it if no link is present.

For DDR to forward packets correctly, you must configure a dial rule and associate it with the dialup interface by using the dialer-group command.

Examples

# Create dialer group 1 and configure DDR to place calls for IPv4 packets. Associate Serial 2/1/0 with dialer group 1.

<Sysname> system-view

[Sysname] dialer-group 1 rule ip permit

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer-group 1

# Create dialer group 1 and configure DDR to place calls for IPv6 packets. Associate Serial 2/1/0 with dialer group 1.

<Sysname> system-view

[Sysname] dialer-group 1 rule ipv6 permit

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] dialer-group 1

Related commands

dialer-group

display dialer

Use display dialer to display the DDR information for an interface.

Syntax

display dialer [ 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 type and number. If you do not specify an interface, this command displays the DDR information for all interfaces.

Examples

# Display the DDR information for all interfaces.

<Sysname> display dialer

Dialer0:

  Dialer Route:

    NextHop: 111.111.111.111  Dialer number: 123456789012345678901234567890

    NextHop: 222.222.222.222  Dialer number: 123456789012345678901234567890

  Dialer number:

  Dialer Timers(in seconds):

    Auto-dial: 300      Compete: 20           Enable: 5

    Idle: 120           Wait-for-Carrier: 60

  Total Channels: 1

  Free Channels: 1

Table 1 Command output

Field

Description

Dialer0

Dialup interface: dialer or physical.

Dialer Route:

  NextHop: 111.111.111.111  Dialer number: 123456789012345678901234567890

Remote IP address and dial string set by using the dialer route command.

Dialer number

Dial string for a remote IP address.

Dialer Timers(in seconds):

  Auto-dial: 300      Compete: 20           Enable: 5

  Idle: 120           Wait-for-Carrier: 60

DDR timers in seconds:

·     Auto-dial—Auto-dial timer set by the dialer timer autodial command.

·     Compete—Compete-idle timer set by the dialer timer compete command.

·     Enable—Link holddown timer set by the dialer timer enable command.

·     Idle—Link idle-timeout timer set by the dialer timer idle command.

·     Wait-for-Carrier—Wait-carrier timer set by the dialer timer wait-carrier command.

Total Channels

Total number of physical interfaces on the interface. For an ISDN interface, it refers to the number of B channels.

Free Channels

Number of free channels.

 

display interface dialer

Use display interface dialer to display information about a dialer interface.

Syntax

display interface [ dialer [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

dialer [ interface-number ]: Specifies a dialer interface by its number. If you do not specify the dialer keyword, this command displays information about all interfaces on the device. If you specify the dialer keyword, this command displays information about all dialer interfaces.

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

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.

down: Displays information about interfaces in physically down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Examples

# Display detailed information about Dialer 1.

<Sysname> display interface dialer 1

Dialer1

Current state: UP

Line protocol state: UP (spoofing)

Description: Dialer1 Interface

Bandwidth: 64kbps

Maximum Transmit Unit: 1500

Hold timer: 10 seconds, retry times: 5

Internet protocol processing: disabled

Link layer protocol: PPP

LCP: initial

Physical: Dialer, baudrate: 64000 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 bits/sec, 0 packets/sec

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

Input: 0 packets, 0 bytes, 0 dropped

Output: 0 packets, 0 bytes, 0 dropped

# Display brief information about Dialer 1.

<Sysname> display interface dialer 1 brief

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

Dia1                 UP   UP(s)    --

# Display brief information about all dialer interfaces in physically Down state.

<Sysname> display interface dialer brief down

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface              Link Cause

Dia1                   ADM  Administratively

Table 2 Command output

Field

Description

Dialer1

Current state

Physical state of the dialer interface:

·     Administratively DOWN—The interface has been shut down by using the shutdown command.

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

Line protocol state

Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer.

·     UP—The data link layer protocol is up.

·     DOWN—The data link layer protocol is down.

Description

Description of the interface.

Bandwidth

Expected bandwidth of the interface.

Maximum Transmit Unit

MTU of the interface.

Hold timer

Interval for sending keepalive packets.

retry times

Maximum number of keepalive retransmission attempts. A link is removed after the maximum number of retransmission attempts is reached.

Internet address: ip-address/mask-length (Type)

IP address of the interface and type of the address in parentheses.

Possible IP address types include:

·     Primary—Manually configured primary IP address.

·     Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed.

·     DHCP-Allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3IP Services Configuration Guide.

·     BOOTP-AllocatedBOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3IP Services Configuration Guide.

·     PPP-Negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in Layer 2WAN Access Configuration Guide.

·     Unnumbered—IP address borrowed from another interface.

·     Cellular-Allocated—IP address allocated through the modem-manufacturer's proprietary protocol. For more information, see 3G/4G modem management in Layer 2WAN Access Configuration Guide.

·     MAD—IP address assigned to an IRF member device for MAD on the interface. For more information, see IRF configuration in Virtual Technologies Configuration Guide.

·     MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast Configuration Guide.

Internet protocol processing: Disabled

The interface is not assigned an IP address and cannot process IP packets.

Internet Address

IP address of the interface. The primary attribute indicates that the address is the primary IP address.

LCP: initial

LCP initialization is complete.

Physical

Physical interface type.

Output queue - Urgent queuing: Size/Length/Discards

Statistics on the packets in the urgent output queue.

Output queue - Protocol queuing: Size/Length/Discards

Statistics on the packets in the protocol output queue.

Output queue - FIFO queuing: Size/Length/Discards

Statistics on the packets in the FIFO output queue.

Last clearing of counters: Never

Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup.

Last 300 seconds input rate

Input interface data rate during the latest 300 seconds.

Last 300 seconds output rate

Output interface data rate during the latest 300 seconds.

Input: 0 packets, 0 bytes, 0 dropped

Statistics on the packets reaching the interface.

Output: 0 packets, 0 bytes, 0 dropped

Statistics on the packets sent through the interface.

Brief information on interface(s) under route mode:

Brief information about Layer 3 interfaces.

Interface

Abbreviated interface name.

Link

Physical link state of the interface:

·     UP—The interface is physically up.

·     DOWN—The interface is physically down.

·     ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

·     Stby—The interface is a backup interface in standby state. To see the primary interface, use the display interface-backup state command.

Protocol

Data link layer protocol state of the interface:

·     UP—The data link layer protocol of the interface is up.

·     DOWN—The data link layer protocol of the interface is down.

·     UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces.

Main IP

Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address.

Cause

Cause for the physical link state of an interface to be DOWN:

·     Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

·     Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).

 

Related commands

reset counters interface

interface dialer

Use interface dialer to create a dialer interface and enter its view, or enter the view of an existing dialer interface.

Use undo interface dialer to delete a dialer interface.

Syntax

interface dialer number

undo interface dialer number

Default

No dialer interface exists.

Views

System view

Predefined user roles

network-admin

Parameters

number: Specifies the number of the dialer interface, in the range of 0 to 1023.

Usage guidelines

A dialer interface has a fixed baud rate of 64000 bps.

Examples

# Create Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

mtu

Use mtu to set the maximum transmission unit (MTU) of a dialer interface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU of dialer interfaces is 1500 bytes.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

size: Specifies the MTU in bytes. The value range for this argument is 128 to 1500.

Usage guidelines

The MTU setting of a dialer interface affects the fragmentation and reassembly of IP packets.

Examples

# Set the MTU of Dialer 1 to 1200 bytes.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] mtu 1200

ppp callback

Use ppp callback to enable an interface to initiate or accept callback requests as the callback client or server.

Use undo ppp callback to disable an interface from initiating or accepting callback requests.

Syntax

ppp callback { client | server }

undo ppp callback { client | server }

Default

Callback requests are not initiated or accepted.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

client: Enables the interface to initiate callback requests as the callback client.

server: Enables the interface to accept callback requests as the callback server.

Usage guidelines

The callback client first originates a call, and the server decides whether to place a return call. If a return call is needed, the callback server disconnects the call and originates a return call according to the username or callback number.

PPP callback saves costs when the call rates in two directions are different.

Examples

# Enable Serial 2/1/0 to accept callback requests as the callback server.

<Sysname> system-view

[Sysname] interface serial 2/1/0

[Sysname-Serial2/1/0] ppp callback server

ppp callback ntstring

Use ppp callback ntstring to specify a dial string for a Windows server to call back.

Use undo ppp callback ntstring to restore the default.

Syntax

ppp callback ntstring dial-number

undo ppp callback ntstring

Default

No callback dial string is specified.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

dial-number: Specifies the dial string, a case-sensitive string of 1 to 64 characters.

Usage guidelines

Configure this command on the callback client if the Windows server requires PPP callback clients to send callback numbers.

Examples

# Specify a dial string of 1234567 for the Windows server to call back.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] ppp callback ntstring 1234567

reset counters interface

Use reset counters interface to clear the statistics of a dialer interface.

Syntax

reset counters interface [ dialer [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

dialer [ interface-number ]: Specifies a dialer interface by its number. If you do not specify the dialer keyword, this command clears statistics for all interfaces. If you specify the dialer keyword, this command clears statistics for all dialer interfaces. If you specify a dialer interface, this command clears statistics for the specified dialer interface.

Usage guidelines

Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.

Examples

# Clear the statistics of Dialer 1.

<Sysname> reset counters interface dialer 1

Related commands

display interface dialer

service

Use service to specify a primary traffic processing slot for an interface.

Use undo service to restore the default.

Syntax

‌In IRF mode:

service slot slot-number

undo service slot

Default

No primary traffic processing slot is specified for an interface.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. (In IRF mode.)

Usage guidelines

This command is supported only in IRF mode.

Specify traffic processing slots if a feature requires that all traffic on a dialer 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

# Specify slot 2 as the primary traffic processing slot for Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] service slot 2

Related commands

service standby

service standby

Use service standby to specify a backup traffic processing slot for an interface.

Use undo service standby to restore the default.

Syntax

In IRF mode:

service standby slot slot-number

undo service standby slot

Default

No backup traffic processing slot is specified for an interface.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. (In IRF mode.)

Usage guidelines

This command is supported only in IRF mode.

Specify traffic processing slots if a feature requires that all traffic on a dialer 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

# Specify slot 2 as the primary traffic processing slot and slot 3 as the backup traffic processing slot for Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] service slot 2

[Sysname-Dialer1] service standby slot 3

Related commands

service

shutdown

Use shutdown to shut down a dialer interface.

Use undo shutdown to bring up a dialer interface.

Syntax

shutdown

undo shutdown

Default

A dialer interface is up.

Views

Dialer interface view

Predefined user roles

network-admin

Examples

# Shut down Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] shutdown

standby routing-group

Use standby routing-group to assign a dialup interface to a dynamic route backup group.

Use undo standby routing-group to remove a dialup interface from a dynamic route backup group.

Syntax

standby routing-group group-number

undo standby routing-group group-number

Default

A dialup interface is not assigned to any dynamic route backup group.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

group-number: Specifies a dynamic route backup group by its number in the range of 1 to 255.

Usage guidelines

Before assigning a dialup interface to a dynamic route backup group, make sure DDR is enabled on the interface.

A dialup interface can be assigned to multiple dynamic route backup groups.

Examples

# Assign dialup interface BRI 2/4/0 to dynamic route backup group 1.

<Sysname> system-view

[Sysname] interface bri 2/4/0

[Sysname-Bri2/4/0] standby routing-group 1

standby routing-group rule

Use standby routing-group rule to create a dynamic route backup group or add a network to be monitored to the group.

Use undo standby routing-group rule to delete a dynamic route backup group or remove a monitored network from the group.

Syntax

standby routing-group group-number rule ip ip-address { mask | mask-length } [ vpn-instance vpn-instance-name ]

undo standby routing-group group-number rule [ ip ip-address { mask | mask-length } ] [ vpn-instance vpn-instance-name ]

Default

No dynamic route backup group exists.

Views

System view

Predefined user roles

network-admin

Parameters

group-number: Specifies the number of the dynamic route backup group, in the range of 1 to 255.

ip ip-address: Specifies the IP address of the network to be monitored.

mask: Specifies the network mask.

mask-length: Specifies the network mask length in the range of 0 to 32.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

You can add a maximum of 255 monitored networks to a dynamic route backup group. DDR determines that the primary link is disconnected only when there are no valid routes to any of the networks monitored by the dynamic route backup group.

Examples

# Create dynamic route backup group 1 to monitor routes to the networks 20.0.0.0/8 and 30.0.0.0/8.

<Sysname> system-view

[Sysname] standby routing-group 1 rule ip 20.0.0.1 255.0.0.0

[Sysname] standby routing-group 1 rule ip 30.0.0.1 255.0.0.0

standby timer routing-disable

Use standby timer routing-disable to set the secondary link disconnection delay.

Use undo standby timer routing-disable to restore the default.

Syntax

standby timer routing-disable delay

undo standby timer routing-disable

Default

The secondary link disconnection delay is 20 seconds.

Views

Dialup interface view

Predefined user roles

network-admin

Parameters

delay: Specifies the secondary link disconnection delay in the range of 0 to 65535 seconds.

Examples

# Set the secondary link disconnection delay to 5 seconds on BRI 2/4/0.

<Sysname> system-view

[Sysname] interface bri 2/4/0

[Sysname-Bri2/4/0] standby timer routing-disable 5

timer-hold

Use timer-hold to set the keepalive interval.

Use undo timer-hold to restore the default.

Syntax

timer-hold seconds

undo timer-hold

Default

The keepalive interval is 10 seconds.

Views

Dialer 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

On an interface encapsulated with PPP, the data link layer sends keepalive packets at keepalive intervals to detect the availability of the remote end. The data link layer determines that the peer end is down if it has not received any keepalive messages when the keepalive retry limit is reached. The data link layer then reports the link down event to the upper-layer protocols.

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

On a slow 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 1000 seconds on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] timer-hold 1000

Related commands

timer-hold retry

timer-hold retry

Use timer-hold retry to set the keepalive retry limit.

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.

Views

Dialer interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

The interface determines that the remote end is down if it has not received a keepalive response when the keepalive retry limit is reached.

On a slow 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 on Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] timer-hold retry 10

Related commands

timer-hold