FibroLAN MetroStar MMM-01 Product information sheet

FibroLAN
MMM-01
MetroStar™ System
CLI User Reference Guide
October 2006
SW Version 1.6.2
Document version: 1.5
FibroLAN Ltd.
6 Hayezira St. P.O. Box 544 Yokneam-Illit, 20692, ISRAEL
Tel: [phone] Fax: [phone]
e-mail: [email protected] web site: www.fibrolan.com
i

1. List of Tables............................................................................................................... vii
2. Document history...................................................................................................... viii
3. Preface........................................................................................................................... 1
4. General rules and guidelines ...................................................................................... 2
General command syntax...................................................................................................... 2
‘view’ commands.................................................................................................................... 2
‘view’ and ‘show’ alternatives................................................................................................. 2
‘config’ commands................................................................................................................. 3
? help modifier........................................................................................................................ 3
! comment modifier ................................................................................................................ 3
Strings are truncated.............................................................................................................. 3
System confirmation code (26974)........................................................................................ 3
Command availability by device type..................................................................................... 4
Wildcard character usage...................................................................................................... 4
Command abbreviations........................................................................................................ 4
All commands are case sensitive........................................................................................... 4
Error messages...................................................................................................................... 5
Warning messages................................................................................................................ 5
Clearing strings...................................................................................................................... 5
Command log......................................................................................................................... 5
ping command........................................................................................................................ 5
5. Device type – command cross reference................................................................... 6
6. Offline configuration .................................................................................................. 13
General ................................................................................................................................13
Usage and commands......................................................................................................... 13
Supported models................................................................................................................ 14
7. System related commands........................................................................................ 15
chassis................................................................................................................................. 15
chassis modules .................................................................................................................. 15
chassis psu .......................................................................................................................... 16
offline chassis....................................................................................................................... 16
offline targetparams............................................................................................................. 17
offline clear........................................................................................................................... 17
offline compare..................................................................................................................... 18
offline copy2mmm................................................................................................................ 18
offline copy2module............................................................................................................. 19
offline reload......................................................................................................................... 19
offline resdef......................................................................................................................... 20
offline save........................................................................................................................... 20
sessions............................................................................................................................... 21
system.................................................................................................................................. 21
system cfgupload................................................................................................................. 21
system cfgupload filename .................................................................................................. 22
system cfgupload rempath................................................................................................... 22
system cfgupload tftpser...................................................................................................... 23
system fwupgr...................................................................................................................... 23
system fwupgr autorestart.................................................................................................... 23
system fwupgr rempath........................................................................................................ 24
system fwupgr revlocal ........................................................................................................ 24
system fwupgr revname....................................................................................................... 24
system fwupgr revremote..................................................................................................... 25
system fwupgr target............................................................................................................ 25
system fwupgr tftpser........................................................................................................... 26
ii

