You are on page 1of 207

www.raisecom.

com

RCMS2903-4E1-4GE (A)
Command Reference
(Rel_02)

Raisecom Technology Co., Ltd. provides customers with comprehensive technical support and services. For any
assistance, please contact our local office or company headquarters.
Website: http://www.raisecom.com
Tel: 8610-82883305
Fax: 8610-82883056
Email: export@raisecom.com
Address: Building 2, No. 28, Shangdi 6th Street, Haidian District, Beijing, P.R.China
Postal code: 100085

-----------------------------------------------------------------------------------------------------------------------------------------

Notice
Copyright 2013
Raisecom
All rights reserved.
No part of this publication may be excerpted, reproduced, translated or utilized in any form or by any means,
electronic or mechanical, including photocopying and microfilm, without permission in Writing from Raisecom
Technology Co., Ltd.
is the trademark of Raisecom Technology Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective holders.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute the warranty of any kind, express or implied.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Preface

Preface
Objectives
This document introduces commands supported by the RCMS2903-4E1-4GE and describes
all commands in aspects of function, format, parameters, default conditions, command modes,
user level, usage guideline, examples, and related commands. In addition, an Index is
introduced in this document to help you find commands quickly.
This document helps you understand commands supported by the RCMS2903-4E1-4GE, so
that you can use listed examples to correctly configure the RCMS2903-4E1-4GE.

Versions
The following table lists the product versions related to this document.
Product name
RCMS2903-4E1-4GE

Hardware version
A.01 or later

Software version
1.2.0 or later

Conventions
Symbol conventions
The symbols that may be found in this document are defined as follows.
Symbol

Description
Indicates a hazard with a medium or low level of risk which, if
not avoided, could result in minor or moderate injury.
Indicates a potentially hazardous situation that, if not avoided,
could cause equipment damage, data loss, and performance
degradation, or unexpected results.
Provides additional information to emphasize or supplement
important points of the main text.

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Preface

Symbol

Description
Indicates a tip that may help you solve a problem or save time.

General conventions
Convention

Description

Times New Roman

Normal paragraphs are in Times New Roman.

Arial

Paragraphs in Warning, Caution, Notes, and Tip are in Arial.

Boldface

Names of files, directories, folders, and users are in boldface.


For example, log in as user root.

Italic

Book titles are in italics.

Lucida Console

Terminal display is in Lucida Console.

Command conventions
Convention

Description

Boldface

The keywords of a command line are in boldface.

Italic

Command arguments are in italics.

[]

Items (keywords or arguments) in square brackets [ ] are


optional.

{ x | y | ... }

Alternative items are grouped in braces and separated by


vertical bars. Only one is selected.

[ x | y | ... ]

Optional alternative items are grouped in square brackets and


separated by vertical bars. One or none is selected.

{ x | y | ... } *

Alternative items are grouped in braces and separated by


vertical bars. A minimum of one or a maximum of all can be
selected.

[ x | y | ... ] *

Optional alternative items are grouped in square brackets and


separated by vertical bars. A minimum of none or a maximum
of all can be selected.

Raisecom Technology Co., Ltd.

ii

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Preface

Change history
Updates between document versions are cumulative. Therefore, the latest document version
contains all updates made to previous versions.

Issue 02 (2012-09-05)
Second commercial release

Added descriptions of the device_role { master | slave | stand_alone } command. Use


this command, you can configure the RCMS2903-4E1-4GE to master mode, slave mode,
or independent mode.

Added alarm management feature.

Modified some descriptions.

Issue 01 (2012-08-07)
Initial commercial release

Raisecom Technology Co., Ltd.

iii

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Contents

Contents
1 Basic configurations ..................................................................................................................... 1
1.1 BootROM commands ....................................................................................................................................... 1
1.1.1 h .............................................................................................................................................................. 1
1.1.2 i ............................................................................................................................................................... 3
1.1.3 m ............................................................................................................................................................. 4
1.1.4 r ............................................................................................................................................................... 6
1.1.5 s ............................................................................................................................................................... 7
1.1.6 u .............................................................................................................................................................. 9
1.2 Basic commands............................................................................................................................................. 11
1.2.1 clear....................................................................................................................................................... 11
1.2.2 config .................................................................................................................................................... 12
1.2.3 disable ................................................................................................................................................... 13
1.2.4 enable .................................................................................................................................................... 14
1.2.5 end......................................................................................................................................................... 15
1.2.6 english ................................................................................................................................................... 16
1.2.7 exit ........................................................................................................................................................ 17
1.2.8 help........................................................................................................................................................ 18
1.2.9 history ................................................................................................................................................... 19
1.2.10 list........................................................................................................................................................ 20
1.2.11 logout .................................................................................................................................................. 21
1.2.12 quit ...................................................................................................................................................... 22
1.2.13 reboot .................................................................................................................................................. 23
1.2.14 reset ..................................................................................................................................................... 24
1.3 User management ........................................................................................................................................... 25
1.3.1 password ............................................................................................................................................... 25
1.3.2 save user ................................................................................................................................................ 26
1.3.3 show terminal ........................................................................................................................................ 27
1.3.4 show user .............................................................................................................................................. 28
1.3.5 user password ........................................................................................................................................ 29
1.3.6 user privilege ......................................................................................................................................... 30
1.3.7 who........................................................................................................................................................ 32
1.4 File management ............................................................................................................................................ 33

Raisecom Technology Co., Ltd.

iv

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Contents

1.4.1 download ............................................................................................................................................... 33


1.4.2 erase startup-config ............................................................................................................................... 34
1.4.3 show running-config ............................................................................................................................. 36
1.4.4 show startup-config ............................................................................................................................... 37
1.4.5 upload.................................................................................................................................................... 39
1.4.6 write ...................................................................................................................................................... 40
1.5 Time management .......................................................................................................................................... 41
1.5.1 clock set ................................................................................................................................................ 41
1.5.2 clock summer-time enable .................................................................................................................... 43
1.5.3 clock summer-time recurring ................................................................................................................ 44
1.5.4 clock timezone ...................................................................................................................................... 45
1.5.5 show clock ............................................................................................................................................ 46
1.6 Debugging management ................................................................................................................................. 48
1.6.1 assert-dest.............................................................................................................................................. 48
1.6.2 clear trace message................................................................................................................................ 49
1.6.3 ping ....................................................................................................................................................... 50
1.6.4 show assert-dest .................................................................................................................................... 51
1.6.5 show trace-dest...................................................................................................................................... 52
1.6.6 show trace message ............................................................................................................................... 53
1.6.7 trace-dest ............................................................................................................................................... 53
1.7 Device management ....................................................................................................................................... 55
1.7.1 clear statistic.......................................................................................................................................... 55
1.7.2 device_role ............................................................................................................................................ 56
1.7.3 hostname ............................................................................................................................................... 57
1.7.4 remote ................................................................................................................................................... 58
1.7.5 restore-default-configuration................................................................................................................. 59
1.7.6 show device ........................................................................................................................................... 60
1.7.7 show info ............................................................................................................................................... 61
1.7.8 show interface (remote/global configuration mode) ............................................................................. 63
1.7.9 show manufacture info .......................................................................................................................... 65
1.7.10 show rotp-cpu-utilization-ratio............................................................................................................ 66
1.7.11 show sys-up-time ................................................................................................................................ 67
1.7.12 show this ............................................................................................................................................. 67
1.7.13 show version ....................................................................................................................................... 69
1.7.14 sync-configuration .............................................................................................................................. 70

2 System management ................................................................................................................... 73


2.1.1 als enable............................................................................................................................................... 73
2.1.2 e1tributary-lost-alarm............................................................................................................................ 74
2.1.3 fault-pass enable .................................................................................................................................... 75
2.1.4 ip route .................................................................................................................................................. 76
2.1.5 show ip route ......................................................................................................................................... 77

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Contents

3 Network management ................................................................................................................ 79


3.1.1 autonegotiate (SNMP interface configuration mode) ............................................................................ 79
3.1.2 arp add................................................................................................................................................... 80
3.1.3 description ............................................................................................................................................. 81
3.1.4 ip address (SNMP interface configuration mode) ................................................................................. 82
3.1.5 show snmp-server community .............................................................................................................. 83
3.1.6 show snmp-server statistics ................................................................................................................... 84
3.1.7 show snmp trap-bind ............................................................................................................................. 87
3.1.8 show snmp trap-server .......................................................................................................................... 88
3.1.9 snmp trap-bind ...................................................................................................................................... 89
3.1.10 snmp trap-server .................................................................................................................................. 90
3.1.11 snmp-server community ...................................................................................................................... 91
3.1.12 shutdown (SNMP interface configuration mode) ................................................................................ 92
3.1.13 snmpd .................................................................................................................................................. 93
3.1.14 speed (SNMP interface configuration mode) ...................................................................................... 94
3.1.15 interface snmp ..................................................................................................................................... 95
3.1.16 show arp .............................................................................................................................................. 96
3.1.17 show interface snmp............................................................................................................................ 97

4 Ethernet access ............................................................................................................................. 99


4.1 VLAN ............................................................................................................................................................. 99
4.1.1 double-tagging tpid ............................................................................................................................... 99
4.1.2 pvid ..................................................................................................................................................... 100
4.1.3 show vlan-entry-list............................................................................................................................. 101
4.1.4 tag-mode ............................................................................................................................................. 103
4.1.5 vlan-entry vid ...................................................................................................................................... 104
4.1.6 vlan-entry vid portlist .......................................................................................................................... 105
4.1.7 vlan-entry-list ...................................................................................................................................... 107
4.1.8 vlan-entry-list port-list ........................................................................................................................ 108
4.1.9 vlan-manage vid .................................................................................................................................. 109
4.1.10 vlan-type ........................................................................................................................................... 110
4.2 QoS............................................................................................................................................................... 112
4.2.1 qos default-cos .................................................................................................................................... 112
4.2.2 qos enable ........................................................................................................................................... 113
4.2.3 qos queue ............................................................................................................................................ 114
4.2.4 qos queue cos-map .............................................................................................................................. 115
4.2.5 qos queue wrr ...................................................................................................................................... 117
4.2.6 qos trust ............................................................................................................................................... 118
4.2.7 show qos ............................................................................................................................................. 119
4.3 Rate limiting ................................................................................................................................................. 121
4.3.1 rate-limit.............................................................................................................................................. 121
4.3.2 show vlan-entry-list rate-limit ............................................................................................................. 123
Raisecom Technology Co., Ltd.

vi

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Contents

4.3.3 vlan-entry-list rate-limit ...................................................................................................................... 124


4.4 Storm control ................................................................................................................................................ 125
4.4.1 show storm-control ............................................................................................................................. 125
4.4.2 storm-control ....................................................................................................................................... 127
4.4.3 storm-control rate ................................................................................................................................ 128

5 Interface management .............................................................................................................. 130


5.1 Switching interface commands .................................................................................................................... 130
5.1.1 interface switchport ............................................................................................................................. 130
5.2 GE electrical interface commands ................................................................................................................ 131
5.2.1 autonegotiate (GE electrical interface configuration mode) ............................................................... 131
5.2.2 clear statistic (GE electrical interface configuration mode) ................................................................ 132
5.2.3 flow-control on (GE electrical interface configuration mode) ............................................................ 133
5.2.4 interface ge .......................................................................................................................................... 134
5.2.5 show interface (GE electrical interface configuration mode).............................................................. 135
5.2.6 show statistic (GE electrical interface configuration mode) ............................................................... 136
5.2.7 shutdown ............................................................................................................................................. 138
5.2.8 speed(GE electrical interface configuration mode) ............................................................................. 139
5.2.9 show esw ............................................................................................................................................. 140
5.3 GF optical interface commands .................................................................................................................... 142
5.3.1 clear statistic (GF optical interface configuration mode) .................................................................... 142
5.3.2 flow-control on (GF optical interface configuration mode) ................................................................ 143
5.3.3 interface fx-ge ..................................................................................................................................... 144
5.3.4 show interface (GF optical interface configuration mode) .................................................................. 145
5.3.5 show statistic (GF optical interface configuration mode) ................................................................... 146
5.4 E1 interface commands ................................................................................................................................ 147
5.4.1 alarm-mask all ..................................................................................................................................... 147
5.4.2 bert ...................................................................................................................................................... 148
5.4.3 clear statistic (E1 interface configuration mode) ................................................................................ 149
5.4.4 interface e1 .......................................................................................................................................... 150
5.4.5 loopback .............................................................................................................................................. 151
5.4.6 show interface (E1 interface configuration mode) .............................................................................. 153
5.4.7 show loopback .................................................................................................................................... 155
5.5 PDH optical interface commands ................................................................................................................. 156
5.5.1 interface pdh-opt ................................................................................................................................. 156
5.5.2 show interface (PDH optical interface configuration mode) ............................................................... 157
5.6 SFP optical interface commands .................................................................................................................. 158
5.6.1 interface sfp pdh-opt ........................................................................................................................... 158
5.6.2 sfp-switch on ....................................................................................................................................... 159
5.6.3 show history-statistic-interval ............................................................................................................. 160
5.6.4 show statistic-current .......................................................................................................................... 161
5.6.5 show interface (PDH SFP optical interface configuration mode) ....................................................... 162

Raisecom Technology Co., Ltd.

vii

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Contents

6 Alarm management................................................................................................................... 166


6.1.1 alarm ................................................................................................................................................... 166
6.1.2 alarm active delay ............................................................................................................................... 167
6.1.3 alarm active storage-mode .................................................................................................................. 168
6.1.4 alarm auto-report enable ..................................................................................................................... 169
6.1.5 alarm auto-save ................................................................................................................................... 170
6.1.6 alarm clear ........................................................................................................................................... 171
6.1.7 alarm clear delay ................................................................................................................................. 173
6.1.8 alarm delay enable .............................................................................................................................. 174
6.1.9 alarm inhibit enable ............................................................................................................................. 175
6.1.10 alarm inverse enable.......................................................................................................................... 176
6.1.11 alarm inverse-mode ........................................................................................................................... 177
6.1.12 alarm monitor enable ........................................................................................................................ 179
6.1.13 alarm-trap list-size............................................................................................................................. 180
6.1.14 alarm-trap-disable index ................................................................................................................... 181
6.1.15 show alarm active.............................................................................................................................. 182
6.1.16 show alarm auto-report config .......................................................................................................... 183
6.1.17 show alarm cleared............................................................................................................................ 184
6.1.18 show alarm config ............................................................................................................................. 185
6.1.19 show alarmindex ............................................................................................................................... 187
6.1.20 show alarm inverse config ................................................................................................................ 188
6.1.21 show alarm monitor config ............................................................................................................... 189
6.1.22 show alarm-trap info ......................................................................................................................... 190
6.1.23 show general-alarm ........................................................................................................................... 191

7 Index ............................................................................................................................................ 192

Raisecom Technology Co., Ltd.

viii

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Basic configurations

You can configure and manage the RCMS2903-4E1-4GE through the following
methods:
Log in to the RCMS2903-4E1-4GE through the Console interface and configure it
in global configuration mode or related interface configuration mode.
When the RCMS2903-4E1-4GE, as a remote device, is managed by the Central
Office (CO) device, such as, the OPCOM3500E, the iTN2100, the RC002, and the
RCMS2903-4E1-4GE in master mode, configure the RCMS2903-4E1-4GE in
remote configuration mode and related interface configuration mode.
When the RCMS2903-4E1-4GE is managed through the NView NNM system, you
need to use the device_role master command to configure it to master mode and
switch the fourth Ethernet interface to the SNMP interface, through which the
RCMS2903-4E1-4GE is managed; or use the device_role stand_alone
command to configure the RCMS2903-4E1-4GE to independent mode. In this
case, you can perform in-band management through any GE interface and remote
in-band management by connecting the RCMS2903-4E1-4GE in independent
mode through the PDH interface on the CO device.

1.1 BootROM commands


1.1.1 h
Function
To check all command s in BootROM configuration mode, use this command.

Format
h

Parameter
N/A

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Default conditions
N/A

Command mode
BootROM configuration

User level
N/A

Usage guideline
Scenario
You can use this command to check all commands supported by the BootROM configuration
mode.
Prerequisite
After the RCMS2903-4E1-4GE is started, enter Space when "Press Space to Enter Bootrom
menu......" appears to enter BootROM configuration mode.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to check all commands in BootROM configuration mode.
[Raisecom]: h
?
show this list
h
show this list
i
modify network manage port ip address
s
show network manage interface information
d
delete core file
u
update your system
m
update microcode
r
reboot system
test
test the hardware

The following table lists fields displayed in previous command lines.


Field

Description

Show all commands in BootROM configuration mode.

Show all commands in BootROM configuration mode.

Modify the IP address of the SNMP interface.

Show configurations of the network management interface.


Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Field
d

1 Basic configurations

Description
Delete core files.

Wrong deletion may crash the system, so use this command


with caution.
u

Upgrade the system software.

Upgrade the FPGA file.

Reboot the device.

test

Test the hardware.

Related commands
N/A

1.1.2 i
Function
To modify the IP address of the SNMP interface, use this command.

Format
i

Parameter
N/A

Default conditions
N/A

Command mode
BootROM configuration

User level
N/A

Usage guideline
Scenario
You can use this command to modify the IP address of the SNMP interface in BootROM
configuration mode only. The IP address is used to manage temporary IP addresses of the

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

RCMS2903-4E1-4GE, configure the TFTP client, and download system software from the
TFTP server.
This command cannot modify the IP address of the SNMP interface in user configuration
mode (CLI mode), and the configuration is not saved. Restore default IP address when the
RCMS2903-4E1-4GE is rebooted.
Prerequisite
After the RCMS2903-4E1-4GE is started, enter Space when "Press Space to Enter Bootrom
menu......" appears to enter BootROM configuration mode.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to modify the IP address of the SNMP interface to 192.168.10.1.
[Raisecom]: i
start look up old ip addr...
old ip address:
old ip mask address:
new ip address:
new ip mask address:

192.168.50.31
255.255.255.0
192.168.10.1
255.255.255.0

The following table lists fields displayed in previous command lines.


Field

Description

old ip address

Old IP address

old ip mask address

Ole subnet mask address

new ip address

New IP address

new ip mask address

New subnet mask address

Related commands
N/A

1.1.3 m
Function
To upgrade the Field-Programmable Gate Array (FPGA) file, use this command.

Format
m
Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Parameter
N/A

Default conditions
N/A

Command mode
BootROM configuration

User level
N/A

Usage guideline
Scenario
When there is any bug in the logical design, you need to upgrade the FPGA file after fixing
the bug.
Prerequisite
After the RCMS2903-4E1-4GE is started, enter Space when "Press Space to Enter Bootrom
menu......" appears to enter BootROM configuration mode.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to upgrade the FPGA file.
[Raisecom]: m
config network infor ...
host ip address: 192.168.10.1
usr: 1
passwd: 111111
filename:RCMS2903.pof
start connecting host,please wait...
Do you really want to update bootrom?<Y/N>Y
start updating, please wait some minutes.
begin write...
success

Related commands
N/A
Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.1.4 r
Function
To load the system software and start the RCMS2903-4E1-4GE, use this command.

Format
r

Parameter
N/A

Default conditions
N/A

Command mode
BootROM configuration

User level
N/A

Usage guideline
Scenario
After the configuration in BootROM mode, you can use this command to load the system
software and start the RCMS2903-4E1-4GE.
Prerequisite
After the RCMS2903-4E1-4GE is started, enter Space when "Press Space to Enter Bootrom
menu......" appears to enter BootROM configuration mode.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to start the RCMS2903-4E1-4GE quickly.
[Raisecom]: r
booting...
Raisecom Boot Loader Bootrom version 1.0.5
Raisecom Technology CO.,LTD. .Compiled Aug 6 2013 14:28:20

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Base ethernet Mac address: 00:09:07:04:0e:0e


Press Space to Enter Bootrom menu......
0
show core system file...
1. core:system.z
Uncompress start...
Loading image... 5682320
Uncompress success, device initialize,please wait...
start loading microcode....success.
rcms2903_restore_file not exist.
local: 0, type: 0x2014, bus: 3, reverse support: FALSE
Initializing environment ...... Done.
ROTP version: Version 3.17.25
Product name: RCMS2903-4E1-4GE
Hardware revision: Version A.2
Entering RaisecomOS ......
................Failed to execute:
...Failed to execute: interface

interface ge 4
switchport 4

.Failed to execute:

switchport 6

interface

***********************************************************
*
*
*
Welcome to RaisecomOS.
*
*
*
*
Copyright (c) 2002-2013 Raisecom Company.
*
*
*
***********************************************************
RaisecomOS Version 1.2.7 on RCMS2903-4E1-4GE.

Related commands
N/A

1.1.5 s
Function
To check configurations of the network management interface, use this command.

Format
s

Parameter
N/A

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Default conditions
N/A

Command mode
BootROM configuration

User level
N/A

Usage guideline
Scenario
You can use this command to show configurations of the network management interface.
Prerequisite
After the RCMS2903-4E1-4GE is started, enter Space when "Press Space to Enter Bootrom
menu......" appears to enter BootROM configuration mode.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to show configurations of the network interface.
[Raisecom]: s
motfec (unit number 0):
Flags: (0x68043) UP BROADCAST MULTICAST ARP RUNNING INET_UP
Type: ETHERNET_CSMACD
inet: 192.168.4.28
Broadcast address: 192.168.4.255
Netmask 0xffffff00 Subnetmask 0xffffff00
Ethernet address is 00:0e:5e:00:12:ad
Metric is 0
Maximum Transfer Unit size is 1500
0 octets received
0 octets sent
1 unicast packets received
0 unicast packets sent
8 non-unicast packets received
1 non-unicast packets sent
0 incoming packets discarded
0 outgoing packets discarded
0 incoming errors
0 outgoing errors
3 unknown protos
0 collisions; 0 dropped

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

0 output queue drops

Related commands
N/A

1.1.6 u
Function
To upgrade system files in BootROM configuration mode, use this command.

Format
u

Parameter
N/A

Default conditions
N/A

Command mode
BootROM configuration

User level
N/A

Usage guideline
Scenario
You need to upgrade the system software after the RCMS2903-4E1-4GE is added with new
features or new bugs are fixed. The software can be upgraded in BootROM configuration
mode. The RCMS2903-4E1-4GE supports upgrading system software through FTP.
Prerequisite
After the RCMS2903-4E1-4GE is started, enter Space when "Press Space to Enter Bootrom
menu......" appears to enter BootROM configuration mode.
Follow-up procedure
N/A
Precaution
N/A

Raisecom Technology Co., Ltd.

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Examples
This example shows how to download system software through the serial interface.
[Raisecom]: u
choose mode for updating core file.
----------------------------------1. |
serial
----------------------------------2. |
network
----------------------------------please input mode choose...
1
choose serial baud rate for updating core file.
----------------------------------1. |
9600
----------------------------------2. |
19200
----------------------------------3. |
38400
----------------------------------4. |
57600
----------------------------------5. |
115200
----------------------------------please input baud rate choose...

