Professional Documents
Culture Documents
Ip10 Cli 10 09
Ip10 Cli 10 09
CLI
(Command Line Interface)
Procedures
Notice
This document contains information that is proprietary to Ceragon Networks Ltd.
No part of this publication may be reproduced, modified, or distributed without prior written
authorization of Ceragon Networks Ltd.
This document is provided as is, without warranty of any kind.
Registered TradeMarks
Ceragon Networks is a registered trademark of Ceragon Networks Ltd.
FibeAir is a registered trademark of Ceragon Networks Ltd.
CeraView is a registered trademark of Ceragon Networks Ltd.
Other names mentioned in this publication are owned by their respective holders.
TradeMarks
CeraMapTM, PolyViewTM, EncryptAirTM, ConfigAirTM, CeraMonTM, EtherAirTM, and MicroWave
FiberTM, are trademarks of Ceragon Networks Ltd.
Other names mentioned in this publication are owned by their respective holders.
Statement of Conditions
The information contained in this document is subject to change without notice.
Ceragon Networks Ltd. shall not be liable for errors contained herein or for incidental or
consequential damage in connection with the furnishing, performance, or use of this
document or equipment supplied with it.
Information to User
Any changes or modifications of equipment not expressly approved by the manufacturer
could void the users authority to operate the equipment and the warranty for such equipment.
Copyright 2009 by Ceragon Networks Ltd. All rights reserved.
Corporate Headquarters:
Ceragon Networks Ltd.
24 Raoul Wallenberg St.
Tel Aviv 69719, Israel
Tel: 972-3-645-5733
Fax: 972-3-645-5499
Email: info@ceragon.com
North American Headquarters:
Ceragon Networks Inc.
10 Forest Avenue,
Paramus, NJ 07652, USA
Tel: 1-201-845-6955
Toll Free: 1-877-FIBEAIR
Fax: 1-201-845-5665
Email: infous@ceragon.com
www.ceragon.com
European Headquarters:
Ceragon Networks (UK) Ltd.
4 Oak Tree Park, Burnt Meadow Road
North Moons Moat, Redditch,
Worcestershire B98 9NZ, UK
Tel: 44-(0)-1527-591900
Fax: 44-(0)-1527-591903
Email: infoeuro@ceragon.com
APAC Headquarters:
Ceragon Networks APAC
(S'pore) Pte Ltd
100 Beach Road
#27-01/03 Shaw Towers
Singapore 189702
Tel.: 65 65724170
Fax: 65 65724199
Contents
General .......................................................................................................... 1
Basic Commands.......................................................................................... 1
Basic System Configuration ........................................................................ 3
Navigating between Stacked Units.............................................................. 4
TDM Trail Management................................................................................. 5
TDM Protected Trails (SNPC)......................................................................10
Showing TDM Trail PMs and Status ...........................................................12
Ethernet Switch Application Configuration...............................................13
Management Ports.......................................................................................14
VLAN Configuration.....................................................................................16
QoS Configuration .......................................................................................16
Auxiliary Channels.......................................................................................19
Automatic State Propogation, 1+0 Configuration Only ............................20
Metro Switch and Port Type Configuration ...............................................20
Radio Script Configuration .........................................................................22
Radio Parameter Configurations ................................................................23
NTP................................................................................................................25
SNMP ............................................................................................................26
CFM ...............................................................................................................29
General
This guide provides instructions for specific FibeAir IP-10 CLI based operations. The document is
updated for software release 6.5CA.
CLI (Command Line Interface) is used to perform IP-10 configuration and obtain system statistical and
performance information.
Using the CLI, you can perform configuration operations for stand-alone IP-10 units or units connected in a
stacked configuration, as well as configure several IP-10 units in a single batch command.
In a stacked configuration, all commands are available both in the main and extension units unless
otherwise stated.
Basic Commands
The following basic commands are available when you first log in, if you belong to the Operator user
group:
ls
List entities
get
Get parameter
set
Set parameter
help
Help
cd
Change directory
exit
Exit CLI
logout
cli-ver
CLI version
cls
Clear screen
shell
write
show-tree
find
Search for a string in the parameter's entity name and information fields
lsp
echo
In order to get help on a specific command, add a question mark or the parameter --help after the
command.
In addition, you can use the up and down arrow keys, or the q key, when the word END appears at the
end of the screen.
Note: To perform the operations in this guide, you should log in as follows:
User: admin or operator
Password: admin
Adding Users
To define a new user, do the following:
1. Log in.
2. At the command prompt, type: cd management/mng-services/users/, and press Enter.
3. Type: add-user <name> <group> <password aging days> <expiration date>, and press Enter.
4. Type the password for the new user.
Argument Description:
Operational/reserved: reserved trails are introduced in the database and the bandwidth wont be
used for TDM traffic (it may be used for ethernet traffic) but traffic does not flow. For operational
trails, bandwidth is fully allocated and traffic flows.
Protected/unprotected: unprotected trails map between two interfaces only. Protected trails map
between an end-point interfaces and two other interfaces, the first of which is the primary path and
the second of which is the secondary path (see the SNCP section below).
Interface slot: slot number of the IDU containing the interface (from 1 to 6).
For radio, the maximum number depends on the radio script being used
Parameter
CLI Name
Description
The clock source used as a
reference for the outgoing
STM-1 signal.
Enable/disable receiving
and transmitting traffic
through the STM-1
interface
Range
Internal clock,
TDM trail,
Loop timing
Enable or Disable
Enable
Force-mute
Mute, or Unmute
Unmute
Trace-identifierstring-length
In E1 systems:
1 to 15
15 or 62
Transmitted J0
trace identifier string
Transmit-traceidentifier
String of length:
(0,trace-identifier-length)
String of
NULLs
Received J0 trace
identifier string
received-traceidentifier
String of
NULLs, or
0
Expected J0 trace
identifier string
expected-traceidentifier
String of length:
[0,trace-identifier-length]
String of
NULLs
None
STM-1 interface
transmission behavior
under protection mode
Normal or
Uni-directional MSP
Normal
1E-3
1E-6
STM1-clocksource
STM1
enable/disable
admin
STM1
transmit/silent
J0 trace identifier
length
SDH management
bytes
Protection mode
STM-1 excessive
BER threshold
STM-1 signal
degrade threshold
SDH-Networkmanagementchannel
Line-txProtectionmode
STM1excessive-berthreshold
STM1-signaldegradethreshold
Default
Internal
clock
The configuration for XC with an STM-1 interface is the same as that for the E1 interface, with the
following exceptions:
The interface type to write in the CLI is "stm-1", instead of "line". The interface number is the VC-12
slot number. For example, the command:
add-trail t1 d1 high operational unprotected 1 stm-1 3 2 radio 6
will configure a trail between VC-12 number 3 in the STM-1 interface placed in IDU 1, and channel
(VC) 6 in the radio of IDU 2.
CLI interface numbers in the STM-1 are numbered 1-63 for the available VC-12 slots inside the
STM-1.
The numbering of the VC-12 slots is according to the KLM numbering, as defined in ITU-T G.707
clause 7.3, as shown in the following table taken from the standard:
Allocation of TU-n capacity to Time Slots within VC-4
Deleting Trails
There are several ways to delete trails:
1. Log in.
2. At the command prompt, type cd /interfaces/pdh/trails/, and press Enter.
3. To delete all trails, type del-all-trails, and press Enter.
4. To delete a specific trail by its ID, type del-trail-by-id <trail ID>, and press Enter.
4. To delete a specific trail by its source interface, type del-trail-by-src <interface 1 slot #> <interface 1
type> <interface 1 number>, and press Enter.
Activating/Deactivating Trails
Trails mode can be toggled between active and reserved, as follows:
1. Log in.
2. At the command prompt, type cd /interfaces/pdh/trails/, and press Enter.
3. To activate/reserve all trails, type act-all-trails, and press Enter.
4. To activate/reserve a specific trail by its ID, type act-trail-by-id <trail ID>, and press Enter.
Argument Description:
Operational/reserved: reserved trails are introduced in the database and the bandwidth wont be
used for TDM traffic (it may be used for ethernet traffic) but traffic does not flow. For operational
trails, bandwidth is fully allocated and traffic flows.
Protected/unprotected: unprotected trails map between two interfaces only. Protected trails map
between an end-point interfaces and two other interfaces, the first of which is the primary path and
the second of which is the secondary path.
Interface slot: slot number of the IDU containing the interface (from 1 to 6)
For radio, the maximum number depends on the radio script being used
10
11
12
13
Management Ports
Setting the Number of Management Ports
1. At the command prompt, type: cd /management/networking/, and press Enter.
2. Type: set number-of-ports <no. of ports> (0-3), and press Enter.
Setting the Management Type (inband, outband, VLAN)
1. At the command prompt, type: cd /management/networking/, and press Enter.
2. Type set type < in-band or out-of-band >, and press Enter.
If you choose in-band, you should configure management VLAN id as follows:
a) At the command prompt, type: cd /management/networking/, and press Enter.
b) Type set vlan <no. of VLAN> (1-4090), and press Enter.
Port Configuration
Flow Control (Single Pipe only)
14
15
VLAN Configuration
To add, remove, enable, or disable VLANs, do the following:
1. At the command prompt, type cd interfaces/ethernet/bridge/, and press Enter.
2. Type vlan <VLAN no.> <add, remove, enable, disable>, and press Enter.
To add or change the VLAN name, do the following:
1. At the command prompt, type cd interfaces/ethernet/bridge/, and press Enter.
2. Type vlan <VLAN no.> name <VLAN name>, and press Enter.
QoS Configuration
Ingress Classifier
16
17
18
Auxiliary Channels
Wayside Channel
19
20
21
22
profile-5
profile-6
profile-7
23
24
NTP
To set NTP service enable/disable:
1. At the command prompt, type: cd /management/mng-services/time-service/ntp, and press Enter.
2. Type set server 192.168.1.100, and press Enter.
3. Type set admin <enable/disable>, and press Enter.
To set NTP offset from GMT:
1. At the command prompt, type: cd management/mng-services/time-service/, and press Enter.
2. Type set gmt-offset-hours 2, and press Enter.
3. Type set gmt-offset-minutes 0, and press Enter.
To set Daylight Saving Time:
1. At the command prompt, type: cd /management/mng-services/time-service, and press Enter.
2. Type set dst-start-month Apr, and press Enter.
3. Type set dst-start-day 1, and press Enter.
4. Type set dst-end-month Nov, and press Enter.
5. Type set dst-end-day 1, and press Enter.
To set Date and Time, whereby the time and date format are day-month-year,hours:mins:secs:
1. At the command prompt, type : cd /management/mng-services/time-service, and press Enter.
2. Type set time-and-date 10-3-2009,15:00:00, and press Enter.
25
SNMP
To set SNMP enable/disable:
1. At the command prompt, type: cd /management/mng-protocols/snmp, and press Enter.
2. Type set admin <enable /disable>, and press Enter.
To set the SNMP version:
1. At the command prompt, type: cd /management/mng-protocols/snmp, and press Enter.
2. Type set version v3 (or v1 for SNMP version 1), and press Enter.
SNMP Parameters for SNMP Version 3
To set the security mode to authentication, and the authentication algorithm to sha:
1. At the command prompt, type: cd /management/mng-protocols/snmp, and press Enter.
2. Type change-user-settings user_name_example authentication sha, and press Enter.
3. Enter the SNMPv3 Password: user_password_example, and press Enter.
To set the security mode to authentication-privacy, and the Authentication algorithm to md5:
1. At the command prompt, type: cd /management/mng-protocols/snmp, and press Enter.
2. Type change-user-settings user_name_example authentication-privacy md5, and press Enter.
3. Enter the SNMPv3 Password: user_password_example, and press Enter.
To set the security mode to no-security, and the authentication algorithm to no authentication:
1. At the command prompt, type: cd /management/mng-protocols/snmp, and press Enter.
2. Type change-user-settings no-se-user no-security no-auth, and press Enter.
To set the telnet protocol to enable/disable:
1. At the command prompt, type: cd /management/mng-protocols, and press Enter.
26
27
28
CFM
Domain
Under service-oam level
Creation:
IP-10:/interfaces/ethernet/bridge/service-oam> domain add <Domain name> <Domain level [1-7]> , and
press Enter.
Deletion:
IP-10:/interfaces/ethernet/bridge/service-oam> domain remove <Domain name> <Domain level [1-7]> ,
and press Enter.
Domain & Association
Under service-oam level
Creation:
IP-10:/interfaces/ethernet/bridge/service-oam> domain add <Domain name> <Domain level [1-7]>
<Association name> <VLAN ID [1-4090]> , and press Enter.
Deletion:
IP-10:/interfaces/ethernet/bridge/service-oam> domain remove <Domain name> <Domain level [1-7]>
<Association name> <VLAN ID [1-4090]> , and press Enter.
Association
Under service-oam level:
Creation
IP-10:/interfaces/ethernet/bridge/service-oam> association add <Association name> <Domain name>
<VLAN ID [1-4090]> , and press Enter.
Deletion
IP-10:/interfaces/ethernet/bridge/service-oam> association remove <Association name> <Domain name>
<VLAN ID [1-4090]> , and press Enter.
CCM
Under service-oam level
On
IP-10:/interfaces/ethernet/bridge/service-oam> ccm-admin enable <Domain level [1-7]> <VLAN ID [14090]> , and press Enter.
29
Off
IP-10:/interfaces/ethernet/bridge/service-oam> ccm-admin disable <Domain level [1-7]> <VLAN ID [14090]> , and press Enter.
Local MEP
Under interfaces level
Creation
1. IP-10:/interfaces/ethernet/bridge/eth-port [x]> mep set < MEP ID [1-8191]> < Domain level [1-7]>
<VLAN ID [1-4090]> < Direction [up/down]> <CCM VLAN Pbit priority [0-7]> , and press Enter.
2. IP-10:/interfaces/ethernet/bridge/eth-port [x]> mep set < MEP ID [1-8191]> < Domain level [1-7]>
<VLAN ID [1-4090]> < Direction [up/down]> , and press Enter.
Deletion
IP-10:/interfaces/ethernet/bridge/eth-port [x]> mep remove < MEP ID [1-8191]> < Domain level [1-7]>
<VLAN ID [1-4090]> < Direction [up/down]> , and press Enter.
Remote MEP
Under service-oam level
Creation
1. IP-10:/interfaces/ethernet/bridge/service-oam> remote-mep set <Remote MEP ID [1-8191]> <Domain
name> <VLAN ID [1-4090]> <MAC address [xx:xx:xx:xx:xx:xx]> , and press Enter.
2. IP-10:/interfaces/ethernet/bridge/service-oam> remote-mep set <Remote MEP ID [1-8191]> <Domain
name> <VLAN ID [1-4090]> , and press Enter.
Deletion
IP-10:/interfaces/ethernet/bridge/service-oam> remote-mep remove <Remote MEP ID [1-8191]>
<Domain name> <VLAN ID [1-4090]> , and press Enter.
MIP
Under interfaces level
Creation
IP-10:/interfaces/ethernet/bridge/eth-port[x]> mip add <Domain level [1-7]> , and press Enter.
Deletion
IP-10:/interfaces/ethernet/bridge/eth-port[x]> mip remove <Domain level [1-7]> , and press Enter.
30
Loopback (Ping)
Under service-oam level
1. IP-10:/interfaces/ethernet/bridge/service-oam> ping mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-name <Domain name> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]> ,
and press Enter.
2. IP-10:/interfaces/ethernet/bridge/service-oam> ping mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-name <Domain name> <VLAN ID[1-4090]> , and press Enter.
3. IP-10:/interfaces/ethernet/bridge/service-oam> ping mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-level <Domain level[1-7]> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]>
, and press Enter.
4. IP-10:/interfaces/ethernet/bridge/service-oam> ping mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-level <Domain level[1-7]> <VLAN ID[1-4090]> , and press Enter.
5. IP-10:/interfaces/ethernet/bridge/service-oam> ping mep-id <Remote MEP ID[1-8191]> md-name
<Domain name> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]> , and press Enter.
6. IP-10:/interfaces/ethernet/bridge/service-oam> ping mep-id <Remote MEP ID[1-8191]> md-name
<Domain name> <VLAN ID[1-4090]> , and press Enter.
7. IP-10:/interfaces/ethernet/bridge/service-oam> ping mep-id <Remote MEP ID[1-8191]> md-level
<Domain level[1-7]> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]> , and press Enter.
8. IP-10:/interfaces/ethernet/bridge/service-oam> ping mep-id <Remote MEP ID[1-8191]> md-level
<Domain level[1-7]> <VLAN ID[1-4090]> , and press Enter.
Link Trace
Under service-oam level
1. IP-10:/interfaces/ethernet/bridge/service-oam> linktrace mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-name <Domain name> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]> ,
and press Enter.
2. IP-10:/interfaces/ethernet/bridge/service-oam> linktrace mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-name <Domain name> <VLAN ID[1-4090]> , and press Enter.
3. IP-10:/interfaces/ethernet/bridge/service-oam> linktrace mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-level <Domain level[1-7]> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]>
, and press Enter.
4. IP-10:/interfaces/ethernet/bridge/service-oam> linktrace mac-address <MAC address
[xx:xx:xx:xx:xx:xx]> md-level <Domain level[1-7]> <VLAN ID[1-4090]> , and press Enter.
5. IP-10:/interfaces/ethernet/bridge/service-oam> linktrace mep-id <Remote MEP ID[1-8191]> mdname <Domain name> <VLAN ID[1-4090]> <VLAN Pbit priority[0-7]> , and press Enter.
6. IP-10:/interfaces/ethernet/bridge/service-oam> linktrace mep-id <Remote MEP ID[1-8191]> mdname <Domain name> <VLAN ID[1-4090]> , and press Enter.
31
32
Modification
IP-10:/interfaces/ethernet/bridge/service-oam> set remote-meps-learning-time [seconds: range 60-3600] ,
and press Enter.
: Ring RSTP
To enable Ring RSTP:
1. Type cd /interfaces/ethernet/bridge/ set stp-protocol ring-rstp, and press Enter.
To set bridge priority:
Type cd /interfaces/ethernet/bridge/ set priority <priority no: range 0-61440, steps of 4096>, and press
Enter.
To set interfaces priority:
Type cd /interfaces/ethernet/bridge/ethe-port[port no.]/ set priority <interface priority no: range:0240, steps of 16>, and press Enter.
To set interfaces patch cost:
Type cd /interfaces/ethernet/bridge/ethe-port[port no.]/ set path-cost <patch cost>, and press Enter.
To set if interface is an edge port or ring port (non-edge port):
Type cd /interfaces/ethernet/bridge/ethe-port[port no.]/ set edge-port <yes/no>, and press Enter.
33