system login......................................................................................................................... 26
system login password......................................................................................................... 26
system login username........................................................................................................ 27
system net............................................................................................................................ 27
system net defgw................................................................................................................. 27
system net ipaddr................................................................................................................. 28
system net subnmask.......................................................................................................... 28
system ntp............................................................................................................................ 28
system ntp <on|off>.............................................................................................................. 29
system ntp server add.......................................................................................................... 29
system ntp server clear........................................................................................................ 29
system ntp server remove.................................................................................................... 30
system ntp status................................................................................................................. 30
system ntp sync ................................................................................................................... 30
system ntp syncinterval........................................................................................................ 31
system ntp timezone............................................................................................................ 31
system offlinecfg .................................................................................................................. 31
system offlinecfg <on|off>.................................................................................................... 32
system offlinecfg conflictalert............................................................................................... 32
system radius....................................................................................................................... 32
system radius <on|off>......................................................................................................... 33
system radius secret............................................................................................................ 33
system radius server add..................................................................................................... 33
system radius server clear................................................................................................... 34
system radius server remove............................................................................................... 34
system radius udpport.......................................................................................................... 34
system snmp........................................................................................................................ 35
system snmp getcomm........................................................................................................ 35
system snmp sendtrap......................................................................................................... 36
system snmp setcomm........................................................................................................ 36
system snmp syscontact...................................................................................................... 37
system snmp syslocation..................................................................................................... 37
system snmp sysname ........................................................................................................ 37
system snmp trapcomm....................................................................................................... 38
system snmp trapdest.......................................................................................................... 38
system snmp trapfilter.......................................................................................................... 38
system snmp trapfilter severity ............................................................................................ 39
system snmp trapfilter sevthreshold .................................................................................... 39
system snmp traplog............................................................................................................ 40
system snmp traplog <time>................................................................................................ 40
system snmp traplog <on|off>.............................................................................................. 41
system snmp traplog clear................................................................................................... 41
system snmp traplog resend <count>.................................................................................. 41
system snmp traplog resend <time(days|hours).................................................................. 42
system snmp trapsev........................................................................................................... 42
system swupgr..................................................................................................................... 43
system swupgr autoreboot................................................................................................... 43
system swupgr rempath....................................................................................................... 44
system swupgr start............................................................................................................. 44
system swupgr tftpser.......................................................................................................... 45
system swupgr vername...................................................................................................... 45
system syslog....................................................................................................................... 46
system syslog <on|off>........................................................................................................ 46
system syslog msgfilter........................................................................................................ 46
system syslog server add .................................................................................................... 47
system syslog server clear................................................................................................... 47
system syslog server remove .............................................................................................. 47
system syslog test................................................................................................................ 48
system telnet........................................................................................................................ 48
system telnet acclist............................................................................................................. 49
iii

system telnet acclist add...................................................................................................... 49
system telnet acclist clear.................................................................................................... 50
system telnet acclist remove................................................................................................ 50
system telnet prompt............................................................................................................ 51
system telnet timeout........................................................................................................... 51
test alarm send..................................................................................................................... 52
users .................................................................................................................................... 52
8. Module and CPE related commands ........................................................................ 53
802.1p.................................................................................................................................. 53
802.1pbase .......................................................................................................................... 53
802.1q.................................................................................................................................. 54
autocross.............................................................................................................................. 54
autonego.............................................................................................................................. 54
bcastprotect.......................................................................................................................... 55
bcastrate .............................................................................................................................. 55
bckp2mainfo......................................................................................................................... 56
bckp2maintp......................................................................................................................... 56
bwdown................................................................................................................................57
bwup..................................................................................................................................... 57
bw rxdiff................................................................................................................................58
bw rxhigh.............................................................................................................................. 58
bw rxhighfc........................................................................................................................... 59
bw rxlow............................................................................................................................... 59
bw rxlowfc ............................................................................................................................ 60
bw txdiff................................................................................................................................60
bw txhigh.............................................................................................................................. 61
bw txlow ............................................................................................................................... 61
buffershare........................................................................................................................... 62
datarate................................................................................................................................62
defvid.................................................................................................................................... 63
desc...................................................................................................................................... 63
diffserv.................................................................................................................................. 64
discardnpvid......................................................................................................................... 64
downsle................................................................................................................................65
dscp...................................................................................................................................... 65
dscp <code>......................................................................................................................... 66
e1......................................................................................................................................... 66
e1 port <p>........................................................................................................................... 66
e1 port <p> desc.................................................................................................................. 67
e1 port <p> enable............................................................................................................... 67
e1 port <p> encoding........................................................................................................... 67
e1 port <p> locallb ............................................................................................................... 68
e1 port <p> remalb............................................................................................................... 68
e1 port <p> remlb................................................................................................................. 68
e1 port <p> resdef................................................................................................................ 69
e1 port <p> rx....................................................................................................................... 69
e1 port <p> taos................................................................................................................... 69
e1 port <p> taosonlos.......................................................................................................... 70
e1 port <p> tx....................................................................................................................... 70
e1 port <p> useralb.............................................................................................................. 70
e1 port <p> userlb................................................................................................................ 71
e1 resdef.............................................................................................................................. 71
e1 reset................................................................................................................................71
e2ethfp................................................................................................................................. 72
enable .................................................................................................................................. 72
f2tfp...................................................................................................................................... 72
f2tlst...................................................................................................................................... 73
fdx ........................................................................................................................................ 73
fef......................................................................................................................................... 73
iv