Download the system software from the FTP server with the IP address of 192.168.18.240.
[Raisecom]: u
choose mode for updating core file.
----------------------------------1. |
serial
----------------------------------2. |
network
----------------------------------please input mode choose...
2
config network infor ...
host ip address: 192.168.18.240
usr: 1
passwd: 111111
filename: RCMS2903.z
starting connect host,please waiting...
Do you want to update image file?<Y/N>y
start update core , please wait some minutes.
..
success.

Raisecom Technology Co., Ltd.

10

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

1.2 Basic commands


1.2.1 clear
Function
To clear all information displayed on the terminal screen, use this command.

Format
clear

Parameter
N/A

Default conditions
N/A

Command mode
Any configuration

Usage guideline
Scenario
When two much information is displayed on the terminal screen and the configuration is
disturbed, use this command to clear information displayed on the terminal screen.
Prerequisite
N/A
Follow-up procedure
After clearing the information, enter new commands from the first line of the terminal screen.
Precaution
This command is only used to clear information displayed on the terminal screen but cannot
be used to clear previous configurations.

Examples
This example shows how to clear information displayed on the terminal screen.
Raisecom# clear

Raisecom Technology Co., Ltd.

11

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

1.2.2 config
Function
To enter global configuration mode, use this command.

Format
config

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
When you configure the RCMS2903-4E1-4GE, use this command to enter global
configuration mode for executing commands in this mode.
Prerequisite
Use the enable command to enter privileged EXEC mode.
Follow-up procedure

After entering global configuration mode, you can use related commands to configure
the RCMS2903-4E1-4GE.

You can enter "?" to view commands supported in global configuration mode.

You can use the list command to view detailed information about commands supported
in global configuration mode.

Precaution
N/A

Examples
This example shows how to enter global configuration mode.
Raisecom> enable
Password:

Raisecom Technology Co., Ltd.

12

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Raisecom# config
Configuration mode, one command input per time. End with CTRL-Z.
Raisecom(config)#

Related commands
N/A

1.2.3 disable
Function
To exit privileged EXEC mode to return to user EXEC mode, use this command.

Format
disable

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
The RCMS2903-4E1-4GE supports using the exit command to return to the upper
configuration mode. However, if use the exit command in privileged EXEC mode, you will
log off the RCMS2903-4E1-4GE. You can use the disabe command in privileged EXEC
mode to return to the upper configuration mode (user EXEC mode).
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to exit privileged EXEC mode to return to user EXEC mode.

Raisecom Technology Co., Ltd.

13

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Raisecom# disable
Raisecom>

Related commands
N/A

1.2.4 enable
Function
To enter privileged EXEC mode, use this command.

Format
enable

Parameter
N/A

Default conditions
The password for all users to enter privileged EXEC mode is raisecom.

Command mode
User EXEC

Usage guideline
Scenario
When you configure the RCMS2903-4E1-4GE, use this command to enter privileged EXEC
mode from user EXEC mode.
Prerequisite
N/A
Follow-up procedure
Input the correct password.
Precaution
N/A

Examples
This example shows how to enter privileged EXEC mode.
Raisecom> enable
Password:
Raisecom#

Raisecom Technology Co., Ltd.

14

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

1.2.5 end
Function
To return to privileged EXEC mode, use this command.

Format
end

Parameter
N/A

Default conditions
N/A

Command mode
Any configuration except privileged EXEC mode and user EXEC

Usage guideline
Scenario
You can use this command to return to privileged EXEC mode after completing
configurations in a specified configuration mode.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to return to privileged EXEC mode from SNMP mode.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)# end
Raisecom#

Raisecom Technology Co., Ltd.

15

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

1.2.6 english
Function
To display the command line descriptions in English, use this command.

Format
english

Parameter
N/A

Default conditions
Descriptions of the command line are displayed in English.

Command mode
Any configuration

Usage guideline
Scenario
You can use this command to display the command line descriptions in English.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to the command line descriptions in English.
Raisecom# english
Set successfully

Related commands
N/A

Raisecom Technology Co., Ltd.

16

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.2.7 exit
Function
To return to the upper configuration mode, use this command.

Format
exit

Parameter
N/A

Default conditions
N/A

Command mode
Any configuration

Usage guideline
Scenario
You can use this command to return to the upper configuration mode after completing
configurations in a specified configuration mode.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
If you use this command in user EXEC or privileged EXEC mode, you will log out.

Examples
This example shows how to return to privileged EXEC mode from global configuration mode.
Raisecom# config
Raisecom(config)# exit
Raisecom#

Related commands
N/A

Raisecom Technology Co., Ltd.

17

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.2.8 help
Function
To display the system help information, use this command.

Format
help

Parameter
N/A

Default conditions
N/A

Command mode
Any configuration

Usage guideline
Scenario
You can use this command to view descriptions of system help.
Two types of help information are provided by the system software:

When you want to obtain all parameters and related descriptions of a specified command,
enter this command followed by a space and a "?". For example, by entering "show ?",
all parameters of the show command are listed.

When you want to obtain all parameters prefixed with certain characters of a specified
command, enter this command followed by related characters and a "?". For example, by
entering "show m?", all parameters starting with "m" of the show command are listed.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to display system help information.
Raisecom# help
RaisecomOS software provides advanced help feature. When you need help,
anytime at the command line please press '?'.

Raisecom Technology Co., Ltd.

18

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

If nothing matches, the help list will be empty and you must backup
until entering a '?' show the available options.
Two styles of help are provided:
1. Full help is available when you are ready to enter a
command argument (e.g. 'show ?') and describes each possible
argument.
2. Partial help is provided when an abbreviated argument is entered
and you want to know what arguments match the input
(e.g. 'show me?'.)

Related commands
N/A

1.2.9 history
Function
To display historical commands, use this command.

Format
history

Parameter
N/A

Default conditions
The last 20 historical commands can be displayed.

Command mode
Any configuration except user EXEC

Usage guideline
Scenario
You can use this command to display historical commands since the current user logs in to the
RCMS2903-4E1-4GE.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A
Raisecom Technology Co., Ltd.

19

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Examples
This example shows how to display the historical commands.
Raisecom# history
enable
config
exit
history

Related commands
N/A

1.2.10 list
Function
To display all commands available for the current configuration mode in a form of list, use
this command.

Format
list

Parameter
N/A

Default conditions
N/A

Command mode
Any configuration

Usage guideline
Scenario
When you configure the RCMS2903-4E1-4GE, use this command to display all commands
available for the current configuration mode if you are not sure of the commands or command
formats.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A
Raisecom Technology Co., Ltd.

20

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Examples
This example shows how to display commands available for privileged EXEC mode.
Raisecom# list
chinese
clear
clear trace message
clock set <0-23> <0-59> <0-59> <2000-2099> <1-12> <1-31>
clock summer-time (enable|disable)
clock summer-time recurring <1-5> ( sun | mon | tue | wed | thu | fri |
sat )
<1-12> <0-23> <0-59> <1-5> ( sun | mon | tue | wed | thu | fri | sat )
<1-12>
<0-23> <0-59> <1-1440>
clock timezone (+|-) <0-11> <0-59>
config terminal
config
debug
device unlock
disable
download (fpga-image|license-dat) (tftp | ftp)
download (system-boot | startup-config| default-startupconfig|bootrom|flashall) (tftp | ftp)
english
erase startup-config
erase startup-config device 0 <1-255>
erase startup-config device 0 <1-255> <1-255>
erase startup-config device 0 <1-255> <1-255> <1-255>
---more--- ('q','Q' to quit; 'ENTER' to next line; other key to
continue)

Related commands
N/A

1.2.11 logout
Function
To log off the RCMS2903-4E1-4GE, use this command.

Format
logout

Parameter
N/A

Default conditions
N/A
Raisecom Technology Co., Ltd.

21

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Command mode
Privileged EXEC

Usage guideline
Scenario
You can use this command to log off the RCMS2903-4E1-4GE after completing
configurations.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Before logging off the RCMS2903-4E1-4GE, use the write command to save configurations.

Examples
This example shows how to log off the RCMS2903-4E1-4GE.
Raisecom# logout
Login:

Related commands
N/A

1.2.12 quit
Function
To log off the RCMS2903-4E1-4GE, use this command.

Format
quit

Parameter
N/A

Default conditions
N/A

Command mode
Any configuration
Raisecom Technology Co., Ltd.

22

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Usage guideline
Scenario
You can use this command to log off the RCMS2903-4E1-4GE after completing
configurations in a specified configuration mode.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to log off the RCMS2903-4E1-4GE in global configuration mode.
Raisecom# config
Raisecom(config)# quit
Login:

Related commands
N/A

1.2.13 reboot
Function
To reboot the RCMS2903-4E1-4GE, use this command.

Format
reboot

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Raisecom Technology Co., Ltd.

23

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Usage guideline
Scenario
Configurations take effect after the RCMS2903-4E1-4GE is rebooted.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution

Service may be interrupted during the reboot.

Use the write command to save the current configuration file before reboot.

Examples
This example shows how to reboot the RCMS2903-4E1-4GE.
Raisecom# reboot
Do you reboot the device?(Y/N)y
Rebooting ...

Related commands
N/A

1.2.14 reset
Function
To reset the RCMS2903-4E1-4GE, use this command.

Format
reset

Parameter
N/A

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Raisecom Technology Co., Ltd.

24

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Usage guideline
Scenario
Use the write command to save current configurations before executing this command since
unsaved configurations will be lost.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
The command cannot be executed when you use the RC002 to remotely configure the
RCMS2903-4E1-4G.

Examples
This example shows how to reset the RCMS2903-4E1-4GE.
Raisecom# config
Raisecom(config)# reset

booting...

Related commands
N/A

1.3 User management


1.3.1 password
Function
To modify the password of the current user, use this command.

Format
password

Parameter
N/A

Default conditions
N/A

Raisecom Technology Co., Ltd.

25

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Command mode
Privileged EXEC

Usage guideline
Scenario
To enhance security of the RCMS2903-4E1-4GE and prevent unauthorized users from
accessing the RCMS2903-4E1-4GE, use this command to modify the login password of the
current user.
Prerequisite
N/A
Follow-up procedure

Input the new password twice.

Use the write command to save configurations.

Precaution

The entered password must be in ciphertext and you have entered the password twice
with consistent spellings. Otherwise, configurations fail.

The new password takes effect when you log in to the RCMS2903-4E1-4GE next time.

Examples
This example shows how to modify the password of the current user.
Raisecom# password
Please input password:
Please input again:
set sucessfully!
please execute "write" to save!

Related commands
show user

1.3.2 save user


Function
To save configurations of added users, use this command.

Format
save user

Parameter
N/A

Raisecom Technology Co., Ltd.

26

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
After configuring the host name, password, and privilege, you need to use this command to
save configurations of added users.
Prerequisite
Use the hostname, user password, and user privilege commands to configure the host name,
password, and privilege respectively.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to save configurations of added users.
Raisecom# save user
Save user information successfully!

Related commands
show user

1.3.3 show terminal


Function
To show information about the terminal user, use this command.

Format
show terminal

Parameter
N/A

Raisecom Technology Co., Ltd.

27

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
N/A

Examples
This example shows how to check information about the terminal user.
Raisecom# show terminal
terminal
state
time-out
user
----------------------------------------------------------console
active
600sec
Not Login
1-telnet
active
600sec
1
2-telnet/ssh
inactive
3-telnet/ssh
inactive
4-telnet/ssh
inactive
5-telnet/ssh
inactive
-

Related commands
N/A

1.3.4 show user


Function
To show all user information, use this command.

Format
show user

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Raisecom Technology Co., Ltd.

28

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Usage guideline
N/A

Examples
This example shows how to how to show user information.
Raisecom# show user
Username
Priority
Server
---------------------------------------------raisecom
admin
Local
aa
limited
Local
1
admin
Local

The following table lists fields displayed in previous command lines.


Field

Description

Username

User name

Priority

Priority of the user

Admin: administrator
Normal: general user
Limited: limited user

Server

Authentication method for users to log in to the RCMS2903-4E14GE


Local: log in to the RCMS2903-4E1-4GE through the local user
name and password.

Related commands
N/A

1.3.5 user password


Function
To add a user and configure the password, use this command. To delete a user, use the no
form of this command.

Format
user username password { no-encryption | md5 } password
no user username

Parameter
Parameter

Description

username

User name, a string of 1 to 16 characters

no-encryption

Non-encryption
Raisecom Technology Co., Ltd.

29

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Parameter

Description

md5

MD5 algorithm encryption mode

password

Password, a string of 1 to 16 characters

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
You can use this command to add a new user and configure the initial password. By default,
the privilege is Administrator.
Prerequisite
N/A
Follow-up procedure
After adding the user, use the save user command to save user information.
You can use the password command to modify the password.
Precaution
The user name is case-insensitive, while the password is case-sensitive.

Examples
This example shows how to add a user with the user name of RCMS2903 and the password of
RCMS2903 (non-encryption).
Raisecom# user RCMS2903 password no-encryption RCMS2903
Set successfully !
please execute "write" to save!

Related commands
show user

1.3.6 user privilege


Function
To modify the user privilege, use this command. To delete the user information, use the no
form of this command.

Raisecom Technology Co., Ltd.

30

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Format
user username privilege { administrant | normal | limited }
no user username

Parameter
Parameter

Description

username

User name, a string of 1 to 16 characters

adminitrant

Administrator, who can check all information about the device,


configure the device, and add or delete a user

normal

General user, who can view all information about the device

limited

Limited user, who can check partial information about the device

Default conditions
The user privilege is administrant, that is, the administrator.

Command mode
Privileged EXEC

Usage guideline
Scenario
You can use this command to modify the user privilege.

adminitrant: show the system-related configurations and commands, and debugging


commands.

normal: show service-related configurations and commands.

limited: show non-debugging commands and basic system commands.

Prerequisite
N/A
Follow-up procedure
After modifying the user privilege, use the save user command to save user information.
Precaution
N/A

Examples
This example shows how to configure the privilege of the user RCMS2903 to limited.
Raisecom# user RCMS2903 privilege limited
Set successfully !
please execute "write" to save!

Raisecom Technology Co., Ltd.

31

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
show user

1.3.7 who
Function
To show the current connected user, use this command.

Format
who

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
You can use this command to check the current connected user. The user with a "*" before it
refers to the one who is configuring the RCMS2903-4E1-4GE.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to show the current connected user.
Raisecom# who
vty[0] connected from console
*vty[1] connected from 192.168.4.250

Raisecom Technology Co., Ltd.

32

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
show terminal

1.4 File management


1.4.1 download
Function
To download system files from the specified FTP/TFTP server, use this command.

Format
download { bootrom | default-startup-config | fpga-image | license-dat | startup-config |
system-boot } { ftp | tftp }

Parameter
Parameter

Description

bootrom

Bootrom file

default-startup-config

Default startup configuration file

fpga-image

FPGA program file

license-dat

License data file

startup-config

Startup configuration file

system-boot

System boot file

ftp

Download files from the FTP server.

tftp

Download files from the TFTP server.

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
When upgrading the system, use this command to save related files to the RCMS2903-4E14GE.
Prerequisite
Raisecom Technology Co., Ltd.

33

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Before upgrading system files, build a FTP/TFTP environment to ensure proper network
connection.
Follow-up procedure
N/A
Precaution

Downloading new system files may cause the RCMS2903-4E1-4GE to fail and interrupt
services. We recommend using the upload command to back up original files before
downloading new files.

The FTP host name and password cannot exceed 16 characters. The file name cannot
exceed 80 characters.

Examples
This example shows how to download the host software RCMS2903-4E1-4GE.z from the
server with the IP address of 192.168.4.250 through the TFTP.
Raisecom# download system-boot tftp
Please input server IP Address
: 192.168.4.250
Please input TFTP port(default 69):
Please input TFTP Server File Name: RCMS2903-4E1-4GE.z
Are you sure[Y/N]:y
Loading, please wait...file length = 5600475
Please select the disk for saving image
1. core:
2. exit
Please input the number:1
Writing to core disk, please wait....................
time = 106 s
Copy file successfully!
Please reboot device!
Raisecom# reboot
Do you reboot the device?(Y/N)y
Now restarting, please wait .......

Related commands
N/A

1.4.2 erase startup-config


Function
To delete the configuration file of the RCMS2903-4E1-4GE, specified slot, or remote device,
use this command.

