DCC configuration commands· 1

bandwidth· 1

dialer bundle· 1

dialer disconnect 2

dialer queue-length· 2

dialer timer enable· 3

dialer timer idle· 4

dialer timer wait-carrier 4

dialer user 5

dialer-group· 6

dialer-rule· 7

display dialer 8

display interface dialer 9

interface dialer 11

reset counters interface· 12

 

bandwidth

Use bandwidth to set the intended bandwidth for an interface.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value

undo bandwidth

Views

Dialup interface (physical interface or dialer interface) view

Default command level

2: System level

Parameters

bandwidth-value: Specifies the intended bandwidth for the interface, ranging from 1 to 4294967295 kbps.

Usage guidelines

You can get the intended bandwidth of an interface by querying the ifspeed value of the MIB node with third-party software.

The intended bandwidth is used for bandwidth monitoring of the network management. It does not affect the actual bandwidth of the interface.

Examples

# Set the intended bandwidth to 1000 kbps for interface Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] bandwidth 1000

dialer bundle

Use dialer bundle to associate a dialer bundle with a dialer interface in RS-DCC.

Use undo dialer bundle to remove the association.

Syntax

dialer bundle number

undo dialer bundle

Default

Dialer interfaces are not associated with any dialer bundle in RS-DCC.

Views

Dialer interface view

Default command level

2: System level

Parameters

number: Specifies the dialer bundle number, in the range of 1 to 255.

Usage guidelines

This command applies only to dialer interfaces. In addition, a dialer interface can be associated with only one dialer bundle.

Examples

# Associate dialer bundle 3 with interface Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer bundle 3

dialer disconnect

Use dialer disconnect to clear the dialup link on an interface or all dialup links if no interface is specified.

Syntax

dialer disconnect [ interface interface-type interface-number ]

Views

Any view

Default command level

1: Monitor level

Parameters

interface interface-type interface-number: Disconnects the dialup link on an interface specified by its type and number.

Examples

# Clear the dialup link on interface Dialer 1.

<Sysname> dialer disconnect interface dialer 1

dialer queue-length

Use dialer queue-length to set the buffer queue length on the 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.

Views

Dialup interface view

Default command level

2: System level

Parameters

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

Usage guidelines

If no connection is available yet when a dialup interface without a buffer queue receives a packet, it will drop the packet. Configured with a buffer queue, the dialup interface will buffer the packet until a connection is available for packet sending.

Examples

# Set the buffer queue length to 10 on interface  Dialer 1.

<Sysname> system-view

[Sysname] interface  dialer 1

[Sysname-Dialer1] dialer queue-length 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 seconds

undo dialer timer enable

Default

The link holddown timer is five seconds.

Views

Dialup interface view

Default command level

2: System level

Parameters

seconds: Holddown timer value, setting the interval for originating a call to bring up a link after it is disconnected. It ranges from 5 to 65535 seconds.

Usage guidelines

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

Examples

# Set the interval for DCC to make the next call attempt to 15 seconds.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] 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 seconds

undo dialer timer idle

Default

The link idle-timeout timer is 120 seconds.

Views

Dialup interface view

Default command level

2: System level

Parameters

seconds: Link idle-timeout timer, setting the time that a link is allowed to be idle. It ranges from 0 to 65535 seconds.

Usage guidelines

A link idle-timeout timer starts upon setup of a link. If no interesting packets are present before the timer expires, DCC disconnects the link.

If the timer is set to 0, the link will never be disconnected, regardless of whether there are interesting packets on the link or not.

Examples

# Set the link idle-timeout timer to 50 seconds on interface  Dialer1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] 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 seconds

undo dialer timer wait-carrier

Default

The wait-carrier timer is 60 seconds.

Views

Dialup interface view

Default command level

2: System level

Parameters

seconds: Wait-carrier timer value, setting the time waiting for call setup. This argument ranges from 0 to 65535 seconds.

Usage guidelines

Sometimes, the time that DCC waits for a connection to be established may vary call by call. To handle this situation, you may use a wait-carrier timer. A wait-carrier timer starts when a call is placed. If the connection is not established upon expiration of the timer, DCC terminates the call.

Examples

# Set the wait-carrier timer to 100 seconds on interface Dialer1.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer timer wait-carrier 100

dialer user

Use dialer user to add a remote username for authenticating incoming calls.

Use undo dialer user to remove the remote username.

Syntax

dialer user username

undo dialer user [ username ]

Default

No remote username is set.

Views

Dialer interface view

Default command level

2: System level

Parameters

username: Remote username for PPP authentication, a string of 1 to 80 characters.

Usage guidelines

This command is only valid on dialer interfaces in RS-DCC.

On a dialer interface encapsulated with PPP, DCC identifies which dialer interface is to be used for receiving calls based on the remote username obtained through PPP authentication.