folb ....................................................................................................................................... 74
forcefo.................................................................................................................................. 74
forcetp.................................................................................................................................. 75
global.................................................................................................................................... 75
globalprio.............................................................................................................................. 76
globalvlan............................................................................................................................. 76
ingressfilter........................................................................................................................... 77
lb .......................................................................................................................................... 77
loopback............................................................................................................................... 78
lx2sxlst ................................................................................................................................. 78
lxautonego............................................................................................................................ 78
lxlb........................................................................................................................................ 79
mac dynamic........................................................................................................................ 79
mac dynamic clear............................................................................................................... 79
mac static............................................................................................................................. 80
mac static add...................................................................................................................... 80
mac static clear.................................................................................................................... 80
mac static delete.................................................................................................................. 81
mcastprotect......................................................................................................................... 81
mdix...................................................................................................................................... 82
mtu....................................................................................................................................... 82
nullvidreplace....................................................................................................................... 82
oa2unifp ............................................................................................................................... 83
oalb ...................................................................................................................................... 83
p1lb ...................................................................................................................................... 83
p1p2fp.................................................................................................................................. 84
p1p2sle................................................................................................................................. 84
p2lb ...................................................................................................................................... 84
p2p1fp.................................................................................................................................. 85
p2p1sle................................................................................................................................. 85
pause ................................................................................................................................... 85
port....................................................................................................................................... 86
port <p> bw.......................................................................................................................... 86
port <p> prio......................................................................................................................... 86
port <p> vlan........................................................................................................................ 87
prio....................................................................................................................................... 87
prioratio................................................................................................................................88
redcfg................................................................................................................................... 88
resdef................................................................................................................................... 89
restart................................................................................................................................... 89
sfp ........................................................................................................................................ 89
sfp status.............................................................................................................................. 90
slelogic................................................................................................................................. 90
sleports................................................................................................................................. 91
stats...................................................................................................................................... 91
stats all................................................................................................................................. 91
stats clear............................................................................................................................. 92
stats collision........................................................................................................................ 92
stats error............................................................................................................................. 92
stats errrates........................................................................................................................ 93
stats good............................................................................................................................. 93
stats sizegraph..................................................................................................................... 93
stats total.............................................................................................................................. 94
status.................................................................................................................................... 94
sx2lxlst ................................................................................................................................. 94
sxautonego........................................................................................................................... 95
sxlb....................................................................................................................................... 95
t1.......................................................................................................................................... 95
t1 port <p>............................................................................................................................ 96
t1 port <p> cablelen............................................................................................................. 96
v

t1 port <p> desc................................................................................................................... 96
t1 port <p> enable................................................................................................................ 97
t1 port <p> encoding............................................................................................................ 97
t1 port <p> locallb ................................................................................................................ 97
t1 port <p> remalb................................................................................................................ 98
t1 port <p> remlb.................................................................................................................. 98
t1 port <p> resdef................................................................................................................. 98
t1 port <p> rx........................................................................................................................ 99
t1 port <p> taos.................................................................................................................... 99
t1 port <p> taosonlos ........................................................................................................... 99
t1 port <p> tx...................................................................................................................... 100
t1 port <p> useralb............................................................................................................. 100
t1 port <p> userlb............................................................................................................... 100
t1 resdef............................................................................................................................. 101
t1 reset............................................................................................................................... 101
t2ethfp................................................................................................................................ 101
t2ffp.................................................................................................................................... 102
t2flst.................................................................................................................................... 102
taginsert ............................................................................................................................. 102
tagremove.......................................................................................................................... 103
tplb ..................................................................................................................................... 103
tpresponse ......................................................................................................................... 103
unilb.................................................................................................................................... 104
unusedfo ............................................................................................................................ 104
unusedtp ............................................................................................................................ 105
upsle................................................................................................................................... 105
userprio.............................................................................................................................. 106
vlan..................................................................................................................................... 106
vlan add.............................................................................................................................. 106
vlan add default.................................................................................................................. 107
vlan addport ....................................................................................................................... 107
vlan delete.......................................................................................................................... 108
vlan removeport ................................................................................................................. 108
9. Abbreviations and Terms......................................................................................... 109
vi

1. List of Tables
Table 2-1 – document history page viii
Table 5-1 – command availability by device type page 6
Table 6-1 – OFC model support page 14
vii

