- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
08-DDR commands | 207.79 KB |
Contents
DDR commands
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: 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
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] 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
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 123456TESTplat&!
[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
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] 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
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] 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
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
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] interface dialer 1
[Sysname-Dialer1] dialer number 11111
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] interface serial 2/1/0
[Sysname-Serial2/1/0] dialer circular-group 1
[Sysname-Serial2/1/0] dialer priority 5
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] 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
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 2—WAN 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
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
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
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 3—IP Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · PPP-negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in Layer 2—WAN 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 2—WAN 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 standalone mode:
service slot slot-number
undo service slot
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
Dialer interface view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone 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. (In IRF mode.)
Usage guidelines
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 standalone mode:
service standby slot slot-number
undo service standby slot
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
Dialer interface view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone 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. (In IRF mode.)
Usage guidelines
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