Format
erase startup-config [ slot slot-id ]
erase startup-config device 0 [ device1-id ] [ device2-id [ device3-id [ device4-id ]
Raisecom Technology Co., Ltd.

34

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Parameter
Parameter

Description

slot slot-id

Slot ID, an integer, ranging from 0 to 15

0: delete the global configuration made before the slot


configuration.
1: delete related configurations of the current slot.
device1-id

ID of the first-hop device, an integer, ranging from 1 to 255

device2-id

ID of the second-hop device, an integer, ranging from 1 to 255

device3-id

ID of the third-hop device, an integer, ranging from 1 to 255

device4-id

ID of the forth-hop device, an integer, ranging from 1 to 255

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
After completing loading and upgrade, you need to delete the configuration file of the
RCMS2903-4E1-4GE, specified slot, or remote device.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Deleting files may cause the RCMS2903-4E1-4GE to fail and interrupt the service.

Examples
This example shows how to delete the initial configuration file.
Raisecom# erase startup-config
Are you sure[Y/N]:y
Erasing startup-config file...
Erase successfully

Related commands
N/A

Raisecom Technology Co., Ltd.

35

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.4.3 show running-config


Function
To show the running configuration, use this command.

Format
show running-config [ slot slot-id ]
show running-config device 0 [ device1-id ] [ device2-id [ device3-id [ device4-id ]

Parameter
Parameter
slot slot-id

Description
Slot ID, an integer, ranging from 0 to 15

0: delete the global configuration made before the slot


configuration.
1: delete related configurations of the current slot.
device1-id

ID of the first-hop device, an integer, ranging from 1 to 255

device2-id

ID of the second-hop device, an integer, ranging from 1 to 255

device3-id

ID of the third-hop device, an integer, ranging from 1 to 255

device4-id

ID of the forth-hop device, an integer, ranging from 1 to 255

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the running configuration.
Raisecom# show running-config
current running configuration :
#System up time: 0 day(s), 3 hour(s), 17 minute(s), 2 second(s)
#System time: 01/01/1970 11:27:02 +08:10
#Software Version: 4.5.5(Compiled Nov 15 2011, 17:27:25)
#Boot times: cold(121) warm(22)
syslog enable
syslog overlay enable
no syslog rate
syslog time-stamp date-time

Raisecom Technology Co., Ltd.

36

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

syslog console warnings


no syslog monitor
snmp-server community public ro
snmp-server community private rw
no alarm-trap-disable
current-alarm storage-mode loop
current-alarm max-size 500
alarm delay disable
alarm delay starting-time 5
alarm delay end-time 5
alarm inhibit enable
alarm auto-report disable index 10505-10529
alarm auto-report enable index 1,1,1,1-2,2-5,21-45,6171,101,111,927,1027,10451047,1051-1055,2815-2819,2823-2825,2901-2903,3001-3009,3301-3313,34013405,3703
-3721,4301,4401-4407,5301-5303,5401,5411-5413,5501-5507,56015655,5701,6001,610
1,6201-6339,10001-10021,10101-10117,10201-10203,10301-10325
alarm auto-report enable index 10401-10407,10501-10503,10531-10537,1060110607,
10701-10729,10801-10811,10901-10949,11001-11007,11011,11015-11021,1105111081,1
1101-11105,11201-11209,11401-11413,11701-11705,12001-12003,12201-12209
alarm monitor enable index 1,1,1,1-2,2-5,21-45,6171,101,111,927,1027,1045-1047
,1051-1055,2815-2819,2823-2825,2901-2903,3001-3009,3301-3313,34013405,3703-372
1,4301,4401-4407,5301-5303,5401,5411-5413,5501-5507,56015655,5701,6001,6101,62
01-6339,10001-10021,10101-10117,10201-10203,10301-10325
alarm monitor enable index 10401-10407,10501-10537,10601-10607,1070110729,1080
1-10811,10901-10949,11001-11007,11011,11015-11021,11051-11081,1110111105,11201
-11209,11401-11413,11701-11705,12001-12003,12201-12209
alarm index 1,1,1,1-2,2-5,21-45,61-71,101,111,927,1027,1045-1047,10511055,2815

Related commands
N/A

1.4.4 show startup-config


Function
To show the startup configuration file, use this command.

Format
show startup-config [ slot slot-id ]
show startup-config device 0 [ device1-id ] [ device2-id [ device3-id [ device4-id ]

Raisecom Technology Co., Ltd.

37

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Parameter
Parameter
slot slot-id

Description
Slot ID, an integer, ranging from 0 to 15

0: delete the global configuration made before the slot


configuration.
1: delete related configurations of the current slot.
device1-id

ID of the first-hop device, an integer, ranging from 1 to 255

device2-id

ID of the second-hop device, an integer, ranging from 1 to 255

device3-id

ID of the third-hop device, an integer, ranging from 1 to 255

device4-id

ID of the forth-hop device, an integer, ranging from 1 to 255

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the startup configuration file.
Raisecom# show startup-config
current start up configuration :
als disable
fault-pass disable
qos disable
qos queue sp
qos queue wrr 1 2 4 8
double-tagging tpid 0x9100
vlan-type tagvlan
qos trust port
qos queue cos-map 1 0,3
qos queue cos-map 2 4,5
qos queue cos-map 3 6,7
qos queue cos-map 4 1,2
vlan-entry-list 1 port-list 1,2,3,5
vlan-entry 1 vid 100
vlan-entry-list 1 active
vlan-entry 2 vid 200
vlan-entry-list 2 active
vlan-entry 3 vid 300
vlan-entry-list 3 active
vlan-entry 4 vid 4
vlan-entry-list 4 suspend

Raisecom Technology Co., Ltd.

38

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

vlan-entry 5 vid 5
vlan-entry-list 5 suspend
vlan-entry 6 vid 6
vlan-entry-list 6 suspend
vlan-entry 7 vid 7
vlan-entry-list 7 suspend
vlan-entry 8 vid 8

Related commands
N/A

1.4.5 upload
Function
To upload the system file to a specified FTP/TFTP server, use this command.

Format
upload { default-startup-config | fpga-image | startup-config | system-boot } { ftp | tftp }

Parameter
Parameter

Description

default-startup-config

Default startup configuration file

fpga-image

FPGA program file

startup-config

Startup configuration file

system-boot

System boot file

ftp

Download files from the FTP server.

tftp

Download files from the TFTP server.

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
Scenario
Before upgrading the system software, you need to back up the original software to restore the
system when the upgrade fails. Use this command to back up related files to the server.
Prerequisite
Raisecom Technology Co., Ltd.

39

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Before backing up system files, build a FTP/TFTP environment to ensure proper network
connection.
Follow-up procedure
N/A
Precaution
The FTP host name and password cannot exceed 16 characters. The file name cannot exceed
80 characters.

Examples
This example shows how to upload the host software RCMS2903-4E1-4GE.z to the server
with the IP address of 192.168.4.250 through the FTP. Both the host name and password are
test.
Raisecom# upload system-boot ftp
Please input server IP Address:192.168.4.250
Please input FTP User name:test
Please input FTP Password:test
Please input FTP Server File Name: RCMS2903-4E1-4GE.z
Are you sure[Y/N]:y
Please select the file for uploading image
1. core:system.z
2. exit
Please input the number:1

Related commands
N/A

1.4.6 write
Function
To write the current configurations into the memory of the RCMS2903-4E1-4GE, use this
command.

Format
write

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC
Raisecom Technology Co., Ltd.

40

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Usage guideline
Scenario
After configurations, you need to save them to the RCMS2903-4E1-4GE to override the
original ones. After the RCMS2903-4E1-4GE is rebooted, the new configurations can take
effect. If the new configurations are not saved to the RCMS2903-4E1-4GE, when rebooted,
the RCMS2903-4E1-4GE will continue to execute original configurations.
Prerequisite
N/A
Follow-up procedure
Use the reboot command to reboot the RCMS2903-4E1-4GE so that new configurations can
take effect.
Precaution
After configurations, use this command to save them so that the new configuration can take
effect.

Examples
This example shows how to save the current configuration.
Raisecom# write
Are you sure[Y/N]:y
Please wait..
Save current configuration successfully!

Related commands
N/A

1.5 Time management


1.5.1 clock set
Function
To configure the system time, use this command.

Format
clock set hour minute second year month day

Parameter
Parameter
hour

Description
Hour, an integer, ranging from 0 to 23

Raisecom Technology Co., Ltd.

41

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Parameter

Description

minute

Minute, an integer, ranging from 0 to 59

second

Second, an integer, ranging from 0 to 59

year

Year, an integer, ranging from 2000 to 2099

month

Month, an integer, ranging from 1 to 12

day

Day, an integer, ranging from 1 to 31

Default conditions
The system time is 01/01/1970 08:00:00.

Command mode
Privileged EXEC/Global configuration

Usage guideline
Scenario
To configure the system time for the RCMS2903-4E1-4GE, use this command.
Configurations will not be lost even though the RCMS2903-4E1-4GE is powered off or
rebooted.
Prerequisite
N/A
Follow-up procedure
Use the write command to save configurations of the current system time.
Precaution
N/A

Examples
This example shows how to modify the system time to 10/30/2013 08:30:00.
Raisecom# clock set 8 30 0 2013 10 30
System time changed successfully
Current system time: 09/30/2003 08:30:00 +08:00

Related commands
show clock

Raisecom Technology Co., Ltd.

42

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.5.2 clock summer-time enable


Function
To enable Daylight Saving Time (DST), use this command. To disable DST, use the disable
form of this command.

Format
clock summer-time { enable | disable }

Parameter
Parameter

Description

enable

Enable DST.

disable

Disable DST.

Default conditions
DST is disabled.

Command mode
Privileged EXEC/Global configuration

Usage guideline
Scenario
DST is a convention established by people for saving resources. It is earlier in summer than in
winter at sunrise. To reduce evening usage of incandescent lighting and save energy, clocks
are adjusted forward an hour.
Prerequisite
N/A
Follow-up procedure
You can use the clock summer-time recurring command to configure related parameters of
DST.
Precaution
When DST is enabled, all synchronized time obtained through SNTP will be translated into
local DST.

Examples
This example shows how to enable DST.
Raisecom# clock summer-time enable
Set successfully

Raisecom Technology Co., Ltd.

43

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
show clock

1.5.3 clock summer-time recurring


Function
To configure the start time, end time and time offset of DST, use this command.

Format
clock summer-time recurring start-week { sun | mon | tue | wed | thu | fri | sat } startmonth start-hour start-minute end-week { sun | mon | tue | wed | thu | fri | sat } end-month
end-hour end-minute offset-mm

Parameter
Parameter
start-week

Description
Week when DST begins, an integer, ranging from 1 to 5

5 refers that DST begins from the last week of a month.


sun

DST begins in the last week a month.

mon

DST begins on Sunday of a week.

tue

DST begins on Monday of a week.

wed

DST begins on Tuesday of a week.

thu

DST begins on Wednesday of a week.

fri

DST begins on Thursday of a week.

sat

DST begins on Friday of a week.

start-month

Month when DST begins, an integer, ranging from 1 to 12

start-hour

Hour when DST begins, an integer, ranging from 0 to 23

start-minute

Minute when DST begins, an integer, ranging from 0 to 59

end-week

Week when DST ends, an integer, ranging from 1 to 5

5 refers that DST ends at the last week of a month.


end-month

Month when DST ends, an integer, ranging from 1 to 12

end-hour

Hour when DST ends, an integer, ranging from 0 to 23

end-minute

Minute when DST ends, an integer, ranging from 0 to 59

Raisecom Technology Co., Ltd.

44

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Parameter
offset-min

1 Basic configurations

Description
Time offset of DST, an integer, ranging from 1 to 1440, in unit of
minute

Default conditions
N/A

Command mode
Global configuration

Usage guideline
Scenario
After DST is enabled, the system time will be adjusted forward according to the configured
time offset when DST begins. When DST ends, the system time will automatically returns to
the Coordinated Universal Time (UTC).
Prerequisite
Use the clock summer-time enable command to enable DST.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure DST to begin at 02:00 am, the second Sunday of April,
and end at 02:00 am, the second Sunday of September. During this period, the clock is
adjusted forward an hour, that is the time offset is 60min.
Raisecom# clock summer-time recurring 2 sun 4 2 0 2 sun 9 2 0 60
Set successfully

Related commands
show clock

1.5.4 clock timezone


Function
To configure the time zone of the system time, use this command.

Format
clock timezone { + | - } hour minute
Raisecom Technology Co., Ltd.

45

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Parameter
Parameter

Description

Time zones in the Eastern Hemisphere

Time zones in the Western Hemisphere

hour

Time zone offset hour, an integer, ranging from 0 to 11.

minute

Time zone offset minute, an integer, ranging from 0 to 59.

Default conditions
The system time is GMT + 8:00.

Command mode
Global configuration

Usage guideline
Scenario
To configure the time zone of the system time, use this command. The time offset of both the
Eastern and Western Hemispheres is based on the Greenwich Mean Time (GMT).
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the system time being in the time zone of Western
Hemisphere and how to set the time offset to 05:40:00.
Raisecom# config
Raisecom(config)# clock timezone - 5 40
Set Successfully

Related commands
show clock

1.5.5 show clock


Function
To display information about the system time, use this command.
Raisecom Technology Co., Ltd.

46

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Format
show clock [ summer-time-recurring ]

Parameter
Parameter
summer-time-recurring

Description
Show configurations about DST.

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to check the current system time.
Raisecom# show clock
Current system time: 10/30/2013 08:30:04 +08:00

This example shows how to show DST configurations.


Raisecom#show clock summer-time-recurring
Current system time: 10/30/2013 08:30:20 +08:00
Summer
Summer
Summer
Summer

time
time
time
time

recurring: Enable
start: week 1 Sunday January 00 00
end: week 1 Sunday January 00 00
Offset: 0 min

The following table lists fields displayed in previous command lines.


Field

Description

Current system time

Current system time

Summer time recurring

Enable/Disable DST.

Summer time start

Starting time of DST

Summer time end

End time of DST

Summer time Offset

DST offset

Related commands
N/A
Raisecom Technology Co., Ltd.

47

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.6 Debugging management


1.6.1 assert-dest
Function
To configure the output destination for assertion debug information, use this command. To
delete the configuration, use the no form of this command.

Format
assert-dest { file | serial }
no assert-dest { file | serial }

Parameter
Parameter

Description

file

Output assertion debug information to the file.

serial

Output assertion debug information to the serial interface.

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
Scenario
You can use this command to configure the output destination for assertion debug information.
Assertion debug information can be output to the file or the serial interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to output assertion debug information to the file.
Raisecom# assert-dest file

Raisecom Technology Co., Ltd.

48

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Raisecom#

Related commands
show assert-dest

1.6.2 clear trace message


Function
To clear the trace message, use this command.

Format
clear trace message

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
Scenario
You can use this command to clear the trace message about outputting to the file, memory, or
serial interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to clear the trace message.
Raisecom# config
Raisecom(config)# clear trace message
0 trace messages cleared

Raisecom Technology Co., Ltd.

49

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

1.6.3 ping
Function
To test the network connectivity, use this command.

Format
ping ip-address [ count count ] [ size size ] [ timeout time ]

Parameter
Parameter

Description

ip-address

Destination IP address, in dotted-decimal notation, such as


10.10.10.1

count count

Specify the number of detection packets for exiting Ping program.


count refers to the number of detection packets. It is an integer
ranging from 1 to 65535.

size size

Specify the size of the detection packet.


size refers to the size of the detection packet. It is an integer ranging
from 0 to 4076 Bytes.

timeout time

Specify the wait time for Ping program. If no response is received


when the wait time expires, it is believed the destination is
unreachable.
time refers to the timeout period. It is an integer ranging from 1 to
255s.

Default conditions
The number of Ping detection packets is set to 4. The size of a Ping detection packet is set to
64B.

Command mode
Privileged EXEC/Global configuration

Usage guideline
Scenario
The Ping program is used to test the connectivity between the source address and the
destination address. The local device sends an ICMP echo-request packet to the destination
address. It the network connectivity is normal, the destination host sends an ICMP echo-reply
packet to the source host. If the source host does not receive the ICMP echo-reply packet sent

Raisecom Technology Co., Ltd.

50

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

by the destination host with in the timeout period, it is believed the network connectivity is
abnormal.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to Ping through a host with the IP address of 192.168.4.250 to
verify network connection.
Raisecom# config
Raisecom(config)# ping 192.168.4.250
(Press CTRL+C break)PING 192.168.4.250 (84=20+8+56 bytes)
64 bytes from 192.168.4.250: icmp_seq=0. time=0. ms
64 bytes from 192.168.4.250: icmp_seq=1. time=0. ms
64 bytes from 192.168.4.250: icmp_seq=2. time=0. ms
64 bytes from 192.168.4.250: icmp_seq=3. time=0. ms
----192.168.4.250 PING Statistics---4 packets transmitted, 4 packets received, 0% packet loss
round-trip (ms) min/avg/max = 0/0/0

Related commands
N/A

1.6.4 show assert-dest


Function
To show the output destination of assertion debug information, use this command.

Format
show assert-dest

Parameter
N/A

Default conditions
N/A

Raisecom Technology Co., Ltd.

51

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the current output destination of assertion debug
information.
Raisecom# show assert-dest
assert destination: SF-

Related commands
N/A

1.6.5 show trace-dest


Function
To show the trace message, use this command.

Format
show trace-dest

Parameter
N/A

Default conditions
N/A

Command mode
User EXEC/Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the trace message.
Raisecom# show trace-dest
trace destination: S--

Raisecom Technology Co., Ltd.

52

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

1.6.6 show trace message


Function
To show the trace message, use this command.

Format
show trace message

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the trace message.
Raisecom# show trace message
Totally 0 message traced out.

Related commands
N/A

1.6.7 trace-dest
Function
Configure the output destination for Trace debug information, use this command. To restore
default configurations, use the no form of this command.

Format
trace-dest { file | memory | serial }

Raisecom Technology Co., Ltd.

53

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

no trace-dest { file | memory | serial }

Parameter
Parameter

Description

file

Output Trace debug information to the file.

memory

Output Trace debug information to the memory.

serial

Output Trace debug information to the serial interface.

Default conditions
Output Trace debug information to the serial interface.

Command mode
User EXEC

Usage guideline
Scenario
You can use this command to configure the output destination for Trace debug information.
Trace debug information can be output to the file, memory, or serial interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to output Trace debug information to the file.
Raisecom> trace-dest file
Raisecom>

Related commands
show trace-dest

Raisecom Technology Co., Ltd.

54

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.7 Device management


1.7.1 clear statistic
Function
To clear all statistics on the RCMS2903-4E1-4GE, use this command.

Format
clear statistic

Parameter
N/A

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to clear all statistics on the RCMS2903-4E1-4GE, including the
GE electrical interface, GF optical interface, and E1 interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Cleared statistics cannot be restored.

Examples
This example shows how to all statistics.
Raisecom# config
Raisecom(config)# clear statistic
Set successfully

Related commands
N/A

Raisecom Technology Co., Ltd.

55

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.7.2 device_role
Function
To configure the working mode for the RCMS2903-4E1-4GE, use this command.

Format
device_role { master | slave | stand_alone}

Parameter
Parameter

Description

master

Master mode

slave

Slave mode

stand_alone

Independent mode

Default conditions
The RCMS2903-4E1-4GE works in slave mode.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to configure the RCMS2903-4E1-4GE to master mode, slave
mode, or independent mode.

Master mode: the fourth GE interface is configured as the SNMP interface to realize outof-band management. The SNMP interface serves as the management interface only and
cannot transmit service data.

Slave mode: the RCMS2903-4E1-4GE in slave mode can be connected uplink to the
RCMS2903-4E1-4GE in master mode, the iTN2100, and the OPCOM3500E to realize
network element management.

Independent mode: the RCMS2903-4E1-4GE in independent mode can perform in-band


network management on the RCMS2903-4E1-4GE which serves as the Central Office
(CO) device through any GE interface. Moreover, it can connect the remote RCMS29034E1-4GE in independent mode through the PDH optical interface on the CO device to
realize in-band network management of the remote device.

Prerequisite
N/A
Follow-up procedure
The configured working mode takes effect after the RCMS2903-4E1-4GE is rebooted.

Raisecom Technology Co., Ltd.

56

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Precaution
N/A

Examples
This example shows how to configure the RCMS2903-4E1-4GE to master mode.
Raisecom# config
Raisecom(config)# device_role master
Set successfully

Related commands
show info

1.7.3 hostname
Function
To modify the host name, use this command. To restore default configurations, use the no
form of this command.

Format
hostname hostname
no hostname

Parameter
Parameter

Description

hostname

Host name, a string of characters, ranging from 1 to 16

Default conditions
The host name is raisecom.

Command mode
Privileged EXEC

Usage guideline
Scenario
You can use this command to modify the host name. The host name is used to identify
different devices when you configure or maintain the device.
Prerequisite
N/A
Follow-up procedure
Raisecom Technology Co., Ltd.

57

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

N/A
Precaution
N/A

Examples
This example shows how to modify the host name to RCMS2903.
Raisecom# hostname RCMS2903
set successfully
RCMS2903#

Related commands
N/A

1.7.4 remote
Function
To enter remote configuration mode, use this command.

Format
Remote 0 device1-id [ device2-id [ device3-id [ device4-id ] ] ]

Parameter
Parameter

Description

device1-id

ID of the first-hop device, an integer, ranging from 1 to 255

device2-id

ID of the second-hop device, an integer, ranging from 1 to 255

device3-id

ID of the third-hop device, an integer, ranging from 1 to 255

device4-id

ID of the forth-hop device, an integer, ranging from 1 to 255

Default conditions
N/A

Command mode
Global configuration/Switching interface configuration

Usage guideline
Scenario
You can use this command to enter remote configuration mode. The RCMS2903-4E1-4GE
supports up to four hops of remote devices.

Raisecom Technology Co., Ltd.

58

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enter remote configure mode of the first-hop device.
Raisecom# config
Raisecom(config)# remote 0 193
Raisecom(config-remote/0/193)#

Related commands
show device

1.7.5 restore-default-configuration
Function
To restore default configurations, use this command.

Format
restore-default-configuration

Parameter
N/A

Default conditions
N/A

Command mode
Global configuration

Usage guideline
Scenario
You can use this command to restore default configurations. The RCMS2903-4E1-4GE will
be rebooted after you execute this command.
Prerequisite
N/A
Raisecom Technology Co., Ltd.

59

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Follow-up procedure
N/A
Precaution
Previously saved configurations will be lost after you execute this command.

Examples
This example shows how to restore the RCMS2903-4E1-4GE to default configurations.
Raisecom# config
Raisecom(config)# restore-default-configuration

booting...

Related commands
N/A

1.7.6 show device


Function
To show configurations of the remote device, use this command.

Format
show device [ verbose ]

Parameter
Parameter
verbose

Description
Show configurations of the remote device.

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show configurations of the remote device.

Raisecom Technology Co., Ltd.

60

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Raisecom# config
Raisecom(config)# show device
3->2203:0:1 itn-123-4fe state=working, cookie=0x0, flag=0x0
00 active itn123
3->0:0:1 itn-123-4fe working <==> 3->0:0:2 ?devt?
null
1 device(s) found

Related commands
N/A

1.7.7 show info


Function
To show information about the RCMS2903-4E1-4GE, use this command.

Format
show info

Parameter
N/A

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
N/A

Examples
This example shows how to show configurations and status of the RCMS2903-4E1-4GE.
Raisecom# config
Raisecom(config)# show info
Slot 0 is rcms2903-4e1-4ge
Device version: PCB:A.2-Software:1.2.5-FPGA:1.7
Device role: master
Management Mode: mode-1
Remote Power Alarm status : no alarm
Optical ALS config : disable
Optical ALS status : disable
e1tributary lost alarm : unmask
VLAN type config: tag VLAN

Raisecom Technology Co., Ltd.

61

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

VLAN type status: tag VLAN


double-tagging tpid config: 0x9100
double-tagging tpid status: 0x9100
QoS enable config: disable
QoS enable status: disable
queues policy config: strict priority
queues policy status: strict priority
queue No. 1, weight config = 1
queue No. 2, weight config = 2
queue No. 3, weight config = 4
queue No. 4, weight config = 8
queue No. 1, weight status = 1
queue No. 2, weight status = 2
queue No. 3, weight status = 4
queue No. 4, weight status = 8
QoS policy config: port based
QoS policy status: port based
MAC address learning enable config: enable
MAC address aging time config: 300s
fault pass enable config: disable
fault pass enable status: disable
E1 interface number: 4
E1 loopback status:
E1-1 no loopback
E1-2 no loopback
E1-3 no loopback
E1-4 no loopback

The following table lists fields displayed in previous command lines.


Field

Description

Device version

Device version

Device role

Working mode

Management Mode

Network management mode

Remote Power Alarm status

Remote Dying-Gasp alarm

Optical ALS config

ALS configurations on the optical interface

Optical ALS status

ALS status on the optical interface

e1tributary lost alarm

Alarm masking for E1 idle tributary

mask: alarm masking is enabled.


unmask: alarm masking is disabled.

VLAN type config

VLAN type configuration

VLAN type status

VLAN type status

double-tagging tpid config

TPID configuration of outer Tag

double-tagging tpid status

TPID status of outer Tag

QoS enable config

QoS configuration

QoS enable status

QoS status
Raisecom Technology Co., Ltd.

62

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Field

Description

queues policy config

Queue scheduling configuration

queues policy status

Queue scheduling status

queue No

Queue No.

weight config

Weight configuration

weight status

Weight status

QoS policy config

QoS priority trust configuration

QoS policy status

QoS priority trust status

MAC address learning enable config

MAC address learning configuration

MAC address aging time config

MAC address aging time configuration

fault pass enable config

Failover configuration

fault pass enable status

Failover status

E1 interface number

E1 interface number

E1 loopback status

E1 loopback status

Related commands
N/A

1.7.8 show interface (remote/global configuration mode)


Function
To show the status of a specified interface, use this command.

Format
show interface interface-type interface-number

Parameter
Parameter

Description

interface-type

Interface type

interface-number

Interface number, an integer, varying in the range on different


interfaces

Default conditions
N/A

Raisecom Technology Co., Ltd.

63

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Command mode
Remote configuration/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the status of PDH optical interface 1.
Raisecom# config
Raisecom(config)# show interface pdh-opt 1
Interface ID : 1
Optical port 1 description: SLOT0-PDH1
Optical module 1 type: SFP
Optical port 1 enable: enable
Optical port 1 Alarm status:
LOS - OFF
LOF - OFF
E-3 - OFF
E-6 - OFF
R-LOS OFF

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

Optical port 1 description

Description of optical interface 1

Optical module 1 type

Type of optical module 1

Optical port 1 enable

Enable optical interface 1.

Optical port 1 Alarm status

Alarm status of optical interface 1

LOS

Loss of signal alarm

LOF

Loss of frame alarm

E-3

Error rate exceeding 1e-3 alarm

E-6

Error rate exceeding 1e-6 alarm

R-LOS

Loss of signal on remote device alarm

R-LOF

Loss of frame on remote device alarm

Remote power down alarm

Remote Dying-Gasp alarm

Related commands
N/A

Raisecom Technology Co., Ltd.

64

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.7.9 show manufacture info


Function
To show manufacture information about the RCMS2903-4E1-4GE, use this command.

Format
show manufacture info [ all ]
show manufacture info remote 0 device1-id [ device2-id ] [ device3-id ] [ device4-id ]

Parameter
Parameter

Description

all

Show manufacture information about all devices.

device1-id

ID of the first-hop device, an integer, ranging from 1 to 255

device2-id

ID of the second-hop device, an integer, ranging from 1 to 255

device3-id

ID of the third-hop device, an integer, ranging from 1 to 255

device4-id

ID of the forth-hop device, an integer, ranging from 1 to 255

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
N/A

Examples
This example shows how to show manufacture information about all devices.
Raisecom# show manufacture info all
The product manufacture information:
Vendor: raisecom
Product Name: 2903
Hardware Ver: a.0
Serial No.: 123123123123s12345g1234r
MAC Address: 00:0e:5e:00:12:ad

The following table lists fields displayed in previous command lines.


Field
The product manufacture information

Description
Manufacture information

Raisecom Technology Co., Ltd.

65

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Field

Description

Vendor

Vendor

Product Name

Device module

Serial No.

Serial number

MAC Address

MAC address

Related commands
N/A

1.7.10 show rotp-cpu-utilization-ratio


Function
To show the current CPU utilization ratio, use this command.

Format
show rotp-cpu-utilization-ratio

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
N/A

Examples
This example shows how to show the current CPU utilization ratio.
Raisecom# show rotp-cpu-utilization-ratio
cpu utilization-ratio is 2%

Related commands
N/A

Raisecom Technology Co., Ltd.

66

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

1.7.11 show sys-up-time


Function
To show the system uptime, use this command.

Format
show sys-up-time

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
N/A

Examples
This example shows how to show the system uptime.
Raisecom# show sys-up-time
System had been running for
0 day(s), 5 hour(s), 45 minute(s), 4 second(s)

Related commands
N/A

1.7.12 show this


Function
To show operation information about the current node, use this command.

Format
show this

Parameter
N/A

Raisecom Technology Co., Ltd.

67

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
When you use the RC002 to remotely manage the RCMS2903-4E1-4G, this command is not
supported.

Examples
This example shows how to show operation information about the current node.
Raisecom# config
Raisecom(config)# show this
current running configuration of this node:
qos disable
qos queue sp
qos queue wrr 1 2 4 8
double-tagging tpid 0x9100
vlan-type novlan
qos trust port
qos queue cos-map 1 1,2
qos queue cos-map 2 0,3
qos queue cos-map 3 4,5
qos queue cos-map 4 6,7
vlan-entry-list 1 port-list 1,2,3,4,5
vlan-entry 1 vid 1
vlan-entry-list 1 active
vlan-entry-list 2 port-list 1
vlan-entry 2 vid 2
vlan-entry-list 2 suspend
vlan-entry 3 vid 3
vlan-entry-list 3 suspend

vlan-entry 60 vid 60
vlan-entry-list 60 suspend
vlan-entry 61 vid 61
vlan-entry-list 61 suspend
vlan-entry 62 vid 62
vlan-entry-list 62 suspend
vlan-entry 63 vid 63
vlan-entry-list 63 suspend
vlan-entry 64 vid 64
vlan-entry-list 64 suspend
als enable
fault-pass disable
!post-config commands:
exit
clock timezone + 8 0

Raisecom Technology Co., Ltd.

68

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

The following table lists fields displayed in previous command lines.


Field

Description

qos

QoS function

qos queue

QoS queue scheduling

qos queue wrr

QoS queue weight

double-tagging tpid

TPID of outer Tag

vlan-type

VLAN type

qos trust

QoS priority trust

qos queue cos-map

Mapping relationship between QoS queue and CoS priority

vlan-entry-list * port-list

Interface list of VLAN list

vlan-entry * vid

VLAN ID of VLAN list

vlan-entry-list *

VLAN lists status: active and suspend

clock timezone

Time zone

Related commands
N/A

1.7.13 show version


Function
To show version information about the RCMS2903-4E1-4G, use this command.

Format
show version

Parameter
N/A

Default conditions
N/A

Command mode
Remote configuration/Privileged EXEC

Usage guideline
Scenario

Raisecom Technology Co., Ltd.

69

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

You can use this command to show version information about the RCMS2903-4E1-4G.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
When you use the RC002 to remotely manage the RCMS2903-4E1-4G, this command is not
supported.

Examples
This example shows how to show version information about the RCMS2903-4E1-4G.
Raisecom> enable
Password:
Raisecom# show version
Product name: RCMS2903-4E1-4GE
Bootrom Version 1.0.5
RaisecomOS ROTP Version 3.17.25
Software Version 1.2.7(Compiled Sep 9 2013, 10:21:11)
Hardware Version A.2
Firmware 1 Type FPGA Version 2.1(Compiled )
RCMS2903-4E1-4GE with
32M
bytes DRAM
8M
bytes Flash Memory

The following table lists fields displayed in previous command lines.


Field

Description

Product name

Device name

Bootrom Version

Bootrom version

RaisecomOS ROTP Version

ROTP version

Software Version

Software version

Hardware Version

Hardware version

Firmware Version

Firmware version

Related commands
N/A

1.7.14 sync-configuration
Function
To synchronize remote configurations made through different modes, use this command.

Raisecom Technology Co., Ltd.

70

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Format
sync-configuration

Parameter
N/A

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
The remote device can be configured through the Console interface. Moreover, it can be
configured through the uplink CO device in remote configuration mode or through the NView
NNM system.
If the remote device is configured through different modes, configurations and status may be
inconsistent with each other. So you need to use this command to synchronize configurations
on the remote device before configuration.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
This command can be used only in remote configuration mode.

Examples
This example shows how to synchronize configurations on the RCMS2903-4E1-4GE when it
is managed by the OPCOM3500E.
Raisecom# config
Raisecom(config)# remote 1 2
Raisecom(config-remote/1/2)# sync-configuration
Set successfully

This example shows how to synchronize configurations on the RCMS2903-4E1-4GE when it


is managed by the RC002.
Raisecom# config
Raisecom(config)# remote 2 2
Raisecom(config-rcms2903-4e1-4ge/2/1)# sync-configuration
Set successfully

Raisecom Technology Co., Ltd.

71

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

1 Basic configurations

Related commands
N/A

Raisecom Technology Co., Ltd.

72

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

2 System management

System management

2.1.1 als enable


Function
To enable Automatic Laser Shutdown (ALS) on the PDH optical interface, use this command.
To disable this function, use the disable form of this command.

Format
als { enable | disable }

Parameter
Parameter

Description

enable

Enable ALS.

disable

Disable ALS.

Default conditions
ALS is disabled on the PDH optical interface.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
After configuring ALS, you can effectively protect the performance of the optical interface.
Moreover, when the maintenance personnel remove the fiber out, the laser will be stopped if
ALS is enabled. Thus, it can avoid eye damage. And the service will be automatically
recovered when the fiber is plugged in.
Prerequisite
N/A
Raisecom Technology Co., Ltd.

73

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

2 System management

Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to how to enable ALS on the optical interface.
Raisecom# config
Raisecom(config)# als enable
Set successfully

Related commands
show info

2.1.2 e1tributary-lost-alarm
Function
To configure alarm masking for E1 idle tributary, use this command.

Format
e1tributary-lost-alarm { mask | unmask }

Parameter
Parameter

Description

mask

Alarm masking is enabled.

unmask

Alarm masking is disabled.

Default conditions
Alarm masking for E1 idle tributary is disabled.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to configure whether to enable alarm masking for E1 idle tributary
or not. After alarm masking is enabled on E1 idle tributary, the alarm will not be reported to
the NView NNM system when it occurs on E1 idle tributary.
Prerequisite
Raisecom Technology Co., Ltd.

74

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

2 System management

N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to mask alarms on E1 idle tributary.
Raisecom# config
Raisecom(config)# e1tributary-lost-alarm mask
Set successfully

Related commands
show info

2.1.3 fault-pass enable


Function
To configure failover from the local optical interface and remote electrical interface to the
local electrical interface, use this command. Use the disable form of this command to disable
this function.

Format
fault-pass { enable | disable }

Parameter
Parameter

Description

enable

Enable failover.

disable

Disable failover.

Default conditions
Failover is disabled.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario

Raisecom Technology Co., Ltd.

75

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

2 System management

Failover from the optical interface to the Ethernet electrical interface refers to shutting down
the Ethernet electrical interface when Loss of Signal (LOS) and Loss of Frame (LOF) alarms
are generated on the local or remote optical interface, until the optical interface recovers in
both ingress and egress directions.
Failover from the Ethernet electrical interface to the electrical interface refers to shutting
down the local Ethernet electrical interface when status of all remote Ethernet electrical
interfaces is changed to Link down from Link up, until at least one remote Ethernet interface
recovers to Link up.
Failover from the optical interface to electrical interface and from electrical interface to
electrical interface is enabled or disabled at the same time. You can use this command to
enable or disable failover.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable failover.
Raisecom# config
Raisecom(config)# fault-pass enable
Set successfully

Related commands
show info

2.1.4 ip route
Function
To enable static routing, use this command. Use the no form of this command to delete the
configuration.

Format
ip route ip-address ip-mask ip-gate
no ip route ip-address ip-mask

Parameter
Parameter
ip-address

Description
IP address of the destination network subnet or host, in dotted decimal
notation, such as 10.10.10.1
Raisecom Technology Co., Ltd.

76

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Parameter

2 System management

Description

ip-mask

Subnet mask of IP address of the destination network subnet or host, in


dotted decimal notation, such as 255.255.255.0

ip-gate

IP address of the gateway, in dotted decimal notation, such as 10.10.10.1

Default conditions
N/A

Command mode
Global configuration

Usage guideline
Scenario
When the network structure is simple, you can create static routing manually to realize
communication between devices.
The static routing is not influenced by changes of the network topology. When the network
topology changes, static routing remains the same.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
When you configure the default route, both the first two parameters are 0.0.0.0.

Examples
This example shows how to configure the default route.
Raisecom# config
Raisecom(config)# ip route 0.0.0.0 0.0.0.0 192.168.27.254
Successfully add a route

Related commands
show ip route

2.1.5 show ip route


Function
To show information about the routing table, use this command.

Raisecom Technology Co., Ltd.

77

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

2 System management

Format
show ip route

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show information about the routing table.
Raisecom# config
Raisecom(config)# show ip route
Total Count:11
ROUTE NET TABLE
destination
gateway
flags(0x)Rfc Use
pro Interface
------------------------------------------------------------------------127.0.0.0/8
127.0.0.3
2000101 0
0
2 sw4
127.0.0.0/8
127.0.0.2
101 0
0
2 sw0
127.0.0.0/8
127.0.0.2
10101 0
0
8 sw0
127.0.0.0/24
127.0.0.1
2000101 0
0
2 mirror0
127.0.0.0/24
127.0.0.1
10001 0
0
8 lo0
172.31.0.0/16
172.31.0.1
2000101 0
0
2 motfek1
172.31.0.0/16
172.31.0.1
10101 0
0
8 motfek1
192.168.4.0/24
192.168.27.85
2010003 0
0
8 motfec0
192.168.27.0/24
192.168.27.88
2000101 4
0
2 motfec0
192.168.27.0/24
192.168.27.88
10101 0
0
8 motfec0
------------------------------------------------------------------------ROUTE HOST TABLE
destination
gateway
flags(0x)Rfc Use
pro Interface
------------------------------------------------------------------------127.0.0.1
127.0.0.1
2200005 0
0
2 lo0
-------------------------------------------------------------------------

Related commands
N/A

Raisecom Technology Co., Ltd.

78

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Network management

3.1.1 autonegotiate (SNMP interface configuration mode)


Function
To configure auto-negotiation on the SNMP interface, use this command.

Format
autonegotiate
no autonegotiate

Parameter
N/A

Default conditions
Auto-negotiation is enabled.

Command mode
SNMP interface configuration

Usage guideline
Scenario
Auto-negotiation is an Ethernet procedure by which two connected devices choose identical
transmission parameters, such as duplex mode (full duplex or half duplex) and rate (10 Mbit/s
or 100 Mbit/s). Once negotiated, these two devices can transmit data with the same duplex
mode and rate.
Prerequisite
N/A
Follow-up procedure

Raisecom Technology Co., Ltd.

79

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

N/A
Precaution
N/A

Examples
This example shows how to configure auto-negotiation on the SNMP interface.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)# autonegotiate
Set successfully

Related commands
show interface snmp

3.1.2 arp add


Function
To configure static Address Resolution Protocol (ARP) mapping from the IP address to the
MAC address, use this command. To delete the static ARP mapping, use the delete form of
this command.

Format
arp add ip-address mac-address
arp delete ip-address

Parameter
Parameter

Description

ip-address

IP address of the interface, in dotted decimal notation, such as 10.10.10.1

mac-address

MAC address mapped to the physical interface by the IP address, in


colon hexadecimal notation, such as 00:0E:5E:12:34:56

Default conditions
Obtain address mapping through the dynamic ARP.

Command mode
Global configuration

Usage guideline
Scenario

Raisecom Technology Co., Ltd.

80

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

To prevent ARP attacks on the proxy device, bind static mapping from the IP address to the
MAC address on the proxy device. ARP is a protocol used for resolution of IP addresses into
MAC addresses. ARP entries are divided into static ARP entries and dynamic ARP entries.
Static ARP entries are manually added to the ARP mapping table. Dynamic ARP entries are
automatically added to the ARP mapping table through a learning mechanism. To manually
add static ARP entries, use this command.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure mapping from the IP address 192.168.4.1 to the MAC
address 00:0e:5e:12:34:56.
Raisecom# config
Raisecom(config)# arp add 192.168.4.1 00:0e:5e:12:34:56
Successfully add an entry to ARP table

Related commands
show arp

3.1.3 description
Function
To configure descriptions of the SNMP interface, use this command.

Format
description string

Parameter
Parameter
string

Description
Descriptions of the interface, a string of characters, ranging from 1 to 256

Default conditions
N/A

Command mode
SNMP interface configuration
Raisecom Technology Co., Ltd.

81

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Usage guideline
Scenario
Configuring descriptions of the SNMP interface is to facilitate users to memorize the usage of
the interface and identify the interface quickly.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Space in the description is replaced by "^".

Examples
This example shows how to configure descriptions of the SNMP interface to raisecom-snmp.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)# sdh description raisecom-snmp
Set successfully.

Related commands
show interface snmp

3.1.4 ip address (SNMP interface configuration mode)


Function
To configure the IP address and subnet mask for the SNMP interface, use this command.

Format
ip address ip-address [ ip-mask ]

Parameter
Parameter

Description

ip-address

IP address of the interface, in dotted decimal notation, such as 10.10.10.1

ip-mask

Subnet mask, in dotted decimal notation, such as 255.255.255.255

Default conditions
The IP address and subnet mask of the SNMP interface are192.168.4.28 and 255.255.255.0
respectively.

Raisecom Technology Co., Ltd.

82

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Command mode
SNMP interface configuration

Usage guideline
Scenario
You can use this command to configure the IP address and subnet mask for the SNMP
interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the IP address and subnet mask of the SNMP interface
to 192.168.1.111 and 255.255.255.0 respectively.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)# ip address 192.168.1.111 255.255.255.0
Set successfully

Related commands
N/A

3.1.5 show snmp-server community


Function
To show the SNMP community name list, use this command.

Format
show snmp-server community

Parameter
N/A

Default conditions
N/A

Raisecom Technology Co., Ltd.

83

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the SNMP community name list.
Raisecom# show snmp-server community
ID COMMUNITYNAME
RIGHT
-------------------------------------------1
public
ro
2
private
rw

The following table lists fields displayed in previous command lines.


Field

Description

ID

Index ID

COMMUNITYNAME

Community name

RIGHT

Visit privilege

ro: read-only
rw: read-write

Related commands
snmp-server community

3.1.6 show snmp-server statistics


Function
To show statistics of the SNMP server, use this command.

Format
show snmp-server statistics

Parameter
N/A

Default conditions
N/A

Raisecom Technology Co., Ltd.

84

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show statistics of the SNMP server.
Raisecom# show snmp-server statistics
SNMP Statistics:
snmpInPkts: 429
snmpInBadVersions: 0
snmpInBadCommunityNames: 0
snmpInBadCommunityUses: 0
snmpInASNParseErrs: 0
snmpEnableAuthTraps: 0
snmpOutPkts: 429
snmpInBadTypes: 0
snmpInTooBigs: 0
snmpInNoSuchNames: 0
snmpInBadValues: 0
snmpInReadOnlys: 0
snmpInGenErrs: 0
snmpInTotalReqVars: 1718
snmpInTotalSetVars: 0
snmpInGetRequests: 53
snmpInGetNexts: 376
snmpInSetRequests: 0
snmpInGetResponses: 0
snmpInTraps: 0
snmpOutTooBigs: 0
snmpOutNoSuchNames: 0
snmpOutBadValues: 0
snmpOutReadOnlys: 0
snmpOutGenErrs: 0
snmpOutGetRequests: 0
snmpOutGetNexts: 0
snmpOutSetRequests: 0
snmpOutGetResponses: 429
snmpOutTraps: 0
snmpSilentDrops: 0
snmpProxyDrops: 0

The following table lists fields displayed in previous command lines.


Field

Description

snmpInPkts

Number of Rx SNMP packets

snmpInBadVersions

Number of unsupported SNMP packets

Raisecom Technology Co., Ltd.

85

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Field

Description

snmpInBadCommunityNames

Number of Rx SNMP packets with unknown


community names

snmpInBadCommunityUses

Number of Rx SNMP packets whose community is not


allowed to operate

snmpInASNParseErrs

Number of SNMP packets that have ASN.1 or BER


errors

snmpEnableAuthTraps

Number of Rx SNMP Trap packets which fail to be


authenticated.

snmpOutPkts

Number of Tx SNMP packets

snmpInBadTypes

Number of Rx SNMP packets of wrong types

snmpInTooBigs

Number of Rx SNMP packets whose wrong status is


Too Big

snmpInNoSuchNames

Number of Rx SNMP packets which unknown host


names

snmpInBadValues

Number of Rx SNMP packets with wrong values

snmpInReadOnlys

Number of Rx SNMP packets with the read-only


privilege

snmpInGenErrs

Number of Rx SNMP packets whose wrong status is


GenErr

snmpInTotalReqVars

Number of effective GetRequest packets and GetNext


packets

snmpInTotalSetVars

Number of effective Rx configuration request SNMP


packets

snmpInGetRequests

Number of Rx GetRequest SNMP packets

snmpInGetNexts

Number of Rx GetNext SNMP packets

snmpInSetRequests

Number of Rx configuration request SNMP packets

snmpInGetResponses

Number of Rx GetResponses SNMP packets

snmpInTraps

Number of Rx SNMP Traps

snmpOutTooBigs

Number of Tx SNMP packets whose wrong status is


Too Big

snmpOutNoSuchNames

Number of Tx SNMP packets which unknown host


names

snmpOutBadValues

Number of Tx SNMP packets with wrong values

snmpOutReadOnlys

Number of Tx SNMP packets with the read-only


privilege

snmpOutGenErrs

Number of Tx SNMP packets whose wrong status is


GenErr

Raisecom Technology Co., Ltd.

86

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Field

Description

snmpOutGetRequests

Number of Tx GetRequest SNMP packets

snmpOutGetNexts

Number of Tx GetNext SNMP packets

snmpOutSetRequests

Number of Tx configuration request SNMP packets

snmpOutGetResponses

Number of Tx GetResponses SNMP packets

snmpOutTraps

Number of Tx SNMP Traps

snmpSilentDrops

Number of discarded packets

snmpProxyDrops

Number of packets discarded by SNMP Proxy

Related commands
N/A

3.1.7 show snmp trap-bind


Function
To show the bound interface for receiving SNMP Traps, use this command.

Format
show snmp trap-bind

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show the bound interface for receiving SNMP Traps.
Raisecom# show snmp trap-bind
interface: snmp
source ip address: 192.168.18.200

The following table lists fields displayed in previous command lines.


Raisecom Technology Co., Ltd.

87

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Field

Description

interface

Interface for receiving SNMP Traps

source ip address

IP address of the interface

Related commands
N/A

3.1.8 show snmp trap-server


Function
To show information about the SNMP Trap server, use this command.

Format
show snmp trap-server

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Examples
This example shows how to show information about the Trap target server.
Raisecom# show snmp trap-server
Trap server:
ADDRESS
PORT
---------------------------------------192.168.18.184 162

The following table lists fields displayed in previous command lines


Field

Description

ADDRESS

IP address of the Trap target server

PORT

Interface ID for receiving Trap

Raisecom Technology Co., Ltd.

88

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Related commands
N/A

3.1.9 snmp trap-bind


Function
To configure the bound interface for receiving SNMP Traps, use this command.

Format
snmp trap-bind { any | snmp }

Parameter
Parameter

Description

any

Any interface can receive SNMP Traps.

snmp

The SNMP interface receives SNMP Traps.

Default conditions
The bound interface for receiving SNMP Traps is the SNMP interface.

Command mode
Global configuration

Usage guideline
Scenario
You need to configure the bound interface for receiving SNMP Traps on the RCMS2903-4E14GE according to different network management channels. Otherwise, the network
management device cannot receive network management information.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the bound interface for receiving SNMP Traps to
Bridge interface.
Raisecom# config

Raisecom Technology Co., Ltd.

89

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Raisecom(config)# snmp trap-bind bridge


Set successfully

Related commands
show snmp trap-bind

3.1.10 snmp trap-server


Function
To configure the IP address and interface ID for the SNMP Trap target server, use this
command. To delete received Traps, use the no form of this command.

Format
snmp trap-server ip-address [ port-id ]
no snmp trap-server ip-address

Parameter
Parameter

Description

ip-address

IP address of the Trap target server, in dotted decimal notation, such as


10.10.10.1

port-id

Interface ID of the Trap target server, an integer, ranging from 1 to 65535

Default conditions
Interface ID of the Trap target server is 162.

Command mode
Global configuration/Alarm configuration

Usage guideline
Scenario
The network management device can manage the proxy device only when you have
configured the IP address of the Trap target server on the managed device, that is, the IP
address of the network management device.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A
Raisecom Technology Co., Ltd.

90

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Examples
This example shows how to configure the IP address of the SNMP Trap target server to
192.168.1.10.
Raisecom# config
Raisecom(config)# snmp trap-server 192.168.1.10
Set successfully

Related commands
show snmp trap-server

3.1.11 snmp-server community


Function
To configure the community name and read-write privilege for the SNMP server, use this
command. To delete the community name, use the no form of this command.

Format
snmp-server community community-name { ro | rw }
no snmp-server community community-name

Parameter
Parameter

Description

community-name

Community name, used to access MIB variables

ro

Read-only privilege

rw

Read-write privilege

Default conditions
N/A

Command mode
Global configuration

Usage guideline
Scenario
SNMP V1/V2 adopts the community name authentication mechanism. The community name,
like the password, is a string of characters defined on the proxy device. The network
management system can access the proxy device only after having the community name.
Prerequisite
N/A
Raisecom Technology Co., Ltd.

91

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Follow-up procedure
N/A
Precaution
To manage the RCMS2903-4E1-4GE through the NView NNM system, configure the
community name and read-write privilege for the SNMP server. Otherwise, you may fail to
log in to the RCMS2903-4E1-4GE.

Examples
This example shows how to configure the community name and read-write privilege of the
SNMP server to raisecom and read-write respectively.
Raisecom# config
Raisecom(config)# snmp-server community raisecom rw
Set successfully

Related commands
show snmp-server community

3.1.12 shutdown (SNMP interface configuration mode)


Function
To shut down the current SNMP interface, use this command. To restore default configuration,
use the no form of this command.

Format
shutdown
no shutdown

Parameter
N/A

Default conditions
The SNMP interface is enabled.

Command mode
SNMP interface configuration

Usage guideline
Scenario
You can use this command to enable or disable the SNMP interface.
Prerequisite
Raisecom Technology Co., Ltd.

92

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable the SNMP interface.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)# no shutdown
Set successfully

Related commands
show interface snmp

3.1.13 snmpd
Function
To enable SNMP services, use this command. To disable SNMP services, use the no form of
this command.

Format
snmpd
no snmpd

Parameter
N/A

Default conditions
The SNMP server is enabled.

Command mode
Global configuration

Usage guideline
Scenario
SNMP services should be enabled. Otherwise, the NView NNM system cannot manage the
RCMS2903-4E1-4GE.

Raisecom Technology Co., Ltd.

93

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to disable SNMP services.
Raisecom# config
Raisecom(config)# no snmpd
Set successfully

Related commands
N/A

3.1.14 speed (SNMP interface configuration mode)


Function
To configure the rate and duplex mode for the SNMP interface, use this command.

Format
speed { 10 | 100 } duplex { full-duplex | half-duplex }

Parameter
Parameter

Description

100

Force 100 Mbit/s

1000

Force 1000 Mbit/s

full-duplex

Full duplex mode

half-duplex

Half duplex mode

Default conditions
The rate of the SNMP interface is 100 Mbit/s. The duplex mode of the SNMP interface is full
duplex.

Command mode
SNMP interface configuration

Raisecom Technology Co., Ltd.

94

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Usage guideline
Scenario
The SNMP interface can work in two modes: half duplex and full duplex. In half duplex
mode, the interface can receive or send data at one time. In full duplex mode, the interface
can receive and send data at the same time. Duplex mode of interfaces on two interconnected
devices should be consistent. Otherwise, the two devices may fail to communicate.
The SNMP interface can work at 10 Mbit/s or 100 Mbit/s. When interface rates of two
interconnected devices are different, the two devices may fail to communicate.
You can use this command to configure the interface rate and duplex mode for two
interconnected devices to make the interface rate and duplex mode match with each other.
Prerequisite
Use the no autonegotiate command to disable auto-negotiation on the interface.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the rate and duplex mode of the SNMP interface to 100
Mbit/s and half duplex mode respectively.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)# speed 100 duplex half-duplex
Set successfully.

Related commands
show interface snmp

3.1.15 interface snmp


Function
To enter SNMP interface configuration mode, use this command.

Format
interface snmp

Parameter
N/A

Raisecom Technology Co., Ltd.

95

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Default conditions
N/A

Command mode
Global configuration

Usage guideline
N/A

Examples
This example shows how to enter SNMP interface configuration mode.
Raisecom# config
Raisecom(config)# interface snmp
Raisecom(config-snmp)#

Related commands
N/A

3.1.16 show arp


Function
To show information about the ARP table, use this command.

Format
show arp

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration

Usage guideline
N/A

Raisecom Technology Co., Ltd.

96

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Examples
This example shows how to show information about the ARP table.
Raisecom# show arp
LINK LEVEL ARP TABLE
destination
mac-addr
flags(0x)Rfc Use
Interface
------------------------------------------------------------------------192.168.18.1
00:0f:e2:12:5c:a0 2020405 0
0
motfec0
192.168.18.79
b8:ac:6f:3e:97:86 2020405 0
350
motfec0
192.168.18.184
bc:30:5b:c6:11:45 2020405 2
656
motfec0
192.168.18.199
00:0c:29:ce:9c:dc 2020405 1
429
motfec0
-------------------------------------------------------------------------

The following table lists fields displayed in previous command lines


Field

Description

destination

Destination IP address

mac-addr

MAC address

Interface

Interface type

Related commands
N/A

3.1.17 show interface snmp


Function
To show information about the SNMP interface, use this command.

Format
show interface snmp

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/SNMP interface configuration

Usage guideline
N/A

Raisecom Technology Co., Ltd.

97

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

3 Network management

Examples
This example shows how to show information about the SNMP interface.
Raisecom# config
Raisecom(config-snmp)# show interface snmp
Interface:snmp
Administration Status : up Operation Status : up
Description: snmp
Internet address: 10.0.0.1 Netmask: 255.255.255.0
Ethernet address: 00:00:00:00:00:00
Duplex:half-duplex
Speed:10baseT
Autonegotiation:enable

The following table lists fields displayed in previous command lines.


Field

Description

Interface

Interface type

Administration Status

Management status

Description

Interface description

Internet address

IP address

Ethernet address

MAC address

Duplex

Duplex mode of the interface

Speed

Interface rate

Autonegotiation

Auto-negotiation feature

Related commands
N/A

Raisecom Technology Co., Ltd.

98

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Ethernet access

4.1 VLAN
4.1.1 double-tagging tpid
Function
To configure the Tag Protocol Identifier (TPID) for the outer Tag, use this command. To
restore default configurations, use the no form of this command.

Format
double-tagging tpid tpid
no double-tagging tpid

Parameter
Parameter
tpid

Description
TPID, hexadecimal notation, ranging from 0x0000 to 0xffff

Default conditions
The TPID of the outer Tag is 0x9100.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to configure the TPID of the outer Tag.
The TPID is a field in the VLAN Tag and it varies on different vendors. You can configure the
TPID to interconnect with other devices.

Raisecom Technology Co., Ltd.

99

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the TPID to 0x8100.
Raisecom# config
Raisecom(config)# double-tagging tpid 0x8100
Set successfully

Related commands
show info

4.1.2 pvid
Function
To configure the Port-base VLAN ID (PVID) of the switching interface, that is, the default
VLAN ID, use this command.

Format
pvid vlan-id

Parameter
Parameter
vlan-id

Description
Default VLAN ID, an integer, ranging from 1 to 4094

Default conditions
The PVID for five switching interfaces is 1.

Command mode
Switching interface configuration

Usage guideline
Scenario
You can use this command to configure the default VLAN ID of the switching interface.

Raisecom Technology Co., Ltd.

100

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Prerequisite
Before configuring the default VLAN ID of the switching interface, use the vlan-entry-list
port-list or vlan-entry vid port-list command to add the switching interface to the interface
list allowed to pass by the default VLAN ID.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to add switching interface 1 to VLAN 1 and configure the VLAN
ID to 10.
Rasiecom# config
Raisecom(config)# vlan-entry 1 vid 10 port-list 1
Set successfully

Configure the default VLAN ID of switching interface 1 to 10.


Raisecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# pvid 10
Set successfully

Related commands
show esw

4.1.3 show vlan-entry-list


Function
To show information about one or multiple entries in the VLAN list, use this command.

Format
show vlan-entry-list entry-index

Parameter
Parameter
entry-index

Description
VLAN entry index, an integer, supporting rang input, such
as "1-3" and multiple-point input, such as "1,2,3"

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network


management mode.

Raisecom Technology Co., Ltd.

101

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
N/A

Examples
This example shows how to show information about VLAN 1.
Raisecom# config
Raisecom(config)# show vlan-entry-list 1
VLAN entry index: 1
VLAN active config: activated
VLAN active status: activated
VID config: 10
VID status: 10
VLAN member config: 1 2 3 4 5
VLAN member status: 1 2 3 4 5
VLAN rate limit config is: none
VLAN rate limit status is: none
VLAN burst config is: none
VLAN burst status is: none

The following table lists fields displayed in previous command lines.


Field

Description

VLAN entry index

VLAN entry index

VLAN active config

VLAN activation configuration

VLAN active status

VLAN active status

VID config

VLAN ID configuration

VID status

VLAN ID status

VLAN member config

VLAN member configuration

VLAN member status

VLAN member status

VLAN rate limit config

VLAN rate limiting configuration

VLAN rate limit status

VLAN rate limiting status

VLAN burst config

VLAN burst configuration

VLAN burst status

VLAN burst status

Raisecom Technology Co., Ltd.

102

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Related commands
N/A

4.1.4 tag-mode
Function
To configure the Tag mode of the switching interface in the egress direction, use this
command.

Format
tag-mode { tag | untag }

Parameter
Parameter

Description

tag

Tag mode

untag

Untag mode

Default conditions
Egress packets from switching interface 5 carry Tags. Packets from other switching interfaces
do not carry Tags.

Command mode
Switching interface configuration

Usage guideline
Scenario

When the VLAN mode is QinQ, the VLAN packet carries inner and outer VLAN Tags.
The Tag mode refers whether egress packets from the switching interface carry outer
Tags or not.

When the VLAN mode is Tag VLAN, the VLAN packet carries inner VLAN Tag only.
The Tag mode refers whether egress packets from the switching interface carry inner
Tags or not.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Raisecom Technology Co., Ltd.

103

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Examples
This example shows how to configure switching interface 1 to Tag mode.
Rasiecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# tag-mode tag
Set successfully

Related commands
show esw

4.1.5 vlan-entry vid


Function
To configure the VLAN ID for the VLAN list, use this command.

Format
vlan-entry entry-index vid vlan-id

Parameter
Parameter
entry-index

Description
VLAN entry index, an integer

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network


management mode.
vlan-id

VLAN ID, an integer, ranging from 1 to 4094

Default conditions
The VLAN ID for the VLAN entry is 1.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to configure the VLAN ID for the VLAN entry. VLAN IDs of
active VLAN entries are different.
For the RCMS2903-4E1-4GE, each VLAN entry is corresponding to one VLAN ID. You can
configure the status and member interfaces of multiple VLAN entries at the same time.
In different network management modes, the number of the VLAN entries is different:
Raisecom Technology Co., Ltd.

104

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

In mode 1: the RCMS2903-4E1-4GE can be managed by the OPCOM3500E and


iTN2100 and supports 64 VLAN entries.

In mode 2: the RCMS2903-4E1-4GE can be managed by the RC002 and supports 16


VLAN entries.

You can use the bit 4 of SW1 to configure the network management modes.

Mode 1: bit 4 is configured to OFF.

Mode 2: bit 4 is configured to ON.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
The VLAN ID for multiple VLAN entries can be the same, while only one VLAN entry is in
active status.
This command can be used only in Tag VLAN or QinQ mode.

Examples
This example shows how to configure the VLAN ID of VLAN 1 to 10.
Rasiecom# config
Raisecom(config)# vlan-entry 1 vid 10
Set successfully

Related commands
show vlan-entry-list

4.1.6 vlan-entry vid portlist


Function
To specify the VLAN ID for the VLAN entry and add switching interfaces to the VLAN, use
this command.

Format
vlan-entry entry-index vid vlan-id portlist port-list

Raisecom Technology Co., Ltd.

105

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Parameter
Parameter

Description

entry-index

VLAN entry index, an integer

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network


management mode.
vlan-id

VLAN ID, an integer, ranging from 1 to 4094

port-list

Switching interface list, an integer, ranging from 1 to 5,


supporting rang input, such as "1-3" and multiple-point
input, such as "1,2,3"

Default conditions
The VID of the VLAN entry is 1 and no members are in the VLAN.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to specify the VLAN ID for the VLAN entry and add switching
interfaces to the VLAN.
On the RCMS2903-4E1-4GE, switching interfaces in the same VLAN are combined together
logically to form a network, which has same features with the general physical LAN.
Different VLANs are independent and isolated from each other to prevent spread of broadcast
storm.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
This command can be used only in Tag VLAN or QinQ mode.

Examples
This example shows how to add switching interface 1 to VLAN 1 and configure the VLAN
ID to 10.
Rasiecom# config
Raisecom(config)# vlan-entry 1 vid 10 port-list 1
Set successfully

Raisecom Technology Co., Ltd.

106

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Related commands
show vlan-entry

4.1.7 vlan-entry-list
Function
To configure the status of one or multiple VLAN entries, use this command.

Format
vlan-entry-list entry-index { active | suspend }

Parameter
Parameter
entry-index

Description
VLAN entry index, an integer, supporting rang input, such
as "1-3" and multiple-point input, such as "1,2,3"

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network


management mode.
active

Activate the VLAN.

suspend

Suspend the VLAN.

Default conditions
Only VLAN 1 is in active status. Other VLANs are in suspend status.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
Each VLAN entry is corresponding to one VLAN ID. You can configure the status of multiple
VLAN entries at the same time.
The RCMS2903-4E1-4GE supports two network management modes:
In different network management modes, the number of the VLAN entries is different:

In mode 1: the RCMS2903-4E1-4GE can be managed by the OPCOM3500E and


iTN2100 and supports 64 VLAN entries.

In mode 2: the RCMS2903-4E1-4GE can be managed by the RC002 and supports 16


VLAN entries.

Prerequisite
Raisecom Technology Co., Ltd.

107

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to create VLANs 1, 2, and 3, and activate them.
Rasiecom# config
Raisecom(config)# vlan-entry-list 1,2,3 active
Set successfully

Related commands
show vlan-entry-list

4.1.8 vlan-entry-list port-list


Function
To add switching interfaces to one or multiple VLAN entries, use this command.

Format
vlan-entry-list entry-index port-list { port-list | none }

Parameter
Parameter
entry-index

Description
VLAN entry index, an integer, supporting rang input, such
as "1-3" and multiple-point input, such as "1,2,3"

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network


management mode.
port-list

Switching interface list, an integer, ranging from 1 to 5,


supporting rang input, such as "1-3" and multiple-point
input, such as "1,2,3"

none

Clear the interface list.

Default conditions
Siwthcing interfaces 15 are all in VLAN 1.

Raisecom Technology Co., Ltd.

108

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to add switching interfaces to one or multiple VLAN entries.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
This command can be used only in Tag VLAN or QinQ mode.

Examples
This example shows how to add switching interface 1 to VLANs 1 and 2.
Rasiecom# config
Raisecom(config)# vlan-entry-list 1,2 port-list 1
Set successfully

Related commands
show vlan-entry-list

4.1.9 vlan-manage vid


Function
To configure the management VLAN of the RCMS2903-4E1-4GE, use this command.

Format
vlan-manage vid vlan-id

Parameter
Parameter
vlan-id

Description
Management VLAN ID of the remote device, an integer, ranging from 1 to
4094

Default conditions
VLAN 1 is the management VLAN.

Raisecom Technology Co., Ltd.

109

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Command mode
Global configuration

User level
11

Usage guideline
Scenario
You can use this command to configure the management VLAN ID of the RCMS2903-4E14GE.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the management VLAN ID to 100.
Raisecom# config
Raisecom(config)# vlan-manage vid 100
Set successfully.

Related commands
show running-config

4.1.10 vlan-type
Function
To configure the VLAN mode, use this command.

Format
vlan-type { novlan | portvlan | tagvlan | qinq }

Parameter
Parameter

Description

novlan

No VLAN mode, that is, full switching mode

portvlan

Port VLAN mode, in which each interface is isolated from each other
Raisecom Technology Co., Ltd.

110

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Parameter

4 Ethernet access

Description

tagvlan

Tag VLAN mode

qinq

Double Tag VLAN mode

Default conditions
The VLAN mode is full switching mode.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to configure the VLAN mode.
On the RCMS2903-4E1-4GE, switching interfaces in the same VLAN are combined together
logically to form a network, which has same features with the general physical LAN.
Different VLANs are independent and isolated from each other to prevent spread of broadcast
storm.
The RCMS2903-4E1-4GE supports 4 working modes:

novlan: the VLAN is not configured, that is, the RCMS2903-4E1-4GE works in full
switching mode.

portvlan: partition VLANs based on the interface, that is, different interfaces are
isolated from each other.

tagvlan: partition VLANs based on the VLAN ID, that is, the device works in signal Tag
mode.

qinq: double Tag mode. Add the outer VLAN Tag for packets in users' private network
on the carrier access end to make packets carry double VLAN Tags.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the VLAN mode to Tag VLAN mode.
Rasiecom# config
Raisecom(config)# vlan-type tagvlan
Set successfully

Raisecom Technology Co., Ltd.

111

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Related commands
show info

4.2 QoS
4.2.1 qos default-cos
Function
To configure the default CoS priority of the switching interface, use this command.

Format
qos default-cos cos-value

Parameter
Parameter

Description

cos-value

CoS priority, an integer, ranging from 0 to 7

Default conditions
The CoS priority is 0.

Command mode
Switching interface configuration

Usage guideline
Scenario
You can use this command to configure the default CoS priority of the switching interface.
When the priority trust mode is configured to be based on the CoS priority, use the default
CoS priority if the packet is untagged.
When the VLAN mode is QinQ, the default CoS priority is added to the outer Tag of the
packet. When the VLAN mode is Tag VLAN, the default CoS priority is added to the inner
Tag of the packet.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A
Raisecom Technology Co., Ltd.

112

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Examples
This example shows how to configure the default CoS priority of switching interface 1 to 3.
Raisecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# qos default-cos 3
Set successfully

Related commands
show esw

4.2.2 qos enable


Function
To enable global QoS, use this command. To disable this function, use the disable form of
this command.

Format
qos { enable | disable }

Parameter
Parameter

Description

enable

Enable QoS.

disable

Disable QoS.

Default conditions
QoS is disabled.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
QoS can provide different service qualities according to different network applications, and
distribute and schedule network resources.
Before configure related features of QoS, you need to enable global QoS.
Prerequisite
N/A
Follow-up procedure

Raisecom Technology Co., Ltd.

113

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

N/A
Precaution
N/A

Examples
This example shows how to enable QoS.
Raisecom# config
Raisecom(config)# qos enable
Set successfully

Related commands
show qos
show info

4.2.3 qos queue


Function
To configure QoS queue scheduling mode, use this command.

Format
qos queue { sp | wrr | lsp-3wrr | 2sp-2wrr }

Parameter
Parameter

Description

sp

SP scheduling mode

wrr

WRR scheduling mode

1sp-3wrr

1SP-3WRR scheduling mode

2sp-2wrr

2SP-2WRR scheduling mode

Default conditions
The QoS queue scheduling mode is SP.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
You can use this command to configure the QoS queue scheduling mode.
Raisecom Technology Co., Ltd.

114

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

The RCMS2903-4E1-4GE supports the following four QoS queue scheduling modes:

Strict Priority (SP): the device strictly schedules packets in a descending order of priority.
Packets with lower priority cannot be scheduled until packets with higher priority are
scheduled.

Weight Round Robin (WRR): on the basis of scheduling packets in a polling manner
according to the priority, the device schedules packets according to the weight of the
queue. The queue with a higher priority obtains more resources and the queue with a
lower priority obtains fewer resources to avoid the situation that the packet with a lower
priority will not be scheduled for a long time in the fixed priority scheduling.

1SP-3WRR: The queue with the highest priority is scheduled according to the SP mode.
Other three queues are scheduled in a polling manner according to the WRR mode.

2SP-2WRR: The two queues with the higher priority are scheduled according to the SP
mode. Other two queues are scheduled in a polling manner according to the WRR mode.

Prerequisite
N/A
Follow-up procedure
When the QoS queue scheduling mode is WRR or 1SP-3WRR or 2SP-2WRR, use the qos
queue wrr command to configure the weight of the queue.
Precaution
N/A

Examples
This example shows how to configure the QoS queue scheduling mode to 1SP-3WRR.
Raisecom# config
Raisecom(config)# qos queue 1sp-3wrr
Set successfully

Related commands
show qos
show info

4.2.4 qos queue cos-map


Function
To configure mapping from the CoS priority to the QoS queue, use this command.

Format
qos queue cos-map { queue-id cos-value | default }

Raisecom Technology Co., Ltd.

115

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Parameter
Parameter

Description

queue-id

Queue ID, an integer, ranging from 1 to 4

cos-value

CoS priority, an integer, ranging from 0 to 7, supporting rang


input, such as "1-3" and multiple-point input, such as "1,2,3"

default

Restore the mapping from the the CoS priority to the QoS
queue to default configurations

Default conditions
The following table lists mapping from the CoS priority to the QoS queue.
QoS queue ID
CoS priority

1 and 2

0 and 3

4 and 5

6 and 7

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
In QoS queue scheduling, you need to obtain the queue ID according to the mapping
relationship, and then map different CoS priorities to different QoS queues for scheduling.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to map CoS priorities 2 and 3 to QoS queue 1.
Raisecom# config
Raisecom(config)# qos queue cos-map 1 2,3
Set successfully

Related commands
show qos
show info

Raisecom Technology Co., Ltd.

116

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

4.2.5 qos queue wrr


Function
To configure the weight of each queue in WRR mode, use this command. To restore default
configurations, use the no form of this command.

Format
qos queue wrr weight-1 weight-2 weight-3 weight-4
no qos queue wrr

Parameter
Parameter

Description

weight-1

Weight of queue 1, an integer, ranging from 1 to 31

weight-2

Weight of queue 2, an integer, ranging from 1 to 31

weight-3

Weight of queue 3, an integer, ranging from 1 to 31

weight-4

Weight of queue 4, an integer, ranging from 1 to 31

Default conditions
The weight of queues 14 is 1, 2, 4, and 8 respectively.

Command mode
Remote configuration/Global configuration

Usage guideline
Scenario
The RCMS2903-4E1-4GE supports the following four QoS queue scheduling modes:

SP: the device strictly schedules packets in a descending order of priority. Packets with
lower priority cannot be scheduled until packets with higher priority are scheduled.

WRR: on the basis of scheduling packets in a polling manner according to the priority,
the device schedules packets according to the weight of the queue. The queue with a
higher priority obtains more resources and the queue with a lower priority obtains fewer
resources to avoid the situation that the packet with a lower priority will not be
scheduled for a long time in the fixed priority scheduling.

1SP-3WRR: The queue with the highest priority is scheduled according to the SP mode.
Other three queues are scheduled in a polling manner according to the WRR mode.

2SP-2WRR: The two queues with the higher priority are scheduled according to the SP
mode. Other two queues are scheduled in a polling manner according to the WRR mode.

You can use this command to configure the weight of each queue in WRR mode.
Prerequisite
Raisecom Technology Co., Ltd.

117

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Use the qos queue command to configure the QoS scheduling mode to WRR or 1SP-3WRR
or 2SP-2WRR.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the weight of queues 14 to 1, 1, 1, and 2 respectively.
Raisecom# config
Raisecom(config)# qos queue wrr 1 1 1 2
Set successfully

Related commands
show qos
show info

4.2.6 qos trust


Function
To configure the priority trust mode for QoS, use this command.

Format
qos trust { port | cos | dscp }

Parameter
Parameter

Description

port

Trust the default priority of the interface.

cos

Trust the CoS priority of the VLAN packet header.

dscp

Trust the DSCP packet of the IP packet.

Default conditions
QoS trusts the interface priority.

Command mode
Remote configuration/Global configuration

Raisecom Technology Co., Ltd.

118

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Usage guideline
Scenario
The RCMS2903-4E1-4GE supports the following three priority trust modes:

port: partition packets by the default CoS priority and interfaces are isolated from each
other. Use the qos default-cos command to configure the default CoS priority of the
interface.

cos: trust the CoS priority of the VLAN packet header and partition packets according to
the CoS priority of the ingress packet Tag. For the Untagged packet, use the default CoS
priority of the interface. Use the qos default-cos command to configure the default CoS
priority of the interface.

dscp: trust the DSCP priority of the IP packet.

Prerequisite
N/A
Follow-up procedure

When QoS trusts the CoS priority, use the qos queue cos-map command to configure
mapping from the CoS priority to the QoS queue.

When QoS trusts the DSCP priority, use the qos queue dscp-map command to
configure mapping from the DSCP priority to the QoS queue.

Precaution
N/A

Examples
This example shows how to configure QoS to partition priorities according to CoS.
Raisecom# config
Raisecom(config)# qos trust cos
Set successfully

Related commands
show qos
show info

4.2.7 show qos


Function
To show QoS basic information, use this command.

Format
show qos

Raisecom Technology Co., Ltd.

119

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Parameter
N/A

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
N/A

Examples
This example shows how to show QoS basic information.
Raisecom# config
Raisecom(config)# show qos
QoS enable config: disable
QoS enable status: disable
queues policy config: strict priority
queues policy status: strict priority
queue No. 1, weight config = 1
queue No. 2, weight config = 2
queue No. 3, weight config = 4
queue No. 4, weight config = 8
queue No. 1, weight status = 1
queue No. 2, weight status = 2
queue No. 3, weight status = 4
queue No. 4, weight status = 8
QoS policy config: CoS based
QoS policy status: CoS based
Queue ID
CoS
---------------1
1 2
2
0 3
3
4 5
4
6 7
Queue ID
-------1
2
3
4

Dscp
--------0 1 2 3 4 5
10 11 12 13
16 17 18 19
26 27 28 29
32 33 34 35
42 43 44 45
48 49 50 51
58 59 60 61

6 7 8
14 15
20 21
30 31
36 37
46 47
52 53
62 63

9
22 23 24 25
38 39 40 41
54 55 56 57

The following table lists fields displayed in previous command lines.


Raisecom Technology Co., Ltd.

120

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Field

Description

QoS enable config

Enable or disable QoS.

QoS enable status

QoS status

queues policy config

Queue scheduling configuration

queues policy status

Queue scheduling status

queue No

Queue No.

weight config

Weight configuration

weight status

Weight status

QoS policy config

QoS priority trust configuration

QoS policy status

QoS priority trust status

Queue ID

Queue ID

CoS

CoS priority

Dscp

DSCP priority

Related commands
N/A

4.3 Rate limiting


4.3.1 rate-limit
Function
To configure rate limiting for the switching interface, use this command. To delete the
configuration, use the no form of this command.

Format
rate-limit { egress | ingress | both } rate-value
no rate-limit { both | egress | ingress }

Parameter
Parameter

Description

egress

Configure rate limiting on the interface in the egress direction.

ingress

Configure rate limiting on the interface in the ingress direction

both

Configure rate limiting on the interface in both the egress and ingress
directions.
Raisecom Technology Co., Ltd.

121

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Parameter
rate-value

4 Ethernet access

Description
Rate limit, an integer, ranging from 64 to 1000000, in unit of Kbit/s

Default conditions
Rate limiting is disabled.

Command mode
Switching interface configuration

Usage guideline
Scenario
You can use this command to perform rate limiting on the switching interface in either the
egress or ingress direction as needed. The actual rate limit may be different from the
configured value. The actual rate limit follows the upward principle and is multiple of 64
Kbit/s.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Enabling storm control will disable rate limiting on the ingress interface. We do not
recommend configuring storm control and rate limiting on the same interface simultaneously.
When storm control is enabled, rate limiting does not take effect. At this time, the
configuration value is different from the state value. When storm control is disabled, the rate
limit will be automatically configured to the previous configuration value.

Examples
This example shows how to configure rate limiting on switching interface 1 in both the egress
and ingress directions, and the highest rate is 64 Kbit/s.
Raisecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# rate-limit both 64
Set successfully

Related commands
show esw

Raisecom Technology Co., Ltd.

122

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

4.3.2 show vlan-entry-list rate-limit


Function
To show rate limiting information about the VLAN list, use this command.

Format
show vlan-entry-list entry-index rate-limit

Parameter
Parameter
entry-index

Description
VLAN entry index, an integer, supporting rang input, such
as "1-3" and multiple-point input, such as "1,2,3"

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network


management mode.

Default conditions
N/A

Command mode
Remote configuration/Global configuration

Usage guideline
N/A

Examples
This example shows how to rate limiting information about VLANs 1 and 2.
Raisecom# config
Raisecom(config)# show vlan-entry-list 1,2 rate-limit
VLAN entry index: 1
VLAN rate limit config is: 64 kbps
VLAN rate limit status is: 64 kbps
VLAN burst config is: 64 kB
VLAN burst status is: 64 kB
VLAN
VLAN
VLAN
VLAN
VLAN

entry index: 2
rate limit config is: none
rate limit status is: none
burst config is: none
burst status is: none

The following table lists fields displayed in previous command lines.

Raisecom Technology Co., Ltd.

123

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Field

Description

VLAN entry index

VLAN entry index

VLAN rate limit config

VLAN rate limiting configuration

VLAN rate limit status

VLAN rate limiting status

VLAN burst config

VLAN burst configuration

VLAN burst status

VLAN burst status

Related commands
N/A

4.3.3 vlan-entry-list rate-limit


Function
To configure rate limiting for one or multiple VLAN entries, use this command. To delete the
configuration, use the no form of this command.

Format
vlan-entry-list entry-index rate-limit rate burst
no vlan-entry-list entry-index rate-limit

Parameter
Parameter
entry-index

Description
VLAN entry index, an integer, supporting rang input, such as "1-3" and
multiple-point input, such as "1,2,3"

Network management mode 1: ranging from 1 to 64


Network management mode 2: ranging from 1 to 16

You can use bit 4 of DIP SW1 to configure the network management
mode.
rate

Rate, an integer, ranging from 64 to 1000000, in unit of Kbit/s

burst

Burst rate, an integer, ranging from 16 to 16384, in unit of KB/s

Default conditions
Rate limiting for the VLAN entries is disabled.

Command mode
Remote configuration/Global configuration

Raisecom Technology Co., Ltd.

124

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Usage guideline
Scenario
You can use this command to configure rate limiting for VLAN entries.
In configuration, the actual value may different from the configuration value. Corresponding
rules are as below:

0 Mbit/s < rate 1.792 Mbit/s: starting from 64 Kbit/s, in unit of 64 Kbit/s, upward

1.792 Mbit/s < rate 100 Mbit/s: starting from 2 Mbit/s, in unit of 1 Mbit/s, upward

100 Mbit/s < rate 1000 Mbit/s: starting from 104 Mbit/s, in unit of 8 Mbit/s, upward

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
You can configure VLAN rate limiting for multiple times. New configuration will override
the previous one when executing configurations on the same VLAN repeatedly.
When interface rate limiting and VLAN rate limiting in the ingress direction are configured
concurrently, interface rate limiting takes effect first and VLAN rate limiting share the limit
with interface rate limiting.

Examples
This example shows how to configure rate limit for VLANs 1 and 2 to 5 Mbit/s and the burst
rate to 32 KB/s.
Rasiecom# config
Raisecom(config)# vlan-entry-list 1,2 rate-limit 5120 32
Set successfully

Related commands
show vlan-entry-list

4.4 Storm control


4.4.1 show storm-control
Function
To show configurations of storm control on the switching interface, use this command.

Format
show storm-control
Raisecom Technology Co., Ltd.

125

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Parameter
N/A

Default conditions
N/A

Command mode
Switching interface configuration

Usage guideline
Scenario
You can use this command to show configurations of storm control on the switching interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
The actual rate may be different from the configured value. The actual rate follows the
upward principle and is multiple of 64 Kbit/s.

Examples
This example shows how to show configurations of storm control on switching interface 1.
Raisecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# show storm-control
storm-control type config: disable
storm-control type status: disable
storm-control rate config is: 256
storm-control rate status is: 256

The following table lists fields displayed in previous command lines.


Field

Description

storm-control type config

Storm control type configuration

storm-control type status

Storm control type status

storm-control rate config

Storm control rate configuration

storm-control rate status

Storm control rate status

Related commands
N/A
Raisecom Technology Co., Ltd.

126

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

4.4.2 storm-control
Function
To configure the storm control type for the current switching interface, use this command. To
disable the configuration, use the disable form of this command.

Format
storm-control { broadcast | multicast | dlf | all | disable }

Parameter
Parameter

Description

broadcast

Control broadcast packets.

multicast

Control unknown multicast packets.

dlf

Control unknown unicast packets.

all

Control broadcast, unknown multicast, and unknown unicast


packets.

disable

Storm control is disabled.

Default conditions
Storm control is disabled.

Command mode
Switching interface configuration

Usage guideline
Scenario
In most scenarios of the Layer 2 network, unicast traffic is much heavier than broadcast traffic.
If the rate for broadcast traffic is not limited, much bandwidth will be occupied when a
broadcast storm is generated. Therefore, network performance is reduced and forwarding of
normal unicast packets is seriously affected. Moreover, communication between devices may
be interrupted.
Configuring storm control on Layer 2 devices can prevent broadcast storm occurring when
broadcast packets increase sharply on the network. Therefore, it makes sure that unicast
packets can be properly forwarded.
The following forms of traffic may cause broadcast traffic, so you need to limit the bandwidth
for them on Layer 2 devices.

Unknown unicast traffic: the unicast traffic whose destination MAC address is not in
MAC address table. It is broadcasted by Layer 2 devices.

Unknown multicast traffic: the traffic whose destination MAC address is a multicast
MAC address. Generally, it is broadcasted by Layer 2 devices.
Raisecom Technology Co., Ltd.

127

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Broadcast traffic: the traffic whose destination MAC address is a broadcast MAC
address. It is broadcasted by Layer 2 devices.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
We do not recommend configuring storm control and rate limiting on the same interface
simultaneously. When storm control is enabled, rate limiting does not take effect. At this time,
the configuration value is different from the state value. When storm control is disabled, the
rate limit will be automatically configured to the previous configuration value. Enabling
storm control will disable rate limiting on the ingress interface.

Examples
This example shows how to configure storm control on switching interface 1.
Rasiecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# storm-control broadcast
Set successfully

Related commands
show storm-control
show esw

4.4.3 storm-control rate


Function
To configure the storm control rate for the switching interface, use this command.

Format
storm-control rate rate

Parameter
Parameter
rate

Description
Storm control rate, ranging from 64 to 1000000, in unit of Kbit/s

Default conditions
The storm control rate is 256 Kbit/s.

Raisecom Technology Co., Ltd.

128

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

4 Ethernet access

Command mode
Switching interface configuration

Usage guideline
Scenario
You can use this command to configure the storm control rate for the switching interface. The
actual rate may be different from the configured value. The actual rate follows the upward
principle and is multiple of 64 Kbit/s.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the storm control rate of switching interface 1 to 64
Kbit/s.
Raisecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# storm-control rate 64
Set successfully

Related commands
show storm-control
show esw

Raisecom Technology Co., Ltd.

129

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Interface management

5.1 Switching interface commands


5.1.1 interface switchport
Function
To enter switching interface configuration mode, use this command.

Format
interface switchport interface-number

Parameter
Parameter
interface-number

Description
Switching interface number, an integer, ranging from 1 to 5

Switching interfaces 14: GE interfaces 14


Switching interface 5: optical interface 1

Default conditions
N/A

Command mode
Remote configuration/Global configuration/Switching interface configuration

Usage guideline
N/A

Examples
This example shows how to enter switching interface 1 configuration mode.
Raisecom# config

Raisecom Technology Co., Ltd.

130

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Raisecom(config)# interface switchport 1


Raisecom(config-esw/0/1)#

Related commands
N/A

5.2 GE electrical interface commands


5.2.1 autonegotiate (GE electrical interface configuration mode)
Function
To enable auto-negotiation on the GE electrical interface, use this command. To disable this
function, use the no form of this command.

Format
autonegotiate
no autonegotiate

Parameter
N/A

Default conditions
Auto-negotiation on the GE electrical interface is enabled.

Command mode
GE electrical interface configuration

Usage guideline
Scenario
Auto-negotiation enables devices at the two ends of a physical link to choose the same
operating parameters through interaction. The content to be negotiated includes the working
mode (full duplex or half duplex) and interface rate (10/100/1000 Mbit/s). After negotiation,
devices at the two ends of the link will work in the same working mode and at the same
interface rate.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Raisecom Technology Co., Ltd.

131

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

After enabling auto-negotiation, the duplex mode and interface rate are negotiated by devices
at the two ends of the link. And you cannot use the speed command to configure the duplex
mode and interface rate.
When the local device works in auto-negotiation mode, you need to configure the peer device
to work in auto-negotiation mode.

Examples
This example shows how to enable auto-negotiation on the GE electrical interface 1.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# autonegotiate
Set successfully

Related commands
show interface(GF optical interface configuration)

5.2.2 clear statistic (GE electrical interface configuration mode)


Function
To clear statistics of the current GE electrical interface, use this command.

Format
clear statistic

Parameter
N/A

Default conditions
N/A

Command mode
GE electrical interface configuration

Usage guideline
N/A

Examples
This example shows how to clear statistics of GE electrical interface 1.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# clear statistic
Set successfully

Raisecom Technology Co., Ltd.

132

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Related commands
show statistic (GF optical interface configuration mode)

5.2.3 flow-control on (GE electrical interface configuration mode)


Function
To configure flow control on the GE electrical interface, use this command.

Format
flow-control { on | off }

Parameter
Parameter

Description

on

Enable flow control.

off

Disable flow control.

Default conditions
Flow control on the GE electrical interface is enabled.

Command mode
GE electrical interface configuration

Usage guideline
Scenario
Flow control is used to prevent loss of frames when the interface is congested. When Tx or
Rx buffer is overflowed, flow control blocks signals to send to the source address. In this case,
it prevents too excessive data flow from congesting the network.

Half duplex mode: flow control adopts the back pressure technology, which slows down
the sending rate of the information source by sending the jamming signal.

Full duplex mode: flow control adopts the IEEE 802.3X standard. The Rx device sends
the PAUSE frame to the information source to pause the sending of signals.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Raisecom Technology Co., Ltd.

133

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Examples
This example shows how to enable flow control on GE electrical interface 1.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# flow-control on
Set successfully

Related commands
show interface(GF optical interface configuration)

5.2.4 interface ge
Function
To enter the specified GE electrical interface configuration mode, use this command.

Format
interface ge interface-number

Parameter
Parameter
interface-number

Description
GE electrical interface number, an integer, ranging from 1 to 3

Default conditions
N/A

Command mode
Remote configuration/Global configuration/GE electrical interface configuration

Usage guideline
N/A

Examples
This example shows how to enter GE electrical interface 1 configuration mode.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)#