2. Document history
The following table lists the changes made to this document.
Version/date Changes Author
1.0/28.10.04 Initial draft Shamir Stein
1.1/5.12.04
Added restore defaults commands,
‘?’ help modifier, ‘!’ comment
modifier, error messages, LTA41/MA
related commands, offline
configuration section
Shamir Stein
1.2/20.6.05
Added warning messages,
MCM1000S & GSM1000/MA
commands, E1 commands, trap log,
trap filter, send trap, command log,
loopback, sessions, MDX41/81, FW
upgrade commands, ping command
warning
Shamir Stein
1.3/19.10.05
Added MSM622U, F.CON1F/MA,
enhanced traplog commands,
RADIUS, Syslog, NTP, users
command, reset command for
H.CON/MA
Tal Katz-Touaf
1.4/19.7.06
Added MSM2500U, MCM100x-T1,
MCM100RL, PCM110x-E1/T1,
LTA41-xT1, MCM1000X,
GSM1000X, T1 commands, test trap
send command, SFP commands
Tal Katz-Touaf
1.5/15.10.06 Added full show commands. Added
command radius udpport.Tal Katz-Touaf
Table 2-1 – document history
viii

3. Preface
This manual provides you with the necessary information for managing
your MetroStar Access System using the MMM-01 management module
(monitor and control), via the command line interface.
The CLI is available both on the serial connection terminal (through the
RS232 interface) and via remote Telnet sessions (through the Ethernet
interface).
This guide contains a complete command reference for the available
commands within the CLI. The commands are sorted in an ascending
alphabetical order.
1

4. General rules and guidelines
General command syntax
The main basic commands in the system, used for displaying and
modifying configuration, of the various elements within the system, are the
view and config.
When using these commands to manage a speicfic device (module or
CPE), the proper indexing information must be provided within the
command. The MetroStar chassis can house up to 12 traffic conveying
modules. Each of these may have 1 to 4 channels. There must also be a
differentitation between the local module’s configuration and that of the
remote CPE, which is connected at the other end of the fiber, to that
channel.
The format for the indexing information is as follows:
view|config <slot #> <channel #> <loc|rem> {command
modifiers and parameters}
This format applies to ALL Module and CPE related commands.
Commands that are system related (section 4) are not aimed at a specific
target (slot and channel) and therefore require no indices. The following
command is an example for this case:
view system snmp
This command will display all system SNMP parameters.
Throughout the command reference sections the show and config
keywords are omitted from the command name (e.g. show system
snmp will be named system snmp). The syntax and example fields in
each command’s table depict the full syntax, including the show and/or
config keywords.
‘view’ commands
Generally speaking , the ‘view’ command is used for displaying status
and/or configuration.
This command allows you to look at the configuration and status of a
specific local channel, a specific CPE, or of multiple devices (see wildcard
usage below). Any command that is intended for display (as oposed to
configuration) will start with the ‘view’ keyword and use the general
syntax rules as described above.
‘view’ and ‘show’ alternatives
You can use the keyword ‘show’ and ‘view’ alternately, with the same
result. They will both execute the ‘view’ command.
2

‘config’ commands
The ‘config’ keyword will prefix any command that is intended to modify
any configuration parameter within the system. Any config command
uses the general syntax rules as described above.
? help modifier
When the user wishes to know the options of a certain command, he
should use the ‘?’ help modifier. This is done by typing the beginning of
the command and then the ‘?’ modifier. The system will display all
available commands and/or command modifiers. For example
‘config 3 1 rem ?’ will display all main configuration options of the
remote device connected to slot 3, channel 1.
! comment modifier
When it is necessary to comment a command the ‘!’ comment modifier
should be used. This is especially useful when pasting command scripts
from pre-written text files and the user wishes to disable some of the
script’s commands without having to erase them from the text file. The
same use will apply to configuration uploading with text files (in which
case the comment mark can appear anywhere within the line). For
example ‘!config 3 1 loc desc yomoose’ will be ignored by the
system.
Strings are truncated
When the user is configuring a parameter which is a text string, there is
always a limit to the maximum acceptable number of characters. This limit
varies, depending on the parameter.
Any characters exceeding this limit will be automatically truncated and
ignored. The accepted string will consist of all characters until the allowed
string length.
The maximum allowed length of each parameter is detailed in the
command refernce.
System confirmation code (26974)
Some critical commands that may end in destructive results, such as
clearing the access list or starting an upgrade, will require the user to
enter the fixed system confiramtion code. This code will always be 26974.
3

