Emp Cli User Guide
Uploaded by
Romen ThengujamEmp Cli User Guide
Uploaded by
Romen ThengujamEMP CLI User Guide
EDA 1200
Copyright
Ericsson AB 2009-2010. All rights reserved. No part of this document may be
reproduced in any form without the written permission of the copyright owner.
Disclaimer
The contents of this document are subject to revision without notice due to
continued progress in methodology, design and manufacturing. Ericsson shall
have no liability for any error or damage of any kind resulting from the use
of this document.
Legal Notice
The Linux Core system is the operating system for the Ethernet Node Controller
in ECN. The Linux distribution for ECN is based on standard open source
packages widely used in the Linux community. For more information about the
license refer to Third Party License Agreement.
Common Net Notice Text
This product includes software developed by The Apache Software Foundation
(http://www.apache.org/).
The software is based on the Commons Net software (http://jakarta.apach
e.org/commons/net/).
Only the telnet part and some supporting libraries have been included from the
Commons Net package by Ericsson Denmark.
Please refer to the Third Party License Agreements for the license terms.
Trademark List
Windows
is a registered trademark of Microsoft Corporation in the
United States and/or other countries
Linux
is a registered trademark of Linus Torvalds in the United
States and/or other countries.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Contents
Contents
1
Introduction
1.1
Conventions
1.2
Revision Information
Introduction to the EMP CLI
2.1
Login to the CLI
2.2
Entering Commands
2.3
Changing Command Level
10
2.4
Overview of CLI Commands
11
General CLI Commands
13
3.1
Changing Prompt
13
3.2
Changing Password
13
3.3
Configuring Management Access
14
3.4
Configuring NTP Server
16
3.5
Configuring Time and Date
17
3.6
Ping a Node
18
3.7
CLI Autologout
19
3.8
Restarting Nodes
20
3.9
Testing IP DSLAM Connection
21
3.10
Turn Off SBC
22
3.11
Entering Switch CLI (rCLI)
22
Configuring Interfaces
25
4.1
External, Internal and Untagged Interface
25
4.2
Save Running Configuration
28
4.3
Backup Configuration
29
4.4
Restore Configuration
30
4.5
Configuring VMAC Domain
31
System and Status Information
33
5.1
Show System Configuration
33
Managing Software
35
6.1
Configuring FTP Servers
35
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
6.2
Upgrading SW of ECN and Embedded Nodes
36
6.3
Updating EMP SW
37
6.4
Installing SW for Embedded Nodes and ECN Switch
38
6.5
Cleaning Up Temporary Storage
38
Management Configuration
41
7.1
SNMP
41
7.2
Local Management
44
7.3
EM-PEM Management
45
Configuring VLAN
47
8.1
Service VLAN
47
8.2
VLAN Unaware
47
ECN Configuration
49
9.1
External VLAN
49
9.2
Inventory Commands
50
9.3
Port Commands
52
9.4
Spanning Tree Protocol
59
9.5
Link Aggregation
64
9.6
Redundancy
66
9.7
Unmanaged Switch
66
9.8
Unmanaged Node
68
9.9
Unmanaged Node Polling
69
9.10
Unmanaged Node SNMP Version
70
9.11
IGMP Commands for ECN320
70
9.12
Switch Extension
72
9.13
Auto Rediscover
79
9.14
Specifying Switch Location
79
9.15
Show ECN
80
10
EDN Commands
83
10.1
Uplink Configuration
83
10.2
Show EDN Configuration
84
11
DSL Port Commands
85
11.1
Configuring Line Parameters
85
11.2
Configuring ADSL Transmission Properties
88
11.3
Resetting Performance Data Counter
94
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
11.4
PVC Commands
11.5
Configuring Auto-Transmission Mode
107
11.6
Configuring Transmission Mode
109
11.7
VDSL PSD Line Configuration
113
11.8
Copying a DSL Port Configuration
115
11.9
Testing a DSL Port
116
11.10
Alarm Thresholds
117
11.11
Line Initialization Failure Alarms
118
11.12
Show DSL Port
119
12
ESN Commands
121
12.1
Link Aggregation
121
12.2
ESN Port Commands
122
13
EXN Commands
125
13.1
EXN104 Line Configuration
125
13.2
E1 Line Type Configuration
125
13.3
Packet Distribution Across E1 Link
126
13.4
Show EXN104 Configuration
127
14
EFN Commands
129
14.1
EFN324 Commands
129
15
Alarms
131
15.1
Alarm Filter
131
15.2
Alarm Statistics Filter
132
15.3
Active Alarm Synchronization
133
15.4
Remove Active Alarm from Log
135
16
Security
137
16.1
Security Firewall Access Control List
137
16.2
Configuring Security User
138
16.3
Configuring Protocols
139
16.4
Radius Server
140
16.5
Tacacs Server
141
16.6
Server Authentication
142
17
Fallback State CLI Commands
145
17.1
Overview of Fallback State Commands
145
2/1553-LZA 101 464-V1 Uen C 2010-02-02
95
EMP CLI User Guide
18
Downgrading the ECN to a Switch
149
18.1
Downgrading the ECN330
149
18.2
Downgrading the ECN320
149
18.3
Reconfiguring Information After Downgrading
150
19
Factory Default
151
20
Program Packages Under Open Source Licenses
155
20.1
Linux Kernel
155
20.2
Linux Applications
156
20.3
Linux Libraries
156
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Introduction
Introduction
This guide provides detailed information on how to use the Command Line
Interface (CLI) to configure the following Ethernet Controller Nodes (ECN):
ECN320
ECN330
ECN430
The term ECN-switch refers to an ECN running in switch mode. For information
on how to use the Web Interface to configure the ECN, refer to the EMP Web
Interface User Guide.
Although there is a lot of overlap between the Web Interface and the CLI, the
CLI does not include all the functions found in the Web Interface. Similarly,
some CLI functions are not found in the Web Interface.
This guide is intended for both installation personnel and system administrators
responsible for operating and maintaining network equipment. The reader is
expected to have a basic knowledge of general switch functionality, the Internet
Protocol (IP), and Simple Network Management Protocol (SNMP). The guide
does not attempt to give a complete explanation of the various standards, but
rather the implementation of the standards in the ECN. For more information of
the standards, please refer to the standard specifications.
Note:
1.1
It is highly recommended to read the EDA 1200 System Overview
and ECN User Guide before reading this guide. Functions are fully
explained in these guides, while this guide only explains how to set the
different parameters related to these functions.
Conventions
Typographic conventions used throughout this guide are listed in Table 1 on
page 1.
Table 1
Typographic Conventions
Convention
Description
Example
User Input
A command that
you must enter in
a Command Line
Interface (CLI)
exactly as written.
cd $HOME
Command Variables
Command variables,
the values of which
you must supply.
<home_directory>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
Table 1
Typographic Conventions
Convention
Description
Example
[argument1|argument2]
The brackets
indicate that these
arguments are
optional and can
be omitted. The
| indicate that
either argument1 or
argument2 is used.
If used, the brackets
must not be typed.
[disable|enable]
{argument1|argument2}
The brackets
indicate that
argument1 or
argument2 are
required. The
| indicate that
either argument1
or argument2 must
be used as a value
for this parameter.
{lock|unlock}
GUI Objects
GUI objects, such as
menus, fields, and
buttons.
On the File menu, click Exit.
Key Combinations
Key combinations.
Press Ctrl+X to delete the selected
(1)
value.
System Elements
Command and
parameter names,
program names,
path names, URLs,
and directory names
The files are located in E:\Test.
Output Information
Text displayed by
the system
System awaiting input
Code Examples
Code examples
stat char* months[]=\
The files are located in /opt/ericsson
(2)
/bin.
(3)
{Jan,Feb}
(1) The plus sign (+) indicates that the keys must be pressed simultaneously.
(2) The use of the forward slash (/) is for Unix systems, Windows systems use the backslash (\).
(3) The back slash (\) is used to show where long lines are split.
1.2
Revision Information
This guide is valid from EDA 1200 4.1 R8A and later. Other product versions,
with functions not described in this guide, may be available.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Introduction
1.2.1
This Revision (C)
Other than editorial changes, this document has been revised as follows:
1.2.2
Elaboration made on the SNMP command in Section 7.1 on page 41
Description of the local management command corrected in Section 7.2
on page 44
Description of Alarm filter corrected in Section 15.1 on page 131
Alarm Statistics filter added in Section 15.2 on page 132
Version B
Other than editorial changes, this document has been revised as follows:
1.2.3
Statistics receiver added in Section 7 on page 41
Version (A)
This is the first version of the this guide prepared for EDA 1200 4.1 R7A.
Other than editorial changes, this document has been revised as follows:
New Relay Agent option (TR 101 Flex) added in Section 11.4.1 on page 96
Switch extension command (Section 9.12 on page 72) updated concerning
the port argument.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Introduction to the EMP CLI
Introduction to the EMP CLI
The Command Line Interface (CLI) can be used to configure the ECN for
management, configuration and line provisioning. The Command Line Interface
can be accessed using a serial connection to the ECN console port, see
Section 2.1 on page 5. After the ECN network interfaces have been configured
the CLI can be accessed from a remote terminal using SSH.
The CLI enables configuration by entering keywords and parameters at a
command prompt.
There are two CLI modes: normal operation and fallback mode.
The available CLI commands are different in the two modes. The ECN goes
into fallback mode, when it fails to start properly. In this mode, the CLI can be
used to check logs and load new software. When the ECN is in fallback mode,
it is displayed in the CLI during login.
2.1
Login to the CLI
This section describes how to establish a connection to the ECN, initiate a
CLI session and login to the CLI shell.
A connection to the ECN can be done by connecting a the serial port on a
laptop to the console port on the ECN using a serial cable. This is the way to
enter the CLI when performing the initial configuration of the ECN during first
time installation. To access the ECN remotely through a terminal emulator
application such as PuTTY can be done after the ECN has been configured in
terms of IP addresses, subnet mask, default gateway, VLANs and so on.
Do the following to connect a laptop to the console port:
1. Connect the serial cable to the serial port of the laptop and tighten the
captive retaining screws on the DB-9 connector.
2. Connect the other end of the cable to the console port on the ECN.
3. Set the terminal emulation software (for example PuTTY) as follows:
Select the appropriate serial port (COM 1 or COM 2)
Set the data rate to 9600 baud.
Set the data format to 8 data bits, 1 stop bit, and no parity.
Set flow control to none, emulation mode to VT100.
When using HyperTerminal, select Terminal keys, not Windows keys.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
Note:
When using HyperTerminal with Microsoft Windows 2000, make sure
that Windows 2000 Service Pack 2 or later is installed. Windows 2000
Service Pack 2 fixes the problem of arrow keys not functioning in
HyperTerminals VT100 emulation.
When the CLI session has been initiated the following user name and password
has to be given at the login prompt to access the CLI shell:
login:admin
Password:admin (the password will not be shown)
Starting CLI application.
......................
ecn#
2.2
Entering Commands
This section describes how to enter CLI commands.
2.2.1
Keywords and Arguments
A CLI command is a series of keywords, arguments and parameters
separated by spaces. Keywords identify a command, and arguments specify
configuration parameters. For example, in the command config system
interface default-gateway 192.168.3.254, config, system and interface are
keywords, default-gateway is an argument that specifies the interface type,
and 192.168.3.254 is a parameter that specifies the value of the argument.
Commands can be entered as follows:
Enter the required sequence of keywords, arguments and parameters in
one go. For example, to configure the IP address of the default gateway,
enter:
ecn#config system interface default-gateway
192.168.3.254
Enter the required sequence of keywords, arguments and parameters
one by one. The prompt will display the command level. For example, to
configure the IP Address default gateway, enter:
ecn(config)#system
ecn(config system)#interface
ecn(config system interface)#default-gateway
192.168.3.254
When entering a new command level or after a keyword, argument and
parameter the ? character or the TAB key can be used to display a list of
possible keywords, arguments and parameters.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Introduction to the EMP CLI
The commands exit and end, will change the command level, see Section 2.3
on page 10. The CLI is not case sensitive.
2.2.2
Minimum Abbreviation
The CLI will accept a minimum number of characters that uniquely identify a
command. For example, the command config can be entered as co.
If an entry is ambiguous, the system will prompt for further input.
Example:
The command show system calendar can be entered as:
ecn#sho sys cal
2.2.3
Command Completion
If input is terminated by pressing the TAB key, the CLI prints the remaining
characters of a partial keyword or argument up to the point of ambiguity. For
example, typing sh followed by pressing the TAB key will result in printing the
command up to show. If one or more of the previous words are incorrect,
auto-completion does not work. Some detailed examples are shown below.
Examples:
ecn# config dslport 2.3.4 alarms line-initialization-fai
lure e
Pressing the TAB key will result in:
ecn# config dslport 2.3.4 alarms line-initialization-fai
lure enabled
If the value is not uniquely defined, a list of possible options is displayed, that is:
ecn#config dslport 2.3.4 alarms line-initialization-fail
ure
Pressing the TAB key will result in:
line-initialization-failure:
enable, disable
ecn#config dslport 2.3.4 alarms line-initialization-fail
ure
If the group of letters does not match any option, nothing is displayed when
pressing the TAB key.
When the value must be either a certain range or a restricted set, only the
values in the restricted set is auto-completed, that is only the all value.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
2.2.4
CLI Editing Keystrokes
Table 2
2.2.5
CLI Editing Keystrokes
Keystroke
Function
Ctrl + A
Shift cursor to start of command line
Ctrl + B
Shift cursor one character to the left
Ctrl + D
Exit the CLI application
Ctrl + E
Shift cursor to end of command line
Ctrl + F
Shift cursor one character to the right
Ctrl + P
Show the last command
Ctrl + R
Show the previous command
Ctrl + U
Delete the entire line
Getting Help on Commands
Possible commands can be displayed by using the ? character or pressing the
TAB key to list keywords, arguments or parameters.
2.2.6
Partial Keyword Lookup
If a partial keyword is terminated with a question mark, alternatives that match
the initial letters are provided. For example s? shows all the keywords starting
with s.
2.2.7
Using Command History
The CLI maintains a history of the used commands. The up and down arrow
keys can be used to scroll back and forward through the history of commands
(max 20 commands). Any command displayed in the history list can be
executed again, or modified and executed.
2.2.8
Command Execution
After a command is executed, the same prompt at the same command level will
appear, indicating that the command has been executed. If there is no error
message, the execution was successful. A new command can be entered
at the same command level.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Introduction to the EMP CLI
2.2.9
Scripts
CLI commands can be collected in a script. To play the script, a terminal
program supporting scripts is required as for example the Tera Term (pro).
The commands are copied from the script to the terminal program. This will
activate all the copied commands.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EMP CLI User Guide
2.3
Changing Command Level
This section describes the two basic commands for changing command level.
2.3.1
Go to Root Level
Command Usage:
This command is used to bring the command level to the root level. The
command can be used at all command levels.
Command Level:
Any
Syntax:
end
Arguments:
None
Default Settings:
None
Examples:
ecn(config system)#end
2.3.2
Exit
Command Usage:
This command is used to bring the command level to the previous level. The
command can be used at all command levels. At the root level the CLI is
terminated.
The command end will give the root level, see Section 2.3 on page 10.
Command Level:
Any
Syntax:
exit
Arguments:
None
Default Settings:
None
Examples:
ecn(config system)#exit
10
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Introduction to the EMP CLI
2.4
Overview of CLI Commands
This section gives an overview of the CLI commands during normal operation.
Only the commands on level 1 and 2 are shown.
The commands are shown in the hierarchical structure as presented in the CLI.
Table 3
Overview of CLI Commands - Normal Operation
Level 1
Level 2
General Commands - (No
level 1 keyword)
General commands used for troubleshooting, inspection
(end, exit, ping, restart) and access to the CLI for embedded
switches.
config
Configuration commands for the ECN and embedded nodes.
Includes copying DSL configurations from one port to another.
cma
Handling of configuration
privileges.
copy-dslport
Copy a DSL-port configuration
from one port to another.
dslport
Configuration commands for
End-user lines.
ecn
Configuration commands
for redundancy and link
aggregation in the ECN.
edn
Configuration commands for
single IP DSLAMs such as
link type configuration.
esn
Commands to configure
embedded switches.
exn
Configuration of the EXN104:
packet distribution, line-type
and line settings.
load-configuration
Roll back to the last saved
configuration.
reset-dslports
Reset DSL ports configuration
to default.
save-configuration
Save the running
configuration.
security
Security configuration.
system
System configuration.
led-test
LED Commands.
test
Testing lines.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Description
11
EMP CLI User Guide
12
2/1553-LZA 101 464-V1 Uen C 2010-02-02
General CLI Commands
General CLI Commands
These commands are used for basic configuration of the ECN.
3.1
Changing Prompt
Command Usage:
Use this command to change the command prompt of the CLI in order to make
it easier to identify a node.
Command Level:
ecn(config system)#
Syntax:
prompt [<string>|none]
Arguments:
<string>
Type what must be displayed in the prompt.
none
Used if nothing must be displayed in the prompt.
Default Settings:
None
Examples:
ecn(config system)#prompt ECN430-1
The prompt has now been changed to: ECN430-1#
3.2
Changing Password
Command Usage:
This command is used to change the password for administrators and users of
the ECN switch.
The password for the Web user is not affected. Also use this command to
change or set the minimum length of the password, that is, the minimum
number of characters in the password. The minimum length value can be read
out by using the show command.
Command Level:
ecn(config system)#
Syntax:
password change factorydefault old <password> new
<password>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
13
EMP CLI User Guide
password change old <password> new <password>
password length <length>
Arguments:
factorydefault
Change the factory default password
old <password>
Insert the old password
new <password>
Insert the new password
<length>
Insert the minimum length of the password.
Default Settings:
Default minimum length of password is 6.
Examples:
ecn(config system)#password change factorydefault old
admin new 14inimda
ecn(config system)#password change old admin new 14inimda
3.2.1
Show System Password Length
Command Usage:
This command is used to read the length of the password.
Command Level:
ecn#
Syntax:
show system password-length
Arguments:
None
Default Settings:
None
Examples:
ecn#show system password-length
3.3
Configuring Management Access
Command Usage:
Use this command to handle configuration privileges (cma: Configuration
Management Access). Configuration can be done at the same time from
SNMP, CLI or the Web interface. Using the Configuration Management
Access module it is possible to restrict this so only one manager at a time is
14
2/1553-LZA 101 464-V1 Uen C 2010-02-02
General CLI Commands
granted configuration privilege. It is still possible for other managers to read
the configuration.
Command Level:
ecn(config)#
Syntax:
cma {free-privilege|message <message>|mode
{off|interval|exclusive}|timer <time>|defaulttimer <time>}
Arguments:
free-privilege
Used to withdraw the configuration privilege
immediately from the manager so that
other manager can get the configuration
privilege.
<message>
Type a message to other managers
{off | interval |
exclusive}
Off: All managers can configure at the
same time.
Interval: The configuration privilege is
withdrawn when nothing is configured after
the time set in timer <time> or if someone
manually withdraws the privilege.
Exclusive: The configuration privilege is
only withdrawn if a manager withdraws
the privilege using the command: cma
privilege free.
timer <time>
Sets the time the current manager can
keep the configuration privilege when
nothing is configured.
defaulttimer <time>
Sets the default time in seconds for the
configuration management privileges.
Default Settings:
Mode: off
For SNMP: exclusive
Timer: 300 s
Examples:
ecn(config)#cma mode interval
ecn(config)#cma timer 100
3.3.1
Show Configuration Manager Parameters
Command Usage:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
15
EMP CLI User Guide
Use this command to display the configured parameters and gives information
about the actual configuration manager.
Command Level:
ecn#
Syntax:
show cma
Arguments:
None
Default Settings:
None
Examples:
ecn#show cma
3.4
Configuring NTP Server
Command Usage:
Use this command to define the IP address of the central NTP server and
start or stop an NTP client in the ECN.
EMP comprises a NTP client and a NTP server. The NTP server is used as the
central server by the embedded nodes.
When the calendar command has been executed, the NTP server is
automatically stopped.
Note:
When the NTP server is not running, the IP DSLAMs will not be able
to use the remote storage. For more information about the remote
storage function, please refer to the IP DSLAM User Guide.
Command Level:
ecn(config system)#
Syntax:
ntp client {enable|disable}
ntp server-ip <ip-address>
Arguments:
16
{enable | disable}
Enable or disable the NTP client of the
ECN
<ip-address>
The IP address of the NTP server that
the ECN should synchronize with. This
command also enables the NTP client
2/1553-LZA 101 464-V1 Uen C 2010-02-02
General CLI Commands
Default Settings:
NTP client enabled
IP address: 0.0.0.0
Examples:
ecn(config system)#ntp server-ip 192.168.1.3
ecn(config system)#ntp client enable
3.4.1
Show Configured NTP Parameters
Command Usage:
Use this command to display the configured parameters and gives information
about the actual configuration manager.
Command Level:
ecn#
Syntax:
show system ntp
Arguments:
None
Default Settings:
None
Examples:
ecn#show system ntp
The output will be:
NTP Server: 172.30.1.44
NTP Client: enabled
3.5
Configuring Time and Date
Command Usage:
This command should only be used if there is no connection to the network and
a central NTP or SNTP server. Using the calendar command stops the NTP
server and client in the ECN.
The date and time should be Universal Time Coordinate (UTC). To start the
NTP server and client, see the ntp command in Section 3.4 on page 16.
For more information about time synchronization in the EAN refer to the ECN
User Guide.
Command Level:
ecn(config system)#
2/1553-LZA 101 464-V1 Uen C 2010-02-02
17
EMP CLI User Guide
Syntax:
calendar date <date> time <time>
Arguments:
argument
Explanation
<date>
The date in the format dd.mm.yy
<time>
The timer in the format hh:mm:ss
Default Settings:
None
Note:
When the NTP server is not running, the IP DSLAMs will not be able
to use the remote storage. For more information about the remote
storage function, please refer to the IP DSLAM User Guide.
Examples:
ecn(config system)#calendar date 21.10.09 time 15:32:30
ecn(config system)#ntp server-ip 192.168.1.3
3.5.1
Show System Calendar
Command Usage:
Use this command to display the configured parameters and gives information
about the actual configuration manager.
Command Level:
ecn#
Syntax:
show system calendar
Arguments:
None
Default Settings:
None
Examples:
ecn#show system calendar
The output will be:
Tu Jul 14 08:45:39 GMT 2009
3.6
Ping a Node
Command Usage:
This command is almost identical to the ping command from Windows
command prompt. The only difference is that the command parameters cannot
18
2/1553-LZA 101 464-V1 Uen C 2010-02-02
General CLI Commands
be configured. The ping command will always use 56 bytes data packets (64
bytes total), and send the command 5 times.
Command Level:
ecn#
Syntax:
ping <ip-address>
Arguments:
<ip-address>
Insert the IP address of the node in the
format xxx.xxx.xxx.xxx.
Default Settings:
None
Examples:
ecn#ping 172.30.38.1
The output will be as follows:
PING 172.30.38.1 (172.30.38.1): 56 data bytes
64 bytes from 172.30.38.1: icmp_seq=0 ttl=255 time=52.1
ms
64 bytes from 172.30.38.1: icmp_seq=1 ttl=255 time=2.0 ms
64 bytes from 172.30.38.1: icmp_seq=2 ttl=255 time=2.0 ms
64 bytes from 172.30.38.1: icmp_seq=3 ttl=255 time=2.0 ms
64 bytes from 172.30.38.1: icmp_seq=4 ttl=255 time=2.2 ms
--- 172.30.38.1 ping statistics --packets transmitted, 5 packets received, 0% packet loss
round-trip min/avg/max = 2.0/12.0/52.1 ms
3.7
CLI Autologout
Command Usage:
Use this command to set an idle interval after which the CLI will logout
automatically. By default the CLI will log out after 5 minutes if there is no user
input. This command is used to set another idle timeout.
Command Level:*
ecn(config system)#
Syntax:
cli-autologout <time>
Arguments:
<time>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Sets the time in the range 1 to 30 minutes
after which the CLI will logout automatically
if there is no user input
19
EMP CLI User Guide
Default Settings:
5
Examples:
ecn(config system)#cli-autologout 30
3.7.1
Show System CLI Autologout
Command Usage:
Use this command to display the configured parameters and gives information
about the actual configuration manager.
Command Level:
ecn#
Syntax:
show system cli-autologout
Arguments:
None
Default Settings:
None
Examples:
ecn#show system cli-autologout
The output will be: CLI auto-logout interval:
3.8
0 minute(s)
Restarting Nodes
Command Usage:
Use this command to restart nodes in the EAN. The EFN324 does not support
reset-on-lan.
Command Level:
ecn#
Syntax:
restart {ecn|switching-unit|enc}
restart reset-on-lan node <node>
restart node {<node>|all}
Arguments:
20
ecn
Restarts both EMP and the switching unit
switching-unit
Restarts the switching unit
2/1553-LZA 101 464-V1 Uen C 2010-02-02
General CLI Commands
Arguments:
enc
Restarts the EMP
reset-on-lan node <node>
Specifies the node no. in the format a.b to
restart the node.
node <node> | all
Specifies the node no. to restart in the
format a.b or restart all nodes including the
ECN
Default Settings:
None
Examples:
ecn#restart ecn
ecn#restart node all
3.9
Testing IP DSLAM Connection
Command Usage:
Use this command to test the connections to embedded IP DSLAMs. The
command will cause the embedded IP DSLAMs to turn on the green LED in a
sequence, in order to be able to locate the ports to which each IP DSLAM is
connected. The sequence starts from the IP DSLAM connected to port 1 of the
ECN. After 250 ms the IP DSLAM connected to port 2 will turn on the green
LED then 3 and so on until port 24. When all IP DSLAMs are lit the LEDs will
turn off the light in the same order (from 1 to 24) with an interval of one second.
Command Level:
ecn#
Syntax:
led-test flash
led-test node <node> line {enable|disable}
CLI command arguments [argument]
Arguments:
flash
Will cause the embedded IP DSLAMs to
turn on the green LED in a sequence. Note
that only IP DSLAMs connected directly to
ports on the ECN are part of the sequence
<node>
Insert the node no. of the IP DSLAM in the
format a.b
{enable | disable}
Enable or disable line state LEDs for IP
DSLAMs
2/1553-LZA 101 464-V1 Uen C 2010-02-02
21
EMP CLI User Guide
Default Settings:
None
Examples:
ecn#led-test node 1.0 line enable
3.10
Turn Off SBC
Command Usage:
The command is used to turn off the EMP functionality on the ECN330 and run
the ECN330 as a switch. Refer to ECN330-switch User Guide for information
about how to enable the SBC board with the EMP functionality. Note that
basic IP settings must be reconfigured after the downgrade. See Section 18
on page 149.
Command Level:
ecn(config system)#
Syntax:
turn off sbc management-ip-address <ip-address>
Arguments:
<ip-address>
The external management IP address
Default Settings:
None
Examples:
ecn(config system)#turn off sbc management-ip-address
172.30.3.1
3.11
Entering Switch CLI (rCLI)
Command Usage:
When logging in to an embedded node, the prompt changes to the command
prompt for the node, for example: switch#.
The prompt can be configured. Type exit to go back to EMP CLI.
The command is used to establish access to the CLI of the ECN switching
unit or other embedded nodes, including CLI of the switches in flexible blocks
(ESN212 or ESN204g) or the flexible node (EFN324). The command cannot be
used to access the CLI of IP DSLAMs or ESN108.
Command Level:
ecn#
22
2/1553-LZA 101 464-V1 Uen C 2010-02-02
General CLI Commands
Syntax:
rcli <node>
Arguments:
<node>
The node number in the format a.b. If the
node is a flexible block, a is 1000 plus the
nodes Switch ID.
0.0 is used to login to the ECN switching
unit
Default Settings:
None
Examples:
ecn#rcli 0.1
2/1553-LZA 101 464-V1 Uen C 2010-02-02
23
EMP CLI User Guide
24
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Configuring Interfaces
Configuring Interfaces
This section describes different commands used when installing and configuring
the ECN in the network.
4.1
External, Internal and Untagged Interface
Command Usage:
This command is used during the basic configuration, and if the IP or VLAN
properties of the ECN or the embedded elements have to be changed.
Executing interface commands will not change the settings in the ECN until the
interface activate command is executed.
To complete the changes the following steps must be taken:
The interfaces configured are only used for management, and are not
associated with any End-user traffic.
If the internal interface is changed, all embedded nodes will be restarted
automatically when interface activate is executed (in order to be able to receive
traffic on the new management VLAN). The ECN will always restart when
interface activate is executed.
The netmask for the internal interface must be at least 255.255.0.0 or higher
(for example 255.128.0.0). Note that the Default Gateway IP address must be
within the network mask of the external interface
The IP address of the internal interface must not be in the range reserved for
the embedded elements, which means xxx. xxx.xxx.1.1 to xxx.xxx.99.200.
A firewall access list can only be assigned to the external interface. The list
must be defined before it can be assigned, see section 3.6.13 on page 102.
The interface command is used for configuring the ECN with different interfaces:
External, Internal and Untagged. The interfaces can be configured with IP
addresses, subnet mask, VLANs and priority. The default gateway for the
ECN and a firewall access list can be configured. The interface command
can be used when installing the ECN in the network for the first time or when
configurational changes are needed.
Command Level:
ecn(config system)#
Syntax:
interface {external|internal|untagged} vlan <vlan-id> ip
<ip-address> netmask <subnet-mask> priority <prio>
interface external firewall-acl <name> {add|remove}
2/1553-LZA 101 464-V1 Uen C 2010-02-02
25
EMP CLI User Guide
interface default gateway <ip-address>
interface activate
Arguments:
external
The interface that can be seen from the
network
internal
The interface that can be seen by the
embedded nodes. It is invisible to the rest
of the network
untagged
The interface that is used by the embedded
nodes to send untagged DHCP request (if
the tagged request is unanswered). It is
not seen by the rest of the network
<vlan-id>
The ID of the VLAN that should be used
for the interface. The range is an integer
between 1 and 4092
<ip-address>
The IP address that should be used for the
stated interface
<subnet-mask>
The subnet mask that should be used for
the stated interface
<prio>
Specifies the priority of the external
management traffic
<name>
The name of the firewall access list that is
assigned to the external interface
{add | remove}
Add or remove the firewall access list
assigned to the external interface
interface default gateway
<ip-address>
The IP address of the default gateway for
the ECN
activate
Activates the previously executed interface
commands and saves the configurations.
Default Settings:
External Interface:
VLAN ID: 246
IP address: 0.0.0.0
Subnet mask: 255.255.255.0
Firewall-acl: none
Internal Interface:
VLAN ID: 247
IP address: 10.0.100.1
Subnet mask: 255.255.0.0
Untagged Interface:
26
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Configuring Interfaces
VLAN ID: 248
IP address: 10.1.100.1
Subnet mask: 255.255.255.0
Default gateway: 0.0.0.0
Default priority: 7
Examples:
ecn(config system)#interface external vlan 246 ip
192.168.35.21 netmask 255.255.255.0 priority 6
ecn(config system)#interface default-gateway 192.168.35.1
ecn(config system)#interface internal vlan 4000 ip
172.16.100.1 netmask 255.255.0.0
ecn(config system)#interface untagged vlan 4001 ip
172.17.30.1 netmask 255.255.255.0
ecn(config system)#interface activate
4.1.1
Show System Interface
Command Usage:
Use this command to display the configured interface parameters.
Command Level:
ecn#
Syntax:
show system interface
Arguments:
None
Default Settings:
None
Examples:
ecn#show system interface
The output will be:
External VLAN: 246 IP: 172.31.133.144 Netmask:
255.255.255.128 Priority: 7
Internal VLAN: 247 IP: 10.0.100.1 Netmask:
255.255.0.0
Untagged VLAN: 248 IP: 10.1.100.1 Netmask:
255.255.255.0
Default Gateway:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
172.31.133.1
27
EMP CLI User Guide
4.2
Save Running Configuration
Command Usage:
Use this command to save the running configuration file in the flash memory
of the ECN.
Performing a restart of the ECN by using the restart command will load the last
saved configuration on the node, see Section 3.8 on page 20.
Command Level:
ecn(config)#
Syntax:
save-configuration
Arguments:
None
Default Settings:
None
Examples:
ecn(config)#save-configuration
4.2.1
Configuring Autosave Timeout
Command Usage:
Use this command to set the time after which the configuration is automatic
stored. Configurational changes in embedded elements are registered by EMP
but not stored (for those elements where EMP has the configuration file for
example IP DSLAM, ESN108, and EXN104). This command ensures that the
changes are stored in the interval set by the command.
Command Level:
ecn(config system)#
Syntax:
config-autosave-timeout <time>
Arguments:
<time>
The time in seconds after which the
configuration is automatic stored. When
set to 0, autosave is off
Default Settings:
300
Examples:
ecn(config system)#config-autosave-timeout 180
28
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Configuring Interfaces
4.2.1.1
Show Configured Autosave Timeout
Command Usage:
Use this command to display the configured parameters and gives information
about the actual configuration manager.
Command Level:
ecn#
Syntax:
show system config-autosave-timeout
Arguments:
None
Default Settings:
None
Examples:
ecn#show system config-autosave-timeout
The output will be:
Configurationfile auto-save timeout:
4.3
300
Backup Configuration
Command Usage:
Use this command to initiate a backup of the configuration information from
the ECN (EMP) and the embedded elements. To restore the backup file use
the restore command.
The command stores configuration information on a FTP server or if no FTP
server is defined the backup file is placed locally in the directory: /var
Command Level:
ecn(config system)#
Syntax:
backup-configuration {ftp-server <name> filename
<filename>|filename <filename>|terminate}
Arguments:
<name>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Type the name of the FTP server (use the
ftp-server command to define the server,
see Section 6.1 on page 35).
If no FTP server is specified the backup
file will be stored locally on the ECN in the
directory: /var
29
EMP CLI User Guide
Arguments:
<filename>
Path, relative to the root of the FTP
server and file name of the backup file, for
example eda/backup/conf-backup-file
terminate
If an FTP server is not used, the backup
must be terminated with this command,
after you have copied the backup to
another place. Running terminate will
clean up all files created under the backup
Default Settings:
None
Examples:
ecn(config system)#backup-configuration ftp-server ftp1
filename eda/backup/conf-backup-file
The command will store the configuration on the ftp1 server in the directory:
eda/backup directory and with the name conf-backup-file.
4.4
Restore Configuration
Command Usage:
Use this command to initiate a restore of the configuration information from the
ECN (EMP) and the embedded elements saved in a backup file. The backup
file is stored on a chosen FTP server or locally on the ECN in the directory:
/var. During the restore the ECN will restart, and the telnet connection to
the ECN will be lost.
Command Level:
ecn(config system)#
Syntax:
restore-configuration {ftp-server <name> filename
<filename>|filename <filename>|terminate}
Arguments:
<name>
30
Type the name of the FTP server (use the
ftp-server command to define the server,
see Section 6.1 on page 35) from which to
fetch the backup file.
If an FTP server was not used for storing
the backup only the filename parameter is
used
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Configuring Interfaces
Arguments:
<filename>
Path relative to the root of the FTP server
and file name of the backup file, for
example eda/backup/conf-backup-file
terminate
If an FTP server is not used, a restore must
be terminated with this command, before a
new restore can be made. The terminate
argument cannot be used if a backup or
a restore is running
Default Settings:
None
Examples:
The following command will restore a configuration file with the name conf-back
up-file located on the ftp1 server in: eda/backup/conf-backup-file.
ecn(config system)#restore-configuration ftp-server ftp1
filename eda/backup/conf-backup-file
The following command will restore a configuration file with the name
conf-backup-file located on the ECN in: /var.
ecn(config system)#restore-configuration filename
conf-backup-file
ecn(config system)#restore-configuration terminate
4.5
Configuring VMAC Domain
Command Usage:
Use this command to configure the VMAC domain and network element ID for
the whole Ethernet Access Node (EAN) associated with the ECN in which the
command is executed. The assigned network-element-id applies to every node
in the EAN. However, execution of this command does not of itself enable
VMAC use. VMAC is enabled in the Services by the management system using
SNMP. If the Services do not apply VMAC, this command has no effect. Refer
to the System Description for a detailed explanation of the VMAC format.
The vmac disable command disables VMAC configuration in the EMP. In other
words, VMAC parameters will not be configured in new embedded elements.
Note:
Available elements will keep their VMAC parameters until the
configuration has been changed manually.
Command Level:
ecn(config system)#
2/1553-LZA 101 464-V1 Uen C 2010-02-02
31
EMP CLI User Guide
Syntax:
vmac domain <domain-value> network-element-id
<network-element-id>
vmac disable
Arguments:
<domain-value>
The identifier for the Virtual MAC domain.
The allowed values are:
60 EAN topology must follow a specific
scheme. Flexible topologies not allowed.
61-62 configure domain value to 61 in
flexible topology embedded elements, and
62 in fixed topology embedded elements.
63 configure the domain value to 63.
Flexible topologies and switch extensions
are not allowed.
<network-element-id>
A number uniquely identifying the Ethernet
Access Node (EAN). For domain 60, the
allowable range is 0 to 524287. For the
other domains, the range is 0 to 8191.
Default Settings:
None
Examples:
ecn(config system)#vmac domain 60 network-element-id 135
32
2/1553-LZA 101 464-V1 Uen C 2010-02-02
System and Status Information
System and Status Information
This section describes how to use the CLI to display information about the
system configuration and status information about nodes.
5.1
Show System Configuration
Command Usage:
Use this command to display general system configuration data.
Command Level:
ecn#
Syntax:
show system {aaa authentication login|calendar|config-aut
osave-timeout|ftp-server|interface|local-management|ntp|
password-length|pem-management|radius-server|service-vla
ns|snmp {alarm-receiver|configurations|snmpv3-users}|sof
tware-versions|vlan-unaware|cli-autologout|vmac|temperat
ure-unit-in-degrees}
Arguments:
aaa authentication login
Shows the enabled authentication
methods, in order of priority
calendar
Shows system date and time
config-autosave-timeout
Shows the time for automatic storage of
the configuration
ftp-server
Shows information about FTP servers.
interface
Shows interface configuration
local-management
Shows local management configuration
ntp
Shows defined NTP server and whether
NTP is enabled or not
password-length
Shows minimum length of password
pem-management
Shows PEM management configuration
radius-server
Shows defined RADIUS servers.
service-vlans
Shows if the use of the External
management VLAN for End-user traffic is
allowed (enabled) or not (disabled)
2/1553-LZA 101 464-V1 Uen C 2010-02-02
33
EMP CLI User Guide
Arguments:
{alarm-receiver |
configuration |
snmpv3-users}
Shows information about the SNMP
settings.
software-versions
Shows software versions.
vlan-unaware
Shows VLAN unaware mode.
cli-autologout
Shows idle interval after which the CLI
auto-logs out
vmac
Shows the domain value for virtual MAC
address translation
Default Settings:
None
Examples:
ecn#show system calendar
34
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Managing Software
Managing Software
The following commands are used in connection with installing and upgrading
software for the ECN and the embedded nodes.
6.1
Configuring FTP Servers
Command Usage:
Use this command to define or delete an FTP server communication properties
that will be used by the FTP client of the ECN. The FTP server is used for the
backup/restore and software upgrade. Multiple FTP servers can be defined.
The command show system ftp-server displays the defined ftp servers: index,
server name and IP address.
Command Level:
ecn(config system)#
Syntax:
ftp-server add name <name> server-ip <ip-address> username
<username> password <password> protocol {ftp}
ftp-server delete name <name>
Arguments:
<name>
Type a name of the FTP server. This name
is used in the backup/restore command,
the software upgrade command, and when
deleting the server
<ip-address>
The IP address of the FTP server
<username>
Specify a username for access to the FTP
server. The user must be defined on the
FTP server
<password>
Specify a password for access to the FTP
server. The password must be defined on
the FTP server
Default Settings:
None
Examples:
ecn(config system)#ftp-server add name ftp1 server-ip
172.30.30.3 username admin password qwertyui protocol ftp
ecn(config system)#ftp-server delete name ftp1
2/1553-LZA 101 464-V1 Uen C 2010-02-02
35
EMP CLI User Guide
6.1.1
Show System FTP Server
Command Usage:
Use this command to show information about FTP servers.
Command Level:
ecn#
Syntax:
show system ftp-server
Arguments:
None
Default Settings:
None
Examples:
ecn#show system ftp-server
6.2
Upgrading SW of ECN and Embedded Nodes
Command Usage:
Use this command to upgrade the software on the ECN and all embedded
elements. The EMP will fetch the software from an FTP server for upgrading
the ECN and all embedded elements. The EMP will handle the upgrade of
all embedded elements. Before transferring the file, it is checked that the
necessary space for the software package is available.
The total EAN software package contains individual files for each type of
embedded element and must be installed and available in a directory on
the FTP server that can be reached by the ECN. The directory may contain
different versions of the EAN software package. Each version is stored in its
own directory, with a control file identifying the software version.
When the software package has to be transferred to the ECN, it must be the
name of the control file that is specified in the command.
The EMP will only download software for elements actually connected to the
ECN. If a new type of element is connected to the ECN, the software for this
element type must be installed first.
If one of the software installation jobs reports an error the EMP will restart, in
order to get up running with the old software.
When the EMP software has to be upgraded the ECN is restarted. If it fails to
start, it will automatically fall back to the Fallback Software.
Command Level:
ecn(config system)#
36
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Managing Software
Syntax:
sw-upgrade {ftp-server <name> sw-path <path> control-file
<control-file>}
Arguments:
<name>
Type the name of the FTP server (use the
ftp-server command to define the server,
see Section 6.1 on page 35) where to fetch
the software
<path>
Path to the EAN software package relative
to the root of the FTP server, for example
/upgrade/eansw
<control-file>
The name of the control file. The file is
case sensitive and spaces are not allowed,
for example R10A02.zip.
Default Settings:
None
Examples:
The following example will fetch the new.pk.zip control file on the ftp1 server
located in the directory under the root: eansw.
ecn(config system)#sw-upgrade ftp-server ftp1 sw-path
/upgrade/eansw control-file R10A02.zip
6.3
Updating EMP SW
Command Usage:
Use this command to install new software in the EMP. The command should be
executed after the SW has been uploaded to the ECN. The EMP will restart
automatically after the command is executed.
For more information about how to upload SW files please refer to the
installation guides for the ECNs.
Be careful when updating the fallback software. Only update to software that
has been used in the network, as it is important that the fallback software will
work.
Command Level:
ecn(config system)#
Syntax:
update software {enc|fallback}
2/1553-LZA 101 464-V1 Uen C 2010-02-02
37
EMP CLI User Guide
Arguments:
{enc | fallback
Updates the application SW or fallback
software of the EMP
Default Settings:
None
Examples:
ecn(config system)#update software enc
ecn(config system)#update software fallback
6.4
Installing SW for Embedded Nodes and ECN Switch
Command Usage:
Use this command to install new software for the embedded nodes in the ECN.
The command should be executed after the SW has been uploaded to the ECN.
The new SW is recognized by the file name, and will automatically be uploaded
to the relevant embedded nodes. The embedded nodes will automatically
restart after the command is executed. For more information about how to
upload SW files please refer to the installation guides for the ECNs.
Command Level:
ecn(config system)#
Syntax:
install software
Arguments:
None
Default Settings:
None
Examples:
ecn(config system)#install software
6.5
Cleaning Up Temporary Storage
Command Usage:
Use this command to clean up tmp/sw-loader. The command deletes all
files in the temporary sw-loader storage area. When installing or updating
software, the software package is first transferred to this storage area. After
the installation or update has been performed, see Section 6.4 on page 38 and
Section 6.3 on page 37, the software is automatically deleted from the storage
area. If the software has not been installed, but is still located in the storage
area, it can be deleted by using this command.
38
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Managing Software
Command Level:
ecn(config system)#
Syntax:
clean-up-temporary-storage
Arguments:
None
Default Settings:
None
Examples:
ecn(config system)#clean-up-temporary-storage
2/1553-LZA 101 464-V1 Uen C 2010-02-02
39
EMP CLI User Guide
40
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Management Configuration
Management Configuration
Use these commands to configure SNMP management, local management
and EM-PEM management.
7.1
SNMP
Command Usage:
Use this command to configure the followings:
Parameters for SNMP versions
Engine ID calculation method for SNMPv3
Define (add or remove) users to one of the 3 predefined groups:
administrator, guest and public. Users must belong to one of these groups.
Each group has different security level. For a user belonging to the
administrator group, parameters for authentication and encryption (privacy)
must be configured. For a user belonging to the guest group, authentication
parameters must be configured. For a user belonging to the public group a
user name is defined. Access rights for each group can be defined.
Configure (add or remove) up to four Alarm Receivers. All alarms will be
sent except for the alarms defined in the Alarm Filter (see Section 15.1
on page 131)
Configure (add or remove) one Alarm Statistics Receiver. Only alarms
defined in the Alarm Statistics Filter (see Section 15.2 on page 132) will
be sent
Command Level:
ecn(config system)#
Syntax:
snmp access {administrator|guest|public}{read-only|readwrite}
snmp add {admin-user <admin-username> authentication
{md5|sha} auth-passwd <auth-passwd> priv-passwd
<priv-passwd> | guest-user <guest-username> authentication
{md5|sha} auth-passwd <auth-passwd> | public-user
<pub-username>}
snmp alarm-receiver {add|remove} <ip-address>
snmp alarm-receiver statistics {add|remove} <ip-address>
snmp remove {admin-user|guest-user|public-user} <name>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
41
EMP CLI User Guide
snmp engine-calculation {default|mac-address|sys-name}
snmp version {snmpv2|snmpv3}
snmp v2support {none|read-only|read-write}
snmp v2view {administrator|guest|public}
Arguments:
42
{administrator | guest |
public}
SNMP access: 3 groups are
preconfigured
{read-only | read-write}
Defines access rights for the 3 groups:
administrator, guest or public.
{md5 | sha} <auth-passwd>
Authentication can be based on
the MD5 or SHA algorithm. A user
password for authentication is selected
<priv-passwd>
A user password for encryption is
selected, if the user belongs to the
administrator group
<guest-username>
Configure a user belonging to the
guest group
<public-username>
Configure a user belonging to the
public group. For a public-user no
authentication method, authentication
password or password for encryption
is selected since authentication and
encryption are not used.
{add | remove} <ip-address>
Add or remove the alarm receiver.
<ip-address> specifies the ip address
of the alarm receiver
{admin-user | guest-user |
public-user} <name>
Use this command to remove a
specific user
{default | mac-address |
sys-name}
Choose the method to calculate the
engine ID that uniquely identifies the
node
{snmpv2 | snmpv3}
This command is used to switch
between SNMPv2 and SNMPv3. If
SNMPv3 configuration is made it will
be ignored by executing the command
version v2. The SNMPv3 configuration
will be reestablished by the command
version v3
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Management Configuration
Arguments:
{none | read-only |
read-write}
When running SNMPv3 it is possible to
allow SNMPv2 requests. The access
rights to SNMPv2 are set with this
command.
{administrator | guest |
public}
SNMP V2 View: This command
defines the group of MIBs that is
accessible. The administrator group
has access to all MIBs. The guest
group has access to standard and
private device MIBs. The public group
has access to standard MIBs
Note:
It is possible to add up to four alarm receivers.
Default Settings:
Table 4
Default Settings
Groups
(Context
name)
Access
Security
Level
Users (Pred
efined)
Password
Administrator
Read-write
User authen
tication and
encryption is
activated
PEM
auth: admini
strator
priv: administ
rator
Guest
Read-only
User authe
ntication is
activated
guest
auth: guesta
uth
Public
Read-only
No security
activated
anonymous
engine id: default (0x200000000000000000000002)
authentication: md5
version: snmpv2
v2support: none
v2view: public
Examples:
ecn(config system)#snmp access administrator read-write
ecn(config system)#snmp add admin-user administrator
authentication md5 auth-passwd qwert123 priv-passwd
123qwert
ecn(config system)#snmp alarm-receiver add 172.30.3.9
2/1553-LZA 101 464-V1 Uen C 2010-02-02
43
EMP CLI User Guide
7.2
Local Management
Command Usage:
Use this command to control untagged management traffic from and to a port,
and direct traps to a local connected PC. The command enables or disables
untagged management traffic from one of the ports. Used before and after
uploading SW from the PC to the ECN. When lct-receiver is enabled the EMP
will forward SNMP traps to the PC. The type of the traps is defined by the type
argument. To send traps to another trap receiver, use the IP argument. Note
that if the local-trap lct-receiver is disabled and an IP address is defined, traps
will be sent only to the remote trap receiver specified by the IP address.
When local or global management is disabled, the port will be set back to the
default settings specified in Section 9.3 on page 52.
Command Level:
ecn(config system)#
Syntax:
local-management local-traps ip <ip-address>
local-management local-traps lct-receiver {enable|disable}
local-management local-traps local-traps type {1|2|3}
local-management snmp-communities read <string>
local-management snmp-communities set <string>
local-management port {<port>|disable}
Arguments:
44
<ip-address>
Sends traps to a remote host. The
IP address of the remote host must
be specified in dotted decimal format:
xxx.xxx.xxx.xxx
{enable | disable}
Enables or disables sending of traps to the
local connected PC
type {1 | 2 | 3}
Specifies the format of the traps. Type 1:
SNMP v1 traps. Type 2: SNMP v2 traps.
Type 3: SNMP v2 informs. Specify the
read SNMP community
read <string>
Specifies the read SNMP community
set <string>
Specifies the set SNMP community
port {<port> | disable}
Enables the designated port for untagged
management traffic or disables untagged
management traffic. For the ECN330 port
25, 26 and 27 can be used
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Management Configuration
Default Settings:
port disable
lct-receiver enabled
ip 0.0.0.0
type 3
set : public
read: public
Examples:
ecn(config system)#local-management port 25
ecn(config system)#local-management local-traps
lct-receiver enable
ecn(config system)#local-management local-traps type 2
ecn(config system)#local-management snmp-communities read
public
7.3
EM-PEM Management
Command Usage:
Use this command to set the port for EM-PEM management or to disable
EM-PEM management. If EM-PEM management is enabled on a port, that port
is connected to the public management VLAN for untagged traffic. By default
the ECN does not allow untagged traffic through the uplink ports. VLAN 246
is configured as external management VLAN, so VLAN 246 is configured as
tagged VLAN on all uplink ports.
This means that incoming and outgoing traffic tagged with VLAN ID 246 can
pass these ports. If pem-management is enabled on one uplink port of the
ECN, VLAN 246 is configured as untagged on this port. This means that
untagged traffic running through that port is internally tagged with VLAN 246. A
host connected to this port sending and receiving untagged traffic (like a normal
PC) would appear like being connected to VLAN 246.
This function allows a PC to be connected to a port of the ECN and reach the
EM-PEM management VLAN.
When local or global management is disabled, the port will be set back to the
default settings specified in Section 9.3.1 on page 52.
Command Level:
ecn(config system)#
Syntax:
pem-management port {<port>|disable}
2/1553-LZA 101 464-V1 Uen C 2010-02-02
45
EMP CLI User Guide
Arguments:
{<port> | disable}
Disable or set the port for EM-PEM
management. For the ECN330 port 25, 26
and 27 can be used
Default Settings:
Disabled
Examples:
ecn(config system)#pem-management port disable
46
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Configuring VLAN
Configuring VLAN
Use these commands to configure service VLAN and configure RADIUS and
TACACS Servers.
8.1
Service VLAN
Command Usage:
This command may be used to allow the use of the External management VLAN
for End-user traffic. When the command service-vlan use-management-vlan
enable is executed, it is allowed to define a service with the same VLAN ID
as the External Management VLAN.
Stop!
For security reasons it is highly recommended not to enable the External
management VLAN on the downlink ports (default).
Command Level:
ecn(config system)#
Syntax:
service-vlan use-management-vlan {enable|disable}
Arguments:
{enable | disable}
Enable or disable the use of service traffic
on external management VLAN
Default Settings:
Disabled
Examples:
ecn(config system)#service-vlan use-management-vlan enable
ecn(config system)#service-vlan use-management-vlan
disable
8.2
VLAN Unaware
Command Usage:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
47
EMP CLI User Guide
Use this command to enable or disable VLAN unaware mode of the switching
unit. When it is enabled, the ECN is transparent for all service and user VLANs.
VLAN tag is still considered for management traffic.
Command Level:
ecn(config system)#
Syntax:
vlan-unaware {enable|disable}
Arguments:
{enable | disable}
Enables or disables the VLAN unaware
mode of the switching unit
Default Settings:
Disabled
Examples:
ecn(config system)#vlan-unaware enable
48
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
ECN Configuration
Ethernet Controller Node commands. . The show command for all ECN
configurations is described in Section 9.15 on page 80.
9.1
External VLAN
Command Usage:
Use this command to add or remove external VLAN IDs and specify which ports
are tagged and untagged traffic. External VLANs can be used by third-party
products or other nodes outsite the EAN, connected to an auxialiary port. Rules
for external VLANs:
VLANs reserved for management and ANCP are not allowed.
Only auxiliary ports may be specified as untagged.
If no external VLAN is defined as untagged, then the command port
admin-use decides the VLAN set as untagged (for example VLAN 1 for
uplink and auxiliary ports).
A port may not be both tagged and untagged simultaneously on same
VLAN.
Only one VLAN can be set as untagged on a port.
An auxiliary port may not be change by the command port admin-use if
there is a VLAN defined as untagged on the port.
Command Level:
ecn(config)#
Syntax:
ecn external-vlan add vlan-id <vlan-id> [tagged-ports
<number>][untagged-ports <number>]
ecn external-vlan remove {vlan-id <id> ports <number>|all}
Arguments:
<vlan-id>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Specifies the ID of the external VLAN
49
EMP CLI User Guide
Arguments:
<number>
Specifies set of port numbers that runs
tagged and untagged traffic. For example:
1,2,3,10-12 means switch ports with
numbers 1,2,3,10,11,12 on the ECN
all
Removes the VLANs from all ports. But
VLAN needed on some ports due to
configuration of DSL or Ethernet lines are
kept
Default Settings:
No external VLANs are created.
Examples:
ecn(config)#ecn external-vlan add vlan-id 333 tagged-ports
1-10,18,19 untagged-ports 14,15
ecn(config)#ecn external-vlan remove vlan-id 333 all
9.2
Inventory Commands
Use these command to remove unreachable nodes from the inventory and
configure inventory polling interval.
9.2.1
Remove Node from ECN Inventory
Command Usage:
Use this command to remove nodes from the inventory table, for example a
node that is no longer in use or a node that is replaced with a different type
of node (for example EDN312 instead of EDN110). Nodes that are of the
same type can just be replaced physically without any further action. A line
configuration associated with the removed node is lost.
Command Level:
ecn(config)#
Syntax:
ecn inventory remove {node <node>|all}
Arguments:
<node>
Specifies the number of the node in the
format a.b
all
Removes all unreachable nodes from the
inventory table.
Default Settings:
50
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
None
Examples:
ecn(config)#ecn inventory remove node 1.0
ecn(config)#ecn inventory remove all
9.2.2
ECN Inventory Polling
Command Usage:
Use this command to set the parameters for polling. Polling messages are sent
to ensure that nodes in the network are still reachable. The command is used
to configure how often polling messages is send when answers is received and
how often and how many times they are send if no answers are received.
The timeout value should be set high enough to allow the embedded element to
answer in order to avoid false unreachable alarms.
Changes made by this command only come into effect after a restart of the
EMP. Restarting the EMP using the restart enc command (see section 3.5.5 on
page 18) does not affect end user traffic.
Command Level:
ecn(config)#
Syntax:
ecn inventory polling poll-interval <interval> timeout
<time> max-tries <max-tries>
Arguments:
<interval>
Sets the time between 2 polling cycles.
Range 1-18000000 ms
<time>
Sets the time to wait for an answer before
retransmitting a polling message. Range
10-22000 ms
<max-tries>
Sets the number of times to send a polling
message when no answer is received.
Range 1-5.
Default Settings:
interval: 30000
time: 1000
max-tries: 3
Examples:
ecn(config)#ecn inventory polling poll-interval 16000
timeout 800 max-tries 4
2/1553-LZA 101 464-V1 Uen C 2010-02-02
51
EMP CLI User Guide
9.3
Port Commands
The spanning tree interface commands and how to configure a port as uplink,
downlink and auxiliary port are described in this section. The spanning tree
protocol commands are described in Section 9.4 on page 59.
9.3.1
Configuring Port
Command Usage
Use this command to configure the port as an uplink, downlink or auxiliary port.
For the ECN430 the command is used to configure a port as an uplink or a
downlink port. Trying to configure a downlink port on an ECN330 as an uplink
port will give a failure message. The command is used to enable or disable
service VLANs on a port and to withdraw one or more ports from the ordinary
EAN so the port(s) can be used for other purposes without the control from
EMP. An EMP disabled port is called an auxiliary switch port.
In general, all ports on the ECN can be disabled from the EMP. This includes
both uplink and downlink ports. However ports configured to other functions,
can not be disabled, and trying to do so will issue an error message.
The following ports can not be disabled:
Port configured to local management
Port configured to global management
Ports configured to be part of link-aggregation (uplink or downlink).
Port configured to connect daisy-chained extension switch
The last port on ECN330 node used for (external) management; at least
one uplink port must be kept for management
Ports on which an element is registered in the Inventory table (reachable
or unreachable)
If a port is disabled then it is not possible to set the above configurations. It is
thus not possible to set local or global management on a disabled port, and not
possible to let a disabled port be part of link-aggregation, or use it to connect a
daisy-chained switch extension. And it is not possible to add an unmanaged
switch on a disabled port.
If a port is disabled then DHCP requests received from embedded elements
indicating that this port should be used, will cause an alarm, and the DHCP
request will be rejected.
Command Level:
ecn(config)#
Syntax:
52
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
ecn port <port> adm-use {uplink|downlink|auxiliary}
{default-vlans|vlans [internal-mgmt {enable|disable}]
[external-mgmt {enable|disable}] [servicevlan
{enable|disable]}
Arguments:
<port>
ECN port number that can be either one
number or x-y, where x is a lower port
number and y is the higher port number.
{uplink | downlink |
auxiliary}
Configures how the port is used.
{default | vlans}
Configures the port with default VLAN
settings or not.
{enable | disable}
Enables or disables internal management
VLAN, external management VLAN and
service VLAN.
.The VLANs for the ECN430 are from factory disabled as shown in Table 5
on page 53.
Table 5
ECN430
ECN330
ECN320
Factory VLAN Settings
Port
Adm. Use
External
VLAN
Internal
VLAN
Service
VLAN
1 to 23
Downlink
Disabled
Disabled
Disabled
24 to 27
Uplink
Disabled
Disabled
Disabled
1 to 24
Downlink
Disabled
Enabled
Enabled
25 to 27
Uplink
Enabled
Disabled
Enabled
1 to 24
Downlink
Disabled
Enabled
Enabled
25 to 26
Uplink
Enabled
Disabled
Enabled
Default VLAN Settings describes the VLAN configuration chosen by EMP,
when the administrative use of a port is changed and the VLAN configuration
is not explicitly stated.
Table 6
ECN430
ECN330
Default VLAN Settings
Port
Adm. Use
External
VLAN
Internal
VLAN
Service
VLAN
1 to 23
Downlink
Disabled
Enabled
Enabled
24 to 27
Uplink
Enabled
Disabled
Enabled
1 to 24
Downlink
Disabled
Enabled
Enabled
25 to 27
Uplink
Enabled
Disabled
Enabled
2/1553-LZA 101 464-V1 Uen C 2010-02-02
53
EMP CLI User Guide
ECN320
54
Port
Adm. Use
External
VLAN
Internal
VLAN
Service
VLAN
1 to 24
Downlink
Disabled
Enabled
Enabled
25 to 26
Uplink
Enabled
Disabled
Enabled
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Examples:
ecn(config)#ecn port 27 adm-use uplink vlans external-mgmt
enable servicevlan enable
9.3.2
Spanning-tree Cost
Command Usage:
Use this command to configure the spanning tree path cost for the specified
interface. The command is used by the Spanning Tree Algorithm to determine
the best path between devices. Therefore, lower values should be assigned
to ports attached to faster media, and higher values assigned to ports with
slower media.
Path cost takes precedence over port priority.
When spanning tree path-cost-method is set to short, the maximum value
for path cost is 65,535.
Command Level:
ecn(config)#
Syntax:
ecn port <port> spanning-tree cost <cost>
Arguments:
<port>
The ECN port no. Range 1 to 27.
<cost>
The path cost for the port. Range
1-200,000,000.
The recommended range is:
Ethernet: 200,000-20,000,000
Fast Ethernet: 20,000-2,000,000
Gigabit Ethernet: 2,000-200,000
Default Settings:
100.000
Examples
ecn(config)#ecn port 1 spanning-tree cost 20000
9.3.3
Spanning-tree Edge Port
Command Usage:
Use this command to specify an interface as an edge port. This option
can be enabled if an interface is attached to a LAN segment, that is at the
end of a bridged LAN or to an end node. Since end nodes cannot cause
forwarding loops, they can pass directly through to the spanning tree forwarding
state. Specifying Edge Ports provides quicker convergence for devices
2/1553-LZA 101 464-V1 Uen C 2010-02-02
55
EMP CLI User Guide
such as workstations or servers, retains the current forwarding database
to reduce the amount of frame flooding required to rebuild address tables
during reconfiguration events, does not cause the spanning tree to initiate
reconfiguration when the interface changes state, and also overcomes other
STA-related timeout problems. However, remember that Edge Port should only
be enabled for ports connected to an end-node device. If the port is connected
to an EDN312x the edge port must be enabled.
Note:
This command has the same effect as the command: spanning-tree
port-fast.
Command Level:
ecn(config)#
Syntax:
ecn port <port> spanning-tree edge-port {enable|disable}
Arguments:
<port>
ECN port number 1 to 27
{enable | disable}
Enables or Disables Edge Port
Default Settings:
Disabled
Examples
ecn(config)#ecn port 1 spanning-tree edge-port disabled
9.3.4
Rapid Spanning-tree Link Type
Command Usage:
Use this command to configure the link type for Rapid Spanning Tree. Specify
a point-to-point link if the interface can only be connected to exactly one other
bridge, or a shared link if it can be connected to two or more bridges.
When automatic detection is selected, the switch derives the link type from the
duplex mode. A full-duplex interface is considered a point-to-point link, while a
half-duplex interface is assumed to be on a shared link.
RSTP only works on point-to-point links between two bridges. If a port is
designated as a shared link, RSTP is forbidden.
Command Level:
ecn(config)#
Syntax:
ecn port <port> spanning-tree link-type
{auto|point-to-point|shared}
56
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Arguments:
<port>
ECN port number 1 to 27
{auto | point-to-point |
shared}
Automatically derived from the duplex
mode setting, or point-to-point link, or
shared medium
Default Settings:
Auto
Examples
ecn(config)#ecn port 1 spanning-tree link-type
point-to-point
9.3.5
Spanning-tree Fast Forwarding
Command Usage:
Use this command to set an interface to fast forwarding. The command is used
to enable or disable the fast spanning tree mode for the selected port. In this
mode, ports skip the Discarding and Learning states, and proceed straight to
Forwarding.
Since end-nodes cannot cause forwarding loops, they can be passed through
the spanning tree state changes more quickly than allowed by standard
convergence time. Fast forwarding can achieve quicker convergence for
end-node workstations and servers, and also overcome other STA related
timeout problems. (Remember that fast forwarding should only be enabled for
ports connected to a LAN segment, that is, at the end of a bridged LAN or for
an end-node device.)
This command is the same as spanning-tree edge-port, and is only included for
backward compatibility with earlier products. Note that this command may be
removed in future software versions.
Command Level:
ecn(config)#
Syntax:
ecn port <port> spanning-tree port-fast {enable|disable}
Arguments:
<port>
ECN port number 1 to 27
{enable | disable}
Enables or disables the fast spanning tree
mode for the selected port
Default Settings:
Disabled
Examples
2/1553-LZA 101 464-V1 Uen C 2010-02-02
57
EMP CLI User Guide
ecn(config)#ecn port 1 spanning-tree port-fast disable
9.3.6
Spanning-tree Port Priority
Command Usage:
Use this command to configure the priority for the specified interface. The
command defines the priority for the use of a port in the Spanning Tree
Algorithm. If the path cost for all ports on a switch is the same, the port with
the highest priority (that is, lowest value) will be configured as an active link
in the spanning tree.
Where more than one port is assigned the highest priority, the port with the
lowest numeric identifier will be enabled.
Command Level:
ecn(config)#
Syntax:
ecn port <port> spanning-tree port-priority <priority>
Arguments:
<port>
ECN port number 1 to 27
<priority>
The priority for the ECN port. Range:
0-240, in steps of 16
Default Settings:
128
Examples
ecn(config)#ecn port 1 spanning-tree port-priority 0
9.3.7
Spanning-tree Protocol Migration
Command Usage:
Use this command to check the appropriate BPDU (Bridge Protocol Data Units)
format to send on the selected interface. If at any time the switch detects STP
BPDUs, including Configuration or Topology Change Notification BPDUs, it
will automatically set the selected interface to forced STP-compatible mode.
However, the spanning tree protocol-migration command can be used at any
time to manually recheck the appropriate BPDU format to send on the selected
interfaces (RSTP or STP-compatible).
Command Level:
ecn(config)#
Syntax:
ecn port <port> spanning-tree protocol-migration
{enable|disable}
58
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Arguments:
<port>
ECN port number 1 to 27
{enable | disable}
Enables or disables port migration status
for spanning tree.
Default Settings:
Disabled
Examples
ecn(config)#ecn port 1 spanning-tree protocol-migration
enable
9.4
Spanning Tree Protocol
The spanning tree protocol commands follow in this section. The spanning-tree
interface commands are described in Section 9.3 on page 52.
9.4.1
Spanning-tree Bridge Forward Time
Command Usage:
Use this command to configure the spanning tree bridge forward time. This
command is only active in the spanning tree root device. This command sets
the maximum time (in seconds) the root device will wait before changing states.
This delay is required because every device must receive information about
topology changes before it starts to forward frames. In addition, each port
needs time to listen for conflicting information that would make it return to a
blocking state; otherwise, temporary data loops might result.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree forward-time <forward-time>
Arguments:
<forward-time>
Configures the spanning tree bridge
forward time in seconds. The minimum
value is calculated as (max-age / 2) + 1,
though never less than 4. Range 4-30
seconds.
Default Settings:
15 seconds
Examples
ecn(config)#ecn spanning-tree forward-time 20
2/1553-LZA 101 464-V1 Uen C 2010-02-02
59
EMP CLI User Guide
9.4.2
Spanning-tree Hello Time
Command Usage:
Use this command to configure the spanning tree bridge hello time globally for
the ECN. The command is only active in the spanning tree root device. This
command sets the time interval (in seconds) at which the root device transmits
a configuration message.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree hello-time <hello-time>
Arguments:
<hello-time>
Time in seconds, (Range: 1-10 seconds).
The minimum value is calculated as
(max-age / 2) 1, though never greater
than 10.
Default Settings:
2 seconds
Examples
ecn(config)#ecn spanning-tree hello-time 5
9.4.3
Spanning-tree Max Age
Command Usage:
Use this command to configure the spanning tree bridge maximum age globally
for the ECN. The command is only active in the spanning tree root device.
This command sets the maximum time (in seconds) a device can wait without
receiving a configuration message before attempting to reconfigure. All device
ports (except for designated ports) should receive configuration messages
at regular intervals. Any port that ages out STA information (provided in the
last configuration message) becomes the designated port for the attached
LAN. If it is a root port, a new root port is selected from among the device
ports attached to the network.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree max-age <seconds>
60
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Arguments:
<seconds>
Time in seconds. Range: 6-40 seconds.
The minimum value is 2 x (hello-time + 1),
though never less than 6. The maximum
value is 2 x (forward-time 1), though
never greater than 40.
Default Settings:
20 seconds
Examples
ecn(config)#ecn spanning-tree max-age 40
9.4.4
Spanning-tree Mode
Command Usage:
Use this command to select the spanning tree mode for the ECN.
Spanning Tree Protocol
Uses RSTP for the internal state machine but sends only 802.1D BPDUs
(Bridge Protocol Data Units).
Rapid Spanning Tree Protocol
RSTP supports connections to either STP or RSTP nodes by monitoring the
incoming protocol messages and dynamically adjusting the type of protocol
messages the RSTP node transmits, as described below:
STP Mode - If the switch receives an 802.1D BPDU after a ports migration
delay timer expires, the switch assumes it is connected to an 802.1D bridge
and starts using only 802.1D BPDUs
RSTP Mode - If RSTP is using 802.1D BPDUs on a port and receives an
RSTP BPDU after the migration delay expires, RSTP restarts the migration
delay timer and begins using RSTP BPDUs on that port.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree mode {rstp|stp}
Arguments:
{rstp | stp}
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Select stp for Spanning Tree Protocol
(IEEE 802.1D), or rstp for Rapid Spanning
Tree Protocol (IEEE 802.1w).
61
EMP CLI User Guide
Default Settings:
RSTP
Examples
ecn(config)#ecn spanning-tree mode rstp
9.4.5
Rapid Spanning-tree Path-cost-method
Command Usage:
Use this command to configure the path cost method used for Rapid Spanning
Tree. The path cost method is used to determine the best path between
devices. Therefore, lower values should be assigned to ports attached to faster
media, and higher values assigned to ports with slower media (attached with
the spanning tree cost command). Note that path cost takes precedence over
port priority.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree path-cost-method {long|short}
Arguments:
{long | short}
Long specifies 32-bit based values that
range from 1-200,000,000, and short
specifies 16-bit based values that range
from 1-65535.
Default Settings:
Long
Examples
ecn(config)#ecn spanning-tree path-cost-method long
9.4.6
Spanning-tree Priority
Command Usage:
Use this command to configure the spanning tree priority globally for the ECN.
Bridge priority is used in selecting the root device, root port, and designated
port. The device with the lowest priority becomes the STA root device.
However, if all devices have the same priority, the device with the lowest MAC
address will become the root device.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree priority <priority>
62
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Arguments:
<priority>
Priority of the bridge. (Range: 0 61440).
(Range: 0-61440, in steps of 4096;
Options: 0, 4096, 8192, 12288, 16384,
20480, 24576, 28672, 32768, 36864,
40960, 45056, 49152, 53248, 57344,
61440).
Default Settings:
32.768
Examples
ecn(config)#ecn spanning-tree priority 16384
9.4.7
Enable or Disable Spanning-tree
Command Usage:
Use this command to enable or disable the spanning tree. The Spanning Tree
Algorithm (STA) can be used to detect and disable network loops, and to
provide backup links between switches, bridges or routers.
Command Level:
ecn(config)#
Syntax:
ecn spanning-tree status {enable|disable}
Arguments:
{enable | disable}
Note:
Enables or disables spanning tree
Telnet connection will be lost
Default Settings:
Disabled
Examples
ecn(config)#ecn spanning-tree status disable
9.4.8
Spanning-tree Transmission Limit
Command Usage:
Use this command to configure the minimum interval between the transmissions
of consecutive RSTP BPDUs (Bridge Protocol Data Units). The command
limits the maximum transmission rate for BPDUs.
Command Level:
ecn(config)#
2/1553-LZA 101 464-V1 Uen C 2010-02-02
63
EMP CLI User Guide
Syntax:
ecn spanning-tree transmission-limit <seconds>
Arguments:
<seconds>
The transmission limit in seconds. Range
1-10 seconds.
Default Settings:
3 seconds
Examples
ecn(config)#ecn spanning-tree transmission-limit 4
9.5
Link Aggregation
Command Usage:
Use this command to configure a trunk of several ports that can be used as
a single link.
The command is only used for ECN320 and ECN330.
Link aggregation in ECN430 is configured with the switch CLI (RCLI). For
more information about link aggregation in ECN430 please refer to ECN430
Switch/EMN120 CLI User Guide and the ESN212 and ESN204g CLI User
Guide.
Ports can be statically grouped into an aggregation link (that is a trunk) to
increase the bandwidth of a network connection or to ensure fault recovery. For
example, a trunk consisting of two 1000 Mbps ports can support an aggregated
bandwidth of 2 Gbps when operating at full duplex.
The ECN320 supports up to six active trunks and ECN330 supports up to 13
active trunks.
A port can only join a trunk if the configuration of the port (port settings, VLAN,
QoS) matches the configuration of the trunk.
On uplink ports either the Link Aggregation Control Protocol (LACP, IEEE
802.3ad) can be used to automatically negotiate a trunk link between the ECN
and another network device or a static trunk can be configured. For LACP
trunks, the switches have to comply with LACP. For static trunks the switches
have to comply with the Cisco EtherChannel standard.
When link aggregation is configured on the downlink ports it must be configured
in the EDN312x as well in order to work. The EDN312x is in the Inventory
regarded as connected to the primary port, thus it is edn node a.0 where a is the
primary port number which need to have the link-configuration set to link-aggr.
Command Level:
ecn(config)#
64
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Syntax:
ecn link-aggregation create-trunk primary <primary>
secondary <secondary>
ecn link-aggregation remove-trunk primary <primary>
ecn link-aggregation uplink {lacp|static} primary <primary>
secondary <secondary>
ecn link-aggregation uplink off
Arguments:
create-trunk
Create a down link trunk for link
aggregation.
<primary>
ECN port number. The number must be
smaller than the secondary port number.
The primary port is the port that appears in
the inventory. Range 1 to 23 for down link
ports. For uplink ports either one port in
the range 26 to 27 can be specified or two
ports can be specified as "26,27".
<secondary>
ECN port number. The number must
be larger than the primary port number.
Range 2 to 25 for down link ports. For
uplink ports either one port in the range 26
to 27 can be specified or two ports can be
specified as "26,27".
remove-trunk
Remove a down link trunk from the link
aggregation configuration.
{uplink lacp | static}
LACP can be enabled on switch uplink
ports (25, 26 and 27 for ECN330). The
other device must comply with LACP.
Static is used to create a static trunk,
and the other device must support Cisco
EtherChannel standard..
uplink off
Disable link aggregation on all uplink ports.
Default Settings:
None
Examples:
ecn(config)#ecn link-aggregation create-trunk primary 1
secondary 2
ecn(config)#ecn link-aggregation uplink static primary 26
secondary 27
2/1553-LZA 101 464-V1 Uen C 2010-02-02
65
EMP CLI User Guide
9.6
Redundancy
The EAN redundancy is achieved by using EDN312x (containing two 100
Mbps uplinks) and an expansion kit. The expansion kit contains an extra
ECN. One ECN is configured as Active, while the other ECN is configured
as Standby. During normal operation, all data and management traffic goes
through the active ECN. When either the active ECN, the uplink connecting
it to the network, or the link between the ECN and the EDN312x fails, the
EDN312x will go over to unmanaged state, and all the End-user data will be
directed through the standby ECN.
Note:
Rapid Spanning Tree (RSTP) must be enabled in both ECNs for
redundancy to work. One ECN must be configured as standby and
the other as active.
Command Level:
ecn(config)#
Syntax:
ecn redundancy work-mode {active|standby}
Arguments:
{active | standby}
Redundancy work mode of the ECN
Default Settings:
Active
Examples:
ecn(config)#ecn redundancy work-mode standby
9.7
Unmanaged Switch
Command Usage:
Use this command to add or remove an unmanaged switch.
The unmanaged-switch function is used to enable the ECN port for a 3rd party
switch. Valid ECN ports are port 1 to 24.
The 3rd party switch must be configured with the value listed in Table 7 on
page 67. For more detailed information for configuration please refer to the
3rd party switch user guides.
Note:
The configuration must be done through the console port of the 3rd
party switch and the 3rd party switch must comply with RFC1493.
Command Level:
ecn(config)#
Syntax:
66
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
ecn unmanaged-switch {add|remove} port <port> ip
<ip-address>
ecn unmanaged-switch remove port <port>
Arguments:
{add | remove}
Add or remove an unmanaged switch
<port>
Only downlink ECN ports number 1-24 is
allowed
<ip-address>
The IP address of the unmanaged switch
Default Settings:
None
Table 7
Preconfiguration of the 3rd Party Switch
Parameter
Value
Switch IP address (Static IP)
10.0.0.1 to 10.0.0.254, see Figure 1
on page 68.
Netmask
255.255.0.0
Gateway
10.0.100.1
Admin VLAN
247
SNMP
Enabled
VLAN Operation Mode
Port Based VLAN
VLAN Information
VID: 247
All ports must be added as members.
Community String
Public
Trap Managers IP address
10.0.100.1
2/1553-LZA 101 464-V1 Uen C 2010-02-02
67
EMP CLI User Guide
Figure 1
Configure 3rd Party Switch
Examples:
ecn(config)#ecn unmanaged-switch add port 2 ip 10.0.0.2
9.8
Unmanaged Node
Command Usage:
Use this command to add or remove an unmanaged node connected to an
embedded ESN212 to the inventory of the ECN.
Only RSC96 Power Supply System can be used as an unmanaged node. For
detailed information about this implementation please refer to Adding Power
One RSC96 to EAN guide in the Solution Descriptions folder.
The command configures the ECN to recognize the unmanaged node
connected to a specific port of an embedded ESN212.
Only internal IP address can be used for an unmanaged node.
The IP address must be unique within the EAN, but can be reused in another
EAN.
The unique identification of the unmanaged node is the combination of ECN
IP Address + Node ID in the traps.
68
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
The CLI is the only way to configure (add/remove) and readout, the connection
between ESN212 and the unmanaged node.
The unmanaged node must be configured as described in the guide: Adding
Power One RSC96 to EAN.
Command Level:
ecn(config)#
Syntax:
ecn unmanaged-node add node <a.b> ip <ip-address>
ecn unmanaged-node remove node <a.b>
Arguments:
{add | remove}
Add or remove an unmanaged node on the
specified port of the ESN212.
<a.b>
a specifies the ESN212 and can be any
ESN212 connected to the ESN. b specifies
the port of the ESN212 and can be any
number from 1 to 12.
<ip-address>
Specifies the IP address of the unmanaged
node that is added. The IP range to use
will be the same as reserved for switch
extensions, 10.0.0.1 to 10.0.0.254.
From the inventory of the ECN the existing
unmanaged nodes can be seen. Use the
command: show ecn inventory.
Default Settings:
None
Examples:
Connect unmanaged node with IP-address 10.0.0.55 to port 9 of ESN212 with
ID 1002.
ecn(config)#ecn unmanaged-node add node 1002.9 ip
10.0.0.55
ecn(config)#ecn unmanaged-node remove node 1002.9
9.9
Unmanaged Node Polling
Command Usage:This command is used to configure the ECN to use a
specific OID for polling of unmanaged nodes.
The OID is used for all unmanaged nodes within the same EAN. It is possible to
change the OID without restart.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
69
EMP CLI User Guide
Command Level:
ecn(config)#
Syntax:
ecn unmanaged-node polling <oid>
Arguments:
<oid>
The OID that will be queried in the polling
Default Settings:
oid = 1.3.6.1.2.1.1.2 (the default sysObjectID OID).
Examples:
ecn(config)#ecn unmanaged-node polling 1.3.6.1.2.1.1.2
9.10
Unmanaged Node SNMP Version
Command Usage:
Use this command to configure the ECN to use a specific SNMP version
towards all unmanaged nodes in the EAN.
The SNMP version is used for all unmanaged nodes within the same EAN. It is
possible to change SNMP version without restart.
The command sets the SNMP version used between the ECN and the
unmanaged node. Allowed versions are 1 and 2.
Command Level:
ecn(config)#
Syntax:
ecn unmanaged-node snmp-version <version>
Arguments:
<version>
Allowed versions are 1 and 2.
Default Settings:
Version = 1
Examples:
ecn(config)#ecn unmanaged-node snmp-version 1
9.11
IGMP Commands for ECN320
The following IGMP commands are only valid for ECN320. For ECN330 and
ECN430 IGMP functions are set per VLAN, and this is done through the ECN
switch CLI. Logon to the switch CLI using the command rcli 0.0 Please refer to
70
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
the ECN switch CLI user Guide for more information about how to configure
the switch as IGMP proxy. The IGMP proxy is disabled per default in the
ECN330 and ECN430.
9.11.1
IGMP Snooping Querier
Command Usage:
Use this command to enable or disable IGMP querier in the ECN320.
If multicast routing is not supported on other switches in the network, use
IGMP Snooping and Query to monitor IGMP service requests passing between
multicast clients and servers, and dynamically configure the switch ports that
need to forward multicast traffic.
Command Level:
ecn(config)#
Syntax:
ecn ip igmp snooping querier {enable|disable}
Arguments:
{enable | disable}
Enables or disables IGMP snooping
querier.
Default Settings:
Enabled
Examples:
ecn(config)#ecn ip igmp snooping querier enable
9.11.2
IGMP snooping proxy-query-address
Command Usage:
This command configures the source address for IGMP query messages that
the ECN320 sends if the querier function is enabled.
Command Level:
ecn(config)#
Syntax:
ecn ip igmp snooping proxy-query-address <ip-address>
Arguments:
<ip-address>
The IP address to be used in the queries.
The format is xxx.xxx.xxx.xxx.
Default Settings:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
71
EMP CLI User Guide
In ECN320 the IP address is set to the External management IP address. In
ECN330 and ECN430 the proxy address for all the VLANs is set to 0.0.0.0.
However the proxy in the ECN330 and ECN 430 is disabled by default.
Examples:
ecn(config)#ecn ip igmp snooping proxy-query-address
172.30.105.117
9.12
Switch Extension
Command Usage:
Use this command to add or remove a switch extension to the inventory of the
ECN (add or remove an ESN310, ECN320 in ESN310 switch, ECN330 switch,
ECN330a switch or ESN410 switch). The command is not used in the ECN430.
This command can also be used to enable or disable service VLAN
configurations on the interconnecting ports (11 and 12) on ESN410 extension
switches.
Executing the command:
1. Adds the switch to the ECN inventory.
2. For the first switch added (node 0.1), the ECN uplink-port status changes
to EMP enabled internal. This applies for all extension switch types,
except 410-uplink, where the port status is changed to EMP enabled
internal-external.
As a consequence of the command execution:
3. All service VLANs from the extension switch(es) are configured on the
uplink ports when these are in use (unless the ecn switch-extension
interconnection-esn410 service-vlan disable command has been used).
4. Internal management VLANs (247 and 248) are configured on the ECN
uplink port.
The switch must be configured with the values listed in Table 8 on page 72.
For more detailed information about configuring the switch refer to section 4 on
page 152 and to the ESN310 User Guide and the ECN User Guide.
Note:
Table 8
72
The extension switch configuration must be done through the console
port of the extended switch.
Required Configuration of the ESN310 Switch, ESN410 and ECN
Switch
Parameter
Value
Switch IP address (Static IP)
10.0.0.1 to 10.0.0.254
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Parameter
Value
Netmask
255.255.0.0
Gateway
10.0.100.1
Management VLAN
247 tagged
248 untagged
SNMP
Enabled
VLAN Operation Mode
Port Based VLAN
VLAN Information
VID: 247
Community String
Public
Trap Managers IP address
10.0.100.1
NTP Server
10.0.100.1
Ingress-filtering (ESN410)
Enabled
Command Level:
ecn(config)#
Syntax:
ecn switch-extension add <switch-type> remote-uplink-port
<port> ip <ip-address>
ecn switch-extension remove <node-no>
ecn switch-extension interconnection-esn410 service-vlan
{enable|disable}
Arguments:
{add | remove}
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Add or remove a switch extension on the specified
uplink port
73
EMP CLI User Guide
Arguments:
<switch-type>
Specifies the hardware type of the extension
switch.
The value of the parameter is esn310,
ecn320_esn310, ecn330-switch, ecn330a-switch,
esn410 or esn410-uplink.
ecn320_esn310 refers to an ECN320, which has
been downgraded to be a switch.
ecn330-switch and ecn330a-switch refer to
ECN330 and ECN330a respectively, downgraded
to be a switch.
esn410 refers to an ESN410, used as a switch
extension. This argument has the same effect
as esn410-uplink when used together with the
emp enable internal-external command on the
port of the ECN connected to the ESN410 switch
extension.
esn410-uplink has the same effect as esn410,
but in addition creates the external management
VLAN (VLAN 246) on the uplink port of the ECN
itself.
<port>
Specifies the uplink port of the previous switch, to
which the switch extension is connected. The port
parameter connects the extension switch. For the
first switch extension, this refers to the port on the
ECN. This is port 25 or 26 when adding a switch
extension to an ECN330, or port 11 or 12 for
ESN410, when adding to more than one ESN410.
For example, when one ESN410 is daisy chained
to the ECN, the remote-uplink-port refers to the
uplink port of the ECN. When a second ESN410
is added to the daisy chain, remote-uplink-port
refers to the uplink port on the previous (in this
case, the first) ESN410.
ECN330 port 27 must not be used for
daisy-chaining.
This argument is only mandatory for the first
switch extension.
74
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Arguments:
<ip-address>
Specifies the IP address of the switch that is
added.
The IP address must be within the range that is
reserved for the embedded nodes, which means
in the range from 10.0.0.1 to 10.0.0.254.
<node-no>
The node number, which may be 0.1, 0.2, 0.3
and so on, where the first daisy chained node is
node number 0.1
{enable | disable}
Enables or disables the configuration of service
VLANs on ports 11 and 12 on all ESN410
extension switches.
Default Settings:
Service VLAN configuration on port 11 and 12 is enabled on ESN410 extension
switches.
Example 1:
Add three daisy chained ESN310 switches, see Figure 2 on page 75.:
Figure 2
Configure Extended Switches - Daisy Chain Topology
ecn(config)# ecn switch-extension add esn310 remote-uplink
-port 25 ip 10.0.0.1
(Port 25 here refers to the port on node 0.0.)
ecn(config)# ecn switch-extension add esn310 remote-uplink
-port 25 ip 10.0.0.2
(Port 25 here refers to the port on node 0.1.)
2/1553-LZA 101 464-V1 Uen C 2010-02-02
75
EMP CLI User Guide
ecn(config)# ecn switch-extension add esn310 remote-uplink
-port 25 ip 10.0.0.3
(Port 25 here refers to the port on node 0.2.)
Note:
The switch extension can be added to the ECNs inventory before the
connection between the ECN and the extended switch is established.
However, the extended switch will be unreachable until it is connected.
Remove two extension switches again:
ecn(config)# ecn switch-extension remove 0.3
ecn(config)# ecn switch-extension remove 0.2
Note:
The connection between the ECN and the extended switch has to be
unreachable before it is possible to remove the switch extension.
If all the extension switches are removed, the uplink port of the ECN330 is
reconfigured to allow traffic only on the external management VLAN.
The second and third switch extensions can also be added without specifying
the port:
ecn(config)# ecn switch-extension add esn310 ip 10.0.0.2
ecn(config)# ecn switch-extension add esn310 ip 10.0.0.3
Example 2:
Add three ESN410 switches and disable service VLANs on the interconnecting
links, see Figure 3 on page 77:
76
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Figure 3
Configure Extended Switches - Star Topology
ecn(config)# ecn switch-extension add esn410-uplink
remote-uplink-port 25 ip 10.0.0.1
(Port 25 here refers to the port on node 0.0.)
ecn(config)# ecn switch-extension add esn410-uplink
remote-uplink-port 11 ip 10.0.0.1
(Port 11 here refers to the port on node 0.1.)
ecn(config)# ecn switch-extension add esn410 remote-uplink
-port 11 ip 10.0.0.2
(Port 11 here refers to the port on node 0.2.)
ecn(config)# ecn switch-extension add esn410 remote-uplink
-port 12 ip 10.0.0.3
(Port 12 here refers to the port on node 0.3.)
ecn(config)# ecn switch-extension interconnection-esn410
service-vlan disable
Note:
For star topology, these commands must refer to the switches in
the order in which they are added as switch-extensions (and not
necessarily to their physical configuration order). The node numbers
are assigned according to the order in which the switch-extensions are
added. Similarly, the remote-uplink-port number refers to the port of
the switch added before (in other words, at an earlier time than) the
switch that is being added.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
77
EMP CLI User Guide
Other Examples Network Topologies with ESN410 as Switch Extension
ESN410s can be used as switch extensions with ECNs in many different
configurations.
Some topology examples are shown in Figure 4 on page 78. Table 15 on
page 86 indicates which switch type must be used for each extension switch.
The table also indicates whether service VLANs can be disabled, using the
command ecn switch-extension interconnection-esn410 service-vlan disable, to
prevent the flow of service traffic between extension switches.
Figure 4
ESN410 Used as Extension Switches
Table 9
78
Exampl
e
First Extension
Switch Type
2 or More
Extension
Switches
Disable Service
VLANs
ESN410
ESN410
No
ESN410
ESN410
Yes
ESN410-uplink
ESN410
No
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
9.13
Exampl
e
First Extension
Switch Type
2 or More
Extension
Switches
Disable Service
VLANs
ESN410-uplink
ESN410
Yes
ESN410-uplink
ESN410
No
Auto Rediscover
Command Usage:
The command is used to configure the automatic rediscovery function. Normally
elements are discovered though an initial DHCP sequence. But under more
special circumstances, for example when an ECN is replaced, elements having
a separate power supply, may not detect this and do a new DHCP-request. The
element will thus not be discovered by ECN and remain unmanaged until next
DHCP renewal (up to 24 hours) although it carries traffic. To circumvent this, a
ping is periodically broadcasted to discover such ghost embedded elements
To discover ghost-elements a ping is broadcasted out on the internal
management VLAN (default 247). If a ping response is received from an
element (IP address) not known in the current inventory in the EMP, a
reset-on-lan is sent, which in turn will make the element restart and run a
normal DHCP-discover sequence that makes it known to the EMP.
Command Level:
ecn(config)#
Syntax:
ecn auto-rediscover state {enable|disable}
ecn auto-rediscover interval <1-60>
Arguments:
{enable | disable}
Enables or disables the function.
<1-60>
Specifies the period in minutes
Default Settings:
State: Enabled
Interval: 5 minutes
Examples:
ecn(config)#ecn auto-rediscover state disable
9.14
Specifying Switch Location
Command Usage:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
79
EMP CLI User Guide
Use this command is used to specify a location for a switch.
Command Level:
ecn(config)#
Syntax:
ecn location node <node> location {<string>|none}
Arguments:
<node>
The node number of the switch in the
format a.b for example 1.0, which refers
to the ESN212 connected to port 1 of the
ECN.
{<string> | none}
The parameter <string> specifies a location
for a switch. Specifying none will remove
the location specified for a switch.
Default Settings:
None
Examples:
ecn(config)#location node 1.0 location Paris
ecn(config)#location node 1.0 location none
9.15
Show ECN
Command Usage:
This command is used to display the different configuration and status in the
ECN.
Command Level:
ecn#
Syntax:
show ecn {external-vlan {tag|vlan-id <id>|port
<port>}|inventory|link-aggregation|polling|port <port> span
ning-tree|redundancy|spanning-tree|ip| switchextension|
switch-ports|auto-rediscover|unmanaged-node| location}
ecn auto-rediscover interval <1-60>
Arguments:
external-vlan tag /
vlan-id <id> / port
<port>
80
Show information about external VLAN
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ECN Configuration
Arguments:
inventory
Shows the following for the embedded
nodes:
Port No (node ID in a.b format)
Reachable / Unreachable
Name of the node
HW version of the node
IP address
SW versions
link-aggregation
Show all trunks configured for link
aggregation. Not valid for ECN430
polling
Show information about polling
redundancy
Show status of ECN redundancy
spanning-tree
Show port settings of spanning tree
parameters for the elements
ip
Show all configurations related to IP
switch-extension
Show all configured switch extensions. Not
valid for ECN430
switch-ports
Shows information about the ports on the
ECN
auto-rediscover
Show the setting for auto rediscover
Unmanaged-node
Show all global configurations related to
the unmanaged nodes
port <port> spanning-tree
Show spanning tree information for the port
on the ECN switch. The port number must
be in the range 1 to 27.
location
Show information about the location of the
switches
Default Settings:
None
Interval: 5 minutes
Examples:
ecn#show ecn inventory
ecn#show ecn port 4 spanning-tree
2/1553-LZA 101 464-V1 Uen C 2010-02-02
81
EMP CLI User Guide
82
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EDN Commands
10
EDN Commands
Use these commands to configure the uplink of an embedded IP DSLAM.
.
10.1
Uplink Configuration
Command Usage:
The command will configure the IP DSLAM to use link redundancy or link
aggregation.
Command Level:
ecn(config)#
Syntax:
edn <node> link-configuration <secondary>
{single-link|redundancy|link-aggr}
Arguments:
<node>
Specifies the node no. of the EDN (IP
DSLAM)
single-link
Use this argument if there is only one uplink
redundancy
Use this argument if the IP DSLAM is
used in redundancy scenario. When this
option is selected the IP DSLAM must be
connected with one uplink to an active
ECN, and with the other uplink to a standby
ECN. RSTP must be enabled in both
ECNs.
link-aggr
Use this argument if link aggregation
is used towards the ECN. The link
aggregation (trunk) for the two connected
ports on the ECN must be configured in the
ECN using CLI commands
Default Settings:
None
Examples:
ecn(config)#edn 1.0 link-configuration single-link
2/1553-LZA 101 464-V1 Uen C 2010-02-02
83
EMP CLI User Guide
10.2
Show EDN Configuration
Command Usage:
This command is used to display EDN configuration.
Command Level:
ecn#
Syntax:
show edn <node> link-configuration
Arguments:
<node>
Specifies the node no. of the EDN (IP DSLAM) in
a.b format
Default Settings:
None
Examples:
ecn#show edn 1.0 link-configuration
84
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
11
DSL Port Commands
Use these commands to configure DSL Ports.
11.1
Configuring Line Parameters
Command Usage:
Use this command to configure the ADSL line parameters like alarm thresholds,
impulse noise protection and so on. This is the lowest level of the protocols.
Additional information about specific parameters can be found in ITU-T G.997.1
Physical layer management for digital subscriber lines (DSL) transceivers.
Each line configuration sets the line with specific parameters.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> channel 0 {downstream|upstream}
[data-rate-alarm-threshold <bitrate>][impulse-noise-prote
ction {no-inp|half-dmt|one-dmt|two-dmt|four-dmt|eight-dm
t|sixteen-dmt}][min-bit-rate <min-bit-rate>] [max-bit-rate
<max-bit-rate>][interleave-delay <time>]
dslport <dslport> channel 0 downstream power-down-mode
{enable|disable}
Arguments:
<dslport>
The DSL-port to configure. The
parameter a.b.c refers to the ECN port
(a), the ESN108 port (b) and the IP
DSLAM line (c).
{downstream | upstream}
Sets the downstream and upstream
parameters for the line.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
85
EMP CLI User Guide
Arguments:
86
data-rate-alarm-threshold
<bitrate>
Configures the IP DSLAM to send
an alarm if the actual data rate of
the line is less than the predefined
value (bit_rate). Different values can
be set for upstream and downstream
traffic. Range downstream: 0-128000,
upstream: 0-64000. To disable
the alarm set the data rate alarm
threshold to a lower value than the
Minimum data rate for that direction.
Values equal or higher will enable the
alarm. The range for each direction
is between zero and Maximum data
rate. An alarm will be issued when
the actual data rate is lower than the
specified Data rate alarm threshold for
upstream.
impulse-noise-protection
The ability of the ADSL transmission
to withstand corruption of data due to
noise impulses. This parameter sets a
requirement to the transmission, and
it is related to the data rate and the
interleave delay parameters.
{no-inp | half-dmt | one-dmt
| two-dmt | four-dmt |
eight-dmt | sixteen-dmt}
The Impulse Noise Protection (INP)
unit is DMT (discrete multitone)
symbols which is equivalent to 250
S in ADSL, ADSL2 and ADSL2+.
Half DMT will cause the transmission
to withstand (correct errors due to) a
noise pulse with 125 S duration, one
DMT will withstand a pulse of 250 S
duration and so on.
min-bit-rate <min-bit-rate>
Sets the Minimum Bit Rate within
the range of 0-128000 kbps for
downstream and the range of 0-64000
kbps for upstream
max-bit-rate <max-bit-rate>
Sets the Maximum Bit Rate within
the range of 64-128000 kbps for
downstream and the range of
64-64000 kbps for upstream.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
interleave-delay <time>
Interleave delay in msec or specific S
value. The Interleaved delay improves
the error correction capabilities of the
ADSL connection (and therefore less
retransmissions).
Range: 2 to 254 ms
S0 = Maximum Interleave Delay in the
IP DSLAM
S1 = No delay (0 ms) in the IP DSLAM
This correspond to fast path
S2 = 1 ms. Interleave Delay in the IP
DSLAM (only used on VDSL)
power-down-mode {enable |
disable}
When there is only a little traffic the IP
DSLAM can be set to go in an energy
saving state (enable).
For more information about the line parameters refer to the EMP Web Interface
User Guide.
Default Settings:
Table 10
Channel Default Settings
Downstream
Upstream
Minimum bit rate
32 kbps
32 kbps
Maximum bit rate
512 kbps
256 kbps
Interleave delay
20 ms
20 ms
Power down mode
Disabled
impulse-noise-protection: half-dmt when interleave-delay has the default value
20 ms.
Examples:
ecn(config)#dslport 1.0.1 channel 0 downstream
min-bit-rate 32 max-bit-rate 512 interleave-delay 20
ecn(config)#dslport 1.0.1 channel 0 downstream
min-bit-rate 32 max-bit-rate 512 interleave-delay S1
ecn(config)#dslport 1.0.1 channel 0 downstream
data-rate-alarm-threshold 64000
ecn(config)#dslport 1.0.1 channel 0 downstream
impulse-noise-protection half-dmt
2/1553-LZA 101 464-V1 Uen C 2010-02-02
87
EMP CLI User Guide
11.2
Configuring ADSL Transmission Properties
Command Usage:
Use this command to set properties of the ADSL transmission. All the target
and time arguments are related to Rate Adaptation Mode. The Rate Adaptation
Mode argument is only related to lines that operate with ADSL2 or ADSL2+.
On lines operating with ADSL1 this parameter will not have any influence. The
possible values from the CLI correspond to RFC2662. The corresponding
values in ITU-T G.997.1 are Manual (fixed), At_Init (at-startup) and Dynamic
(at-runtime). For more information about the rate adaptation please refer
to ITU-T 997.1 or RFC2662.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> line downstream [dmt-carrier-mask <mask>]
[delta-psd-annex-1 <delta-psd-annex-1>][delta-psd-normal
<delta-psd-normal>]
[delta-psd-plus <delta-psd-plus>][max-snr-margin <margin>]
[max-tx-power <transmit-power>][min-snr-margin <margin>]
[min-downshift-margin <margin>][min-downshift-time <time>]
[min-upshift-margin <margin>][min-upshift-time <time>]
[rate-adaption-mode {fixed|adapt-at-startup|adapt-at-run
time}]
[target-snr-margin <margin>]
[transmit-psd {fixed|priority-to-power|priority-to-rate}]
dslport <dslport> line upstream [dmt-carrier-mask <mask>]
[delta-psd-annex-1 <delta-psd-annex-1>][delta-psd-annex-m
<delta-psd-annex-m>]
[delta-psd-normal <delta-psd-normal>][max-snr-margin
<margin>]
[max-rx-power <receive-power>][max-tx-power <transmit-powe
r>]
[min-snr-margin <margin>][min-downshift-margin <margin>]
[min-downshift-time <time>][min-upshift-margin <margin>]
[min-upshift-time <time>]
[rate-adaption-mode {fixed|adapt-at-startup|adapt-at-run
time}]
[target-snr-margin <margin>]
dslport <dslport> line prm-protection {disable|12khz|16khz}
dslport <dslport> line auto-configuration {enable|disable}
dslport <dslport> line tssi-shape
[no-of-breakpoints <no-of-breakpoints> breakpoints
<breakpoints>]
[adsl2-protocol <protocol>]
dslport <dslport> line tx-filter-id <filter-id>
88
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
dslport <dslport> line hx-tx-psd [a43 <hs-tx-psd>]
[b43 <hs-tx-psd>][cab <hs-tx-psd>]
Arguments:
<dslport>
The DSL-port to configure. The
parameter a.b.c refers to the ECN
port (a), the ESN port (b) and the IP
DSLAM line (c).
dmt-carrier-mask
<mask>
Sets the DMT (Discrete Multi Tone)
carrier mask. 128 hexadecimal
characters, default downstream and
16 hexadecimal characters, default
upstream
delta-psd-annex-1
<delta-psd-annex-1>
Defines the maximum PSD configured
as a delta with respect to the
Annexplus. Allowed range is -400 to
-40 0.1 dBm/Hz. Only downstream.
delta-psd-annex-m
<delta-psd-annex-1>
Defines the maximum PSD Annex
M. Allowed range is -400 to -32 0.1
dBm/Hz.
delta-psd-normal
<delta-psd-normal>
Defines the maximum nominal PSD
configured as a delta with respect to
the Annexs maximum nominal PSD,
ADSL/2/2+ Annex A/B. Allowed range
is -400 to -40 0.1 dBm/Hz.
delta-psd-plus
<delta-psd-plus>
Defines the maximum nominal PSD
configured as a delta with respect to
ADSL2+. Allowed range is -400 to -40
0.1 dBm/Hz. Only downstream
max-snr-margin
<margin>
Sets the Maximum SNR (Signal To
Noise) margin in dB. Range 0-31 dB.
max-rx-power
<receiver-power>
Defines the maximum received power
at the ATU-C, expressed in 0.1 dBm.
The ATUC will request an Upstream
Power Cutback such that the power
received at the ATUC is not higher
than Max. Rx Power Upstream.
The parameter applies to ADSL2
and ADSL2+ only. Allowed range is
[-50..200] 0.1 dBm.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
89
EMP CLI User Guide
Arguments:
90
upstream max-tx-power
<transmit-power>
Defines the maximum allowed
transmitted power used in the
upstream direction, expressed in 0.1
dBm. Allowed range is [-130..200] 0.1
dBm. Note that for the EDN612nef
the maximum value is 145 although a
higher value can be inserted without
receiving any failure message.
delta-psd-plus
<delta-psd-plus>
Defines the maximum nominal PSD
configured as a delta with respect to
ADSL2+. Allowed range is -400 to -40
0.1 dBm/Hz. Only downstream
downstream max-tx-power
<transmit-power>
Defines the maximum allowed
transmitted power used in the
downstream direction, expressed in
0.1 dBm. Allowed range is [-50..230]
0.1 dBm. Note that for the EDN612nef
the maximum value is 145 although a
higher value can be inserted without
receiving any failure message..
min-snr-margin
<margin>
Sets the Minimum SNR (Signal To
Noise) margin in dB. Range 0-31 dB
min-downshift-margin
<margin>
Sets the Minimum Downshift Margin in
dB. Range 0-31 dB.
min-downshift-time
<time>
Sets Minimum Downshift Time in
seconds. Range 0 -16383 seconds.
The Downshift SNR margin and
Min Downshift Time are only valid
if Rate Adaptation Mode is set to
adapt-at-runtime. If the Actual SNR
Margin falls below the Downshift SNR
margin for more than Min Downshift
Time the line will be temporarily closed
and reinitialized at a lower bit-rate
min-upshift-margin
<margin>
Sets the Minimum Upshift Margin in
dB. Range 0-31 dB
min-upshift-time
<time>
Sets the Minimum Upshift Time in
seconds. Only valid if Rate Adaptation
Mode is set to adapt-at-runtime.
Range 0 16383 seconds
rate-adaption-mode
{fixed | adapt-at-startup |
adapt-at-runtime}
Select the rate adaptation mode
either fixed, adapt-at-startup or
adapt-at-runtime
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
state
{enable | disable}
The DSL line can be activated or
deactivated. Select enable to activate
the line or disable to deactivate the line
target-snr-margin
<target-snr-margin>
Sets the Target SNR Margin in dB.
Range 1-31 dB. The Target SNR
margin is the ultimate condition
that always must be achieved for
successful training.
transmit-psd
{fixed | priority-to-power |
priority-to-rate}
ADSL transmission mode (PSD:
Power Spectral Density) can be set to:
fixed A constant 19 dB output power
from IP DSLAM. This setting is the
default setting for the IP DSLAM.
priority-to-power The output power
will be the lowest possible and the
bandwidth will be between minimum
peak cell rate and maximum peak cell
rate
priority-to-rate The output power is
optimized to reach maximum peak cell
rate with the lowest possible output
power
prm-protection
{disable | 12khz | 16khz}
s used for 12/16 kHz Private Metering
(PRM) support for DSL line.
disable (default) Will disable the
PRM pulse signaling for the DSL line.
enable 12kHz Will enable 12 KHz
PRM signaling for the DSL line.
enable 16kHz Will enable 16 KHz
PRM signaling for the DSL line.
Please note that if the PRM Protection
is enabled the performance for the
upstream bit rate can be about 15%
lower.
tssi-shape no-of-breakpoints
<no-of-breakpoints>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Defines the number of breakpoints.
Allowed range is [0..16]
91
EMP CLI User Guide
Arguments:
breakpoints
<breakpoints>
A hexadecimal string which defines
the PSD breakpoints. One breakpoint
is represented by two byte (16 bits).
Bit0-bit6 represents the value of log
TSSI for the breakpoint at the defined
Tone, expressed in dB. The range is 0
to 124 (1 = -0.5 dB). Zero represents
zero dB while 124 represent -62 dB.
Bit7-bit15 represents Tone Index for
which a PSD breakpoint is set. The
range is 0 to 511. For more information
see the EMP Web Interface User
Guide
Please note that the maximum
number of breakpoints is 16. All the
breakpoints values have to be entered
in a continuous hex string.
auto-configuration
{enable | disable}
Enables or disables the ILMI (Interim
Local Management Interface)
auto-configuration on the port. ILMI is
used to configure the CPE modem with
the upstream bandwidth parameters.
This however requires that the CPE
modem support ILMI.
tssi-shape adsl2-protocol
<protocol>
Defines the ADSL2 protocol type.
Allowed range is 0-7.
1: G.992.3 Annex A/B/J
2: G.992.5 Annex A/B/M
3: G.992.3 Annex A/B/J + G.992.5
Annex A/B/M
4: G.992.3 Annex L
5: G.992.3 Annex A/B/J + G.992.3
Annex L
6: G.992.5 Annex A/B/M + G.992.3
Annex L
7: G.992.3 Annex A/B/J + G.992.5
Annex A/B/M + G.992.3 Annex L
92
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
tx-filter-id
<tx-filter-id>
Enables a high pass filter for ADSL2+
cabinet deployment with a cutoff tone
equal to: 130 + 10 * filter I. The range
is 140 to 280 with steps of 10 tones. 0
means that the filter is disabled. The
filter id range is [0..15].
hs-tx-psd
Defines the handshake carrier level
of ADSL handshakes. PSD level can
be defined for the following G.994.1
carrier set designations.
a43 <hx-tx-psd> - Mainly for Annex
A. The range from -128 to -32 and 0.
The unit is dBm/Hz.
b43 <hx-tx-psd> - Mainly for Annex
B. The range from -128 to -32 and 0.
The unit is dBm/Hz.
cab <hx-tx-psd> - Mainly for cabinet
deployment. The range from -128 to
-32 and 0. The unit is dBm/Hz
For more information about the parameters refer to the EMP Web Interface
User Guide.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
93
EMP CLI User Guide
Default Settings:
Table 11
Line Default Settings
Parameter
Downstream
Upstream
Target SNR margin
6.0 dB
6.0 dB
Maximum SNR margin
6.0 dB
6.0 dB
Minimum SNR margin
0.0 dB
0.0 dB
Rate adaption mode
Adapt-at-startup
Adapt-at-startup
Minimum downshift
margin
0 dB
0 dB
Minimum downshift time 0 s
0s
Minimum upshift margin
0 dB
0 dB
Minimum upshift time
0s
0s
Transmit-psd
Fixed
PRM protection
Disable
Disable
Auto-configuration
Disable
Disable
State
Disable
Disable
Note:
The following rules apply: Minimum Noise Margin Downshift Noise
Margin Target Noise Margin Upshift Noise Margin Maximum
Noise Margin.
Examples:
ecn(config)#dslport 1.0.1 line downstream dmt-carrier-mask
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
FFFFFFFFFFFFFFFFFFFFFFFFFFF delta-psd-annex-1 -200
max-snr-margin 1 min-downshift-margin 1 min-downshift-time
1 rate-adaption-mode disable target-snr-margin 1
ecn(config)#dslport 1.0.1 line downstream max-snr-margin
9 min-downshift-margin 1 min-downshift-time 400
min-upshift-margin 6 min-upshift-time 400
ecn(config)#dslport 1.0.1 line downstream transmit-PSD
fixed
11.3
Resetting Performance Data Counter
Command Usage:
Use this command to reset the performance data counters that are counting
error parameters of the line in the ADSL, ATM, and Ethernet layers. Different
counters count relevant parameters in each layer.
94
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
The uplink port of the ESN108 can supply the uplink node with power over the
Ethernet cable. The ability to supply a node with power over the Ethernet cable
in the upstream direction can be enabled by the ECN by this command. It
can be disabled or set to auto as well.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> performance-data reset-counters
Arguments:
<dslport>
The DSL-port to configure. Insert the
dslport in the format a.b.c where the
parameter a.b.c refers to the ECN port (a),
the ESN108 port (b) and the IP DSLAM
line (c)
performance-data
Error parameters of the line in the ADSL,
ATM, and Ethernet layers. Different
counters count relevant parameters in
each layer.
reset-counters
Reset the performance data counters
Default Settings:
None
Examples:
ecn(config)#dslport 1.0.1 performance-data reset-counters
11.4
PVC Commands
Use these commands to configure PVC parameters.
Table 12
Overview of PVC Commands
pvc general
Configure general setting for the PVC
pvc atm
Configure ATM Service Classes,
VPI and VCI and enable upstream
policing for the PVC
pvc bandwidth
Set the bandwidth for a service
pvc ethernet
Enable forced forwarding (layer-2)
and specify MAC address count limit
pvc ip
Specify IP parameters
2/1553-LZA 101 464-V1 Uen C 2010-02-02
95
EMP CLI User Guide
11.4.1
pvc remove
Remove the specified PVC
pvc vlan
Define the mapping between a PVC
and a VLAN (VLAN ID) and set the
priority tag of the VLAN (Ethernet
priority)
General PVC Settings
Command Usage:
Use this command to set the End-users access method to the network for the
service and to configure the relay agent identifier. The relay agent configuration
can only be selected for a DHCP or PPP access method. The IP DSLAM will
insert an identifier in all DHCP requests or PoE Active Discovery Requests
(PADR) from the End-user, and thereby allow the Service Operator (Access
Provider) to authenticate and control the rights to assign IP addresses to
End-users. String is one of the identifier methods where specific characters are
inserted. A string of up to 253 octets (characters) can be inserted. For further
information refer to the System Description.
The access method used will depend on the equipment used by the Service
Provider and the CPE equipment.
Refer to the System Description for more information on the Relay Agent
options for transmitting line characteristics in DHCP Option 82.
In the example below, the number 4 has been used in the command, thus
indicating that the method: Circuit ID String has been selected.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> pvc <pvc> general
[cpe-access-method <access-method>]
[relay-agent-remoteid-configuration <relay-agent-remoteid-co
nfiguration>]
[relay-agent-circuitid-configuration <relay-agent-circuiti
d-configuration>]
[relay-agent-remoteid-string <string>]
[relay-agent-circuitid-string <string>]
[relay-agent-options {all|none|{[adsl-transmission-system
][access-loop-encapsulation][downstream-actual-data-rate
][downstream-minimum-data-rate][downstream-attainable-data
-rate][downstream-maximum-data-rate][downstream-minimum-da
96
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
ta-rate-low-power-state][downstream-maximum-interleave-del
ay][downstream-actual-interleave-delay][upstream-actual-da
ta-rate][upstream-minimum-data-rate][upstream-attainable-d
ata-rate][upstream-maximum-data-rate][upstream-minimum-dat
a-rate-low-power-state][upstream-maximum-interleave-delay
][upstream-actual-interleave-delay]}}]
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
<variable>
Configure the specified PVC number or
service ID number. Range 1-8 for ADSL
and 9 to 16 for VDSL.
pvc <pvc>
Configure the specified PVC number or
service ID number. Range 1 to 8 for ADSL
and 9 to 16 for VDSL
cpe-access-method
<access-method>
End-users access method to the network:
dhcp - DHCP
static-ip-o-lan - Static IP
transparent_lan - Transparent LAN
ppp_o_ethernet - PPP over Ethernet
ppp_o-atm - PPP over ATM
ppp_automatic - PPP Automatic
static_ip_o_atm - Static IP over ATM
dynamic_ip_o_atm - Dynamic IP over
ATM
transparent_ip_o_atm - Transparent IP
over ATM
2/1553-LZA 101 464-V1 Uen C 2010-02-02
97
EMP CLI User Guide
Arguments:
relay-agent-remoteid-conf
iguration
<method>
Select which DHCP Relay Agent
Information option method to use:
0 or not_used - Not used.
1 or string - String is a string of up to 253
octets that can be inserted.
2 or customer_number - Customer
Number is a format specified by
management system, which uses the
customer number as the id.
3 or eda is a format specified by Ericsson.
4 or cisco - A format specified by Cisco.
5 or tr101 - A standard specified by
TR101.
6 or tr101 flex - A flexible string specified
by TR101.
relay-agent-circuitid-con
figuration
<method>
Select which DHCP Relay Agent
Information option method to use:
0 or not_used - Not used.
1 or string - String is a string of up to 253
octets that can be inserted.
2 or customer_number - Customer
Number is a format specified by
management system, which uses the
customer number as the id.
3 or eda is a format specified by Ericsson.
4 or tr101 - A standard specified by
TR101.
5 or tr101 flex - A flexible string specified
by TR101.
relay-agent-remoteid-str
ing
<string>
98
String of up to 253 characters to be used
when the method is Remote ID String.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
relay-agent-circuitid-st
ring
<string>
String of up to 253 characters to be used
when the method is Circuit ID String.
relay-agent-options
<string>
Select the Relay Agent options desired, to
include line characteristics in the DHCP
Option 82. Any number of the Relay Agent
options may be specified. All includes all
options, and none excludes all options
Default Settings:
cpe-access-method: DHCP
relay-agent-configuration: Not used
relay-agent-options: None
Examples:
ecn(config)# dslport 1.0.1 pvc 1 general cpe-access-method
dhcp relay-agent-configuration 4 relay-agent-string user1of-netservice relay-agent-options adsl-transmission-system
downstream-actual-data-rate upstream-actual-data-rate
11.4.2
PVC ATM Settings
Command Usage:
Used to configure ATM Service Classes, VPI and VCI and enabling upstream
policing for the PVC.
VPI (Virtual Path ID) and VCI (Virtual Channel ID) are the ATM identification
of the PVC. The VPI range is 0 15. The VCI range is 0 255. The VPI and
VCI values must be the same as the corresponding values in the CPE modem.
The VPI and VCI are used only in the specific ADSL connection. Other IP
DSLAM ports may use the same set of VPI and VCI. Note that VCI 0 31 are
considered to be reserved for other purposes, and should therefore not be used.
Enable upstream policing Enabling upstream policing will force Ethernet
traffic policing on the data from a specific PVC. The parameters used are the
upstream bandwidth parameter, which are used for configuration of the CPE
modem (always enabled if the CPE modem supports ILMI), and the upstream
policing. The upstream policing discards Ethernet frames coming from the
End-user to the IP DSLAM if the rate exceeds the rate defined in the bandwidth
parameter. Note that since frames are discarded, higher application levels (for
example TCP) will retransmit the discarded frames.
Important
Upstream policing must be used with care, since Ethernet frames will be
discarded.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
99
EMP CLI User Guide
Command Level:
ecn(config)#
Syntax:
dslport <dslport> pvc <pvc> atm [atm-service-class <class>]
[upstream-policing {enable|disable}] [vci <vci>] [vpi
<vpi>]
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
<pvc>
Configure the specified PVC number.
Range 1-8.
<class>
4 ATM service classes (PVC types) can be
configured:
ubr - UBR service is Unspecified Bit Rate,
which is used for data transmissions.
vbr-nrt - VBR-nrt service is Variable
Bit Rate non real time, which is used
for video transmissions. It provides a
specified throughput capacity but data is
not sent evenly.
vbr-rt - VBR-rt is Variable Bit Rate
real time, which is used for real time
applications such as Telephony over IP.
cbr - CBR service is Constant Bit Rate
transmissions, which can be used for
Telephony over IP. It specifies a fixed
bit rate so that data is sent in a steady
stream. The configured bit rate is
reserved by the PVC, but can be used by
other services if there is no data to send.
upstream-policing
{enable | disable}
Enable or disable upstream policing
<vci>
Sets the VCI (Virtual Channel ID) as
identification of the PVC. Range 0 to 255.
<vpi>
Sets the VPI (Virtual Path ID) as
identification of the PVC. Range 0 to 15.
Default Settings:
atm-service-class: UBR
100
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
upstream-policing: Disabled
vpi: 0
vci: X+31, 32 for PVC 1, 33 for PVC 2, 34 for PVC 3 and so on.
Examples:
ecn(config)# dslport 1.0.1 pvc 1 atm atm-service-class ubr
upstream-policing enable vpi 1 vci 32
11.4.3
Bandwidth for a Service
Command Usage:
Use this command to set the bandwidth of the PVC for a service defining the
Peak Cell Rate, Sustainable Cell Rate and the Maximum Burst Size.
When ATM service class is set to ubr or cbr, Sustainable Cell Rate and
Maximum Burst Size is not used.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> pvc <pvc> bandwidth {downstream|upst
ream}[max-burst-size <size>] [peak-cell-rate <speed>]
[sustainable-cell-rate <speed>]
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
bandwidth
{downstream | upstream}
Downstream and upstream bandwidth.
<pvc>
Configure the specified PVC number.
Range 1-8.
<size>
Defines the maximum number of ATM cells
allowed in one burst at Peak Cell Rate. The
number of cells should be set according
to the size of the packets that should be
transferred. Note when calculating the
number of cells needed, that the payload
of an ATM cell is 48 byte. Range 1-65535.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
101
EMP CLI User Guide
Arguments:
peak-cell-rate
<vci>
Sets the maximum speed attainable in
traffic bursts through the PVC. Range
0-32768. It is used to limit the absolute
bandwidth used by the PVC. The traffic in
the PVC can never exceed the Peak Cell
rate. The Peak Cell rate should be equal to,
or greater than the Sustainable Cell Rate.
If no value is entered the value will be set
to zero, which means that the PVC will not
be created. The units of this parameter are
kbps (1.000 bits per second).
sustainable-cell-rate
<speed>
Sets the average speed through the PVC.
Range 0-32768. When Telephony over
IP is used, a minimum of 170 kbps per
channel is needed.
Default Settings:
None.
Examples:
ecn(config)# dslport 1.0.1 pvc 1 bandwidth downstream
max-burst-size 1 peak-cell-rate 32 sustainable-cell-rate
32
11.4.4
PVC Ethernet Settings
Command Usage:
Use this command to enable forced forwarding (layer-2), limit the number of
End-user devices or disable / enable local switching.
When MAC forced forwarding is enabled all the End-users upstream data is
checked for destination (layer-2) and always redirected to the default gateway.
Note:
Forced forwarding must not be selected together with Broadcast
allowed. This option is enabled only if Static IP Address or DHCP are
selected as the CPE Access Method.
If both MAC forced forwarding and local switching are enabled, MAC forced
forwarding has precedence, and local switching will not be used.
Command Level:
ecn(config)#
102
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
<pvc>
Configures the specified PVC number.
Range 1-8.
mac-forced-forwarding
{enable | disable}
Enabling or disabling MAC forced
forwarding.
<mac-address-count-limit>
Sets the maximum number of MAC
allowed. Range 0 - 254. If zero is set
as value the maximum number of CPE
devices will be unlimited.
local-switching
{enable | disable}
Enables or disables local switching to and
from the PVC, within the IP DSLAM.
Syntax:
dslport <dslport> pvc <pvc> ethernet
[ac-forced-forwarding {enable|disable}]
mac-address-count-limit <mac-address-count-limit>]
[local-switching {enable|disable}]
Default Settings:
mac-forced-forwarding: disabled.
mac-address-count-limit: 0
local-switching: enabled
Examples:
ecn(config)# dslport 1.0.1 pvc 1 ethernet mac-forced-forw
arding enable mac-address-count-limit 10 local-switching
disable
11.4.5
PVC IP Parameters
Command Usage:
Use this command to enable the subscriber to broadcast traffic on the VLAN,
to enable IGMP snooping, to add or remove one or more static IP addresses
and a default gateway.
Command Level:
ecn(config)#
Syntax:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
103
EMP CLI User Guide
dslport <dslport> pvc <pvc> ip [broadcast-allowed {enabl
e|disable}] [default-gateway <ip-address>][igmp-snooping
{enable|disable}] [static-ip {add|remove} <ip-address>]
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
<pvc>
Configures the specified PVC number.
Range 1-8.
broadcast allowed
{enable | disable}
Enables or disables the End-user to
broadcast traffic on the VLAN into which
the PVC is mapped.
default-gateway
<ip-address>
Sets the IP address of the default gateway.
igmp-snooping
{enable | disable}
With IGMP Ethernet, parallel transmission
of the same video stream is avoided.
Ethernet bandwidth is saved by snooping
the streaming requests from one user
and connecting them to an already active
stream towards another user.
static-ip
{add | remove}
<ip-address>
Sets or removes a static IP address.
Default Settings:
igmp-snooping: enabled.
broadcast-allowed: disabled
Examples:
ecn(config)# dslport 1.0.1 pvc 1 ip broadcast-allowed
enable default-gateway 192.168.1.1 igmp-snooping enable
static-ip add 192.168.1.3
11.4.6
Removing a PVC
Command Usage:
This command is used to remove a specified PVC.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> pvc <pvc> remove
104
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
<pvc>
Configures the specified PVC number.
Range 1-8.
remove
Removes the PVC.
Default Settings:
None
Examples:
ecn(config)# dslport 1.0.1 pvc 1 remove
11.4.7
Mapping PVC and VLAN
Command Usage:
Use this command to define on which VLAN upstream traffic from a PVC is
forwarded. Also downstream traffic received on the specified VLAN will be
sent on this PVC. The command is also used to set an Ethernet priority tag
of the VLAN in the range of 0-7. Seven is the highest priority and reserved
for management.
Note:
Management traffic is received and generated internally by the IP
DSLAM, and has no mapping connection with a PVC.
The VLAN will be configured on all ports of the ECN (both downlink and uplink)
and on all ports of daisy chained switch extensions.
Stop!
Do not use any of the VLAN IDs that are used for management. Apart from the
configurable management VLANs (246, 247, 248, and 249), VLANs 1 and
4093 are used internally in the ECN.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> pvc <pvc> vlan [ethernet-priority
<priority>] vlan-id <vlan-id>
2/1553-LZA 101 464-V1 Uen C 2010-02-02
105
EMP CLI User Guide
Arguments:
<dslport>
The DSL-port (a.b.c) to configure. The
parameter a.b.c refers to the ECN port (a),
the port of the switch between the ECN
and the IP DSLAM (b) and the IP DSLAM
line (c).
<pvc>
Configures the specified PVC number.
Range 1-8.
<priority>
Ethernet priority sets the priority tag of the
VLAN. Range 0-7.
<vlan-id>
VLAN ID is a number of the VLAN. Note
that VLAN ID nr. 246, 247 and 248 are the
default VLAN ID for management. VLAN
ID 1 is used for untagged traffic. Range 1
4092. VLAN IDs above 4092 are reserved.
Default Settings:
ethernet-priority: 0
Examples:
ecn(config)# dslport 1.0.1 pvc 1 vlan ethernet-priority 1
vlan-id 3
106
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
11.5
Configuring Auto-Transmission Mode
Command Usage:
There are different ADSL standards that can be used in an ADSL connection.
The use of the transmission mode depends on the equipment and installation
in the customer premises. The IP DSLAM supports multi-annex on a per line
basis, except for ADSL over ISDN. If ADSL over ISDN is used, all lines of the
same IP DSLAM are set to ADSL over ISDN.
This command requires at least two transmission modes to be specified
and gives the possibility to specify a user defined group of transmission
modes. If only one transmission group is specified or if the predefined groups
AUTO ADSL1 or AUTO ADSL2 can be used, use the CLI command dslport
transmission mode instead, see Section 11.6 on page 109.
The list of modes defined by this command overwrites any previous allowed
mode. That is, only the modes included in the last entered command will be
allowed.
Annex M and Annex J within the same ADSL standard (ADSL2 or ADSL2+)
are mutually exclusive. For example it is not possible to use ITU-T ADSL2
G.992.3 Annex M and ITU-T ADSL2 G.992.3 Annex J as modes in the same
command. It is possible to use ITU-T ADSL2 G.992.3 Annex M and ITU-T
ADSL2+ G.992.5 Annex J in the same command.
Use this command to configure two or more transmission modes that may
be used for the connection.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> configurable-auto-transmission-mode
<mode> <mode> [<mode>.....<mode>]
Arguments:
<dslport>
The DSL-port to configure. The parameter
a.b.c refers to the ECN port (a), the ESN
port (b) and the IP DSLAM line (c).
<mode>
The parameter <mode> is repeated for
each allowed transmission mode. Name or
number can be used. Range 1-21.
Note:
Because some CPE modems have errors in handling the automode
feature, it is recommended not to mix Annex A, B and M.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
107
EMP CLI User Guide
Numbers:
108
Range
Mode
01
AUTODETECT
AUTO ADSL1
AUTO ADSL2
ANSI T1.413
ETSI TS 101 388
ITU-T ADSL over POTS, G.992.1 Annex A
ITU-T ADSL over ISDN, G.992.1 Annex B
ITU-T ADSL Lite over POTS, G.992.2 Annex A
ITU-T ADSL2 over POTS, G.992.3 Annex A
10
ITU-T ADSL2 over ISDN, G.992.3 Annex B
11
ITU-T RE-ADSL2 over POTS, G.992.3 Annex A and L
12
ITU-T RE-Narrow PSD ADSL2 over POTS, G.992.3 Annex A and L
13
ITU-T ADSL2, G.992.3 Annex M
14
ITU-T ADSL2+ over POTS, G.992.5 Annex A
15
ITU-T ADSL2+ over ISDN, G.992.5 Annex B
16
ITU-T ADSL2+, G.992.5 Annex M
18
Auto Annex A
19
ITU-T VDSL2, G993.2
20
ITU-T ADSL2, G.992.3 Annex J
21
ITU-T ADSL2+, G992.5 Annex J
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Names:
Range
Name
01
autodetect
auto_adsl1
auto_adsl2
ansi_t1.413
etsi_ts_101_388
itu-t_adsl_over_pots,_g.992.1_annex_a
itu-t_adsl_over_isdn,_g.992.1_annex_b
itu-t_adsl_lite_over_pots,_g.992.2_annex_a
itu-t_adsl2_over_pots,_g.992.3_annex_a
10
itu-t_adsl2_over_isdn,_g.992.3_annex_b
11
itu-t_re-adsl2_over_pots,_g.992.3_annex_a_and_l
12
itu-t_re-narrow_psd_adsl2_over_pots,_g.992.3_annex_a_and_l
13
itu-t_adsl2,_g.992.3_annex_m
14
itu-t_adsl2+_over_pots,_g.992.5_annex_a
15
itu-t_adsl2+_over_isdn,_g.992.5_annex_b
16
itu-t_adsl2+,_g.992.5_annex_m
18
auto_annex_a
19
itu-t_vdsl2,_g.993.2
20
itu-t_adsl2,_g.992.3_annex_j
21
itu-t_adsl2+,_g.992.5_annex_j
Default Settings:
Autodetect
Examples:
ecn(config)#dslport 1.0.1 configurable-auto-transmission
-mode 6 8
11.6
Configuring Transmission Mode
Command Usage:
Use this command to configure the transmission modes that can be used for
the connection.
There are different ADSL standards that can be used in an ADSL connection.
The use of the transmission mode depends on the equipment and installation
on the customer premises. The IP DSLAM supports multi-annex on a per line
2/1553-LZA 101 464-V1 Uen C 2010-02-02
109
EMP CLI User Guide
basis, except for ADSL over ISDN. If ADSL over ISDN is used, all lines of the
same IP DSLAM are set to ADSL over ISDN.
Choosing AUTO ADSL1 or AUTO ADSL2 will let the IP DSLAM to decide which
access method is appropriate. ADSL1 includes a bunch of ADSL CPE access
methods. ADSL2 includes bunch of ADSL2 and ADSL2+ CPE access methods.
The list of modes defined by this command overwrites any previous allowed
mode. That is, only the modes included in the last entered command will be
allowed.
ITU-T G992.3 Annex J and G.992.3 Annex M cannot be used in the same
command, they exclude each other.
ITU-T G992.5 Annex J and G992.5 Annex M cannot be used in the same
command, they also exclude each other.
If other groups of transmission modes are needed, use the command:
configurable-auto-transmission-mode instead, see Section 11.5 on
page 107.
Note:
It is recommended to select AUTODETECT. AUTODETECT negotiates
with the CPE modem and selects automatically the transmission mode.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> transmission-mode <mode> [<mode>][<mode
>]......[<mode>]
Arguments:
<dslport>
The DSL-port to configure. The parameter
a.b.c refers to the ECN port (a), the ESN
port (b) and the IP DSLAM line (c).
<mode>
The parameter <mode> is repeated for
each allowed transmission mode. Name or
number can be used. Range 1-21.
Numbers:
110
Range
Mode
01
AUTODETECT
AUTO ADSL1
AUTO ADSL2
ANSI T1.413
ETSI TS 101 388
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Numbers:
Range
Mode
ITU-T ADSL over POTS, G.992.1 Annex A
ITU-T ADSL over ISDN, G.992.1 Annex B
ITU-T ADSL Lite over POTS, G.992.2 Annex A
ITU-T ADSL2 over POTS, G.992.3 Annex A
10
ITU-T ADSL2 over ISDN, G.992.3 Annex B
11
ITU-T RE-ADSL2 over POTS, G.992.3 Annex A and L
12
ITU-T RE-Narrow PSD ADSL2 over POTS, G.992.3 Annex A and L
13
ITU-T ADSL2, G.992.3 Annex M
14
ITU-T ADSL2+ over POTS, G.992.5 Annex A
15
ITU-T ADSL2+ over ISDN, G.992.5 Annex B
16
ITU-T ADSL2+, G.992.5 Annex M
18
Auto Annex A
19
ITU-T VDSL2, G993.2
20
ITU-T ADSL2, G.992.3 Annex J
21
ITU-T ADSL2+, G992.5 Annex J
2/1553-LZA 101 464-V1 Uen C 2010-02-02
111
EMP CLI User Guide
Names:
Range
Name
01
autodetect
auto_adsl1
auto_adsl2
ansi_t1.413
etsi_ts_101_388
itu-t_adsl_over_pots,_g.992.1_annex_a
itu-t_adsl_over_isdn,_g.992.1_annex_b
itu-t_adsl_lite_over_pots,_g.992.2_annex_a
itu-t_adsl2_over_pots,_g.992.3_annex_a
10
itu-t_adsl2_over_isdn,_g.992.3_annex_b
11
itu-t_re-adsl2_over_pots,_g.992.3_annex_a_and_l
12
itu-t_re-narrow_psd_adsl2_over_pots,_g.992.3_annex_a_and_l
13
itu-t_adsl2,_g.992.3_annex_m
14
itu-t_adsl2+_over_pots,_g.992.5_annex_a
15
itu-t_adsl2+_over_isdn,_g.992.5_annex_b
16
itu-t_adsl2+,_g.992.5_annex_m
18
auto_annex_a
19
itu-t_vdsl2,_g.993.2
20
itu-t_adsl2,_g.992.3_annex_j
21
itu-t_adsl2+,_g.992.5_annex_j
Arguments, cont.:
<priority>
Ethernet priority sets the priority tag of the
VLAN. Range 0-7.
<vlan-id>
VLAN ID is a number of the VLAN. Note
that VLAN ID nr. 246, 247 and 248 are the
default VLAN ID for management. VLAN
ID 1 is used for untagged traffic. Range 1
4092. VLAN IDs above 4092 are reserved.
Default Settings:
Autodetect
Examples:
ecn(config)# dslport 1.0.1 transmission-mode 2 3
112
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
11.7
VDSL PSD Line Configuration
Command Usage:
Use this command to configure different VDSL PSD line configuration
parameters.
There are different VDSP PSD parameters that can be configured with this
command. For further information see the EMP Web Interface User Guide.
Note:
The EDN624p only supports 8a, 8b, 8c and 8d.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> vdsl-psd {downstream|upstream}
adv-power-back-off {enabled|disabled}
dslport <dslport> vdsl-psd downstream esel <length> escma
<model> escmb <model> escmc <model> fmax <min-freq> fmin
<max-freq> min-esel <min-esel> mus <min-mask>
dslport <dslport> vdsl-psd upstream power-back-off
{enable us1a <us> us1b <us> us2b <us> us3a <us> us3b <us>
forced-e-length <e-length>}
dslport <dslport> vdsl-psd masks {mib-downstream|mib-upst
ream} {add carrier-index <index> psd-level <level>|delete
carrier-index <index> psd-level <level>|show}
dslport <dslport> vdsl-psd masks carrier-mask {add
start-carrier <integer> stop-carrier <integer>|delete
start-carrier <integer> stop-carrier <integer>|show}
dslport <dslport> vdsl-psd masks notch {add start-carrier
<start-carrier> stop-carrier <stop-carrier>|delete start-car
rier <start-carrier> stop-carrier <stop-carrier>|show}
dslport <dslport> vdsl-psd limit-mask {A_NUS0_PSD|A_EU_32_P
SD|A_EU_36_PSD|A_EU_40_PSD|A_EU_44_PSD|A_EU_48_PSD|A_EU_52
_PSD|A_EU_56_PSD|A_EU_60_PSD|A_EU_64_PSD|EX_ANSI_M1_PSD|EX
_ANSI_M2_PSD|CAB_ANSI_M1_PSD|CAB_ANSI_M2_PSD|EX_ANSI_M1e_P
SD|EX_ANSI_M2e_PSD|CAB_ANSI_M1e_PSD|CAB_ANSI_M2e_PSD|B8_1_
PSD|B8_2_PSD|B8_3_PSD|B8_4_PSD|B8_5_PSD|B8_6_PSD|B8_7_PSD|
B8_8_PSD|B8_9_PSD|B8_10_PSD|B8_11_PSD|B7_1_PSD|B7_2_PSD|
B7_3_PSD|B7_4_PSD|B7_5_PSD|B7_6_PSD}
dslport <dslport> vdsl-psd max-power-down <maximum-power-d
ownstream>
dslport <dslport> vdsl-psd profile-enabling {8a|8b|8c|8d|
12a|12b|17a}
2/1553-LZA 101 464-V1 Uen C 2010-02-02
113
EMP CLI User Guide
Arguments:
All parameters in this command are described in detail in the EMP Web
Interface User Guide. The range for maximum power downstream is -25.6 to
25.6 dBm, though it must not exceed the power defined in the standard for the
selected profile in the profile-enabling parameter. Note that 8a and 8b are not
supported for the EDN612nef although they can be checked without receiving
any failure message.
Note:
If downstream esel is set to 0, downstream power back off is disabled.
Default Settings:
MIN-ESEL: 0
ESEL: 127
ESCMA: -0.90234375
ESCMB: -0.1015625
ESCMC: 1.296875
FMAX: 2992
FMIN: 0
MUS: -11
US1A: -80.0
US1B: -31.0
US2A: 0.0
US2B: 0.0
US3A: 0.0
US3B: 0.0
Forced-e-Length: 120
Power-Back-Off: Enabled
Advanced-Power-Back-Off: Disabled
MIB Mask Downstream:
114
Carrier Index
PSD-Level
125
-25
130
-10
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
MIB Mask Upstream:
Carrier Index
PSD-Level
120
-11
RFI Notches:
Start Carrier
Stop Carrier
125
126
Maximum power downstream: 14.5
Profile enabling: 17a
Examples:
ecn(config)# dslport 1.0.1 vdsl-psd downstream
adv-power-back-off enabled
11.8
Copying a DSL Port Configuration
Command Usage:
Use this command to copy a DSL-port configuration from one port to another.
Command Level:
ecn(config)#
Syntax:
copy-dslport from <dslport> to {<dslport>|all}
Arguments:
from <dslport>
Insert the no. of the DSL-port to copy from
in the format a.b.c, which refers to the ECN
port (a), the ESN108 port (b) and the IP
DSLAM line (c).
to {<dslport> all}
Copy configuration to the specified
DSL-port or to all the ports. Insert the
DSL-port no. in the format a.b.c.
Default Settings:
None.
Examples:
ecn(config)#copy-dslport from 1.0.1 to 1.0.2
2/1553-LZA 101 464-V1 Uen C 2010-02-02
115
EMP CLI User Guide
11.9
Testing a DSL Port
Command Usage:
Use this command to initiate a loop diagnostic test on the specified DSL line, or
to show the results for the previous loop diagnostic test. The loop diagnostic
test is described in the System Description. There is also further information on
the loop diagnostic test in the EMP Web Interface User Guide.
The test requires an active modem at the customer premises that supports
ADSL2, ADSL2+ or VDSL. If the test does not succeed, an error message
is returned.
If the test succeeds, the upstream and downstream results for the following line
parameters are displayed in the CLI: Attainable net data rate (kbps), Actual
aggregate transmit power (dBm). For ADSL, the band parameters Loop
attenuation (dB), Signal attenuation (dB), and Signal to Noise Ratio (dB) are
shown for upstream and downstream. For VDSL, the band parameters are
shown for US0, US1, US2, US3, DS0, DS1 and DS2, as defined in the ITU
standard G.993.2.
The detailed loop diagnostic test results, per sub carrier, are stored in the ECN
at /var/delt_result.txt. The file format is space delimited text. The results can
be accessed using an FTP session to connect to the ECN (user name = root,
password = secret). Note that due to space limitations, the ECN only stores
the latest loop diagnostic test results. Starting another loop diagnostic test
deletes the stored results.
If there are no loop diagnostic tests available for the line, the ECN returns a
result where all the parameters are zero.
Command Level:
ecn#
Syntax:
test dslport <dslport> {loop-diagnostic|load-previous-LD}
Arguments:
<dslport>
Insert the no. of the DSL-port to test in
the format a.b.c, which refers to the ECN
port (a), the ESN108 port (b) and the IP
DSLAM line (c).
Default Settings:
None.
Examples:
ecn#test dslport 14.0.2 loop-diagnostic
116
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
11.10
Alarm Thresholds
Command Usage:
Use this command to set threshold values that will determine when an alarm is
sent telling that a major or critical error affects the system.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> alarm-threshold {downstream|upstream}
{es-15-minutes|ses-15-minutes|uas-15-minutes|es-24-hours|
ses-24-hours|uas-24-hours}
<interval>
Arguments:
<dslport>
The DSL-port to configure. The parameter
a.b.c refers to the ECN port (a), the
ESN108 port (b) and the IP DSLAM line (c)
{downstream | upstream}
The thresholds can be set for both
upstream and downstream.
es-15-minutes
Sets the amount of Error Seconds (ES) in
an interval of 15 minutes that is accepted
before an alarm is sent. ES is a second
with one or more errors
ses-15-minutes
Sets the amount of Error Seconds (ES) in
an interval of 15 minutes that is accepted
before an alarm is sent. ES is a second
with one or more errors
uas-15-minutes
Unavailable Seconds (UAS) is a second
in which the line is defined as unavailable.
The line is defined as unavailable after
10 contiguous SES. The unavailable time
includes the 10 error seconds, which have
defined the state of the line as unavailable.
The line becomes available again after
10 contiguous seconds with no SES. This
argument is used to set the amount of UAS
before an alarm is sent.
es-24-hours
Sets the amount of Error Seconds (ES) in
an interval of 24 hours that is accepted
before an alarm is sent. ES is a second
with one or more errors
2/1553-LZA 101 464-V1 Uen C 2010-02-02
117
EMP CLI User Guide
Arguments:
ses-24-hours
Sets the amount of Severely Error Seconds
(SES) in an interval of 24 hours that is
accepted before an alarm is sent. SES is a
second with 18 or more errors.
uas-24-hours
Unavailable Seconds (UAS) is a second
in which the line is defined as unavailable.
The line is defined as unavailable after
10 contiguous SES. The unavailable time
includes the 10 error seconds, which have
defined the state of the line as unavailable.
The line becomes available again after
10 contiguous seconds with no SES. This
argument is used to set the amount of UAS
before an alarm is sent.
<interval>
The range of interval is 0 to 900.
Note:
Setting the threshold value to 0 (zero) will disable the alarm. The 15
minutes always start at 0,15, 30 and 45 minutes after the hour (start
time is line initialization). The 24 hours interval start at line initialization,
and is synchronized with the 15 minutes interval.
Default Settings:
None
Examples:
ecn(config)#dslport 1.0.1 alarm-thresholds downstream
es-15-minutes 1 uas-15-minutes 1 ses-15-minutes 1
11.11
Line Initialization Failure Alarms
Command Usage:
Use this command to enable or disable line initialization failure alarms and
to enable and disable the link up and link down alarms. Alarms will give
information about the condition of the network.
Command Level:
ecn(config)#
Syntax:
dslport <dslport> alarms line-initialization-failure
{enable|disable} link-up-down {enable|disable}
118
2/1553-LZA 101 464-V1 Uen C 2010-02-02
DSL Port Commands
Arguments:
<dslport>
The DSL-port to configure. The
parameter a.b.c refers to the ECN port
(a), the ESN108 port (b) and the IP
DSLAM line (c).
line-initialization-failure
{enable | disable}
When enabled the alarms will be sent
if training fails and the line cannot be
initialized.
link-up-down {enable |
disable}
To enable and disable the link up and
link down alarms.
Default Settings:
Disabled
Examples:
ecn(config)#dslport 1.0.1 alarms line-initialization
-failure enable link-up-down enable
11.12
Show DSL Port
Command Usage:
Use this command to display configuration data for a specified port to show
Ethernet settings, if MAC forced forwarding is disabled or enabled and will
show the MAC address count limit.
Command Level:
ecn#
Syntax:
show dslport <dslport> {alarm|line {15-min|24-hours
|since-last-reset}|performance-data|psd line|status
line|vdsl-psd|pvc}
Arguments:
<dslport>
Insert the DSL-port no. in the format a.b.c,
where the letters refer to the ECN port (a),
the THE INTERMEDIATE SWITCH port (b)
and the IP DSLAM line (c).
alarm
Displays alarm configuration.
line
Displays information about the
configuration of the line parameters
that are included in the dslport line
command except the PSD parameters.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
119
EMP CLI User Guide
Arguments:
performance-data
Displays an error parameter of the
line in the ADSL, ATM, and Ethernet
layers. Different counters count relevant
parameters in each layer.
psd line
Displays the settings of the PSD
parameters that are included in the dslport
line commands plus the carrier masks.
status line
Displays information about the status of
the channel and line.
vdsl-psd
Displays the VDSL PSD configuration.
pvc
Displays PVC configuration for the
specified PVC number, that is from 1 to 8.
Default Settings:
None.
Examples:
ecn#show dslport 1.0.1 alarm
ecn#show dslport 1.0.1 pvc 1
120
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ESN Commands
12
ESN Commands
Use these commands to configure embedded switches (ESN nodes) including
the built-in ECN switch.
.
12.1
Link Aggregation
Command Usage:
The command is used to configure a link aggregation trunk for the ESN310
switch or the ECN switch. It is available for downlink ports only.
Command Level:
ecn(config)#
Syntax:
esn <node> link-aggregation create-trunk primary <port>
secondary <port>
esn <node> link-aggregation remove-trunk primary <port>
Arguments:
<node>
The node number of the ESN310 in the
format a.b for example 0.1, which refers to
the first ESN310 connected to port 25 or
26 of the ECN.
primary <port>
ECN port number. The port number must
always be smaller than the secondary port
number. The primary port number is in the
range 1 23. The primary port is the one
that appears in the inventory.
secondary <port>
ECN secondary port number, which must
be larger than the primary port number.
Range is 2 24.
Default Settings:
Disabled
Examples:
ecn(config)#esn 0.1 link-aggregation create-trunk primary
8 secondary 12
ecn(config)#esn 0.1 link-aggregation remove-trunk primary
8
2/1553-LZA 101 464-V1 Uen C 2010-02-02
121
EMP CLI User Guide
12.2
ESN Port Commands
These commands are used for configuring the ESN ports.
12.2.1
ESN108 Physical Mode Configuration
Command Usage:
Use this command to set the physical mode of an ESN108 port which is the
duplex mode and interface speed. The possible physical modes of an ESN108
port can be: auto-negotiation, 10-mbps-half-duplex, 100-mbps-half-duplex,
10-mbps-full-duplex, and 100-mbps-full-duplex.
Command Level:
ecn(config)#
Syntax:
esn <node> port <port> phy-mode <phy-mode>
Arguments:
<node>
The node number of the ESN in the format
a.b for example 1.0, which refers to the
ESN connected to port 1 of the ECN.
<port>
The port no. of the ESN108, which can be
any number from 0 to 8.
<phy-mode>
The physical mode of the ESN108
port with the following possible values:
auto-negotiation, 10-mbps-half-duplex,
100-mbps-half-duplex, 10-mbps-full-duplex
, 100-mbps-full-duplex.
Default Settings:
Auto-negotiation
Examples:
ecn(config)#esn 1.0 port 5 phy-mode auto-negotiation
ecn(config)#esn 5.0 port 8 phy-mode 100-mbps-full-duplex
12.2.2
Spanning-tree
The spanning tree port commands are the same as mentioned in Section 9.3
on page 52.
12.2.3
Spanning-tree Protocol
The spanning tree protocol commands are the same as mentioned in Section
9.4 on page 59.
122
2/1553-LZA 101 464-V1 Uen C 2010-02-02
ESN Commands
12.2.4
ESN108 Power On Uplink
Command Usage:
The command is used to enable, disable or automatically configure the ESN108
to supply power over the Ethernet on the uplink connection.
The uplink port of the ESN108 can supply the uplink node with power over the
Ethernet cable. The ability to supply a node with power over the Ethernet cable
in the upstream direction can be enabled by the ECN by this command. It
can be disabled or set to auto as well.
Command Level:
ecn(config)#
Syntax:
esn <node> power-on-uplink {enable|disable|auto}
Arguments:
<node>
The node number of the ESN in the format
a.b for example 1.0, which refers to the
ESN connected to port 1 of the ECN.
{enable | disable | auto}
Enable, disable or automatically configure
the ESN108 to supply power over Ethernet
on the uplink connection.
Default Settings:
Disabled
Examples:
ecn(config)#esn 3.0 power-on-uplink enable
2/1553-LZA 101 464-V1 Uen C 2010-02-02
123
EMP CLI User Guide
124
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EXN Commands
13
EXN Commands
Use these commands to configure and show EXN104 lines.
.
13.1
EXN104 Line Configuration
Command Usage:
Use this command to configure the EXN104 lines.
Command Level:
ecn(config)#
Syntax:
exn <node> line <line> {state {enable|disable}|sync
{master|slave}|test {disable|line-loop}}
Arguments:
<node>
EXN104 node no. in the format a.b
<line>
The line no. in the range 1 to 4
{enable | disable}
Enable or disable the operational state of
the EXN104 line
{master | slave}
Sets the synchronization mode of the line
to master or slave
{disable | line-loop}
Disables the line-loop test mode or enable
the line-loop test mode
Default Settings:
None
Examples:
ecn(config)#exn 3.100 line 3 state enable
ecn(config)#exn 3.100 line 3 sync master
ecn(config)#exn 3.100 line 3 test line-loop
13.2
E1 Line Type Configuration
Command Usage:
Use this command tol set the line type of the E1 line of the EXN104 FE to
E1 converter.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
125
EMP CLI User Guide
Command Level:
ecn(config)#
Syntax:
exn <node> line-type {esf|d4|e1|e1crc|auto-crc}
Arguments:
<node>
EXN104 node no. in the format a.b
{esf | d4 | e1 | e1crc |
auto-crc}
Insert the line type of the EXN104 lines:
esf - Extended SuperFrame DS1 (T1.107)
d4 - AT&T D4 format DS1 (T1.107)
e1 - ITU-T Recommendation G.704
(Table 4a)
e1crc - ITU-T Recommendation G.704
(Table 4b)
auto-crc - Sets the E1 line to use auto
negotiations on CRC (G.706)
Default Settings:
None
Examples:
ecn(config)#exn 3.100 line-type e1
13.3
Packet Distribution Across E1 Link
Command Usage:
Use this command to enable or disable packet distribution across E1 links in
the EXN104.
Command Level:
ecn(config)#
Syntax:
exn <node> packet-distribution {enable|disable}
Arguments:
<node>
EXN104 node no. in the format a.b
{enable | disable}
Enables or disables packet distribution
across E1 links.
Default Settings:
None
126
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EXN Commands
Examples:
ecn(config)#exn 3.100 packet-distribution enable
13.4
Show EXN104 Configuration
Command Usage:
Use this command to display information about the EXN104 settings including
the line settings of the E1 lines. The state of each of the 4 E1 lines can be
shown, which is: disabled, in operation, testing or unknown. The type and the
coding of the line are shown. The alarm and synchronization mode (master or
slave) are also shown as well as the state of loop test.
Command Level:
ecn#
Syntax:
show exn <node> {general|line}
Arguments:
<node>
EXN104 node no. in the format a.b
general
Displays the general settings, that is,
information about site, packet distribution,
load distribution and link mode.
line
Displays the configuration of the E1 lines,
that is, information about operational state,
line type, coding, alarm, synchronization
mode and test mode settings.
Default Settings:
None
Examples:
ecn#show exn 3.100 general
ecn#show exn 3.100 line
2/1553-LZA 101 464-V1 Uen C 2010-02-02
127
EMP CLI User Guide
128
2/1553-LZA 101 464-V1 Uen C 2010-02-02
EFN Commands
14
EFN Commands
Use these commands to configure EFNs.
14.1
EFN324 Commands
Use these commands to configure and view line state for a port on an
embedded EFN324. The command is only valid for the EFN324.
.
14.1.1
Configure Line State
Command Usage:
Use this command to configure the administrative line state for an embedded
EFN324 port as either unlocked or locked. The operator must ensure that
at least one uplink port is unlocked.
Command Level:
ecn(config)#
Syntax:
ethport <portno> line state {unlock|lock}
Arguments:
<portno>
Specifies the port number of the EFN324,
in a.b.c format. a is the flexible block
number (1000+the Switch ID of the EFN),
b is 0, and c is the number of the EFN324
port (range 1 to 26).
{unlock | lock}
Unlocks or locks the port to which the line
is connected.
Default Settings:
Unlocked
Examples:
ecn(config)#ethport 1035.0.3 line state lock
14.1.2
Show Ethernet Port
Command Usage:
Use this command to display configuration, performance or status data for a
specified ethernet line.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
129
EMP CLI User Guide
Command Level:
ecn#
Syntax:
show ethport <portno> {line|performance-data line|status
line}
Arguments:
<portno>
Specifies the port number of the EFN, in
a.b.c format. a is the flexible block number
(1000+the Switch ID of the EFN), b is 0,
and c is the number of the EFN port (range
1 to 26).
line
Displays information about the
configuration of the line parameters,
including the port speed.
performance-data line
Displays the number of upstream and
downstream octets, unicast packets,
discarded packets and errors since the last
reset.
status line
Displays information about the status of
the line.
Default Settings:
None
Examples:
ecn#show ethport 1035.0.3 line
ecn#show ethport 0.3 performance-data line
130
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Alarms
15
Alarms
Use these commands to configure and display alarms from the EAN.
15.1
Alarm Filter
Command Usage:
Use this command to define entries in the alarm filter that will exclude a specific
alarms from being shown in the LCT and from being forwarded to an alarm
receiver (the add option), or to including an alarm that has been excluded (the
remove option).
Alarm oid defined in the filter will not be processed by the ECN. That is they will
be discarded upon arrival to the EMP.
Command Level:
ecn(config)#
Syntax:
alarm filter {add|remove} oid <alarm oid>
Arguments:
{add | remove}
Adds or removes the specified OID from
the filter.
<alarm oid>
Specifies which alarm oid to add or remove
from the filter. The oid is the SNMP oid of
the alarm.
Default Settings:
Linkup and linkdown are included in the filter (can be removed). OIDs:
1.3.6.1.6.3.1.1.5.3
1.3.6.1.6.3.1.1.5.4
Examples:
ecn(config)#alarm filter add oid 1.3.6.1.4.1.193.72.300.1
0.2.1.0.1
15.1.1
Show Alarm Filter Entries
Command Usage:
Use the command to display the configured filter entries.
Command Level:
ecn#
2/1553-LZA 101 464-V1 Uen C 2010-02-02
131
EMP CLI User Guide
Syntax:
show alarm filter
Arguments:
None
Default Settings:
None
Examples:
ecn#show alarm filter
The output will be:
Alarm Filters:
1.3.6.1.6.3.1.1.5.3
1.3.6.1.6.3.1.1.5.4
15.2
Alarm Statistics Filter
Command Usage:
Use this command to define entries that will be forwarded to a statistics alarm
receiver (the add option), or to exclude an alarm that has been included (the
remove option). Only alarms defined in this filter will be forwarded to the
statistics receiver provided that a statistics receiver has been defined (see
Section 7.1 on page 41).
Command Level:
ecn(config)#
Syntax:
alarm statistics-filter {add|remove} oid <alarm oid>
Arguments:
{add | remove}
Adds or removes the specified OID from
the filter.
<alarm oid>
Specifies which alarm oid to add or remove
from the filter. The oid is the SNMP oid of
the alarm.
Default Settings:
ifLinkup and iflinkdown are included in the filter (can be removed). OIDs:
1.3.6.1.4.1.193.72.600.1.6.0.3
1.3.6.1.4.1.193.72.600.1.6.0.4
Examples:
132
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Alarms
ecn(config)#alarm statistics-filter add oid 1.3.6.1.4.1.1
93.72.300.10.2.1.0.1
15.2.1
Show Alarm Filter Entries
Command Usage:
Use the command to display the configured filter entries.
Command Level:
ecn#
Syntax:
show alarm filter
Arguments:
None
Default Settings:
None
Examples:
ecn#show alarm statistics-filter
The output will be:
Alarm Filters:
1.3.6.1.6.3.1.1.5.3
1.3.6.1.6.3.1.1.5.4
1.3.6.1.4.1.193.72.300.10.2.1.0.1
15.3
Active Alarm Synchronization
Command Usage:
Use this command to enable or disable the synchronization of active alarms
from embedded elements.
Note:
Active alarms are synchronized after a reboot, or in case alarms sent
by an embedded element are lost.
Active Alarms are only synchronized for the following node types:
EDN612
EDN312x
EDN524
Command Level:
ecn(config)#
2/1553-LZA 101 464-V1 Uen C 2010-02-02
133
EMP CLI User Guide
Syntax:
alarm active-alarm-log synchronize {enable|disable}
Arguments:
{enable | disable}
Enables or disables the synchronization of
active alarms from embedded elements.
Default Settings:
Disabled
Examples:
ecn(config)#alarm active-alarm-log synchronize enable
15.3.1
Show Alarm Status
Command Usage:
Use this command to display the status of the inventory information regarding
the active alarm synchronization setting for the embedded elements.
Command Level:
ecn#
Syntax:
show alarm status
Arguments:
None
Default Settings:
None
Examples:
ecn#show alarm status
The output will be:
Status of the Active Alarm Log Synchronization is:
Enabled
134
Port No.
Status
Component
Active Alarm
Status
0.0
Reachable
ECN430
Not Supported
1.0
Reachable
ESN212
Not Supported
1.1
Reachable
EDN312xa
Synchronized
1.3
Reachable
EDN312xe
Synchronized
1.5
Reachable
EDN612p
Synchronized
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Alarms
Note:
15.4
The active alarm status can occur as following: Disabled, Not
supported, Not Synchronized, Synchronized, Synchronizing.
Remove Active Alarm from Log
Command Usage:
Use this command to remove an active alarm from the Active Alarm Log list
with sequence number [integer], or all active alarms.
Command Level:
ecn(config)#
Syntax:
alarm remove-active-alarm {[integer]|all}
Arguments:
integer
Defines which active alarm to remove from
the Active Alarm Log
all
Removes all active alarms from the Active
Alarm Log
Default Settings:
None
Examples:
ecn(config)#alarm remove-active-alarm 1
ecn(config)#alarm remove-active-alarm all
15.4.1
Show Alarm Log
Command Usage:
Use this command to display the active alarms or alarm history.
Command Level:
ecn#
Syntax:
show alarm log {active|history}
Arguments:
{active | history}
Active displays the active alarm log.
History displays the history of alarms.
Default Settings:
None
Examples:
2/1553-LZA 101 464-V1 Uen C 2010-02-02
135
EMP CLI User Guide
ecn#show alarm log active
The output will be:
Alarm Active Log:
Date
Time
Node
Seq.
OID
2009-07-17
08:48:10
1004.0
4987
1.3.6.1.4.
1.193.72.6
00.1.6.0.3
ecn#
show alarm log history
The output will be similar to the Alarm Active Log, but only the history list
of alarms will be displayed.
136
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Security
16
Security
Use these command to configure security settings in the ECN like firewall
access control lists, security users, and net services.
16.1
Security Firewall Access Control List
Command Usage:
Use this command to configure a list of IP addresses from which the ECN will
allow traffic. Different rules may be specified for different kind of traffic (that is
TCP/UDP port number or ICMP). If traffic is received from an IP address not
listed in the access control list the packet will be allowed access.
Start by creating the access list and continue with inserting or appending rules.
The list can be build of several rules. A packet will be matched against the rules
in the order they are defined, and when the first rule is matched the packet will
be permitted or denied according to the rule. Packets that do not match any
rule will be allowed access.
Note:
After the access list is defined it must be assigned to the external
management interface, see Section 4.1 on page 25 in order to take
effect. If no access list is assigned to the interface all traffic arriving on
the external VLAN will be allowed.
Command Level:
ecn(config)#
Syntax:
security firewall-acl <firewall-acl name> {create|remove}
security firewall-acl <name> {permit|deny} ip {ipaddress
<ip-address> netmask <subnetmask>|any}[{tcp|udp} port
{telnet|ftp|http|snmp|tftp|any|<portnumber>}][icmp]
{append|insert <sequence-number>|delete}
security firewall-acl <firewall-acl-name> delete
sequence-number <sequence-number>
Arguments:
<firewall-acl-name>
The name of the firewall IP access list.
{create | remove}
Creates or removes a firewall IP access
list.
<sequence-number>
Deletes a rule with a specific rule number.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
137
EMP CLI User Guide
Arguments:
{permit | deny}
Specifies whether packets that match the
rule is passed or dropped.
{<ip-address> netmask
<subnetmask> | any}
Specifies the source IP address and
netmask that is permitted or denied access.
{append | insert
<sequence-number> |
delete}
Append will insert the rule as the last rule
in the list. Insert <sequence-number> will
insert the rule in the list at the position
specified by the sequence number.
Specifying the parameter delete will delete
the rule matching the parameters.
{tcp | udp port telnet
ftp http | snmp | tftp |
any <portnumber>}
Specifying which TCP or UDP destination
port number that are permitted or denied.
Specifying telnet, ftp, http, nmp or tftp
is equal to specifying the default port
numbers for these services.
icmp
Specifies whether ICMP traffic is permitted
or denied.
Default Settings:
None
Examples:
ecn(config)#security firewall-acl fir1 create
ecn(config)#security firewall-acl fir1 permit ip
ip-address 172.30.39.6 netmask 255.255.255.128 append
ecn(config)#security firewall-acl fir1 deny ip any append
ecn(config)#security firewall-acl fir1 delete
sequence-number 2
16.2
Configuring Security User
Command Usage:
Use this command to define new users or modify existing users.
The command is used for user account administration. Different types of user
accounts can be defined to protect against unauthorized access to EMP by
defining users and passwords with different access rights. A user with admin
rights can change the password of other users (modify) using own password
instead of the password of the user.
Command Level:
ecn(config)#
138
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Security
Syntax:
security user [add username <name> password <password>]|
[remove username <name>]|[modify {usernameold <name> new
<name>}|{password username <name> new <password> password
<password>}|{type username <name> new {admin|cli}}]
Arguments:
{add | modify | type}
Adds or modifies a new user and password
and configures or modifies the user access
rights (type).
<name>
The name of the user.
<password>
The password for the user.
{admin | cli}
Configures the access rights for the
user. admin will give full access to see,
create, delete and modify users. The cli
parameter will give access to CLI and Web
interface and this user is allowed to see
and modify own user name and password..
Default Settings:
Type: cli
Examples:
ecn(config)#security user add username peter password
cliandweb
ecn(config)#security user modify type username peter new
cli
16.3
Configuring Protocols
Command Usage:
Use this command to enable or disable servers in the ECN. If https is enabled
http will be automatically disabled. If a user tries to use http towards the ECN it
will be automatically redirected to use https.
Command Level:
ecn(config)#
Syntax:
security net-service https {enable|disable}
Arguments:
{enable}
Enables the protocol on the server
{disable}
Disables the protocol on the server
2/1553-LZA 101 464-V1 Uen C 2010-02-02
139
EMP CLI User Guide
Default Settings:
https: enabled
Examples:
ecn(config)#security net-service https enable
16.4
Radius Server
Command Usage:
The command is used to define one or more RADIUS Servers.
A RADIUS Server must be defined when authentication is needed to access an
ECN. Several RADIUS Servers can be defined and they are used in the order
they are defined so that if the connection to the first on the list fails, connection
to the next will be tried. The use of RADIUS authentication must be enabled.
For more information about user authentication refer to System Description.
Command Level:
ecn(config system)#
Syntax:
radius-server enable host <ip-address> [auth-port <port>]
[timeout <seconds>][key <string>]
radius-server disable host <ip-address> [auth-port <port>]
Arguments:
<ip-address>
The IP address of the RADIUS Server that
must be added or deleted from the list of
RADIUS Servers
<port>
The port number (TCP), on which the client
must contact the RADIUS Server.
<seconds>
The number of seconds the client will wait
for a connection to the RADIUS Server
before giving up
<string>
The RADIUS Client must share a key
with the server. The key is like a mutual
password. It is agreed upon in advance
and if it needs to be changed, it must be
changed in both the RADIUS Client and
the RADIUS Server
radius-server disable
host
Removes the definition of the RADIUS
Server.
Note:
140
When deleting the RADIUS host the argument auth-port <port>
must be used if the argument is used when configuring the RADIUS
client.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Security
Default Settings:
timeout: 3
authentication-port: 1812
Examples:
ecn(config system)#radius-server enable host 172.1.1.4
timeout 4 key iknowwhatyoudidlastsummer
16.5
Tacacs Server
Command Usage:
Use this command to define one or more TACACS+ Servers.
A TACACS+ Server must be defined when authentication is needed to access
an ECN via the CLI or the Web interface. Several TACACS+ Servers can be
defined and they are used in the order they are defined so that if the connection
to the first on the list fails, connection to the next will be tried. The use of
TACACS+ authentication must be enabled. For more information about user
authentication, refer to the System Description.
Command Level:
ecn(config system)#
Syntax:
tacacs-server {enable|disable} server <ip-address>
tacacs-server {set|unset} secret <string>
Arguments:
<ip-address>
The IP address of the TACACS+ Server
that must be added or deleted from the list
of TACACS+ Servers
<string>
The TACACS+ Client (that is, the ECN)
must share a secret with the server. The
secret is like a mutual password. It is
agreed in advance and if it needs to be
changed, it must be changed in both the
TACACS+ Client and the TACACS+ Server
{enable | disable}
Removes the definition of the TACACS+
Server
{set | unset}
Sets or unsets a secret password
Default Settings:
None
Examples:
ecn(config system)#tacacs-server enable server 172.1.1.4
2/1553-LZA 101 464-V1 Uen C 2010-02-02
141
EMP CLI User Guide
ecn(config system)#tacacs-server set secret iknowwhatyoud
idlastsummer
16.6
Server Authentication
Command Usage:
Use this command to enable or disable RADIUS or TACACS+ authentication
when logging in to CLI and Web interface. In addition, prioritization of
authentication login methods can be enabled or disabled.At least one RADIUS
server must be configured before enabling RADIUS authentication, see Section
16.4 on page 140.
Similarly, at least one TACACS+ server must be configured before enabling
TACACS+ authentication, see Section 16.5 on page 141.
If more than one authentication method is enabled using the prioritize
command, in the event of the first method being unavailable, the second
authentication method will be used. If the second method is unavailable, the
third method will be used. Note that regardless of the prioritized authentication
methods, the root is always able to log in.
If the prioritize function is disabled, LOCAL authentication will be chosen.
To disable a set of login methods, these must previously have been enabled.
Command Level:
ecn(config system)#
Syntax:
aaa authentication login {enable|disable} radius
aaa authentication login {enable|disable} tacacs
aaa authentication login {enable|disable} prioritize
{[local]|[local|tacacs+|tacacs+ local]]|tacacs+
[local|radius|radius local]]}
Arguments:
{enable | disable}
radius
142
Enables or disables RADIUS authentication
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Security
Arguments:
{enable | disable}
tacacs+
Enables or disables TACACS+
authentication
{enable | disable}
prioritize
Enables or disables the authentication
login methods, with prioritization when an
authentication server is unavailable. The
prioritization order of a set of login methods
can then be entered. The first method has
the highest priority, and the last method
has the lowest priority
Default Settings:
disable radius
disable tacacs+
disable prioritize
enable local
Examples:
ecn(config system)#aaa authentication login enable radius
ecn(config system)#aaa authentication login enable
prioritize radius tacacs+ local
2/1553-LZA 101 464-V1 Uen C 2010-02-02
143
EMP CLI User Guide
144
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Fallback State CLI Commands
17
Fallback State CLI Commands
This section describes the CLI commands when the ECN is in Fallback State.
17.1
Overview of Fallback State Commands
Table 13
Overview of Fallback State Commands
Keyword
Argument
Command Usage
calendar*
Sets local date and time in the NTP
server.
exit
Exits the CLI session.
interface
external
Sets VLAN, IP address and subnet mask
for the external interface.
internal*
Sets VLAN, IP address and subnet mask
for the internal interface.
untagged*
Sets VLAN, IP address and subnet mask
for the untagged interface.
default-gatewa
y
Sets the IP address of the default
gateway in the ECN.
restart
enc
Restarts the EMP.
update
software
Installs the EMP Application SW.
clear*
network
Deletes all interface configuration.
inventory
Deletes the inventory table.
nodesw
Deletes the installed embedded nodes
SW from the ECN.
all
Deletes all the network, inventory and
embedded nodes SW from the ECN.
ping
Tests IP connection to another device.
show
status
Shows the status of the EMP.
log
Shows the content of the log.
*) These commands are supported in releases earlier than EDA 1200 2.0.
Note:
The fallback software on ECN is not automatically updated when a
new software version is loaded. ECN will use the fallback software
that is stored on the flash card. To change the fallback software, see
Section 6.3 on page 37.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
145
EMP CLI User Guide
17.1.1
Calendar
This command is the same as under normal operation and described in Section
3.5 on page 17. The command is supported in releases before EDA 1200 2.0.
17.1.2
Exit
This command is the same as under normal operation and described in Section
2.3.2 on page 10.
17.1.3
Interface
This command is almost the same as under normal operation. The only
difference is that it is not necessary to save the interface configuration (interface
activate). The activate argument does not exist in the CLI when the ECN is in
fallback state. Restart the ECN to activate the new settings (restart), seeSection
4.1 on page 25. The commands interface internal and interface untagged are
only supported in releases before EDA 1200 2.0.
17.1.4
Restart
This command is almost the same as under normal operation. The only
difference is that it is only possible to use the enc argument (it is only possible
to restart the EMP from the fallback CLI). Refer to Section 3.8 on page 20.
17.1.5
Update
This command is almost the same as under normal operation. The only
difference is that it is only possible to use the enc parameter value (it is only
possible to update the EMP SW from the fallback CLI). Note that the new EMP
SW must be transferred to the ECN before executing the update command.
Refer to Section 6.3 on page 37for more information about the update. For
more information about how to upload SW files, refer to the ECN430 Installation
Guide, the ECN330 Installation Guide or the ECN320 Installation Guide.
17.1.6
Clear
Command Usage:
Use this command to delete configuration or software that is suspected to be
corrupt, and therefore may prevent the ECN from starting up properly. This
command is supported in releases before EDA 1200 2.0.
Command Level:
vty#
Syntax:
clear {network|inventory|nodesw|all}
146
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Fallback State CLI Commands
Arguments:
network
Deletes the network configuration
(configured with the interface command)
from the ECN.
inventory
Deletes the inventory table (created
automatically by the ECN) from the ECN.
nodesw
Deletes the installed embedded nodes
software from the ECN.
all
Deletes the network, inventory and
embedded nodes from the ECN.
Default Settings:
None
Examples:
vty#clear network
vty#clear inventory
vty#clear nodesw
vty#clear all
17.1.7
Ping
This command is the same as under normal operation. Refer to Section 3.6
on page 18.
17.1.8
Show
Command Usage:
Use this command to view the status or log file of the ECN. This command is
used for diagnostic purposes in order to identify what went wrong during start
up. Since the log file can be large, specifying the line numbers may be useful.
For more information about log files refer to the EMP Web Interface User Guide.
Command Level:
vty#
Syntax:
show status
show log [<line>][<line>]
2/1553-LZA 101 464-V1 Uen C 2010-02-02
147
EMP CLI User Guide
Arguments:
status
Shows the status of the ECN.
log
Prints the log file of the ECN on the screen.
The log argument can be used with two,
one or no parameters:
Use no parameters to print the whole log
file.
Use one parameter to print the last lines
(number of lines specified by the parameter
value).
Use two parameters to print the log file from
the line number specified in parameter one,
to the line number specified in parameter
two.
Default Settings:
None
Examples:
To show the whole log file:
vty#show status
To show the last 15 lines in the log file:
vty#show log 15
To show line 45 to 75 in the log file:
vty#show log 45 75
148
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Downgrading the ECN to a Switch
18
Downgrading the ECN to a Switch
A Node Controller can be downgraded to a switch, which means that it will no
longer act as a Node Controller. Instead, it will act as an aggregation switch.
The procedure to downgrade a node controller depends on the hardware type.
The switch loses its IP settings as a result of the downgrade operation. It is
therefore necessary to reconfigure the switch with the basic IP settings after
the downgrade.
Information on network topology and using extension-switches can be found in
the ECN User Guide.
18.1
Downgrading the ECN330
The ECN330 can run in switch mode if the EMP function is disabled. Connect a
laptop to to the ECN330, see Section 2.1 on page 5.
Execute the following commands (in the example, the IP address of the
ECN330 is 172.30.67.16):
Login: admin
Password:admin
ecn# config system turn off sbc management-ip-address
172.30.67.16
For more information on downgrading the switch, see the turn command
Section 3.10 on page 22.
For information on how to reconfigure the IP settings for the switch (since these
are lost during the downgrade), see Section 18.3 on page 150.
To revert from ECN330 switch to ECN with EMP, refer to ECN330-switch
Users Guide.
18.2
Downgrading the ECN320
The ECN320 can run as an ECN320/ESN310 switch, if the correct controller
and switch application software are installed in the switch (EDA 1200 2.1 R1A
or newer).
See the Release Notes for the correct versions of the software and EDA 1200
Update Description for software update.
Connect a laptop to to the ECN320, see Section 2.1 on page 5.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
149
EMP CLI User Guide
Execute the following commands:
Login: esn310
Password:esn310
When prompted, press: Y to convert to an ESN310.
For information on how to reconfigure the IP settings (since these are lost
during the downgrade), see Section 18.3 on page 150.
It is possible to revert to an ECN320 from an ECN320/ESN310 switch by
logging in with the login: ecn320 and the password: ecn320. Perform the basic
configuration of the management VLAN ID, IP address and so on again.
18.3
Reconfiguring Information After Downgrading
When downgrading the ECN330 to switch mode, the IP address, VLAN ID and
default gateway will be lost and must be reconfigured. To reconfigure, the
following commands are executed in the switch: (In the example, the switch IP
address is 172.30.3.1, and the default gateway IP address is 172.30.3.254.)
console#config
console(config)#interface vlan 246
console(config-if)#ip address 172.30.3.1 255.255.255.0
console(config-if)#exit
console(config)#ip default-gateway 172.30.3.254
console(config)#exit
console#copy running-config startup-config
150
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Factory Default
19
Factory Default
It is possible to reset the ECN to a factory default configuration. Normally the
ECN will start up in normal mode if nothing is selected within 3 seconds. In
some cases the ECN will start up in fallback mode if it fails to start in normal
mode after two attempts, but will never start up in factory default mode unless
selected in the boot menu as explained in the following.
The procedure for resetting the ECN to factory default is described in the
following.
1. Connect a laptop to the console of the ECN. This will enable you to see
the boot menu.
2. Power off the ECN.
3. Power on the ECN.
4. Select reset to factory default in the boot menu.
5. When asked for the password, enter: factorydefault.
6. The following screen will appear. No action is required.
2/1553-LZA 101 464-V1 Uen C 2010-02-02
151
EMP CLI User Guide
7. Select Y to continue. If the question is not answered within 5 minutes, the
ECN will restart without going back to factory defaults.
8. The following information is displayed: Resetting the system to factory
default.
9. The following information is then displayed: Reset to factory default finished
successfully. The system will reboot. The reboot may take a little longer
because some files need to be generated when booting to factory default.
152
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Factory Default
2/1553-LZA 101 464-V1 Uen C 2010-02-02
153
EMP CLI User Guide
154
2/1553-LZA 101 464-V1 Uen C 2010-02-02
Program Packages Under Open Source Licenses
20
Program Packages Under Open Source
Licenses
This section gives an overview of the open source licenses on which the ECN
is based, that is, the GNU Public License Terms, the Apache 2.0 License, the
Apache 1.1 license and the LGPL 2.1 license.
The Linux Core system is the operating system for the Ethernet Node Controller
in ECN. The Linux distribution for ECN is based on standard open source
packages widely used in the Linux community.
These programs are free software; you can redistribute them and/or modify
them under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your option)
any later version.
See the GNU General Public License in the Third Party License Agreement
for more details.
The EMP application contains standard open source packages from Jakarta
Commons Net.
The programs are distributed in the hope that they will be useful, but WITHOUT
ANY WARRANTY.
This Product includes software developed by the Apache Software Foundation
(http://www.apache.org).
The EMP application contains open source code from Enterprise Edt, called
edtFTPj. This is available for distribution under an LGPL license and should
not be modified.
The programs packages are available for download at:
ftp-hotel.Ericsson.net
Login: eda-gpl
Password: q5prst
20.1
Linux Kernel
Table 14
Linux Kernel
Package
kernel
2/1553-LZA 101 464-V1 Uen C 2010-02-02
155
EMP CLI User Guide
20.2
Linux Applications
Table 15
Linux Applications
Package
bash
busybox
chrony
ethtool
fileutils
grub
Iproute2
strace
sysklogd
sysvinit
tftp
udhcp
util-linux
vsftp
watchdog
iptables
procps
20.3
Linux Libraries
Table 16
Linux Applications
Package
glibc
Linux-PAM
ncurses
Pam-Radius
readline
termcap
uClibc
156
2/1553-LZA 101 464-V1 Uen C 2010-02-02
You might also like
- Huawei: VRP User Manual - Configuration GuideNo ratings yetHuawei: VRP User Manual - Configuration Guide9 pages
- 31010794-VRP1.5 Command Reference Volume 1No ratings yet31010794-VRP1.5 Command Reference Volume 1283 pages
- PLC-Driver (V5) Selectron - Ethernet TCP-IPNo ratings yetPLC-Driver (V5) Selectron - Ethernet TCP-IP7 pages
- Etherlink Plus Adapter Technical Reference Manual: A Member of The Etherlink Product FamilyNo ratings yetEtherlink Plus Adapter Technical Reference Manual: A Member of The Etherlink Product Family84 pages
- DellT130 Honeywell Server Planning Installation and Service Guide HWDOC X450 en DNo ratings yetDellT130 Honeywell Server Planning Installation and Service Guide HWDOC X450 en D56 pages
- PLC-Driver (V5) Jetter JetControl Delta Nano - Serial Jetway PC-PPLC - Ethernet TCP-IPNo ratings yetPLC-Driver (V5) Jetter JetControl Delta Nano - Serial Jetway PC-PPLC - Ethernet TCP-IP8 pages
- Ruijie RG s6500 Series Switch Rgos Configuration Guide Release 11.05b9p66 CompressedNo ratings yetRuijie RG s6500 Series Switch Rgos Configuration Guide Release 11.05b9p66 Compressed2,985 pages
- Fibeair Ip-10 Cli User Guide: Part Id: Bm-0134-0 Doc Id: Doc-00018394 Rev A.0 1 May 2008No ratings yetFibeair Ip-10 Cli User Guide: Part Id: Bm-0134-0 Doc Id: Doc-00018394 Rev A.0 1 May 200823 pages
- Take Assessment - Enetwork Practice Final Exam - Ccna Exploration: Network Fundamentals (Version 4.0)No ratings yetTake Assessment - Enetwork Practice Final Exam - Ccna Exploration: Network Fundamentals (Version 4.0)18 pages
- CP1L-EL - EM Modbus TCP Client Socket Services PDFNo ratings yetCP1L-EL - EM Modbus TCP Client Socket Services PDF7 pages
- ANxxxxx - Configuring The Vega 200 Signaling Adapter PDFNo ratings yetANxxxxx - Configuring The Vega 200 Signaling Adapter PDF17 pages
- Guideline ONE032: Technical Bulletin OXO ConnectNo ratings yetGuideline ONE032: Technical Bulletin OXO Connect25 pages
- Decoding Gateway Controller User Manual 01 PDFNo ratings yetDecoding Gateway Controller User Manual 01 PDF11 pages
- WAN TECHNOLOGY FRAME-RELAY: An Expert's Handbook of Navigating Frame Relay NetworksFrom EverandWAN TECHNOLOGY FRAME-RELAY: An Expert's Handbook of Navigating Frame Relay NetworksNo ratings yet
- CISCO PACKET TRACER LABS: Best practice of configuring or troubleshooting NetworkFrom EverandCISCO PACKET TRACER LABS: Best practice of configuring or troubleshooting NetworkNo ratings yet
- CompTIA A+ Complete Review Guide: Core 1 Exam 220-1101 and Core 2 Exam 220-1102From EverandCompTIA A+ Complete Review Guide: Core 1 Exam 220-1101 and Core 2 Exam 220-11025/5 (2)
- Multicore DSP: From Algorithms to Real-time Implementation on the TMS320C66x SoCFrom EverandMulticore DSP: From Algorithms to Real-time Implementation on the TMS320C66x SoCNo ratings yet
- PLC: Programmable Logic Controller – Arktika.: EXPERIMENTAL PRODUCT BASED ON CPLD.From EverandPLC: Programmable Logic Controller – Arktika.: EXPERIMENTAL PRODUCT BASED ON CPLD.No ratings yet