Related commands
N/A

Raisecom Technology Co., Ltd.

134

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

5.2.5 show interface (GE electrical interface configuration mode)


Function
To show configurations of the GE electrical interface, use this command.

Format
show interface

Parameter
N/A

Default conditions
N/A

Command mode
GE electrical interface configuration

Usage guideline
N/A

Examples
This example shows how to show configurations of GE electrical interface 1.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# show interface
Interface ID :1
Descr :ge interface 1
Interface type :electrical, 1000M
Port enable(command) :enable
Port enable status :enable
Autonego config :enable
Autonego status :enable
Duplex config :full-duplex
Duplex status :full-duplex
Speed config :1000M
Speed status :1000M
Flow control config:on
Flow control status:on
Link :linkdown

The following table lists fields displayed in previous command lines.


Field
Interface ID

Description
Interface ID

Raisecom Technology Co., Ltd.

135

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field

Description

Descr

Interface description

Interface type

Interface type

Port enable(command)

Configurations to enable the interface (CLI)

Port enable status

Enabling status of the interface

Autonego config

Auto-negotiation configuration

Autonego status

Auto-negotiation status

Duplex config

Duplex mode configuration

Duplex status

Duplex mode status

Speed config

Rate configuration

Speed status

Rate status

Flow control config

Flow control configuration

