Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 03-WAN interface commands | 99.59 KB |
WAN interface commands
Common WAN interface commands
default
Use default to restore the default settings for an interface.
Syntax
default
Views
CE1 interface
Serial 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 use it on a live network. |
This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. You can use the display this command in interface view to check for these commands, and use their undo forms or follow the command reference to restore their respective default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.
Examples
# Restore the default settings of Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] 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 interface description uses the interface name Interface format, for example, Serial5/1/1:1 Interface.
Views
CE1 interface view
Serial interface view
Predefined user roles
network-admin
Parameters
text: Specifies the description, a case-sensitive string of 1 to 255 characters.
Examples
# Configure the description of Serial 5/1/1:1 as router-interface.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] description router-interface
shutdown
Use shutdown to shut down an interface.
Use undo shutdown to restore the default.
Syntax
shutdown
undo shutdown
Default
A WAN interface is up.
Views
CE1 interface view
Serial interface view
Predefined user roles
network-admin
Examples
# Shut down Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] shutdown
Serial interface commands
bandwidth
Use bandwidth to configure the expected bandwidth of an interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
Serial 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 is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.
Examples
# Set the expected bandwidth to 50 kbps for Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] bandwidth 50
crc
Use crc to set the CRC mode for a synchronous serial interface.
Use undo crc to restore the default.
Syntax
crc { 16 | 32 | none }
undo crc
Default
16-bit CRC is used.
Views
Synchronous serial interface view
Predefined user roles
network-admin
Parameters
16: Specifies 16-bit CRC.
32: Specifies 32-bit CRC.
none: Disables CRC.
Examples
# Configure Serial 5/1/1:1 to use 32-bit CRC.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] crc 32
display interface serial
Use display interface serial to display information about serial interfaces.
Syntax
display interface [ serial [ interface-number ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
serial [ interface-number ]: Specifies a serial interface by its number. If you do not specify the serial keyword, this command displays information about all interfaces. If you specify the serial keyword without specifying an interface, this command displays information about all serial 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 interface descriptions.
down: Displays physically down interfaces and their down causes. If you do not specify this keyword, the command displays information about interfaces in all states.
Examples
# Display detailed information about Serial 5/1/1:1.
<Sysname> display interface Serial 5/1/1:1
Serial5/1/1:1
Current state: DOWN
Line protocol state: DOWN
Description: Serial5/1/1:1 Interface
Bandwidth: 1000 kbps
Maximum transmission unit: 1500
Hold timer: 10 seconds, retry times: 5
Derived from E1 5/1/1, Timeslot(s) Used: 1, Baudrate is 64000 bps
Internet protocol processing: Disabled
Link layer protocol: PPP
LCP: initial
Port priority: 0
Last clearing of counters: Never
CRC type is none
Last 50 seconds input: 0 packets/sec, 0 bytes/sec
Last 50 seconds output: 0 packets/sec, 0 bytes/sec
Input(total): 0 packets, 0 bytes
Input(Bad): 0 Abort, 0 FCS-Error, 0 FIFO-Abort, 0 Giant, 0 Runt
Output(total): 0 packets, 0 bytes
Output(Bad): 0 Abort
Peak value of input: 0 bytes/sec, at 2017-12-22 08:02:01
Peak value of output: 0 bytes/sec, at 2017-12-22 08:02:01
# Display brief information about Serial 5/1/1:1.
<Sysname> display interface Serial 5/1/1:1 brief
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol Primary IP Description
Ser5/1/1:1 UP UP(s) --
# Display brief information about all serial interfaces in down state and the causes.
<Sysname> display interface serial brief down
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
Ser5/1/1:1 ADM Administratively
Table 1 Command output
|
Field |
Description |
|
Current state |
Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · 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 transmission unit |
MTU of the interface. |
|
Hold timer |
Interval at which the interface sends keepalive packets. |
|
retry times |
Keepalive retry limit. The interface determines that the remote end is down if it does not receive a keepalive response after the keepalive retry limit has been made. |
|
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. |
|
Link layer protocol |
Link layer protocol of the interface. |
|
LCP |
LCP status. |
|
Last clearing of counters |
The most recent time that the reset counters interface serial command was executed. This field displays Never if this command has not been executed since the device startup. |
|
Last 50 seconds input: 0 packets/sec, 0 bytes/sec |
Average input rates (in Bps, bps, and pps) for the last 50 seconds. |
|
Last 50 seconds output: 0 packets/sec, 0 bytes/sec |
Average output rates (in Bps, bps, and pps) for the last 50 seconds. |
|
Input(total): 0 packets, 0 bytes |
Total number and size (in bytes) of correct packets received by the interface. |
|
Input(Bad): 0 Abort, 0 FCS-Error, 0 FIFO-Abort, 0 Giant, 0 Runt |
Incoming error traffic statistics for the interface: · Abort—Number of anomalous errors. · FCS-Error—Number of incoming normal-size packets with CRC or FCS errors. · FIFO-Abort—Number of incoming FIFO overflow errors. · Giant—Number of incoming oversized packets. · Runt—Number of incoming undersized packets. |
|
Output(total): 0 packets, 0 bytes |
Outgoing traffic statistics for the interface. |
|
Output(Bad): 0 Abort |
Total number of packets that fail to be forwarded for any reasons (for example, packet collisions were detected during transmission). |
|
Peak value of input |
· Peak rate (in bytes/sec) for incoming traffic on the interface. Time when the peak rate occurred. |
|
Peak value of output |
· Peak rate (in bytes/sec) for outgoing traffic on the interface. Time when the peak rate occurred. |
|
Brief information on interfaces in 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. |
|
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. |
|
Primary IP |
Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address. |
|
Description |
Description of the interface. |
|
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 serial
interface serial
Use interface serial to enter serial interface view.
Syntax
interface serial interface-number
Default
No serial subinterfaces exist.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a serial interface by its number.
Examples
# Enter the view of Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface Serial 5/1/1:1
[Sysname-Serial5/1/1:1]
link-protocol
Use link-protocol to configure the data link layer protocol for an interface.
Syntax
link-protocol { hdlc | ppp }
Default
A serial interface uses PPP as the data link layer protocol.
Views
Serial interface view
Predefined user roles
network-admin
Parameters
hdlc: Specifies the HDLC data link layer protocol.
ppp: Specifies the PPP data link layer protocol.
Examples
# Specify HDLC as the data link layer protocol of Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] link-protocol hdlc
mtu
Use mtu to set the MTU for an interface.
Use undo mtu to restore the default.
Syntax
mtu size
undo mtu
Default
The MTU of an interface is 1500 bytes.
Views
Serial interface view
Predefined user roles
network-admin
Parameters
size: Sets the maximum transmission unit (MTU) in bytes. The value range for this argument varies by card model.
Usage guidelines
The MTU setting affects IP packet assembly and fragmentation on the interface.
After configuring the MTU for a WAN interface, you must use the shutdown command and then the undo shutdown command on the interface for the modification to take effect.
Follow these guidelines when you set the MTU for an interface:
· IP packets received by an incoming interface cannot be fragmented based on the MTU set for the outgoing interface if the incoming interface is on one of the following cards:
¡ SPC.
¡ MPE-1104.
· IP packets are fragmented to each fragment of 1280 bytes when the following conditions are met:
¡ An interface on a CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, SPEX, CSPEX, or CEPC card acts as the incoming interface.
¡ The configured MTU value for the outgoing interface is less than 1280.
If the device is installed with the above cards, as a best practice, set the outgoing interface MTU to a value greater than 1280.
Examples
# Set the MTU to 1430 bytes for Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] mtu 1430
reset counters interface serial
Use reset counters interface serial to clear serial interface statistics.
Syntax
reset counters interface [ serial [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
serial [ interface-number ]: Specifies a serial interface by its number. If you do not specify the serial keyword, this command clears statistics for all interfaces. If you specify the serial keyword without specifying an interface, this command clears statistics for all serial interfaces.
Usage guidelines
Use this command to clear history statistics before you collect traffic statistics for a time period.
Examples
# Clear statistics for Serial 5/1/1:1.
<Sysname> reset counters interface serial 5/1/1:1
Related commands
display interface serial
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
Serial interface view
Predefined user roles
network-admin
Parameters
seconds: Specifies the interval at which an interface sends keepalive packets. The value range is 0 to 32767 seconds.
Usage guidelines
On an interface encapsulated with PPP or HDLC, 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 does not receive a response after the keepalive retry limit has been made. 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 15 seconds for Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] timer-hold 15
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
Serial interface view
Predefined user roles
network-admin
Parameters
retries: Specifies the keepalive retry limit, in the range of 1 to 255.
Usage guidelines
The interface determines that the remote end is down if it does not receive a response after the keepalive retry limit has been made.
This command applies to interfaces encapsulated with PPP or HDLC. To set the keepalive interval, use the timer-hold command.
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 for Serial 5/1/1:1.
<Sysname> system-view
[Sysname] interface serial 5/1/1:1
[Sysname-Serial5/1/1:1] timer-hold retry 10
Related commands
timer-hold
CE1 interface commands
cable
Use cable to set the cable type for a CE1 interface.
Use undo cable to restore the default.
Syntax
cable { long | short }
undo cable
Default
The long keyword applies.
Views
CE1 interface view
Predefined user roles
network-admin
Parameters
long: Specifies the attenuation of the receiver as –43 dB.
short: Specifies the attenuation of the receiver as –10 dB.
Examples
# Set the cable type on E1 5/2/1 to short.
<Sysname> system-view
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] cable short
channel-set
Use channel-set to bundle timeslots on a CE1 interface into a channel set.
Use undo channel-set to cancel the bundling.
Syntax
channel-set set-number timeslot-list list
undo channel-set [ set-number ]
Default
No channel sets exist on a CE1 interface.
Views
CE1 interface view
Predefined user roles
network-admin
Parameters
set-number: Specifies the number of the channel set for the timeslot bundle. The value range is 0 to 30.
timeslot-list list: Specifies a comma-separated list of timeslot items. An item can be an individual timeslot or a timeslot range. Use a hyphen (-) to separate the start and end timeslot numbers of a range. The value range for the timeslot number is 1 to 31.
Usage guidelines
A CE1 interface in CE1 mode is physically divided into 32 timeslots numbered 0 through 31. All the timeslots except timeslot 0 can be bundled into multiple channel sets. For each channel set, the system automatically creates a serial interface that has the same logical features as a standard synchronous serial interface.
The serial interface name uses the serial interface-number:set-number format. The interface-number argument specifies the CE1 interface number. The set-number argument specifies the channel set number.
Examples
# Bundle timeslots 1, 2, 5, 10 through 15, and 18 into channel set 0 on E1 5/2/1.
<Sysname> system-view
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] channel-set 0 timeslot-list 1,2,5,10-15,18
clock
Use clock to set the clock mode of a CE1 interface.
Use undo clock to restore the default.
Syntax
clock { master | slave }
undo clock
Default
The clock mode of a CE1 interface is slave.
Views
CE1 interface view
Predefined user roles
network-admin
Parameters
master: Sets the clock mode to master.
slave: Sets the clock mode to slave.
Usage guidelines
When the clock mode of a CE1 interface is master, it uses the internal clock source. When the clock mode of a CE1 interface is slave, it uses the line clock source.
Examples
# Set the clock mode to master for CE1 interface E1 5/2/1.
<Sysname> system-view
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] clock master
clock-change auto
Use clock-change auto to enable automatic clock mode switchover on an interface.
Use undo clock-change auto to disable automatic clock mode switchover.
Syntax
clock-change auto
undo clock-change auto
Default
Automatic clock mode switchover is disabled on an interface.
Views
CE1 interface view
Predefined user roles
network-admin
Usage guidelines
When automatic clock mode switchover is enabled, the interface automatically switches to the master clock mode when both of the following conditions exist:
· The interface uses the slave clock mode.
· The interface receives an alarm indication signal (AIS), loss of signal (LOS), or loss of frame (LOF) alarm.
After the alarm is cleared, the interface automatically switches back to the slave mode.
When automatic clock mode switchover is disabled, the interface uses the user-configured clock mode.
Examples
# Enable automatic clock mode switchover for E1 5/2/1.
<Sysname> system-view
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] clock-change auto
Related commands
clock
controller e1
Use controller e1 to enter CE1 interface view.
Syntax
controller e1 interface-number
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a CE1 interface by its number.
Examples
# Enter E1 5/2/1 interface view.
<Sysname> system-view
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1]
display controller e1
Use display controller e1 to display information about CE1 interfaces.
Syntax
display controller [ e1 [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
e1 [ interface-number ]: Specifies a CE1 interface by its number. If you do not specify the e1 keyword, the command displays information about all CE1 interfaces and CPOS interfaces. If you specify the e1 keyword without specifying an interface, the command displays information about all CE1 interfaces.
Examples
# Display information about E1 5/2/1.
<Sysname> display controller e1 5/2/1
E1 5/2/1
Current state: DOWN
Description: E1 5/2/1 Interface
Last clearing of counters: Never
Current system time:2013-02-23 09:44:34
Last time when physical state changed to up:-
Last time when physical state changed to down:2013-02-20 15:58:54
Basic Configuration:
Work mode is E1 framed, frame-format is no-crc4.
Resistance type is 120 Ohm balanced.
Cable type is no connector.
Line code is hdb3, source clock is master.
Itf type is 7e, itf number is 4.
Cable loss type is long, auto clock change is enabled.
Loopback is not set.
Alarm State:
LFA LOS
Error Statistic:
Line Code Error: 0, Path Code Error: 0.
Table 2 Command output
|
Field |
Description |
|
Current state |
Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up. |
|
Description |
Description of the interface. |
|
Last clearing of counters |
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. |
|
Current system time |
Current system time in the YYYY-MM-DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY-MM-DD HH:MM:SS UTC±HH:MM:SS format. |
|
Last time when physical state changed to up |
Last time when physical state of the interface changed to up. A hyphen (-) indicates that the physical state of the interface has not changed to up. |
|
Last time when physical state changed to down |
Last time when physical state of the interface changed to down. A hyphen (-) indicates that the physical state of the interface has not changed to down. |
|
Work mode |
Operating mode of the interface: E1 or CE1. |
|
Cable type |
Cable type of the interface. |
|
source clock |
Clock source used by the interface: master or slave. |
|
Line code |
Line code: AMI or HDB3. |
|
Itf type |
Interframe filling tag: 7e or ff. This field is not supported in the current software version. |
|
itf number |
Number of interframe filling tags between two successive frames. This field is not supported in the current software version. |
|
Cable loss type |
Cable type of the interface. |
|
auto clock change |
Auto clock change state on the interface. |
|
Loopback |
Loopback state. |
|
Line Code Error |
Error statistics for line code (AMI or HDB3). The AMI line code is not supported in the current software version. |
|
Path Code Error |
Bit error statistics for frame alignment. |
Related commands
reset counters controller e1
frame-format
Use frame-format to set the framing format for a CE1 interface.
Use undo frame-format to restore the default.
Syntax
frame-format { crc4 | no-crc4 }
undo frame-format
Default
The framing format on a CE1 interface is no-CRC4.
Views
CE1 interface view
Predefined user roles
network-admin
Parameters
crc4: Sets the framing format to CRC4.
no-crc4: Sets the framing format to no-CRC4.
Usage guidelines
A CE1 interface in CE1 mode supports both CRC4 and no-CRC4 framing formats. Only CRC4 supports four-bit CRC on physical frames.
Examples
# Set the framing format to CRC4 on E1 5/2/1.
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] frame-format crc4
loopback
Use loopback to enable loopback and set the loopback mode on a CE1 interface.
Use undo loopback to disable loopback on a CE1 interface.
Syntax
loopback { local | payload | remote }
undo loopback
Default
Loopback is disabled on a CE1 interface.
Views
CE1 interface view
Predefined user roles
network-admin
Parameters
local: Sets the interface to operate in local loopback mode.
payload: Sets the interface to operate in external payload loopback mode.
remote: Sets the interface to operate in external loopback mode.
Usage guidelines
Loopback is intended for testing only. Disable the feature when the interface is operating correctly.
You can bundle timeslots on the CE1 interface to form a serial interface and encapsulate it with PPP. After you enable loopback on this serial interface, it is normal that the state of the link layer protocol is reported as down.
Examples
# Set E1 5/2/1 to operate in internal loopback mode.
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] loopback local
reset counters controller e1
Use reset counters controller e1 to clear CE1 interface statistics.
Syntax
reset counters controller e1 [ interface-number ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a CE1 interface by its number. If you do not specify this argument, the command clears statistics for all CE1 interfaces.
Usage guidelines
The reset counters interface command clears statistics for all interfaces.
To display CE1 interface statistics, use the display controller e1 command.
Examples
# Clear statistics for CE1 interface E1 5/2/1.
<Sysname> reset counters controller e1 5/2/1
Related commands
display controller e1
using
Use using to set the operating mode of a CE1 interface.
Use undo using to restore the default.
Syntax
using { ce1 | e1 }
undo using
Default
A CE1 interface operates in channelized mode.
Views
CE1 interface view
Predefined user roles
network-admin
Parameters
ce1: Sets the interface to operate in channelized mode.
e1: Sets the interface to operate in E1 mode.
Usage guidelines
A CE1 interface can operate in channelized or unchannelized mode.
· Channelized mode is also called CE1 mode. In CE1 mode, the CE1 interface is physically divided into 32 timeslots numbered 0 through 31. Timeslot 0 is used for FSC.
· Unchannelized mode is also called E1 mode. For a CE1 interface in E1 mode, the system automatically creates a 2.048 Mbps serial interface. The interface name uses the serial interface-number:0 format. The interface-number argument specifies the CE1 interface number. This interface has the same logical features as a standard synchronous serial interface.
Examples
# Set E1 5/2/1 to operate in E1 mode.
<Sysname> system-view
[Sysname] controller e1 5/2/1
[Sysname-E1 5/2/1] using e1