You may configure multiple dialer users (up to 255) on a dialer interface. This allows DCC to provide accesses to multiple dialup interfaces by using one dialer interface.

Use this command on a C-DCC enabled dialer interface with caution. It enables RS-DCC and can remove the C-DCC configurations on the interface.

Executing the undo dialer user command on a dialer interface can clear all configurations on it.

Examples

# Add a remote username routerb.

<Sysname> system-view

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer user routerb

Related commands

·          ppp chap user

·          ppp pap local-user

dialer-group

Use dialer-group to assign the interface to a dialer access group.

Use undo dialer-group to remove the interface from the dialer access group.

Syntax

dialer-group group-number

undo dialer-group

Default

An interface is not assigned to any dialer access groups.

Views

Dialup interface view

Default command level

2: System level

Parameters

group-number: Number of a dialer access group, in the range of 1 to 255. You may define it with the dialer-rule command.

Usage guidelines

A DCC dialup interface can belong to only one dialer access group. Configuring this command can overwrite the previous dialer access group setting for the interface, if any.

You must configure this command for DCC to send packets.

Examples

# Add interface Dialer1 to dialer access group 1.

<Sysname> system-view

[Sysname] dialer-rule 1 acl 3101

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer-group 1

Related commands

dialer-rule

dialer-rule

Use dialer-rule to set the condition for a DCC call to be placed for a dialer access group either by directly configuring a rule or by referencing an ACL.

Use undo dialer-rule to remove the setting.

Syntax

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

undo dialer-rule group -number

Default

No condition is set for a DCC call to be placed for a dialer access group.

Views

System view

Default command level

2: System level

Parameters

group-number: Number of a dialer access group, the same as the group-number argument in the dialer-group command. It ranges from 1 to 255.

protocol-name: Network protocol, which can take ip or bridge.

deny: Denies packets of the specified protocol.

permit: Permits packets of the specified protocol.

acl-number: Specifies an ACL by its ACL number. The acl-number argument ranges from 2000 to 3999. An ACL number in the range of 2000 to 2999 identifies a basic ACL. An ACL number in the range of 3000 to 3999 identifies an advanced ACL.

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

Usage guidelines

You may configure a dial ACL to filter traffic that traverses a dialup interface. Packets fall into two categories, depending on whether they are in compliance with the permit or deny statements in the dial ACL.

·          Packets that match a permit statement or that do not match any deny statements. When receiving such a packet, DCC either sends it out if a link is present and resets the idle-timeout timer or originates a new call to set up a link if no link is present.

·          Packets that do not match any permit statements or that match a deny statement. When receiving such a packet, DCC either sends it out without resetting the idle-timeout timer if a link is present, or drops it without originating calls for link setup if no link is present.

For DCC to send packets normally, you must configure a dial ACL and associate it with the concerned dialup interface by using the dialer-group command.

If no dial ACL is configured for the dialer access group associated with a dialup interface, DCC will drop received packets on the interface as uninteresting ones.

Examples

# Define dialer-rule 1 and apply it to interface Dialer1.

<Sysname> system-view

[Sysname] dialer-rule 1 ip permit

[Sysname] interface dialer 1

[Sysname-Dialer1] dialer-group 1

Related commands

dialer-group

display dialer

Use display dialer to display the DCC-related information about an interface. If no interface is specified, this command displays the DCC-related information about all the interfaces.

Syntax

