Sie sind auf Seite 1von 162

EMP 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.1 Conventions 1
1.2 Revision Information 2

2 Introduction to the EMP CLI 5


2.1 Login to the CLI 5
2.2 Entering Commands 6
2.3 Changing Command Level 10
2.4 Overview of CLI Commands 11

3 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

4 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

5 System and Status Information 33


5.1 Show System Configuration 33

6 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

7 Management Configuration 41
7.1 SNMP 41
7.2 Local Management 44
7.3 EM-PEM Management 45

8 Configuring VLAN 47
8.1 Service VLAN 47
8.2 VLAN Unaware 47

9 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 95


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


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

1 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: 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.

1.1 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 cd $HOME
you must enter in
a Command Line
Interface (CLI)
exactly as written.
Command Variables Command variables, <home_directory>
the values of which
you must supply.

2/1553-LZA 101 464-V1 Uen C 2010-02-02 1


EMP CLI User Guide

Table 1 Typographic Conventions


Convention Description Example
[argument1|argument2] The brackets [disable|enable]
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.
{argument1|argument2} The brackets {lock|unlock}
indicate that
argument1 or
argument2 are
required. The
| indicate that
either argument1
or argument2 must
be used as a value
for this parameter.
GUI Objects GUI objects, such as On the File menu, click Exit.
menus, fields, and
buttons.
Key Combinations Key combinations. Press Ctrl+X to delete the selected
(1)
value.
System Elements Command and The files are located in E:\Test.
parameter names,
program names, The files are located in /opt/ericsson
(2)
path names, URLs, /bin.
and directory names
Output Information Text displayed by System awaiting input
the system
Code Examples Code examples stat char* months[]=\
(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 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:

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

1.2.2 Version B
Other than editorial changes, this document has been revised as follows:

Statistics receiver added in Section 7 on page 41

1.2.3 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 3


EMP CLI User Guide

4 2/1553-LZA 101 464-V1 Uen C 2010-02-02


Introduction to the EMP CLI

2 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 5


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.

6 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 7


EMP CLI User Guide

2.2.4 CLI Editing Keystrokes

Table 2 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

2.2.5 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.

8 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 9


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 Description
General Commands - (No General commands used for troubleshooting, inspection
level 1 keyword) (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 11


EMP CLI User Guide

12 2/1553-LZA 101 464-V1 Uen C 2010-02-02


General CLI Commands

3 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 | Off: All managers can configure at the
exclusive} 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:
{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

16 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> Sets the time in the range 1 to 30 minutes
after which the CLI will logout automatically
if there is no user input

2/1553-LZA 101 464-V1 Uen C 2010-02-02 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: 0 minute(s)

3.8 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:
ecn Restarts both EMP and the switching unit
switching-unit Restarts the switching unit

20 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

4 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 The IP address of the default gateway for
<ip-address> 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: 172.31.133.1

2/1553-LZA 101 464-V1 Uen C 2010-02-02 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: 300

4.3 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> 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

2/1553-LZA 101 464-V1 Uen C 2010-02-02 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> 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

30 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

5 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 | Shows information about the SNMP
configuration | settings.
snmpv3-users}
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

6 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

7 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|read-
write}

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:
{administrator | guest | SNMP access: 3 groups are
public} 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 | Use this command to remove a
public-user} <name> specific user
{default | mac-address | Choose the method to calculate the
sys-name} 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

42 2/1553-LZA 101 464-V1 Uen C 2010-02-02


Management Configuration

Arguments:
{none | read-only | When running SNMPv3 it is possible to
read-write} allow SNMPv2 requests. The access
rights to SNMPv2 are set with this
command.
{administrator | guest | SNMP V2 View: This command
public} 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 Access Security Users (Pred Password
(Context Level efined)
name)
Administrator Read-write User authen PEM auth: admini
tication and strator
encryption is priv: administ
activated rator
Guest Read-only User authe guest auth: guesta
ntication is uth
activated
Public Read-only No security anonymous -
activated

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:
<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

44 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

8 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

9 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> Specifies the ID of the external VLAN

2/1553-LZA 101 464-V1 Uen C 2010-02-02 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 | Configures how the port is used.
auxiliary}
{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 Factory VLAN Settings


Port Adm. Use External Internal Service
VLAN VLAN VLAN
ECN430 1 to 23 Downlink Disabled Disabled Disabled
24 to 27 Uplink Disabled Disabled Disabled
ECN330 1 to 24 Downlink Disabled Enabled Enabled
25 to 27 Uplink Enabled Disabled Enabled
ECN320 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 Default VLAN Settings


Port Adm. Use External Internal Service
VLAN VLAN VLAN
ECN430 1 to 23 Downlink Disabled Enabled Enabled
24 to 27 Uplink Enabled Disabled Enabled
ECN330 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

Port Adm. Use External Internal Service


VLAN VLAN VLAN
ECN320 1 to 24 Downlink Disabled Enabled Enabled
25 to 26 Uplink Enabled Disabled Enabled

54 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 | Automatically derived from the duplex
shared} 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} Select stp for Spanning Tree Protocol
(IEEE 802.1D), or rstp for Rapid Spanning
Tree Protocol (IEEE 802.1w).