Command availability by device type
The command reference provides details on each of the generally
available commands in the system. In addition it specifies the scope of
each command, that is, where this command can be used.
Some commands however, may be available for a particular type of
device and may not be applied to other types. Section xxx3 of this manual
contains a detailed list, specifying the available commands for each type
of device.
Wildcard character usage
In cases where the user wishes to apply the same command for devices
on the system, he/she may do so using the wildcard character ‘*’ in the
indexing information.
The following examples illustrate the use of the wildcard character.
config 3 2 loc bwdown 70 – normal usage - set the downstream
bandwidth of channel 2 on slot 3 to 70Mbps
config 3 * loc bwdown 70 – set the downstream bandwidth of all
channels on slot 3 to 70Mbps
config * 1 loc bwdown 70 – set the downstream bandwidth of
channel 1 on all slots to 70Mbps
config * * loc bwdown 70 – set the downstream bandwidth of all
channels on all slots to 70Mbps
show 3 * loc – display the status and configuration of all channels of
the module in slot 3
Command abbreviations
The config and view|show keywords can be abbreviated down to the
shortest string that is still not conflicting with any other command. For
example, in current version, typing con… would be interpreted as
config… . same will apply to using sh instead of show or using vi
instead of view.
Please note that indexing information in the command must be supplied in
full (strict syntax).
All commands are case sensitive
The CLI mechanism is case sensitive and will not accept commands given
in wrong case. Generally, all commands and modifiers are given in
lowercase. Special cases are noted on the commands reference.
String parameters can have both uppercase and lowercase.
4

Error messages
In any case, where a command cannot be executed properly, an error
message will be displayed in response to the command. There are
several types of error messages that will be displayed as a result of
different illegal conditions. For example, if there is no module in slot 5 and
the command sh 5 1 is given, the error message displayed is: No
module in slot 5!
Warning messages
In some cases where a command may cause undesired operation, a
warning message is displayed (configuration is applied). For example,
trying to set a link’s bandwidth to 0Mbps, will trigger such a message.
Clearing strings
Whenever a string parameter is given, it is possible to clear this parameter
by setting the string to the null-string, which is ‘****’. For example, if we
wish to clear the description of channel 1 of the module in slot 3, we would
use the command: config 3 1 desc ****
Command log
It is possible to view all recent commands (up to 32) that were issued by
the system’s users. This log will contain commands from any CLI session.
Commands are displayed in the order they were given (most recent
command will be first). The log is RAM based and will therefore be
cleared upon reboot or power failure.
The log can be viewed using the command cmdlog {<n>}, where nis
the number of requested commands. For example, if n=10 the last 10
commands will be displayed. If no number is specified, the entire log will
be displayed.
ping command
Allows pinging an IP entity from the management module. For example:
ping 192.168.1.27
Warning
DO NOT use the ping command with either localhost or an invalid
address! Use 127.0.0.1 instead of localhost
5

5. Device type – command cross reference
The following table details the available commands for each device type
within the MetroStar system.
All commands specified within this table have the scope of either modules
or CPEs. System related commands are detailed in the system command
reference section.
Model Available commands
MCM100-0x
desc
bwdown
t2ffp
f2tfp
upsle
downsle
pause
enable
fdx
resdef
MCM100-xE1
All MCM100-01 command and:
e1
e1 port <p>
e1 port <p> desc
e1 port <p> taos
e1 port <p> enable
e1 port <p> useralb
e1 port <p> locallb
e1 resdef
e1 reset
MCM100-xT1
All MCM100-01 command and:
t1
t1 port <p>
t1 port <p> desc
t1 port <p> taos
t1 port <p> enable
t1 port <p> useralb
t1 port <p> locallb
t1 resdef
t1 reset
t1 cablelen
MCM100RL
status
redcfg
reset
resdef
redmode
desc
bwdown
t2ffp
ft2fp
upsle
6