display dialer [ interface interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the DCC-related information about all the DCC interfaces.

<Sysname> display dialer

Dialer0 - dialer type = Dialer

   Dialer Route:

   NextHop_address          Dialer_Numbers

   Dialer number            003

 

   Dialer Timers(Secs):

   Auto-dial:300    Enable:5

   Idle:120    Wait-for-Carrier:60

   Total Channels:1  Free Channels:1

Table 1 Command output

Field	Description
dialer type	Type of dialup interface, dialer or physical.
NextHop address	Remote address on the interface.
Dialer_Numbers	Dial strings for the remote IP addresses.
Dialer number	Dial string for a remote IP address.
Dialer Timers(Secs)	DCC timers.
Auto-dial	Timer set by the dialer timer autodial command.
Enable	Timer set by the dialer timer enable command.
Idle	Timer set by the dialer timer idle command.
Wait-for-carrier	Timer set by the dialer timer wait-carrier command.
Total Channels	Total number of channels on the interface.
Free Channels	Number of free channels.

 

display interface dialer

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

Syntax

display interface dialer number [ brief ] [ | { begin | exclude | include } regular-expression ]

display interface [ dialer ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

number: Dialer interface number.

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

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

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If you do not specify the dialer keyword, this command displays information about all interfaces on the device.

If you specify the dialer keyword without the number argument, this command displays information about all the dialer interfaces.

Examples

# Display detailed information about interface Dialer 1.

<Sysname> display interface dialer 1

Dialer1 current state: UP

Line protocol current state: UP (spoofing)

Description: Dialer1 Interface

The Maximum Transmit Unit is 1500, Hold timer is 10(sec)

Internet protocol processing : disabled

Link layer protocol is PPP

LCP initial

Physical is Dialer, baudrate: 64000 bps

Output queue : (Urgent queuing : Length)  50

Output queue : (Protocol queuing : Length)  500

Output queue : (FIFO queuing : Length)  75

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

    0 packets input, 0 bytes, 0 drops

    0 packets output, 0 bytes, 0 drops

# Display brief information about interface Dialer 1.

<Sysname> display interface dialer 1 brief

The brief information of 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 DOWN state.

<Sysname> display interface dialer brief down

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

Dia1                 ADM  Administratively

Table 2 Command output

Field	Description
current state	Physical state of a dialer interface: ·         UP—The dialer interface is physically up. ·         DOWN (Administratively)—The dialer interface was shut down with the shutdown command. To re-enable it, you must use the undo shutdown command on it.
Line protocol current state	Data link layer protocol state of the dialer interface: Up or Down.
Description	Interface description.
The Maximum Transmit Unit	MTU of the dialer interface.
Internet protocol processing	Network layer protocol state of the dialer interface: enabled or disabled.
Link layer protocol is PPP	Current data link layer protocol.
LCP initial	LCP is initialized.
Physical is Dialer	The physical interface is a dialer interface.
Output queue : (Urgent queuing : Length)	Statistics on the packets in the urgent output queue.
Output queue : (Protocol queuing : Length)	Statistics on the packets in the protocol output queue.
Output queue : (FIFO queuing : Length)	Statistics on the packets in the FIFO output queue.
Last clearing of counters: Never	Time when statistics on the dialer interfaces were last cleared. Never indicates the statistics were never cleared.
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.
0 packets input, 0 bytes, 0 drops	Statistics on the packets reaching the interface.
0 packets output, 0 bytes, 0 drops	Statistics on the packets sent through the interface.
The brief information of interface(s) under route mode	Brief information about Layer 3 interfaces.
Link: ADM - administratively down; Stby - standby	Link status: ·         ADM—The interface has been administratively shut down. To recover its physical state, execute the undo shutdown command. ·         Stby—The interface is operating as a backup interface. To see the primary interface, use the display standby state command (High Availability Command Reference).
Protocol: (s) - spoofing	If the network layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present at all, its protocol attribute includes the spoofing flag (an s in parentheses).
Interface	Abbreviated interface name.
Link	Physical link state of the interface: ·         UP—The link is up. ·         ADM—The link has been administratively shut down. To recover its physical state, execute the undo shutdown command.
Protocol	Protocol connection state of the interface: UP, DOWN, or UP(s).
Main IP	Main IP address of the interface.
Description	Description of the interface.
Cause	Cause of a DOWN physical link. If the port has been shut down with the shutdown command, this field displays Administratively. To restore the physical state of the interface, use the undo shutdown command.

 

interface dialer

Use interface dialer to create a dialer interface. In C-DCC, this equals creating a dialer circular group.

Use undo interface dialer to remove a dialer interface.

Syntax

interface dialer number

undo interface dialer number

Default

No dialer interface is created.

Views

System view

Default command level

2: System level

Parameters

number: Dialer interface number. The value range for this argument is 1 to 16.

Usage guidelines

The dialer interface has a fixed baudrate of 64000 bps.

In RS-DCC, any dialer interface can use the services provided by multiple physical interfaces, and individual physical interfaces can provide services for multiple dialer interfaces at the same time. Therefore, authentication must be configured on these physical interfaces, so as to use the username of a dial-in party to locate the corresponding dialer interface for the call. In this mode, physical interfaces and dialer interfaces are dynamically bound. Furthermore, a dialer interface can only call a destination address as specified in the dialer number command.

The physical interfaces in DCC use the network addresses of their associated dialer interface rather than being assigned separate addresses.

Examples

# Create dialer interface Dialer 1.

<Sysname> system-view

[Sysname] interface dialer 1

reset counters interface

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

Syntax

reset counters interface [ dialer [ number ] ]

Views

User view

Default command level

2: System level

Parameters

number: Dialer interface number. The value of this argument can be the number of any existing dialer interface.

Usage guidelines

Before sampling network traffic within a specific period of time on an interface, you must clear the existing statistics.

If neither dialer nor the number is specified, this command clears the statistics of all the interfaces.

If only dialer is specified, this command clears the statistics of all dialer interfaces.

If both dialer and the number are specified, this command clears the statistics of the specified dialer interface.

Examples

# Clear the statistics of Dialer 1.

<Sysname> reset counters interface dialer 1