Flow control status

Flow control status

Link

Link status

Related commands
N/A

5.2.6 show statistic (GE electrical interface configuration mode)


Function
To show statistics of the GE electrical interface, use this command.

Format
show statistic

Parameter
N/A

Default conditions
N/A

Command mode
GE electrical interface configuration

Raisecom Technology Co., Ltd.

136

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Usage guideline
N/A

Examples
This example shows how to show statistics of GE electrical interface 1.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# show statistic
Interface ID :1
Descr :ge interface 1
OutOctets :0
OutPkts :0
OutErrors :0
OutUcastPkts :0
OutBroadcastPkts :0
OutMulticastPkts :0
InOctets :0
InPkts :0
InDiscards :0
InErrors :0
InUcastPkts :0
InBroadcastPkts :0
InMulticastPkts :0

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

Descr

Interface description

OutOctets

Number of Tx bytes

OutPkts

Number of Tx packets

OutErrors

Number of Tx wrong packets

OutUcastPkts

Number of Tx unicast packets

OutBroadcastPkts

Number of Tx broadcast packets

OutMulticastPkts

Number of Tx multicast packets

InOctets

Number of Rx bytes

InPkts

Number of Rx packets

InDiscards

Number of Rx discarded packets

InErrors

Number of Rx wrong packets