2/1553-LZA 101 464-V1 Uen C 2010-02-02 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} Enables or disables spanning tree

Note: 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: The extension switch configuration must be done through the console
port of the extended switch.

Table 8 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

72 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} Add or remove a switch extension on the specified
uplink port

2/1553-LZA 101 464-V1 Uen C 2010-02-02 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
Exampl First Extension 2 or More Disable Service
e Switch Type Extension VLANs
Switches
1 ESN410 ESN410 No
2 ESN410 ESN410 Yes
3 ESN410-uplink ESN410 No

78 2/1553-LZA 101 464-V1 Uen C 2010-02-02


ECN Configuration

Exampl First Extension 2 or More Disable Service


e Switch Type Extension VLANs
Switches
4 ESN410-uplink ESN410 Yes
5 ESN410-uplink ESN410 No

9.13 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 / Show information about external VLAN
vlan-id <id> / port
<port>

80 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:
data-rate-alarm-threshold Configures the IP DSLAM to send
<bitrate> 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 The Impulse Noise Protection (INP)
| two-dmt | four-dmt | unit is DMT (discrete multitone)
eight-dmt | sixteen-dmt} 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.

86 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 | When there is only a little traffic the IP
disable} 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 Sets the DMT (Discrete Multi Tone)
<mask> carrier mask. 128 hexadecimal
characters, default downstream and
16 hexadecimal characters, default
upstream
delta-psd-annex-1 Defines the maximum PSD configured
<delta-psd-annex-1> as a delta with respect to the
Annexplus. Allowed range is -400 to
-40 0.1 dBm/Hz. Only downstream.
delta-psd-annex-m Defines the maximum PSD Annex
<delta-psd-annex-1> M. Allowed range is -400 to -32 0.1
dBm/Hz.
delta-psd-normal Defines the maximum nominal PSD
<delta-psd-normal> 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 Defines the maximum nominal PSD
<delta-psd-plus> configured as a delta with respect to
ADSL2+. Allowed range is -400 to -40
0.1 dBm/Hz. Only downstream
max-snr-margin Sets the Maximum SNR (Signal To
<margin> Noise) margin in dB. Range 0-31 dB.
max-rx-power Defines the maximum received power
<receiver-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:
upstream max-tx-power Defines the maximum allowed
<transmit-power> 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 Defines the maximum nominal PSD
<delta-psd-plus> configured as a delta with respect to
ADSL2+. Allowed range is -400 to -40
0.1 dBm/Hz. Only downstream
downstream max-tx-power Defines the maximum allowed
<transmit-power> 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 Sets the Minimum SNR (Signal To
<margin> Noise) margin in dB. Range 0-31 dB
min-downshift-margin Sets the Minimum Downshift Margin in
<margin> dB. Range 0-31 dB.
min-downshift-time Sets Minimum Downshift Time in
<time> 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 Sets the Minimum Upshift Margin in
<margin> dB. Range 0-31 dB
min-upshift-time Sets the Minimum Upshift Time in
<time> seconds. Only valid if Rate Adaptation
Mode is set to adapt-at-runtime.
Range 0 16383 seconds
rate-adaption-mode Select the rate adaptation mode
{fixed | adapt-at-startup | either fixed, adapt-at-startup or
adapt-at-runtime} adapt-at-runtime

90 2/1553-LZA 101 464-V1 Uen C 2010-02-02


DSL Port Commands