Model Available commands
downsle
pause
enable
forcefo
forcetp
bckp2mainfo
bckp2maintp
unusedfo
unusedtp
PCM110-xE1
desc
autonego
fdx
datarate
e2ethfp
bwdown
downsle
pause
enable
resdef
e1
e1 <port> <p>
e1 <port> <p> remlb
e1 <port> <p> tx
e1 <port> <p> rx
e1 <port> <p> taosonlos
e1 <port> <p> encoding
e1 <port> <p> resdef
PCM110-xT1
desc
autonego
fdx
datarate
t2ethfp
bwdown
downsle
pause
enable
resdef
t1
t1 <port> <p>
t1 <port> <p> remlb
t1 <port> <p> tx
t1 <port> <p> rx
t1 <port> <p> taosonlos
t1 <port> <p> encoding
t1 <port> <p> cablelen
t1 <port> <p> resdef
7

Model Available commands
H.CON/MA
desc
bwup
enable
pause
f2tfp
autonego
fdx
datarate
resdef
reset
ATARA100
desc
bwup
enable
pause
f2tfp
bckp2mainfo
bckp2maintp
forcefo
forcetp
unusedfo
unusedtp
resdef
LTA41/MA
desc
autonego
fdx
datarate
enable
autocross
mdix
bcastprotect
fef
bw rxlow
bw rxhigh
bw txlow
bw txhigh
bw rxdiff
bw txdiff
bw rxlowfc
bw rxhighfc
port
port <p> bw
buffershare
mcastprotect
bcastrate
mtu
slelogic
sleports
global
8

Model Available commands
vlan add
vlan add default
vlan addport
vlan removeport
vlan delete
vlan
taginsert
tagremove
ingressfilter
discardnpvid
defvid
port <p> vlan
802.1q
nullvidreplace
globalvlan
prio
802.1p
diffserv
userprio
port <p> prio
802.1pbase
prioratio
dscp <code>
globalprio
dscp
mac dynamic clear
mac dynamic
mac static add
mac static delete
mac static clear
mac static
stats clear
stats
stats all
stats error
stats good
stats total
stats collision
stats sizegraph
stats errrates
resdef
restart
LTA41-xE1
All LTA41/MA commands and:
e1
e1 port <p>
e1 port <p> desc
e1 port <p> taos
e1 port <p> enable
9

Model Available commands
e1 port <p> userlb
e1 port <p> remalb
e1 resdef
e1 reset
LTA41-xT1
All LTA41/MA commands and:
t1
t1 port <p>
t1 port <p> desc
t1 port <p> taos
t1 port <p> enable
t1 port <p> userlb
t1 port <p> remalb
t1 resdef
t1 reset
t1 cablelen
MCM1000T
desc
bwdown
t2flst
f2tlst
upsle
downsle
autonego
lxautonego
pause
enable
folb
tplb
resdef
MCM1000S
desc
bwdown
sx2lxlst
lx2sxlst
upsle
downsle
enable
autonego
sxautonego
lxautonego
pause
lxlb
sxlb
resdef
MCM1000X
status
sfp
sfp status
p1p2sle
p2p1sle
p1p2fp
10

Model Available commands
p2p1fp
desc
enable
pause
autonego
upsle
downsle
lb
bwdown
autonego
resdef
MSM100U/622U enable
p1lb
p2lb
resdef
MSM2500U sfp
desc
enable
resdef
GSM1010/MA
desc
bwup
f2tlst
enable
folb
resdef
reset
pause
GSM1000/MA
desc
bwup
lx2sxlst
enable
autonego
sxautonego
pause
lxlb
resdef
reset
GSM1000X
sfp
desc
bwup
oa2unifp
enable
pause
autonego
unilb
oalb
resdef
11

Model Available commands
ATARA1000
desc
bwup
enable
f2tlst
bckp2mainfo
bckp2maintp
forcefo
forcetp
unusedfo
unusedtp
folb
tplb
tpresponse
resdef
MDX-41/81 show|view command only
F.CON1F/MA
desc
bwup
enable
pause
oa2unifp
resdef
reset
Table 5-1 – command availability by device type
*commands appearing in italics are view|show commands
12