InUcastPkts

Number of Rx unicast packets

InBroadcastPkts

Number of Rx broadcast packets

InMulticastPkts

Number of Rx multicast packets


Raisecom Technology Co., Ltd.

137

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Related commands
N/A

5.2.7 shutdown
Function
To shut down the GE electrical interface, use this command. To enable the GE electrical
interface, use the no form of this command.

Format
shutdown
no shutdown

Parameter
N/A

Default conditions
The GE electrical interface is enabled.

Command mode
GE electrical interface configuration

Usage guideline
Scenario
You can use this command to enable or disable the GE electrical interface.
Interfaces on the RCMS2903-4E1-4GE should be shut down in situations as below:

The interface is idle for a long time. Shut down the interface to prevent other
interference.

Some parameters of the interface are modified. Shut down the interface and enable it
again to make the parameters to take effect.

The RCMS2903-4E1-4GE needs to block data from the interface.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Raisecom Technology Co., Ltd.

138

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Examples
This example shows how to shut down GE electrical interface 1.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# shutdown
Set successfully

Related commands
show interface(GF optical interface configuration)

5.2.8 speed(GE electrical interface configuration mode)


Function
To configure the rate and duplex mode of the GE electrical interface, use this command.

Format
speed { 10 | 100 | 1000 } duplex { full-duplex | half-duplex }

Parameter
Parameter

Description

10

Configure the rate of the GE electrical interface to 10 Mbit/s

100

Configure the rate of the GE electrical interface to 100 Mbit/s

1000

Configure the rate of the GE electrical interface to 1000 Mbit/s

full-duplex

Configure the duplex mode of the GE electrical interface to full duplex

half-duplex

Configure the duplex mode of the GE electrical interface to half duplex

Default conditions
The GE electrical interface is in auto-negotiation mode. When auto-negotiation is disabled,
the rate is 1000 Mbit/s and the duplex mode is full duplex by default.

Command mode
GE electrical interface configuration

Usage guideline
Scenario
You can use this command to configure the rate and duplex mode of the Ethernet interface.
Prerequisite

Raisecom Technology Co., Ltd.

139

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Only after auto-negotiation is disabled, you can use this command to configure the rate and
duplex mode of the GE electrical interface. You can use the no autonegotiate command to
disable auto-negotiation of the interface.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the rate and duplex mode of GE electrical interface 1 to
100 Mbit/s and full duplex mode respectively.
Raisecom# config
Raisecom(config)# interface ge 1
Raisecom(config-ge/0/1)# no autonegotiate
Set successfully
Raisecom(config-ge/0/1)# speed 100 duplex full-duplex
Set successfully

Related commands
show interface(GE electrical interface configuration)

5.2.9 show esw


Function
To show configurations and status of the switching interface, use this command.

Format
show esw

Parameter
N/A

Default conditions
N/A

Command mode
Switching interface configuration

Usage guideline
N/A

Raisecom Technology Co., Ltd.

140

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Examples
This example shows how to show configurations and status of switching interface 1.
Raisecom# config
Raisecom(config)# interface switchport 1
Raisecom(config-esw/0/1)# show esw
Interface ID: 1
PVID config: 2
PVID status: 2
tag mode config: untag
tag mode status: untag
default cos config: 0
default cos status: 0
storm-control type config: broadcast
storm-control type status: broadcast
storm-control rate config is: 64
storm-control rate status is: 64
rate-limit egress config is: none
rate-limit ingress config is: none
rate-limit egress status is: none
rate-limit ingress status is: none

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

PVID config

PVID configuration

PVID status

PVID status

tag mode config

Tag mode configuration

tag mode status

Tag mode status

default cos config

Default CoS configuration

default cos status

Default CoS status

storm-control type config

Storm control type configuration

storm-control type status

Storm control type status

storm-control rate config

Storm control rate configuration

storm-control rate status

Storm control rate status

rate-limit egress config

Egress rate limiting configuration

rate-limit ingress config

Ingress rate limiting configuration

rate-limit egress status

Egress rate limiting status

rate-limit ingress status

Ingress rate limiting status

Related commands
N/A
Raisecom Technology Co., Ltd.

141

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

5.3 GF optical interface commands


5.3.1 clear statistic (GF optical interface configuration mode)
Function
To clear statistics of the GF optical interface, use this command.

Format
clear statistic

Parameter
N/A

Default conditions
N/A

Command mode
GF optical interface configuration

Usage guideline
Scenario
You can use this command to clear statistics of the GF optical interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Cleared statistics cannot be recovered.

Examples
This example shows how to clear statistics of GF optical interface 1.
Raisecom# config
Raisecom(config)# interface fx-ge 1
Raisecom(config-fx-ge/0/1)# clear statistic
Set successfully

Related commands
show statistic(GF optical interface configuration)

Raisecom Technology Co., Ltd.

142

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

5.3.2 flow-control on (GF optical interface configuration mode)


Function
To configure flow control on the GF optical interface, use this command.

Format
flow-control { on | off }

Parameter
Parameter

Description

on

Enable flow control.

off

Disable flow control.

Default conditions
Flow control on the GF optical interface is enabled.

Command mode
GF optical interface configuration

Usage guideline
Scenario
Flow control is used to prevent LOF when the interface is blocked. When Tx or Rx buffer is
overflowed, flow control blocks signals to send to the source address. In this case, it prevents
too excessive data flow from congesting the network.

Half duplex mode: flow control adopts the back pressure technology, which slows down
the sending rate of the information source by sending the jamming signal.

Full duplex mode: flow control adopts the IEEE 802.3X standard. The Rx device sends
the PAUSE frame to the information source to pause the sending of signals.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable flow control on GF optical interface 1.
Raisecom# config

Raisecom Technology Co., Ltd.

143

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Raisecom(config)# interface fx-ge 1


Raisecom(config-fx-ge/0/1)# flow-control on
Set successfully

Related commands
show interface(GF optical interface configuration)

5.3.3 interface fx-ge


Function
To enter GF optical interface configuration mode, that is, Ethernet uplink optical interface
configuration mode, use this command.

Format
interface fx-ge interface-number

Parameter
Parameter
interface-number

Description
GF optical interface number, an integer, the value of which is 1

Default conditions
N/A

Command mode
Remote configuration/Global configuration/GF optical interface configuration

Usage guideline
N/A

Examples
This example shows how to enter GF optical interface configuration mode.
Raisecom# config
Raisecom(config)# interface fx-ge 1
Raisecom(config-fx-ge/0/1)#

Related commands
N/A

Raisecom Technology Co., Ltd.

144

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

5.3.4 show interface (GF optical interface configuration mode)


Function
To show configurations of the GF optical interface, use this command.

Format
show interface

Parameter
N/A

Default conditions
N/A

Command mode
GF optical interface configuration

Usage guideline
N/A

Examples
This example shows how to show configurations of GF optical interface 1.
Raisecom# config
Raisecom(config)# interface fx-ge 1
Raisecom(config-fx-ge/0/1)# show interface
Interface ID :1
Descr :fx-ge interface 1
Interface type :optical, 1000M
Flow control config:on
Flow control status:on
Link :linkup

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

Descr

Interface description

Interface type

Interface type

Flow control config

Flow control configuration

Flow control status

Flow control

on: flow control is enabled.


off: flow control is disabled.

Raisecom Technology Co., Ltd.

145

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field
Link

Description
Link status

Related commands
N/A

5.3.5 show statistic (GF optical interface configuration mode)


Function
To show statistics of the GF optical interface, use this command.

Format
show statistic

Parameter
N/A

Default conditions
N/A

Command mode
GF optical interface configuration

Usage guideline
N/A

Examples
This example shows how to show statistics of GF optical interface 1.
Raisecom# config
Raisecom(config)# interface fx-ge 1
Raisecom(config-fx-ge/0/1)# show statistic
Interface ID :1
Descr :fx-ge interface 1
OutOctets :128
OutPkts :2
OutErrors :0
OutUcastPkts :0
OutBroadcastPkts :2
OutMulticastPkts :0
InOctets :0
InPkts :0
InDiscards :0
InErrors :0

Raisecom Technology Co., Ltd.

146

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

InUcastPkts :0
InBroadcastPkts :0
InMulticastPkts :0

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

Descr

Interface description

OutOctets

Number of Tx bytes

OutPkts

Number of Tx packets

OutErrors

Number of Tx wrong packets

OutUcastPkts

Number of Tx unicast packets

OutBroadcastPkts

Number of Tx broadcast packets

OutMulticastPkts

Number of Tx multicast packets

InOctets