Arguments:
state The DSL line can be activated or
{enable | disable} deactivated. Select enable to activate
the line or disable to deactivate the line
target-snr-margin Sets the Target SNR Margin in dB.
<target-snr-margin> Range 1-31 dB. The Target SNR
margin is the ultimate condition
that always must be achieved for
successful training.
transmit-psd ADSL transmission mode (PSD:
{fixed | priority-to-power | Power Spectral Density) can be set to:
priority-to-rate}
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 s used for 12/16 kHz Private Metering
{disable | 12khz | 16khz} (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 Defines the number of breakpoints.
<no-of-breakpoints> Allowed range is [0..16]

2/1553-LZA 101 464-V1 Uen C 2010-02-02 91


EMP CLI User Guide

Arguments:
breakpoints A hexadecimal string which defines
<breakpoints> 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 Enables or disables the ILMI (Interim
{enable | disable} 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 Defines the ADSL2 protocol type.
<protocol> 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 Enables a high pass filter for ADSL2+
<tx-filter-id> 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 0 dB 0 dB
margin
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

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)

11.4.1 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 End-users access method to the network:
<access-method>
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 Select which DHCP Relay Agent
iguration Information option method to use:
<method>
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 Select which DHCP Relay Agent
figuration Information option method to use:
<method>
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 String of up to 253 characters to be used
ing when the method is Remote ID String.
<string>

98 2/1553-LZA 101 464-V1 Uen C 2010-02-02


DSL Port Commands

Arguments:
relay-agent-circuitid-st String of up to 253 characters to be used
ring when the method is Circuit ID String.
<string>
relay-agent-options Select the Relay Agent options desired, to
<string> 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 user1-
of-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 or disable upstream policing
{enable | disable}
<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 and upstream bandwidth.
{downstream | upstream}
<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 Sets the maximum speed attainable in
<vci> 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 Sets the average speed through the PVC.
<speed> 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 Enabling or disabling MAC forced
{enable | disable} 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 Enables or disables local switching to and
{enable | disable} 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 Enables or disables the End-user to
{enable | disable} broadcast traffic on the VLAN into which
the PVC is mapped.
default-gateway Sets the IP address of the default gateway.
<ip-address>
igmp-snooping With IGMP Ethernet, parallel transmission
{enable | disable} 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 Sets or removes a static IP address.
{add | remove}
<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:
Range Mode
01 AUTODETECT
2 AUTO ADSL1
3 AUTO ADSL2
4 ANSI T1.413
5 ETSI TS 101 388
6 ITU-T ADSL over POTS, G.992.1 Annex A
7 ITU-T ADSL over ISDN, G.992.1 Annex B
8 ITU-T ADSL Lite over POTS, G.992.2 Annex A
9 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

108 2/1553-LZA 101 464-V1 Uen C 2010-02-02


DSL Port Commands

Names:
Range Name
01 autodetect
2 auto_adsl1
3 auto_adsl2
4 ansi_t1.413
5 etsi_ts_101_388
6 itu-t_adsl_over_pots,_g.992.1_annex_a
7 itu-t_adsl_over_isdn,_g.992.1_annex_b
8 itu-t_adsl_lite_over_pots,_g.992.2_annex_a
9 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:
Range Mode
01 AUTODETECT
2 AUTO ADSL1
3 AUTO ADSL2
4 ANSI T1.413
5 ETSI TS 101 388

110 2/1553-LZA 101 464-V1 Uen C 2010-02-02


DSL Port Commands

Numbers:
Range Mode
6 ITU-T ADSL over POTS, G.992.1 Annex A
7 ITU-T ADSL over ISDN, G.992.1 Annex B
8 ITU-T ADSL Lite over POTS, G.992.2 Annex A
9 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
2 auto_adsl1
3 auto_adsl2
4 ansi_t1.413
5 etsi_ts_101_388
6 itu-t_adsl_over_pots,_g.992.1_annex_a
7 itu-t_adsl_over_isdn,_g.992.1_annex_b
8 itu-t_adsl_lite_over_pots,_g.992.2_annex_a
9 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:

Carrier Index PSD-Level


125 -25
130 -10

114 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 When enabled the alarms will be sent
{enable | disable} if training fails and the line cannot be
initialized.
link-up-down {enable | To enable and disable the link up and
disable} 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 | Insert the line type of the EXN104 lines:
auto-crc}
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

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

134 2/1553-LZA 101 464-V1 Uen C 2010-02-02


Alarms

Note: The active alarm status can occur as following: Disabled, Not
supported, Not Synchronized, Synchronized, Synchronizing.

15.4 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 Specifies the source IP address and
<subnetmask> | any} netmask that is permitted or denied access.
{append | insert Append will insert the rule as the last rule
<sequence-number> | in the list. Insert <sequence-number> will
delete} 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 Specifying which TCP or UDP destination
ftp http | snmp | tftp | port number that are permitted or denied.
any <portnumber>} 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 Removes the definition of the RADIUS
host Server.

Note: When deleting the RADIUS host the argument auth-port <port>
must be used if the argument is used when configuring the RADIUS
client.

140 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} Enables or disables RADIUS authentication
radius

142 2/1553-LZA 101 464-V1 Uen C 2010-02-02


Security

Arguments:
{enable | disable} Enables or disables TACACS+
tacacs+ authentication
{enable | disable} Enables or disables the authentication
prioritize 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 Sets the IP address of the default
y 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

Das könnte Ihnen auch gefallen