Number of Rx bytes

InPkts

Number of Rx packets

InDiscards

Number of Rx discarded packets

InErrors

Number of Rx wrong packets

InUcastPkts

Number of Rx unicast packets

InBroadcastPkts

Number of Rx broadcast packets

InMulticastPkts

Number of Rx multicast packets

Related commands
N/A

5.4 E1 interface commands


5.4.1 alarm-mask all
Function
To mask all alarms on the current E1 interface, use this command. To restore default
configurations, use the no form of this command.

Format
alarm-mask all
no alarm-mask all
Raisecom Technology Co., Ltd.

147

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Parameter
N/A

Default conditions
Alarm masking is disabled on the E1 interface.

Command mode
E1 interface configuration

Usage guideline
Scenario
You can use this command to mask all alarms on the current E1 interface. After alarm
masking is enabled, alarms generated on the E1 interface will not reported to the network
management server.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to mask all alarms on E1 interface 2.
Raisecom# config
Raisecom(config)# interface e1 2
Raisecom(config-e1/0/2)# alarm-mask all
Set successfully

Related commands
show interface(E1 interface configuration mode)

5.4.2 bert
Function
To enable BERT for the E1 channel, use this command. To disable this function, use the no
form of this command.

Format
bert { line | client }

Raisecom Technology Co., Ltd.

148

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

no bert

Parameter
Parameter

Description

line

Enable BERT on the line end.

client

Enable BERT on the user end.

Default conditions
BERT is disabled.

Command mode
E1 interface configuration

Usage guideline
Scenario
You perform online BERT for the E1 interface by using the built-in BERT.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
You can enable BERT on only one way of E1 channel at a time. When you need to enable
BERT on another E1 channel, you should disable BERT on this E1 channel.

Examples
This example shows how to enable BERT on No.1 E1 channel.
Raisecom# config
Raisecom(config)# interface e1 1
Raisecom(config-e1/0/1)# bert line
Set successfully

Related commands
show interface(E1 interface configuration mode)

5.4.3 clear statistic (E1 interface configuration mode)


Function
To clear statistics of the E1 interface, use this command.

Raisecom Technology Co., Ltd.

149

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Format
clear statistic

Parameter
N/A

Default conditions
N/A

Command mode
E1 interface configuration

Usage guideline
Scenario
You can use this command to clear statistics of the E1 interface.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Cleared statistics cannot be recovered.

Examples
This example shows how to clear statistics of E1 interface 1.
Raisecom# config
Raisecom(config)# interface e1 1
Raisecom(config-e1/0/1)# clear statistic
Set successfully

Related commands
show interface(E1 interface configuration mode)

5.4.4 interface e1
Function
To enter the specified E1 interface configuration mode, use this command.

Raisecom Technology Co., Ltd.

150

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Format
interface e1 interface-number

Parameter
Parameter
interface-number

Description
E1 interface number, an integer, ranging from 1 to 4

Default conditions
N/A

Command mode
Remote configuration/Global configuration/E1 interface configuration

Usage guideline
N/A

Examples
This example shows how to enter E1 interface 2 configuration mode.
Raisecom# config
Raisecom(config)# interface e1 2
Raisecom(config-e1/0/2)#

Related commands
N/A

5.4.5 loopback
Function
To enable E1 loopback, and specify the loopback type and hold time, use this command. To
disable E1 loopback, use the no form of this command.

Format
loopback { external | internal | bidirection | remote-internal } [ hold-time minute ]
no loopback

Parameter
Parameter
external

Description
Local external loopback

Raisecom Technology Co., Ltd.

151

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

Parameter

5 Interface management

Description

internal

Local internal loopback

bidirection

Bidirectional loopback

remote-internal

Remote internal loopback

hold-time minute

Hold time of loopback, an integer, ranging from 1 to 65535, in unit


of minute
If the minute parameter is not configured, loopback will not be
disabled automatically.

Default conditions
Loopback is disabled.

Command mode
E1 interface configuration

Usage guideline
Scenario
Loopback detection is a common method to test and analyse interface and line problems.

Local internal loopback: signals sent by the Tx of an interface are received by the Rx of
the same interface. You can know the working status of the interface by checking the
sending and receiving of data.

Local external loopback: the interface sends signals sent by the peer to the Rx of the peer
to form a detection loop. It is mainly used for checking the line status.

Local bidirectional loopback: local internal loopback and local external loopback is
enabled at the same time.

Remote internal loopback: the interface sends signals to the peer, and then the peer sends
the received signals to the local, thus forming a detection loop.

Figure 5-1 and Figure 5-2 show local bidirectional loopback and remote internal loopback.
Figure 5-1 Local bidirectional loopback

Raisecom Technology Co., Ltd.

152

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Figure 5-2 Remote internal loopback

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable local internal loopback on E1 interface 1 and configure
the hold time to 2min.
Raisecom# config
Raisecom(config)# interface e1 1
Raisecom(config-e1/0/1)# loopback internal hold-time 2
Set successfully

Related commands
show interface (E1 interface configuration mode)

5.4.6 show interface (E1 interface configuration mode)


Function
To show configurations and status of the E1 interface, use this command.

Format
show interface

Parameter
N/A

Default conditions
N/A

Raisecom Technology Co., Ltd.

153

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Command mode
E1 interface configuration

Usage guideline
N/A

Examples
This example shows how to show configurations and status of the E1 interface.
Raisecom# config
Raisecom(config-e1/0/1)# show interface
Interface ID: 1
Interface Descr: e1-1
Interface type: unbalance
LoopbackConfig config: no Loopback
LoopbackConfig status: no Loopback
Alarm mask config: none
Alarm mask status: none
Frame mode config: unframed
Frame mode status: unframed
LineStatus: noAlarm
Remote E1 LineStatus: noAlarm
Bert config: disable
Bert status: disable
Bert errored seconds: 0
Bert severely errored seconds: 0
CV Statistic is 0

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

Interface Descr

Interface description

Interface type

Interface type

LoopbackConfig config

Loopback configuration

LoopbackConfig status

Loopback status

Alarm mask config

Alarm masking configuration

Alarm mask status

Alarm masking status

Frame mode config

Frame mode configuration

Frame mode status

Frame mode status

LineStatus

Line status

Bert config

BERT configuration

Bert status

BERT status

Raisecom Technology Co., Ltd.

154

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field

Description

Bert errored seconds

BERT errored second

Bert severely errored seconds

Severely errored second

CV Statistic

CV statistics

Related commands
N/A

5.4.7 show loopback


Function
To show loopback information about the E1 interface, use this command.

Format
show loopback

Parameter
N/A

Default conditions
N/A

Command mode
E1 interface configuration

Usage guideline
N/A

Examples
This example shows how to show loopback information about the E1 interface.
Raisecom# config
Raisecom(config)# interface e1 1
Raisecom(config-e1/0/1)# show loopback
loopback config : local externalLoop
loopback config Status: local externalLoop
loopback auto remove setting time: 2
loopback auto remove remain time: 116
loopback auto remove: enable

The following table lists fields displayed in previous command lines.

Raisecom Technology Co., Ltd.

155

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field

Description

loopback config

Loopback configuration

loopback config Status

Loopback status

loopback auto remove setting time

Loopback auto-recovery interval

loopback auto remove remain time

Loopback auto-recovery remaining time

loopback auto remove

Loopback auto-recovery feature

Related commands
N/A

5.5 PDH optical interface commands


5.5.1 interface pdh-opt
Function
To enter PDH optical interface configuration mode, use this command.

Format
interface pdh-opt interface-number

Parameter
Parameter
interface-number

Description
PDH optical interface number, an integer, the value of which is 1

Default conditions
N/A

Command mode
Remote configuration/Global configuration/PDH optical interface configuration

Usage guideline
N/A

Examples
This example shows how to enter PDH optical interface configuration mode.
Raisecom# config

Raisecom Technology Co., Ltd.

156

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Raisecom(config)# interface pdh-opt 1


Raisecom(config-pdh-opt/0/1)#

Related commands
N/A

5.5.2 show interface (PDH optical interface configuration mode)


Function
To show information about the PDH optical interface, use this command.

Format
show interface

Parameter
N/A

Default conditions
N/A

Command mode
PDH optical interface configuration

Usage guideline
N/A

Examples
This example shows how to show information about the PDH optical interface.
Raisecom# config
Raisecom(config)# interface pdh-opt 1
Raisecom(config-pdh-opt/0/1)# show interface
Interface ID : 1
Optical port 1 description: PDH 1
Optical module 1 type: none
Optical port 1 enable: enable
Optical port 1 Alarm status:
LOS - OFF
LOF - OFF
E-3 - OFF
E-6 - OFF
R-LOS - OFF
R-LOF - OFF
Remote power down alarm: normal

Raisecom Technology Co., Ltd.

157

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

The following table lists fields displayed in previous command lines.


Field

Description

Interface ID

Interface ID

Optical port 1 description

Description of optical interface 1

Optical module 1 type

Type of optical module 1

Optical port 1 enable

Enabling optical interface 1

Optical port 1 Alarm status

Alarm status of optical interface 1

LOS

Loss of signal alarm

LOF

Loss of frame alarm

E-3

Error rate exceeding 1e-3 alarm

E-6

Error rate exceeding 1e-6 alarm

R-LOS

LOS alarm on remote device

R-LOF

LOF alarm on remote device

Remote power down alarm

Remote Dying-Gasp alarm

Related commands
N/A

5.6 SFP optical interface commands


5.6.1 interface sfp pdh-opt
Function
To enter PDH SFP optical interface configuration mode, use this command.

Format
interface sfp pdh-opt sfp-number

Parameter
Parameter
sfp-number

Description
PDH SFP optical interface number, an integer, the value of which is 1

Default conditions
N/A

Raisecom Technology Co., Ltd.

158

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Command mode
Remote configuration/Global configuration/PDH SFP optical interface configuration

Usage guideline
N/A

Examples
This example shows how to enter PDH SFP optical interface configuration.
Raisecom# config
Raisecom(config)# interface sfp pdh-opt 1
Raisecom(config-sfp-pdh-opt/0/1)#

Related commands
N/A

5.6.2 sfp-switch on
Function
To enable the PDH SFP optical interface, use this command. To disable the PDH SFP optical
interface, use the off form of this command.

Format
sfp-switch { on | off }

Parameter
Parameter

Description

on

Enable the PDH SFP optical interface.

off

Disable the PDH SFP optical interface.

Default conditions
The SFP optical interface is enabled.

Command mode
PDH SFP optical interface configuration

Usage guideline
Scenario
You can use this command to enable or disable the PDH SFP optical interface. When the PDH
SFP optical interface is disabled, the SFP module will stop working.
Raisecom Technology Co., Ltd.

159

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
This command is not supported in remote network management mode. This command is
supported when the device is managed through the Console interface only.

Examples
This example shows how to disable the PDH SFP optical interface.
Raisecom# config
Raisecom(config-sfp-pdh-opt/0/1)# sfp-switch off
Set successfully

Related commands
show interface(PDH SFP optical interface configuration)

5.6.3 show history-statistic-interval


Function
To show history statistics of the PDH SFP optical interface, use this command.

Format
show history-statistic-interval { all | interval }

Parameter
Parameter

Description

all

All history statistics within 15min

interval

History statistics number, an integer, ranging from 1 to 96

Default conditions
N/A

Command mode
PDH SFP optical interface configuration

Usage guideline
N/A

Raisecom Technology Co., Ltd.

160

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Examples
This example shows how to show information about SFP optical interface 1.
Raisecom# config
Raisecom(config)# interface sfp pdh-opt 1
Raisecom(config-sfp-pdh-opt/0/1)# show history-statistic-interval all
0 statistics interval exist by now!

Related commands
N/A

5.6.4 show statistic-current


Function
To show statistics of the PDH SFP optical interface within 15min, use this command.

Format
show statistic-current

Parameter
N/A

Default conditions
N/A

Command mode
PDH SFP optical interface configuration

Usage guideline
N/A

Examples
This example shows how to show information about the SFP optical interface 1.
Raisecom# config
Raisecom(config)# interface sfp pdh-opt 1
Raisecom(config-sfp-pdh-opt/0/1)# show statistic-current
Interface ID :1
Transceiver Temperature :17.3 C
Supply voltage :3.286 V
TX bias current :33.5 mA
TX optical power :-1.5 dBm
RX optical power :-26.7 dBm

The following table lists fields displayed in previous command lines.


Raisecom Technology Co., Ltd.

161

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field

Description

Interface ID

Interface ID

Transceiver Temperature

Temperature of optical module

Supply voltage

Supply voltage

TX bias current

Laser bias current

TX optical power

Tx optical power

RX optical power

Rx optical power

Related commands
N/A

5.6.5 show interface (PDH SFP optical interface configuration mode)


Function
To show information about the PDH SFP optical interface, use this command.

Format
show interface

Parameter
N/A

Default conditions
N/A

Command mode
PDH SFP optical interface configuration

Usage guideline
N/A

Examples
This example shows how to show information about the PDH SFP optical interface.
Raisecom# config
Raisecom(config)# interface sfp pdh-opt 1
Raisecom(config-sfp-pdh-opt/0/1)# show interface
Present Status :Present
TX-DISABLE :Enable
LOS :Alarm

Raisecom Technology Co., Ltd.

162

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

TX-FAULT :Normal
Media type :Single Mode Fiber
Module type :sfp
Connector type :LC
Nominal bitrate :1.25G bps
Transmission Distance :15 Km
Wavelength :1310 nm
Vendor name :Raisecom
Vendor PN :USFP-Gb/S1-D-01R
Vendor rev :
Vendor SN :MA12190490221
DDMI :Externally calibrated
Transceiver Temperature :44.4 C
Supply voltage :3.306 V
TX bias current :18.9 mA
TX optical power :-5.7 dBm
RX optical power :-60.0 dBm
DDM Alarm status:
Temp High Alarm - Normal
Temp Low Alarm - Normal
Voltage High Alarm - Normal
Voltage Low Alarm - Normal
Bias High Alarm - Normal
Bias Low Alarm - Normal
TX Power High Alarm - Normal
TX Power Low Alarm - Normal
RX Power High Alarm - Normal
RX Power Low Alarm - Alarm
DDM Warning status:
Temp High Warning - Normal
Temp Low Warning - Normal
Voltage High Warning - Normal
Voltage Low Warning - Normal
Bias High Warning - Normal
Bias Low Warning - Normal
TX Power High Warning - Normal
TX Power Low Warning - Normal
RX Power High Warning - Normal
RX Power Low Warning - Warning

The following table lists fields displayed in previous command lines.


Field

Description

Present Status

SFP present status

TX-DISABLE

Laser control

LOS

Loss of signal alarm

TX-FAULT

Laser Tx fault

Media type

Transmission media

Module type

Module type
Raisecom Technology Co., Ltd.

163

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field

Description

Connector type

Connector type

Transmission Distance

Transmission distance

Wavelength

Wavelength

Vendor name

Vendor name

Vendor PN

Optical module model

Vendor rev

Version

Vendor SN

Serial number

DDMI

DDM

Transceiver Temperature

Temperature of optical module

Supply voltage

Supply voltage

TX bias current

Laser bias current

TX optical power

Tx optical power

RX optical power

Rx optical power

DDM Alarm status

DDM alarm status

Temp High Alarm

High temperature alarm of optical


module

Temp Low Alarm

Low temperature alarm of optical


module

Voltage High Alarm

High voltage alarm

Voltage Low Alarm

Low voltage alarm

Bias High Alarm

High laser bias current alarm

Bias Low Alarm

Low laser bias current alarm

TX Power High Alarm

High Tx optical power alarm

TX Power Low Alarm

Low Tx optical power alarm

RX Power High Alarm

High Rx optical power alarm

RX Power Low Alarm

Low Rx optical power alarm

DDM Warning status

DDM warning status

Temp High Warning

High temperature warning of optical


module

Temp Low Warning

Low temperature warning of optical


module

Voltage High Warning

High voltage warning

Voltage Low Warning

Low voltage warning

Raisecom Technology Co., Ltd.

164

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

5 Interface management

Field

Description

Bias High Warning

High laser bias current warning

Bias Low Warning

Low laser bias current warning

TX Power High Warning

High Tx optical power warning

TX Power Low Warning

Low Tx optical power warning

RX Power High Warning

High Rx optical power warning

RX Power Low Warning

Low Rx optical power warning

Related commands
N/A

Raisecom Technology Co., Ltd.

165

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Alarm management

6.1.1 alarm
Function
To enter alarm configuration mode, use this command.

Format
alarm

Parameter
N/A

Default conditions
N/A

Command mode
Global configuration

Usage guideline
N/A

Examples
This example shows how to enter alarm configuration mode from global configuration mode.
Raisecom# config
Raisecom(config)# alarm
alarm mode, one command input per times. End with CTRL-Z.
Raisecom(config-alarm)#

Related commands
N/A

Raisecom Technology Co., Ltd.

166

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

6.1.2 alarm active delay


Function
To configure alarm delay, use this command.

Format
alarm active delay second

Parameter
Parameter

Description

second

Alarm delay, an integer, ranging from 5 to 6000, in unit of second

Default conditions
The alarm delay is 5s.

Command mode
Alarm configuration

Usage guideline
Scenario
Alarm delay refers that the RCMS2903-4E1-4GE will record alarms and report them to the
NMS after a delay when alarms are generated; similarly, the RCMS2903-4E1-4GE will clear
alarms and report them to the NMS after a delay when alarms are recovered. Delays for
recording/clearing and reporting alarms to the NMS are identical.
Alarm delay can be divided into the following two types:

Alarm generation delay refers to the time interval to be delayed for the generation time
of an alarm.

Alarm recovery delay refers to the time interval to be delayed for the clearing time of an
alarm when the alarm is recovered.

Prerequisite
You can use the alarm delay enable command to enable alarm delay.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the alarm generation delay to 32s.
Raisecom Technology Co., Ltd.

167

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm active delay 32
Set successfully

Related commands
show alarm config

6.1.3 alarm active storage-mode


Function
To configure the storage mode for the current alarm table, use this command.

Format
alarm active storage-mode { loop | stop }

Parameter
Parameter

Description

loop

Specify the alarm storage mode to loop.

stop

Specify the alarm storage mode to stop.

Default conditions
The alarm storage mode is set to loop.

Command mode
Alarm configuration

Usage guideline
Scenario
The alarm storage mode refers how to save alarm data by the register of the RCMS2903-4E14GE. There are two modes:

stop: when the alarm register is full, newl alarms will be discarded.

loop: when the alarm register is full, newl alarms will override the previous ones and
alarms will be saved from the initial address of the register.

Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Raisecom Technology Co., Ltd.

168

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

N/A

Examples
This example shows how to configure the alarm storage mode to stop.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm active storage-mode stop
Set successfully

Related commands
show alarm config

6.1.4 alarm auto-report enable


Function
To enable alarm auto-report, use this command. To disable this function, use the disable form
of this command.

Format
alarm auto-report { enable | disable} index index
alarm auto-report { enable | disable} 0 [ device1-id ] [ module_name interface-number ]
[ index index ]

Parameter
Parameter

Description

enable

Enable alarm auto-report.

disable

Disable alarm auto-report.

device1-id

ID of the first-hop device, an integer, ranging from 1 to 255

module_name

Module name, depending on the device

interface-number

Interface number, an integer, depending on the device

index index

Alarm index, starting from 0x, in hexadecimal notation

Default conditions
Alarm auto-report is enabled.

Command mode
Alarm configuration

Raisecom Technology Co., Ltd.

169

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Usage guideline
Scenario
Auto-report refers that an alarm is reported to the NMS automatically with its generation and
you do not need to initiate inquiries or synchronization.
Prerequisite
You can use the show alarmindex command to show the alarm index.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable alarm auto-report on the RCMS2903-4E1-4GE.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm auto-report enable 0
Set successfully

This example shows how to enable alarm auto-report of the 0x50072a02 type on E1 interface
1.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm auto-report enable 1 e1 1 index 0x50072a02
Set successfully

Related commands
show alarm auto-report config
show alarmindex

6.1.5 alarm auto-save


Function
To configure alarm auto-save, use this command. To restore default configurations, use the no
form of this command.

Format
alarm auto-save
no alarm auto-save

Parameter
N/A
Raisecom Technology Co., Ltd.

170

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Default conditions
Alarm auto-save is not configured.

Command mode
Alarm configuration

Usage guideline
Scenario
You can use this command to configure alarm auto-save. When you do not need to save
alarms automatically, you can use the no form of this command to disable alarm auto-save.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
Alarm auto-save is a periodical saving. If the RCMS2903-4E1-4GE right after the alarm
configuration is modified, the configuration may not be saved. In this case, you can use the
write command to save the configuration.

Examples
This example shows how to configure alarm auto-save.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm auto-save
Set successfully.

Related commands
show alarm config

6.1.6 alarm clear


Function
To clear the current alarm table or a specified alarm, use this command.

Format
alarm clear { all | index index }

Raisecom Technology Co., Ltd.

171

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Parameter
Parameter

Description

all

Clear the current alarm table.

index index

Clear a specified alarm in the current alarm table.


index refers to the alarm index.

Default conditions
N/A

Command mode
Alarm configuration

Usage guideline
Scenario
You can clear the current alarm when you are sure that the alarm is inconsistent with the
actual situation. Otherwise, you should use related commands of alarm masking. Deleting the
current alarm table by mistake will cause abnormal alarm status, so we do not recommend
using this command frequently.
Prerequisite
You can use the show alarmindex command to show the alarm index.
Follow-up procedure
N/A
Precaution
Using this command will delete the current alarm.

Examples
This example shows how to clear all alarms in the current alarm table.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm clear all
Set successfully

Related commands
show alarm cleared

Raisecom Technology Co., Ltd.

172

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

6.1.7 alarm clear delay


Function
To configure alarm recovery delay, use this command. After alarm recovery delay is enabled,
the RCMS2903-4E1-4GE will clear alarms after a delay when alarms are recovered. Alarm
recovery delay can avoid clearing alarms by mistake.

Format
alarm clear delay second

Parameter
Parameter
second

Description
Alarm recovery delay, an integer, ranging from 5 to 600, in unit of second

Default conditions
The alarm recovery delay is 5s.

Command mode
Alarm configuration

Usage guideline
Scenario
Alarm delay refers that the RCMS2903-4E1-4GE will record alarms and report them to the
NMS after a delay when alarms are generated; similarly, the RCMS2903-4E1-4GE will clear
alarms and report them to the NMS after a delay when alarms are recovered. Delays for
recording/clearing and reporting alarms to the NMS are identical.
Alarm delay can be divided into the following two types:

Alarm generation delay refers to the time interval to be delayed for the generation time
of an alarm.

Alarm recovery delay refers to the time interval to be delayed for the clearing time of an
alarm when the alarm is recovered.

Prerequisite
You can use the alarm delay enable command to enable alarm delay.
Follow-up procedure
N/A
Precaution
N/A

Raisecom Technology Co., Ltd.

173

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Examples
This example shows how to configure the alarm recovery delay to 32s.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm clear delay 32
Set successfully

Related commands
show alarm config

6.1.8 alarm delay enable


Function
To enable alarm delay, use this command. To disable this function, use this disable form of
this command.

Format
alarm delay { enable | disable }

Parameter
Parameter

Description

enable

Enable alarm delay.

disable

Disable alarm delay.

Default conditions
Alarm delay is disabled.

Command mode
Alarm configuration

Usage guideline
Scenario
Alarm delay refers that the RCMS2903-4E1-4GE will record alarms and report them to the
NMS after a delay when alarms are generated. Delays for recording and reporting alarms to
the NMS are identical.
Prerequisite
N/A
Follow-up procedure
N/A
Raisecom Technology Co., Ltd.

174

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Precaution
N/A

Examples
This example shows how to enable alarm delay.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm delay enable
Set successfully.

Related commands
show alarm config

6.1.9 alarm inhibit enable


Function
To enable alarm inhibition, use this command. To disable this function, use the disable form
of this command.

Format
alarm inhibit { enable | disable }

Parameter
Parameter

Description

enable

Enable alarm inhibition.

disable

Disable alarm inhibition.

Default conditions
Alarm inhibition is enabled.

Command mode
Alarm configuration

Usage guideline
Scenario
When alarm inhibition is enabled, the RCMS2903-4E1-4GE records the root alarm only but
not attached alarms. For example, alarm B is caused by alarm A. When alarm inhibition is
enabled, alarm B is inhibited and cannot be saved to the alarm buffer or log buffer. By
enabling alarm inhibition, you can effectively reduce the number of alarms.

Raisecom Technology Co., Ltd.

175

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

When alarm inhibition is disabled, both the root alarm and attached alarms are saved on the
RCMS2903-4E1-4GE.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable alarm inhibition.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm inhibit enable
Set successfully

Related commands
show alarm config

6.1.10 alarm inverse enable


Function
To enable alarm inverse, use this command. To disable this function, use the disable form of
this command.

Format
alarm inverse { enable | disable} 0 [ device-id ] { all | module_name interface-number }

Parameter
Parameter

Description

enable

Enable alarm inverse.

disable

Disable alarm inverse.

device-id

ID of the first-hop device, an integer, ranging from 1 to 255

module_name

Module name, depending on the device

interface-number

Interface number, an integer, depending on the device

Default conditions
N/A

Raisecom Technology Co., Ltd.

176

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Command mode
Alarm configuration

Usage guideline
Scenario
You can enable or disable alarm inverse according to the actual performance modules.
Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to enable alarm inverse on E1 interface 1 in slot 10.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm inverse enable 10 e1 1
Set successfully

Related commands
show alarm inverse config

6.1.11 alarm inverse-mode


Function
To configure alarm inverse modes, use this command.

Format
alarm inverse-mode { auto | manual | none }

Parameter
Parameter

Description

auto

Automatic recovery mode

manual

Manual recovery mode

none

Non-inverse mode

Raisecom Technology Co., Ltd.

177

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Default conditions
The alarm inverse mode is set to auto.

Command mode
Alarm configuration

Usage guideline
Scenario
The alarm inverse mode can be divided into:

Automatic recovery mode: when you enable alarm inverse on a specified interface, the
configuration fails although the command line returns successfully, if there is not the
highest level of alarm (emergency) on the current interface. If there is some highest level
of alarm (emergency) on the current interface, alarm inverse is enabled.

Manual recovery mode: when you enable alarm inverse on a specified interface, the
alarm status reported by the interface is inverse to the actual situation. When you disable
alarm inverse on a specified interface, the alarm status reported by the interface is
consistent with the actual situation.

Non-inverse mode: in this mode, you can configure to enable alarm inverse on a
specified interface, but the configuration will not take effect until the alarm inverse mode
changes.

The RCMS2903-4E1-4GE reports alarms as usual.


Prerequisite
N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the alarm inverse mode to automatic recovery mode.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm inverse-mode auto
Set successfully

Related commands
show alarm config

Raisecom Technology Co., Ltd.

178

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

6.1.12 alarm monitor enable


Function
To enable alarm monitoring, use this command. To disable this function, use the disable form
of this command.

Format
alarm monitor { enable | disable} 0 [ device-id ] ] [ module_name interface-number ]
[ index index ]

Parameter
Parameter

Description

index index

Alarm index, starting from 0x, in hexadecimal notation

enable

Enable alarm monitoring.

disable

Disable alarm monitoring.

device-id

ID of the first-hop device, an integer, ranging from 1 to 255

module_name

Module name, depending on the device

interface-number

Interface number, an integer, depending on the device

Default conditions
Alarm monitoring is enabled.

Command mode
Alarm configuration

Usage guideline
Scenario
Alarm monitoring processes alarms generated by modules:

When alarm monitoring is enabled, the alarm module receives alarms generated by other
modules and then processes them based on configurations, such as saving them to the
alarm buffer or the system log.

When alarm monitoring is disabled, the alarm module discards alarms generated by
other modules. These alarms are not saved on the RCMS2903-4E1-4GE.

Alarm monitoring can be enabled on some module, interface, or the module on a specified
interface.
Prerequisite
You can use the show alarmindex command to show the alarm index.
Follow-up procedure
Raisecom Technology Co., Ltd.

179

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

N/A
Precaution
N/A

Examples
This example shows how to enable alarm monitoring.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm monitor index
Set successfully

Related commands
show alarm monitor config
show alarmindex

6.1.13 alarm-trap list-size


Function
To configure the maximum size of the Trap list, use this command.

Format
alarm-trap list-size size

Parameter
Parameter
size

Description
Maximum size of the Trap list, an integer, ranging from 1 to 5000

Default conditions
The maximum size of the Trap list is 1000.

Command mode
Global configuration

Usage guideline
Scenario
Trap refers to information actively sent by the managed device to the NMS to report some
emergency events (such as, the managed device is restarted). You can use this command to
configure the maximum size of the Trap list.
Prerequisite

Raisecom Technology Co., Ltd.

180

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

N/A
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to configure the maximum size of the Trap list to 500.
Raisecom# config
Raisecom(config)# alarm-trap list-size 500
Raisecom(config)#

Related commands
show alarm-trap info

6.1.14 alarm-trap-disable index


Function
To disable the RCMS2903-4E1-4GE to send Traps to the NMS, use this command. To enable
the this function, use the no form of this command.

Format
alarm-trap-disable [ index index ]
no alarm-trap-disable [ index index ]

Parameter
Parameter
index index

Description
Alarm index, starting from 0x, in hexadecimal notation

Default conditions
Allow the RCMS2903-4E1-4GE to send Traps to the NMS.

Command mode
Alarm configuration

Usage guideline
Scenario
Trap refers to information actively sent by the managed device to the NMS to report some
emergency events (such as, the managed device is restarted). However, some alarms may be
Raisecom Technology Co., Ltd.

181

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

reported continuously, which interferes with monitoring other alarms. You can use this
command to disable the RCMS2903-4E1-4GE to send Traps to the NMS. Then users will not
receive any related alarms.
Prerequisite
You can use the show alarmindex command to show the alarm index.
Follow-up procedure
N/A
Precaution
N/A

Examples
This example shows how to forbid the alarm with the index of 0x10030402 to be sent to the
NMS.
Raisecom# config
Raisecom(config)# alarm
Raisecom(config-alarm)# alarm-trap-disable index 0x10030402
Set successfully

Related commands
show alarmindex
show alarm config

6.1.15 show alarm active


Function
To show information about the current alarm, use this command.

Format
show alarm active [ module_name ]

Parameter
Parameter
module_name

Description
Module name, depending on the device

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/Alarm configuration

Raisecom Technology Co., Ltd.

182

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Usage guideline
N/A

Examples
This example shows how to show information about the current alarm.
Raisecom# show alarm active
1
coldStart
LOCATION:SLOT-0
2
EntDiscoverTrap
LOCATION:SLOT-0
3
linkDown
LOCATION:SLOT-0 GE-1
4
linkDown
LOCATION:SLOT-0 GE-2
5
linkDown
LOCATION:SLOT-0 GE-3
6
OptTrapE1LosTrap
LOCATION:SLOT-0 E1-2
7
OptTrapE1LosTrap
LOCATION:SLOT-0 E1-3
8
OptTrapE1LosTrap
LOCATION:SLOT-0 E1-4
9
OptTrapE1LosTrap
LOCATION:SLOT-0 E1-1

Related commands
show alarm cleared

6.1.16 show alarm auto-report config


Function
To show alarm auto-report configurations, use this command.

Format
show alarm auto-report config

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/Alarm configuration
Raisecom Technology Co., Ltd.

183

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Usage guideline
N/A

Examples
This example shows how to show the alarm index in the output group.
Raisecom# show alarm auto-report config
alarm auto-report disable index
0x50072a02, 0x50072b02, 0x50072c02, 0x50072d02,
0x50073002, 0x50073102, 0x50073202, 0x50073302,
0x50073602
alarm auto-report enable index
0x10010102, 0x10010202, 0x10010302, 0x10010402,
0x10010702, 0x10010802, 0x10030102, 0x10030202,
0x40010102, 0x40010202, 0x40010302, 0x40010402,
0x40010702, 0x40010802, 0x40010902, 0x40010a02,
0x40010d02, 0x40010e02, 0x40010f02, 0x40011002,
0x40011302, 0x40011402, 0x40011502, 0x40011602,
0x40011902, 0x40020102, 0x40020202, 0x40020302,
0x40020602, 0x40020702, 0x40020802, 0x40020902,
0x40020c02, 0x40020d02, 0x40030102, 0x40030202,
0x40030502, 0x40030602, 0x40030702, 0x40030802,
0x40080102, 0x400b0102, 0x400b0102, 0x400b0202,
0x400b0302, 0x400b0402, 0x400b0502, 0x400b0602,
0x400b0902, 0x400b0a02, 0x400b0b02, 0x400c0102,
0x400c0302,

0x50072e02, 0x50072f02,
0x50073402, 0x50073502,

0x10010502,
0x10030302,
0x40010502,
0x40010b02,
0x40011102,
0x40011702,
0x40020402,
0x40020a02,
0x40030302,
0x40030902,
0x400b0202,
0x400b0702,
0x400c0202,

0x10010602,
0x10030402,
0x40010602,
0x40010c02,
0x40011202,
0x40011802,
0x40020502,
0x40020b02,
0x40030402,
0x40030a02,
0x400b0302,
0x400b0802,

Related commands
N/A

6.1.17 show alarm cleared


Function
To show information about the cleared alarms, use this command.

Format
show alarm cleared

Parameter
N/A

Default conditions
N/A

Raisecom Technology Co., Ltd.

184

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Command mode
Privileged EXEC/Global configuration/Alarm configuration

Usage guideline
N/A

Examples
This example shows how to show information about the cleared alarms.
Raisecom# show alarm cleared
1, EntDelCardTrap:
BIND VAR-1: len = 4, value
BIND VAR-2: len = 4, value
State:Auto Recovered
Active time:8411700
Cleared time:8412600
2, EntDelCardTrap:
BIND VAR-1: len = 4, value
BIND VAR-2: len = 4, value
State:Auto Recovered
Active time:0
Cleared time:8411700

7, EntDelCardTrap:
BIND VAR-1: len = 4, value
BIND VAR-2: len = 4, value
State:Auto Recovered
Active time:0
Cleared time:4800

is 3 1 9 0
is 0 0 16 35

is 3 1 9 0
is 0 0 29 1

is 3 1 14 0
is 0 0 16 25

Related commands
N/A

6.1.18 show alarm config


Function
To show alarm configurations, use this command.

Format
show alarm config

Parameter
N/A

Raisecom Technology Co., Ltd.

185

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/Alarm configuration

Usage guideline
N/A

Examples
This example shows how to alarm configurations.
Raisecom# show alarm config
Alarm auto-save: disable
Trap enable: enable
Alarm filter switch: off
Alarm inhibit: enable
Alarm delay: disable
Alarm active delay time: 5
Alarm clear delay time: 5
Alarm active table max size: 500
Active alarm table storage mode: loop
Alarm inverse-mode : auto

The following table lists fields displayed in previous command lines.


Field

Description

Alarm auto-save

Enable/Disable alarm auto-save

Trap Enable

Enable/Disable Trap feature

Alarm Filter Switch

Status of the alarm filtering switch

on: enable alarm filtering.


off: disable alarm filtering.

Alarm Inhibit

Enable/Disable alarm inhibition

Alarm Delay

Enable/Disable alarm delay.

Alarm Delay Starting Time

Starting time of alarm delay.

Alarm Delay End Time

End time of alarm delay

Active Alarm Table Max Size

Maximum size of the alarm table

Active Alarm Table Storage Mode

Storage mode of the current alarm table:

Alarm inverse-mode

loop
stop

Alarm inverse modes:

auto: automatic recovery mode


manual: manual recovery mode
none: non-inverse mode

Raisecom Technology Co., Ltd.

186

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

Related commands
N/A

6.1.19 show alarmindex


Function
To show alarm configurations according to the alarm index or module name, use this
command.

Format
show alarmindex [ module_name | index index ]

Parameter
Parameter

Description

module_name

Module name, depending on the device

index index

Alarm index, starting from 0x, in hexadecimal notation

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/Alarm configuration

Usage guideline
N/A

Examples
This example shows how to show the alarm index and configurations.
Raisecom# show alarmindex
system alarm-trap-enable: enable
system alarm-filter-switch: off
index
alarm_name
monitor trap
filter
0x10030102 coldStart
enable enable enable
0x10030202 warmStart
enable enable enable
0x10030302 authenticationFailure
enable enable enable
0x10030402 linkDown
enable enable enable
0x60030102 MultiPathDeviceMultipathTrap
enable enable enable
0x40020102 DevicePowerDeviceLostTrap
enable enable enable
0x40020202 DevicePowerFaultTrap
enable enable enable
0x40020302 DeviceFanFaultTrap
enable enable enable
0x40020402 DeviceShelfLostTrap
enable enable enable
0x40020502 DeviceFanLostTrap
enable enable enable
0x40020602 DeviceCardWorkStatusFaultTrap
enable enable enable

Raisecom Technology Co., Ltd.

187

Raisecom
RCMS2903-4E1-4GE (A) Command Reference
0x40020702
0x40020802
0x40020902
0x40020a02
0x40020b02

DeviceShelfAlarmTrap
DeviceLockTrap
DeviceAlarmOutputTrap
DeviceAlarmInputTrap
DeviceFanGroupLostTrap

6 Alarm management
enable enable enable
enable enable enable
enable enable enable
enable enable enable
enable enable enable

Related commands
N/A

6.1.20 show alarm inverse config


Function
To show alarm inverse configurations, use this command.

Format
show alarm inverse config

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/Alarm configuration

Usage guideline
N/A

Examples
This example shows how to show alarm inverse configurations.
Raisecom# show alarm inverse config
alarm inverse disable 0 e1 1-4
alarm inverse disable 0 ge 1-4
alarm inverse disable 0 fx-ge 1
alarm inverse disable 0 pdh-opt 1
alarm inverse disable 0 esw 1-5

Related commands
N/A

Raisecom Technology Co., Ltd.

188

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

6.1.21 show alarm monitor config


Function
To show information about the alarm index, use this command.

Format
show alarm monitor config

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC/Global configuration/Alarm configuration

Usage guideline
N/A

Examples
This example shows how to show information about the alarm index.
Raisecom# show alarm monitor config
alarm monitor disable index
0x500a0102, 0x500a0202, 0x500a0302,
0x50190202
alarm monitor enable index
0x10010102, 0x10010202, 0x10010302,
0x10010702, 0x10010802, 0x10020102,
0x10030202, 0x10030302, 0x10030402,
0x40010402, 0x40010502, 0x40010602,
0x40010a02, 0x40010b02, 0x40010c02,
0x40011002, 0x40011102, 0x40011202,
0x40011602, 0x40011702, 0x40011802,
0x40011c02, 0x40011d02, 0x40020102,
0x40020502, 0x40020602, 0x40020702,
0x40020b02, 0x40020c02, 0x40020d02,
0x40030302, 0x40030402, 0x40030502,

0x500a0402, 0x500a0502, 0x50190102,

0x10010402,
0x10020202,
0x40010102,
0x40010702,
0x40010d02,
0x40011302,
0x40011902,
0x40020202,
0x40020802,
0x40020e02,
0x40030602,

0x10010502,
0x10030102,
0x40010202,
0x40010802,
0x40010e02,
0x40011402,
0x40011a02,
0x40020302,
0x40020902,
0x40030102,
0x40030702,

0x10010602,
0x10030102,
0x40010302,
0x40010902,
0x40010f02,
0x40011502,
0x40011b02,
0x40020402,
0x40020a02,
0x40030202,
0x40030802,

Related commands
N/A

Raisecom Technology Co., Ltd.

189

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

6.1.22 show alarm-trap info


Function
To show Trap configurations sent to the NMS, use this command.

Format
show alarm-trap info

Parameter
N/A

Default conditions
N/A

Command mode
Global configuration

Usage guideline
N/A

Examples
This example shows how to show Trap configurations sent to the NMS.
Raisecom# config
Raisecom(config)# show alarm-trap info
trap-repeat-list info:
trap repeat disable
Current trap index: 0
Current trap list is NULL
trap list MAX size: 1000
trap repeat response max time:10

The following table lists fields displayed in previous command lines.


Field

Description

trap repeat

Enabling Trap repetition

Current trap index

Index of current Trap

Current trap list

Current Trap list

trap list MAX size

Maximum size of Trap list

trap repeat response max time

Maximum time to respond to Trap repetition request

Raisecom Technology Co., Ltd.

190

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

6 Alarm management

6.1.23 show general-alarm


Function
To show general alarm information, use this command.

Format
show general-alarm

Parameter
N/A

Default conditions
N/A

Command mode
Privileged EXEC

Usage guideline
N/A

Examples
This example shows how to show general alarm information.
Raisecom# show general-alarm
General alarm is on
item 2: SYS-CLK-LOSS

Related commands
N/A

Raisecom Technology Co., Ltd.

191

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

7 Index

Index

alarm ..............................166

autonegotiate (SNMP
interface configuration
mode) ............................... 79

alarm active delay ..........167

alarm active storage-mode


.......................................168

bert ................................. 148

alarm auto-report enable 169

alarm auto-save ..............170

clear ................................. 11

alarm clear .....................171

clear statistic .................... 55

alarm clear delay ............173

clear statistic (E1 interface


configuration mode) ...... 149

alarm delay enable .........174


alarm inhibit enable .......175
alarm inverse enable ......176

clear statistic (GE electrical


interface configuration
mode) ............................. 132

alarm monitor enable .....179

clear statistic (GF optical


interface configuration
mode) ............................. 142

alarm-mask all ...............147

clear trace message .......... 49

alarm-trap list-size .........180

clock set ........................... 41

alarm-trap-disable index 181

clock summer-time enable


......................................... 43

alarm inverse-mode .......177

als enable .........................73


arp add .............................80

clock summer-time
recurring .......................... 44

assert-dest ........................48

clock timezone ................. 45

autonegotiate (GE electrical


interface configuration
mode) .............................131

config ............................... 12

Raisecom Technology Co., Ltd.

192

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

7 Index

interface pdh-opt............ 156

description........................81

interface sfp pdh-opt ...... 158

device_role .......................56

interface snmp ................. 95

disable ..............................13

interface switchport ....... 130

double-tagging tpid ..........99

ip address (SNMP interface


configuration mode) ........ 82

download..........................33

ip route ............................. 76

e1tributary-lost-alarm ......74
enable ...............................14
end....................................15
english ..............................16
erase startup-config..........34
exit ...................................17

list .................................... 20
logout ............................... 21
loopback ........................ 151

m ........................................ 4

fault-pass enable ..............75


flow-control on (GE
electrical interface
configuration mode).......133
flow-control on (GF optical
interface configuration
mode) .............................143

password .......................... 25
ping .................................. 50
pvid ................................ 100

qos default-cos ............... 112


qos enable ...................... 113

qos queue ....................... 114

h .........................................1

qos queue cos-map ........ 115

help ..................................18

qos queue wrr ................ 117

history ..............................19

qos trust ......................... 118

hostname ..........................57

quit ................................... 22

i ..........................................3

r .......................................... 6

interface e1.....................150

rate-limit ........................ 121

interface fx-ge ................144

reboot ............................... 23

interface ge.....................134

remote .............................. 58

Raisecom Technology Co., Ltd.

193

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

reset ..................................24
restore-defaultconfiguration ....................59

s ..........................................7
save user...........................26
sfp-switch on ..................159
show alarm active ..........182
show alarm auto-report
config .............................183
show alarm cleared ........184
show alarm config..........185
show alarm inverse config
.......................................188
show alarm monitor config
.......................................189

7 Index

show interface (GF optical


interface configuration
mode) ............................. 145
show interface (PDH optical
interface configuration
mode) ............................. 157
show interface (PDH SFP
optical interface
configuration mode) ...... 162
show interface
(remote/global
configuration mode) ........ 63
show interface snmp ........ 97
show ip route ................... 77
show loopback ............... 155
show manufacture info .... 65
show qos ........................ 119

show alarmindex ............187

show rotp-cpu-utilizationratio .................................. 66

show alarm-trap info ......190

show running-config........ 36

show arp ...........................96

show snmp trap-bind ....... 87

show assert-dest ...............51

show snmp trap-server..... 88

show clock .......................46

show snmp-server
community ....................... 83

show device .....................60


show esw ........................140

show snmp-server statistics


......................................... 84

show general-alarm........191

show startup-config ......... 37

show history-statisticinterval ...........................160

show statistic (GE electrical


interface configuration
mode) ............................. 136

show info .........................61


show interface (E1 interface
configuration mode).......153

show statistic (GF optical


interface configuration
mode) ............................. 146

show interface (GE


electrical interface
configuration mode).......135

show statistic-current ..... 161


show storm-control ........ 125
show sys-up-time ............. 67

Raisecom Technology Co., Ltd.

194

Raisecom
RCMS2903-4E1-4GE (A) Command Reference

7 Index

show terminal...................27

sync-configuration ........... 70

show this ..........................67

show trace message..........53

tag-mode ........................ 103

show trace-dest ................52

trace-dest ......................... 53

show user .........................28

show version ....................69


show vlan-entry-list .......101

u ......................................... 9
upload .............................. 39

show vlan-entry-list ratelimit ................................123

user password .................. 29

shutdown ........................138

user privilege ................... 30

shutdown (SNMP interface


configuration mode).........92
snmp trap-bind .................89
snmp trap-server ..............90
snmpd...............................93
snmp-server community ..91
speed(GE electrical
interface configuration
mode) .............................139
speed(SNMP interface
configuration mode).........94
storm-control..................127
storm-control rate...........128

Raisecom Technology Co., Ltd.

vlan-entry vid ................ 104


vlan-entry vid portlist .... 105
vlan-entry-list ................ 107
vlan-entry-list port-list ... 108
vlan-entry-list rate-limit 124
vlan-manage vid ............ 109
vlan-type ........................ 110

who .................................. 32
write ................................. 40

195

Address: Building 2, No. 28, Shangdi 6th Street, Haidian District, Beijing, P.R.China.
Postal code: 100085
Tel: +86-10-82883305
Fax: 8610-82883056
http://www.raisecom.com
Email: export@raisecom.com

You might also like