MetroNID TE v6.4.2 CLI Command Guide

MetroNID TE v6.4.2 CLI Command Guide

Revision 1

Publication Information

MetroNID TE v6.4.2 CLI Command Guide, revision 1 Publication Date: December 1, 2014

Trademark Information 2014 Accedian Networks Inc. All rights reserved. Accedian, Accedian Networks, the Accedian Networks logo, R-FLO, SkyLIGHT, antMODULE, Vision EMS, Vision Suite, VisionMETRIX, V-NID, Plug & Go, Network State+, Traffic-Meter & FlowMETER are trademarks or registered trademarks of Accedian Networks Inc. All other company and product names may be trademarks of their respective companies. Accedian Networks may, from time to time, make changes to the products or specifications contained herein without notice. Some certifications may be pending final approval; please contact Accedian Networks for current certifications. Accedians products are protected by patents as indicated on Accedians website, located at http://www.accedian.com/en/legal.html The mention of any product herein does not constitute an endorsement by Accedian Networks Inc. The content of this publication is provided for informational use only, is subject to change without notice and should not be construed as a commitment by Accedian Networks Inc. Accedian Networks Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. Except as permitted by such lease agreement, no part of this publication may be reproduced, stored in any retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without prior written consent of Accedian Networks Inc. Changes are periodically made to the information herein; these changes will be incorporated into new editions of this publication. Accedian Networks Inc. may make improvements and/or changes in the products and/or software programs described in this publication at any time.

If you have comments regarding this manual or the products it describes, address them to:

Accedian Networks Inc. Attention: Technical Publications 2351 Alfred-Nobel Blvd., Suite N-410 Saint-Laurent, Qubec Canada H4S 2A9 Tel: 514-331-6181 Fax: 514-331-2210 Toll free: 1-866-685-8181 accedian.com

Accedian Networks Inc. may use or distribute whatever information you provide in any way it believes appropriate without incurring any obligation to you.

Copyright 2009-2014 Accedian Networks Inc. All rights reserved, including those to reproduce this publication or parts thereof in any form without permission in writing from Accedian Networks Inc.


Contents

1 MetroNID TE Command Overview .................................................. 1 1.1 Ethernet Port Commands ........................................................................................................................... 1 1.2 User Traffic/Flow Through Commands ...................................................................................................... 1 1.3 System Management Commands .............................................................................................................. 2 1.4 OAM Commands ........................................................................................................................................ 3 1.5 Utilities ....................................................................................................................................................... 3 1.6 Miscellaneous Commands .......................................................................................................................... 4

2 Syntax Meta-Characters and Variables ........................................... 5

3 CLI Commands................................................................................ 7 3.1 ACL Add List ................................................................................................................................................ 7 3.2 ACL Delete Interface ................................................................................................................................... 7 3.3 ACL Delete List ............................................................................................................................................ 7 3.4 ACL Edit Interface ....................................................................................................................................... 8 3.5 ACL Edit List ................................................................................................................................................ 9 3.6 ACL Show Interface ................................................................................................................................... 10 3.7 ACL Show List ............................................................................................................................................ 10 3.8 Alarm Edit ................................................................................................................................................. 11 3.9 Alarm Reporting ....................................................................................................................................... 12 3.10 Alarm Show Configuration ....................................................................................................................... 12 3.11 Alarm Show Reporting .............................................................................................................................. 13 3.12 Alarm Show Status ................................................................................................................................... 13 3.13 Application Edit File Transfers .................................................................................................................. 14 3.14 Application Edit Web ................................................................................................................................ 14 3.15 Application Show ...................................................................................................................................... 15 3.16 Bandwidth Regulator Add Regulator ........................................................................................................ 15 3.17 Bandwidth Regulator Clear Regulator Statistics ....................................................................................... 16 3.18 Bandwidth Regulator Delete Regulator .................................................................................................... 16 3.19 Bandwidth Regulator Edit Regulator ........................................................................................................ 17 3.20 Bandwidth Regulator Show Regulator Configuration .............................................................................. 17 3.21 Bandwidth Regulator Show Regulator Statistics ...................................................................................... 18 3.22 Beacon Add L3 .......................................................................................................................................... 19 3.23 Beacon Delete L3 ...................................................................................................................................... 21

Revision 1 v


3.24 Beacon Edit L3 .......................................................................................................................................... 21 3.25 Beacon Send L3 ........................................................................................................................................ 23 3.26 Beacon Send L3 One-Shot ........................................................................................................................ 23 3.27 Beacon Show L3 Configuration ................................................................................................................. 24 3.28 Board Show CPU ....................................................................................................................................... 24 3.29 Board Show Info ....................................................................................................................................... 24 3.30 Board Show Start Time ............................................................................................................................. 25 3.31 Board Show Status.................................................................................................................................... 25 3.32 Board Show Uptime.................................................................................................................................. 25 3.33 Board Show Uptime Seconds ................................................................................................................... 25 3.34 Bridge Clear Statistics ............................................................................................................................... 26 3.35 Bridge Edit ................................................................................................................................................ 26 3.36 Bridge Show Configuration ....................................................................................................................... 27 3.37 Bridge Show Statistics .............................................................................................................................. 27 3.38 Bridge Show Status ................................................................................................................................... 27 3.39 Cable Test Perform ................................................................................................................................... 28 3.40 Cable Test Show ....................................................................................................................................... 28 3.41 Certificate Delete ...................................................................................................................................... 28 3.42 Certificate Import ..................................................................................................................................... 29 3.43 Certificate Show ....................................................................................................................................... 29 3.44 CFM Add DMM ......................................................................................................................................... 30 3.45 CFM Add Domain ...................................................................................................................................... 32 3.46 CFM Add MA ............................................................................................................................................ 33 3.47 CFM Add MEG .......................................................................................................................................... 34 3.48 CFM Add MEP ........................................................................................................................................... 35 3.49 CFM Add Packet Loss ................................................................................................................................ 36 3.50 CFM Add SLM ........................................................................................................................................... 37 3.51 CFM Clear MEP Statistics .......................................................................................................................... 37 3.52 CFM Clear Packet Loss Result ................................................................................................................... 38 3.53 CFM Clear SLM Result ............................................................................................................................... 38 3.54 CFM Clear Statistics .................................................................................................................................. 38 3.55 CFM Clear VSP Result ............................................................................................................................... 39 3.56 CFM Delete DMM ..................................................................................................................................... 39 3.57 CFM Delete Domain ................................................................................................................................. 40 3.58 CFM Delete MA ........................................................................................................................................ 40 3.59 CFM Delete MEG ...................................................................................................................................... 41 3.60 CFM Delete MEP ....................................................................................................................................... 41 3.61 CFM Delete Packet Loss ............................................................................................................................ 42 3.62 CFM Delete SLM ....................................................................................................................................... 42 3.63 CFM Edit Defaults ..................................................................................................................................... 43

Revision 1 vi


3.64 CFM Edit DMM ......................................................................................................................................... 44 3.65 CFM Edit Domain ...................................................................................................................................... 45 3.66 CFM Edit MA ............................................................................................................................................. 46 3.67 CFM Edit MEG ........................................................................................................................................... 47 3.68 CFM Edit MEP ........................................................................................................................................... 48 3.69 CFM Edit Packet Loss ................................................................................................................................ 49 3.70 CFM Edit SLM............................................................................................................................................ 50 3.71 CFM Edit VSP ............................................................................................................................................ 50 3.72 CFM LBM .................................................................................................................................................. 51 3.73 CFM LTM ................................................................................................................................................... 52 3.74 CFM Show Defaults .................................................................................................................................. 53 3.75 CFM Show DMM Configuration ................................................................................................................ 53 3.76 CFM Show DMM Result ............................................................................................................................ 54 3.77 CFM Show Domain Configuration ............................................................................................................ 54 3.78 CFM Show Latest Error ............................................................................................................................. 55 3.79 CFM Show LTR .......................................................................................................................................... 55 3.80 CFM Show MA Configuration ................................................................................................................... 55 3.81 CFM Show MEG Configuration ................................................................................................................. 56 3.82 CFM Show MEP Configuration ................................................................................................................. 56 3.83 CFM Show MEP Database ........................................................................................................................ 57 3.84 CFM Show MEP Statistics ......................................................................................................................... 57 3.85 CFM Show MEP Status.............................................................................................................................. 58 3.86 CFM Show Packet Loss Configuration ...................................................................................................... 58 3.87 CFM Show Packet Loss Result .................................................................................................................. 59 3.88 CFM Show SLM Configuration .................................................................................................................. 59 3.89 CFM Show SLM Result .............................................................................................................................. 60 3.90 CFM Show Stack ....................................................................................................................................... 60 3.91 CFM Show Statistics ................................................................................................................................. 60 3.92 CFM Show VSP Configuration ................................................................................................................... 61 3.93 CFM Show VSP Result ............................................................................................................................... 61 3.94 CFM Stop LBM .......................................................................................................................................... 61 3.95 Configuration Cancel ................................................................................................................................ 62 3.96 Configuration Changes ............................................................................................................................. 62 3.97 Configuration Export/Import/Reset/Rollback/Cancel .............................................................................. 63 3.98 Configuration Generate-Script ................................................................................................................. 64 3.99 Configuration Import ................................................................................................................................ 65 3.100 Configuration Reset .................................................................................................................................. 65 3.101 Configuration Rollback ............................................................................................................................. 65 3.102 Console Disable ........................................................................................................................................ 66 3.103 Console Enable ......................................................................................................................................... 66

Revision 1 vii


3.104 Console Show ........................................................................................................................................... 66 3.105 COS Profile Add/Edit DSCP ....................................................................................................................... 67 3.106 COS Profile Add/Edit PCP ......................................................................................................................... 68 3.107 COS Profile Add/Edit Precedence ............................................................................................................. 69 3.108 COS Profile Delete .................................................................................................................................... 70 3.109 COS Profile Show Configuration ............................................................................................................... 70 3.110 CPU Edit OAM Options ............................................................................................................................. 71 3.111 CPU Show OAM Options ........................................................................................................................... 71 3.112 Date .......................................................................................................................................................... 72 3.113 DNS Disable .............................................................................................................................................. 73 3.114 DNS Edit .................................................................................................................................................... 74 3.115 DNS Show ................................................................................................................................................. 74 3.116 Dry-Contact-Input Edit ............................................................................................................................. 75 3.117 Dry-Contact-Input Show Configuration .................................................................................................... 75 3.118 Dry-Contact-Input Show Status ................................................................................................................ 75 3.119 Exit/Quit ................................................................................................................................................... 76 3.120 Fault Propagation Edit .............................................................................................................................. 76 3.121 Fault Propagation Enable/Disable ............................................................................................................ 77 3.122 Fault Propagation Show ........................................................................................................................... 77 3.123 Filter Delete IPv4 ...................................................................................................................................... 77 3.124 Filter Delete L2 ......................................................................................................................................... 78 3.125 Filter Add/Edit IPv4................................................................................................................................... 78 3.126 Filter Add/Edit L2 ...................................................................................................................................... 80 3.127 Filter Show ................................................................................................................................................ 82 3.128 Firmware Activate .................................................................................................................................... 82 3.129 Firmware Clear Download ........................................................................................................................ 83 3.130 Firmware Download ................................................................................................................................. 83 3.131 Firmware Rollback .................................................................................................................................... 84 3.132 Firmware Upgrade .................................................................................................................................... 84 3.133 Firmware Version ..................................................................................................................................... 85 3.134 GPS Edit .................................................................................................................................................... 85 3.135 GPS Show Configuration ........................................................................................................................... 85 3.136 GPS Show Status ....................................................................................................................................... 85 3.137 Help .......................................................................................................................................................... 86 3.138 History Edit File ......................................................................................................................................... 86 3.139 History Edit Local ...................................................................................................................................... 87 3.140 History Edit Scheduling ............................................................................................................................. 89 3.141 History Show File ...................................................................................................................................... 90 3.142 History Show Local ................................................................................................................................... 90 3.143 History Show Scheduling .......................................................................................................................... 90

Revision 1 viii


3.144 Interface Add/Edit .................................................................................................................................... 91 3.145 Interface Advertisement Edit ................................................................................................................... 93 3.146 Interface Advertisement Show ................................................................................................................. 93 3.147 Interface Beacon Edit ............................................................................................................................... 94 3.148 Interface Beacon Show ............................................................................................................................. 95 3.149 Interface Delete ........................................................................................................................................ 95 3.150 Interface Discovery Edit ............................................................................................................................ 96 3.151 Interface Discovery Show ......................................................................................................................... 97 3.152 Interface Refresh ...................................................................................................................................... 97 3.153 Interface Show.......................................................................................................................................... 98 3.154 Inventory Edit ........................................................................................................................................... 98 3.155 Inventory Show......................................................................................................................................... 99 3.156 Keepalive .................................................................................................................................................. 99 3.157 L2PT Add/Edit ......................................................................................................................................... 100 3.158 L2PT Clear ............................................................................................................................................... 102 3.159 L2PT Delete ............................................................................................................................................. 102 3.160 L2PT Edit Global ...................................................................................................................................... 103 3.161 L2PT Show Configuration ....................................................................................................................... 103 3.162 L2PT Show Statistics ............................................................................................................................... 103 3.163 LACP Clear Statistics ............................................................................................................................... 104 3.164 LACP Edit ................................................................................................................................................ 104 3.165 LACP Show Configuration ....................................................................................................................... 105 3.166 LACP Show Statistics ............................................................................................................................... 105 3.167 LACP Show Status ................................................................................................................................... 106 3.168 Loopback Edit ......................................................................................................................................... 108 3.169 Loopback Show ....................................................................................................................................... 109 3.170 MAC Learning Show Results ................................................................................................................... 109 3.171 MAC Learning Start ................................................................................................................................. 110 3.172 MAC Learning Stop ................................................................................................................................. 110 3.173 Media-Selection Select ........................................................................................................................... 111 3.174 Media-Selection Show ............................................................................................................................ 112 3.175 Mode Edit ............................................................................................................................................... 112 3.176 Mode Show ............................................................................................................................................ 113 3.177 Monitor Edit ........................................................................................................................................... 113 3.178 Monitor Show Configuration .................................................................................................................. 113 3.179 MOTD Edit .............................................................................................................................................. 114 3.180 MOTD Show ............................................................................................................................................ 114 3.181 MTR Edit ................................................................................................................................................. 114 3.182 MTR Enable/Disable ............................................................................................................................... 115 3.183 MTR Show ............................................................................................................................................... 115

Revision 1 ix


3.184 NTP Add .................................................................................................................................................. 115 3.185 NTP Delete .............................................................................................................................................. 116 3.186 NTP Disable ............................................................................................................................................. 116 3.187 NTP Disable Server ................................................................................................................................. 116 3.188 NTP Edit .................................................................................................................................................. 117 3.189 NTP Enable ............................................................................................................................................. 118 3.190 NTP Enable Server .................................................................................................................................. 119 3.191 NTP Show ............................................................................................................................................... 119 3.192 OAM Add/Edit ........................................................................................................................................ 120 3.193 OAM Clear Statistics ............................................................................................................................... 121 3.194 OAM Delete ............................................................................................................................................ 121 3.195 OAM Show Configuration ....................................................................................................................... 121 3.196 OAM Show Events .................................................................................................................................. 122 3.197 OAM Show Statistics............................................................................................................................... 122 3.198 OAM Show Status ................................................................................................................................... 122 3.199 PAA Add/Edit L2 ..................................................................................................................................... 123 3.200 PAA Add/Edit UDP .................................................................................................................................. 126 3.201 PAA Delete .............................................................................................................................................. 129 3.202 PAA Show Configuration ........................................................................................................................ 130 3.203 PAA Show Counters ................................................................................................................................ 130 3.204 PAA Show Result .................................................................................................................................... 131 3.205 PAA Show Status .................................................................................................................................... 131 3.206 Permission-Group Add ........................................................................................................................... 132 3.207 Permission-Group Delete ....................................................................................................................... 132 3.208 Permission-Group Edit ............................................................................................................................ 133 3.209 Permission-Group Show ......................................................................................................................... 133 3.210 Ping ......................................................................................................................................................... 133 3.211 Policy Clear Statistics .............................................................................................................................. 134 3.212 Policy Edit ............................................................................................................................................... 134 3.213 Policy Show Configuration ...................................................................................................................... 136 3.214 Policy Show Statistics ............................................................................................................................. 136 3.215 Port Clear Statistics................................................................................................................................. 137 3.216 Port Edit .................................................................................................................................................. 137 3.217 Port Show Configuration ........................................................................................................................ 139 3.218 Port Show Statistics ................................................................................................................................ 139 3.219 Port Show Status .................................................................................................................................... 140 3.220 PTP Edit ................................................................................................................................................... 140 3.221 PTP Reset ................................................................................................................................................ 141 3.222 PTP Show ................................................................................................................................................ 141 3.223 RADIUS Edit ............................................................................................................................................ 142

Revision 1 x


3.224 RADIUS Show .......................................................................................................................................... 143 3.225 Rate Edit ................................................................................................................................................. 143 3.226 Rate Show ............................................................................................................................................... 143 3.227 Reboot .................................................................................................................................................... 143 3.228 Regulator-Set Add/Edit DSCP ................................................................................................................. 144 3.229 Regulator-Set Add/Edit PCP ................................................................................................................... 145 3.230 Regulator-Set Add/Edit Precedence ....................................................................................................... 146 3.231 Regulator-Set Delete .............................................................................................................................. 146 3.232 Regulator-Set Show Configuration ......................................................................................................... 147 3.233 RFC-2544 Generator Edit ........................................................................................................................ 147 3.234 RFC-2544 Generator Show Configuration .............................................................................................. 150 3.235 RFC-2544 Generator Show Results ......................................................................................................... 150 3.236 RFC-2544 Generator Start ...................................................................................................................... 150 3.237 RFC-2544 Generator Stop ....................................................................................................................... 151 3.238 RFC-2544 Monitor Clear Statistics .......................................................................................................... 151 3.239 RFC-2544 Monitor Edit ........................................................................................................................... 151 3.240 RFC-2544 Monitor Show Configuration .................................................................................................. 153 3.241 RFC-2544 Monitor Show Results ............................................................................................................ 153 3.242 RFC-2544 Test Suite Add ........................................................................................................................ 154 3.243 RFC-2544 Test Suite Delete .................................................................................................................... 157 3.244 RFC-2544 Test Suite Edit ......................................................................................................................... 157 3.245 RFC-2544 Test Suite Show Configuration ............................................................................................... 160 3.246 RFC-2544 Test Suite Show Reports......................................................................................................... 161 3.247 RFC-2544 Test Suite Start ....................................................................................................................... 161 3.248 RFC-2544 Test Suite Stop ....................................................................................................................... 162 3.249 RFC-2544 Test Suite Upload ................................................................................................................... 162 3.250 Route Add/Edit ....................................................................................................................................... 163 3.251 Route Delete ........................................................................................................................................... 163 3.252 Route Show Configuration/Active .......................................................................................................... 164 3.253 SA Add Metric ......................................................................................................................................... 164 3.254 SA Add Service ........................................................................................................................................ 166 3.255 SA Clear Service Counters....................................................................................................................... 166 3.256 SA Delete Metric ..................................................................................................................................... 167 3.257 SA Delete Service .................................................................................................................................... 167 3.258 SA Edit Metric ......................................................................................................................................... 168 3.259 SA Edit Service ........................................................................................................................................ 169 3.260 SA Show Metric Configuration ............................................................................................................... 170 3.261 SA Show Metric Counters ....................................................................................................................... 170 3.262 SA Show Service Configuration............................................................................................................... 171 3.263 SA Show Service Counters ...................................................................................................................... 171

Revision 1 xi


3.264 SAT Protocol Clear Statistics ................................................................................................................... 172 3.265 SAT Protocol Edit .................................................................................................................................... 172 3.266 SAT Protocol Show Configuration .......................................................................................................... 172 3.267 SAT Protocol Show Sessions ................................................................................................................... 173 3.268 SAT Protocol Show Statistics .................................................................................................................. 173 3.269 SAT Reporting Edit .................................................................................................................................. 174 3.270 SAT Reporting Show Configuration ........................................................................................................ 174 3.271 Session Edit ............................................................................................................................................. 175 3.272 Session Show Configuration ................................................................................................................... 175 3.273 Session Show Status ............................................................................................................................... 176 3.274 Session Terminate .................................................................................................................................. 176 3.275 Session Writelock ................................................................................................................................... 176 3.276 Session Writeunlock ............................................................................................................................... 176 3.277 SFP Dump ............................................................................................................................................... 177 3.278 SFP Show ................................................................................................................................................ 177 3.279 SNMP Edit ............................................................................................................................................... 178 3.280 SNMP Show ............................................................................................................................................ 179 3.281 SNMP Trap Edit Auto .............................................................................................................................. 179 3.282 SNMP Trap Edit V1 ................................................................................................................................. 180 3.283 SNMP Trap Edit V2c ................................................................................................................................ 180 3.284 SNMP Trap Show .................................................................................................................................... 181 3.285 Statistics Clear ........................................................................................................................................ 181 3.286 SyncE Edit ............................................................................................................................................... 182 3.287 Syntax ..................................................................................................................................................... 183 3.288 Syslog Edit ............................................................................................................................................... 183 3.289 Syslog Show Configuration ..................................................................................................................... 184 3.290 Syslog Show Log ..................................................................................................................................... 184 3.291 Syslog Show Log Continuous .................................................................................................................. 184 3.292 System Show Status ............................................................................................................................... 184 3.293 TACACS+ Edit .......................................................................................................................................... 185 3.294 TACACS+ Show ....................................................................................................................................... 186 3.295 TCP Connect ........................................................................................................................................... 186 3.296 Traceroute .............................................................................................................................................. 187 3.297 Traffic Edit Mode .................................................................................................................................... 187 3.298 Traffic Shaping Clear Port Statistics ........................................................................................................ 188 3.299 Traffic Shaping Edit Map ........................................................................................................................ 188 3.300 Traffic Shaping Edit Port ......................................................................................................................... 190 3.301 Traffic Shaping Edit Queue ..................................................................................................................... 190 3.302 Traffic Shaping Edit Shaper ..................................................................................................................... 192 3.303 Traffic Shaping Show Blue Statistics ....................................................................................................... 193

Revision 1 xii


3.304 Traffic Shaping Show Map ...................................................................................................................... 193 3.305 Traffic Shaping Show Port Configuration ............................................................................................... 193 3.306 Traffic Shaping Show Port Statistics ....................................................................................................... 194 3.307 Traffic Shaping Show Shaper Configuration ........................................................................................... 194 3.308 Traffic Shaping Show Shaper Statistics ................................................................................................... 194 3.309 Traffic Show ............................................................................................................................................ 195 3.310 TWAMP Clear Statistics .......................................................................................................................... 195 3.311 TWAMP Edit ........................................................................................................................................... 195 3.312 TWAMP Show Configuration .................................................................................................................. 196 3.313 TWAMP Show Statistics .......................................................................................................................... 196 3.314 User Add/Edit ......................................................................................................................................... 196 3.315 User Delete ............................................................................................................................................. 197 3.316 User Permissions Edit ............................................................................................................................. 197 3.317 User Permissions Show .......................................................................................................................... 197 3.318 User Show ............................................................................................................................................... 198 3.319 VCAgent Edit Collection .......................................................................................................................... 198 3.320 VCAgent Edit Configuration .................................................................................................................... 198 3.321 VCAgent Show Configuration ................................................................................................................. 198 3.322 VCAgent Show Descriptors ..................................................................................................................... 199 3.323 Version .................................................................................................................................................... 199 3.324 VID-Set Add ............................................................................................................................................ 199 3.325 VID-Set Delete ........................................................................................................................................ 200 3.326 VID-Set Edit ............................................................................................................................................. 200 3.327 VID-Set Show Set .................................................................................................................................... 200 3.328 VID-Set Show VID ................................................................................................................................... 201 3.329 Y.1564 Add Test ...................................................................................................................................... 202 3.330 Y.1564 Delete Report ............................................................................................................................. 203 3.331 Y.1564 Delete Test .................................................................................................................................. 203 3.332 Y.1564 Edit Report .................................................................................................................................. 204 3.333 Y.1564 Edit Service ................................................................................................................................. 204 3.334 Y.1564 Edit Test ...................................................................................................................................... 208 3.335 Y.1564 Generate Report ......................................................................................................................... 209 3.336 Y.1564 Show Activation .......................................................................................................................... 209 3.337 Y.1564 Show Service Configuration ........................................................................................................ 209 3.338 Y.1564 Show Test Configuration ............................................................................................................ 210 3.339 Y.1564 Start Activation ........................................................................................................................... 210 3.340 Y.1564 Stop Activation ........................................................................................................................... 211 3.341 Y.1564 Upload Report ............................................................................................................................ 211

Revision 1 xiii


About This Guide The MetroNID TE v6.4.2 CLI Command Guide walks you through the command line interface of Accedians MetroNODE product and shows you how to configure and use it effectively through the provided procedures and examples. Its target audience is network designers and network administrators.

The technologies and standards implemented by Accedian Networks equipment and procedures enable wireless operators, service providers and cable MSO personnel to provide their customers with service assurance and service creation solutions.

Requirements This Command Guide describes all possible CLI commands with their parameters for the MetroNID TE release 6.4.2 firmware. It applies to the following products and models from Accedian Networks:

MetroNID TE (AMN-1000-TE)

MetroNID TE-R (AMN-1000-TE-R)

MetroNID TE-S (AMN-1000-TE-S)

MetroNID TE-RS (AMN-1000-TE-RS)

Style Conventions Commands are displayed in a monospace font.

Keywords are displayed in bold type.

Note: Tips or suggestions related to how to carry out a task are typically presented in italics and indented from the main text.

References Deploying teleco equipment such as the MetroNID TE requires the understanding of various networking standards, technical specifications and technologies. This document provides basic information about such standards and technologies.

Revision 1 xiv


1 MetroNID TE Command Overview

Below is a list of all MetroNID TE CLI commands, grouped according to their primary function.

1.1 Ethernet Port Commands

Command Name Description

cable-test Perform time domain reflectometry diagnostics.

fault-propagation Manage the link fault propagation between ports.

media-selection Select which physical ports will be used to carry traffic.

port Manage the link and physical level port settings.

sfp Display the SFP information, including digital diagnostics.

1.2 User Traffic/Flow Through Commands


bandwidth-regulator Manage bandwidth regulator database.

cos-profile Manage service mapping CoS profiles.

filter Manage the filter database.

l2pt Manage L2 protocol tunneling rules.

policy Manage policy entries applied on ports.

regulator-set Manage service mapping regulator sets.

traffic Policy list VLAN mode configuration.

traffic-shaping Manage the traffic shaper database.

vid-set Manage VID sets.

Revision 1 1


1.3 System Management Commands


acl Manage Access Control Lists.

beacon Manage Plug & Go beacon instances.

bridge Manage the bridge created with the interface module.

console Manage the serial (RS-232) console port.

date Print or set the system date and time.

dns Manage the DNS settings.

history Manage the history buckets statistics.

interface Manage the interfaces used to access the management plane.

inventory Manage the inventory when using auto configuration with beacons.

mode Define general system settings.

motd Manage the MOTD of the unit.

mtr Manage management traffic regulation settings.

ntp Manage the network time client function.

permission-group Manage the user privilege profiles.

ptp Manage the network time client function.

radius Manage the RADIUS authentication.

route Manage the IP routes and gateways.

session Manage the session settings or active sessions.

snmp Manage the SNMP agent settings.

snmp-trap Manage the SNMP trap handler configuration.

syslog Manage the remote syslog settings.

tacacs-plus Manage the TACACS+ authentication.

Revision 1 2



user Manage user account settings and privilege profiles.

vcagent Manage the Vision Collect bucket statistics.

1.4 OAM Commands Command Name Description

alarm Manage the alarm settings.

cfm Manage the SOAM CFM feature.

loopback Manage the loopback settings associated with an OAM instance.

oam Manage the OAM instances (802.3ah).

paa Manage the Performance Assurance Agent instances.

sa Manage the Service Availability instances.

twamp Two-Way Active Measurement Protocol (TWAMP).

1.5 Utilities


application Manage SSL certificates for specific applications.

certificate Manage SSL certificates.

configuration Export, import or factory reset the device configuration.

firmware Install a new firmware or display current firmware version.

mac-learning Debug received MAC and VLAN tuples.

ping Send pings to a specified host over IPv4.

ping6 Send pings to a specified host over IPv6.

Revision 1 3



reboot Restart the device, equivalent to a power up boot.

rfc2544 Run out-of-service packet generator and RFC-2544 tests.

sat-protocol Configure Service Activation Testing protocol.

sat-reporting Configure Service Activation Testing reporting.

statistics Clear all statistics (port, policies, regulators, OAM).

tcp-connect Test that a TCP service is responding.

traceroute Display the hops used to reach a given host over IPv4.

traceroute6 Display the hops used to reach a given host over IPv6.

y1564 Run Y.1564 Service Activation Methodiology tests.

1.6 Miscellaneous Commands


board Manage assembly and environmental information.

exit Terminate the current CLI session.

help Display this help or for a specific given command.

quit Terminate the current CLI session.

syntax Display the general command syntax.

version Display CLI version.

Revision 1 4


2 Syntax Meta-Characters and Variables

Character Name Description

{} Matches one in the set.

[] Optionally matches one in the set.

* Repeat 0 or more times.

+ Repeat 1 or more times.

- Matches one in the range.

| Separates options in a set.

\ Escape a meta-character.

_ Single space character.

Syntax variable, as described in the table below.

Variable Name Description

* [[] *]

[, ]

{ | | }

{a-z} [{a-z} | {0-9} | {\-}]*

{ | }

{"} [[ _ | ]* ] {"}

{a-z | A-Z} [{a-z | A-Z |0-9 | : | ! | $ | % | ^ | & | \-}]*

Revision 1 5


Variable Name Description

|

{0-9}+

0{x | X}{0-9 | a-f | A-F } [0-9 | a-f | A-F]*

...

:::::

[:]+[: | :]

[:]/[]

{/}+

[.]+

Revision 1 6


3 CLI Commands

This section describes all CLI commands; commands are listed by name in alphanumerical order.

3.1 ACL Add List acl add list - Add an ACL definition Description Use this command to add a new ACL definition to the ACL service. Newly- created ACL definitions do not contain any rules and are disabled by default. You may edit the definition using the "acl edit list" command to add rules to it. To enable a definition, you must assign it to an interface. Syntax acl add list Parameters -

3.2 ACL Delete Interface acl delete interface - Delete an interface definition Description Delete an existing interface definition from the ACL service. Syntax acl delete interface Parameters -

3.3 ACL Delete List acl delete list - Delete an ACL list Description Delete an existing ACL list from the ACL service. The ACL list state must be set to "Unassigned" before deleting the list. Syntax acl delete list Parameters -

Revision 1 7

MetroNID TE v6.4.2 CLI Command Guide ACL Edit Interface

3.4 ACL Edit Interface acl edit interface - Edit an interface definition Description Edit an existing interface definition from the ACL service. Any changes made to the interface definition will be automatically executed and saved if valid. ACL and Bridge Assigning an ACL to a sub-interface that belongs to a bridge is not supported. The ACL must be assigned to the bridge itself. ACL and LAG (MetroNODE and MetroNID GT only): When ACL protection is needed on a LAG, the ACL should be assigned to the LAG interface, but not to its members (e.g. assign the ACL to LAG-1-1 interface, but not to SFP-1-1 and SFP-2-1 sub-interfaces). Syntax acl edit interface { {acl_name } | {acl_types } | {state {enable|disable}} }+ Parameters - - {cli|web|snmp} [,{cli|web|snmp}]* acl_name - The ACL name acl_types - The ACL types state - The interface state

Revision 1 8

MetroNID TE v6.4.2 CLI Command Guide ACL Edit List

3.5 ACL Edit List acl edit list - Edit an ACL definition Description Edit an existing ACL definition from the ACL service. Any changes made to the ACL definition will be automatically executed and saved if valid. Syntax acl edit list { {name } | {index {|} { {type {ipsrc|macsrc}} | {value } | {action {drop|accept}} | {rule_name } | {priority } | {state {enable|disable}} }+ }+ Parameters - - - {||} - name - The new ACL name index - The rule index or the rule name to edit a specific rule type - The rule type value - The rule value that match the type format action - The rule action if the type and value match rule_name - The rule name priority - The rule priority that determine the order of execution of the rules state - The rule state

Revision 1 9

MetroNID TE v6.4.2 CLI Command Guide ACL Show Interface

3.6 ACL Show Interface acl show interface - Show an interface definition Description Show all interface definitions if no interface name is specified. If an interface name is specified, only that interface will be displayed. Statistics based on the assigned ACL definition can also be displayed if specified. Syntax acl show interface [ [stats]] Parameters - stats - Display rules statistics based on the assigned ACL definition.

3.7 ACL Show List acl show list - Show an ACL definition Description Show all ACL definitions if no ACL name is specified. If an ACL name is specified, only that interface will be displayed. Syntax acl show list [] Parameters -

Revision 1 10

MetroNID TE v6.4.2 CLI Command Guide Alarm Edit

3.8 Alarm Edit alarm edit - Edit alarm configuration. Description Alarm edit allows you to change the configuration of an alarm. Syntax alarm edit {{disable | enable} | {service-affecting {yes | no}} | {severity {minor | major | critical | informational}} | {state {enable | disable}} | {description }}+ Parameters - .. - description - The alarm description. disable - Disable the alarm. If the alarm is triggered, nothing happens (see the note below). enable - Enable the alarm. If the alarm is triggered, it will be reported as defined (see the note below). service-affecting - Tag the alarm as service-affecting or not. severity - The severity level of the alarm when it is raised. state - Enable or disable the alarm. If the alarm is triggered when enabled, it will be reported as defined. Otherwise, nothing will happen. Note: Using "disable" or "enable" as stand-alone arguments, i.e. not preceeded by "state", is deprecated. This syntax remains valid for backward compatibility, but the best practice is to always use "state enable" and "state disable".

Revision 1 11

MetroNID TE v6.4.2 CLI Command Guide Alarm Reporting

3.9 Alarm Reporting alarm reporting - Enable alarm status reporting Description Enable alarm status reporting via different ways. Syntax alarm reporting {{led {disable | enable}} | {snmp {disable | enable}} | {syslog {disable | enable}} | {802.3ah {disable | enable}} | {threshold-on } | {threshold-off }} Parameters led - Enable the LEDs on the front panel of the unit to report the alarms. snmp - Enable the reporting of alarms via SNMP traps. syslog - Enable the reporting of alarms via entries in the syslog. 802.3ah - Enable reporting of alarms via 802.3ah OAMPDUs. threshold-on - The delay (in milliseconds) after an event is detected and before the alarm notification occurs. threshold-off - The delay (in milliseconds) after the event status goes back to normal and before the alarm notification clears.

3.10 Alarm Show Configuration alarm show configuration - Show alarm configuration Description Display the alarm reporting behavior. Syntax alarm show configuration [] [more] Parameters - ..

Revision 1 12

MetroNID TE v6.4.2 CLI Command Guide Alarm Show Reporting

3.11 Alarm Show Reporting alarm show reporting - Show alarm reporting configuration Description Display the alarm reporting parameters. Syntax alarm show reporting

3.12 Alarm Show Status alarm show status - Show alarms current status Description Display alarm status based on specified parameters. If an alarm number is specified, the detailed status for this alarm is displayed. If no alarm number is specified, the status of all applicable alarms is displayed in a table format. By default, only the alarms that are enabled and active are displayed. If the option "all" is specified, the status will be displayed for all possible alarms. Syntax alarm show status [ | active | all | more] Parameters - ..

Revision 1 13

MetroNID TE v6.4.2 CLI Command Guide Application Edit File Transfers

3.13 Application Edit File Transfers application edit filetransfers - Allows changing SSL certificates for file transfer applications. Description application edit allows selecting and managing validation on how certificates are used when sending or receiving files through a secure channel (https or ftps). For example, firmware upgrades and configuration import/export using the CLI. Syntax application edit filetransfers { {name } | {validate {enable | disable}} | {client {enable | disable}}}+ Parameters name - The common name of the certificate to be associated with the specified application. validate - For client type applications, perform peer certificate validation. This includes, expiration dates, hostname and CA chain. client - For client type applications, enable or disable the use of the selected client certificate.

3.14 Application Edit Web application edit web - Allows changing SSL certificates for the Web application. Description application edit allows selecting and managing validation on how certificates are used by the web GUI application. Syntax application edit web {{name }} Parameters name - The common name of the certificate to be associated with the specified application.

Revision 1 14

MetroNID TE v6.4.2 CLI Command Guide Application Show

3.15 Application Show application show - Show SSL certificates applications. Description Shows a summary of the SSL certificates applications. All applications making possible use of certificates are listed here. Syntax application show

3.16 Bandwidth Regulator Add Regulator bandwidth-regulator add regulator - Add a bandwidth regulator configuration Description With bandwidth-regulator add, you can create a new bandwidth regulator instance. Up to 16 traffic regulators can be defined on TE/TE-S models. Up to 60 traffic regulators can be defined on TE-R/TE-RS models. Supported rate values: - 0 to 8 Mbps (steps of 125 kbps) - 9 to 135 Mbps (steps of 1 Mbps) - 150 to 1 Gbps (steps of 25 Mbps) The burst size must be greater than the port Maximum Transfer Unit (MTU). Syntax bandwidth-regulator add regulator { {cir } | {cbs } | {eir } | {ebs } | {color-mode {aware | blind}} | {coupling-flag {true | false}} }+ Parameters - cir - Committed Information Rate in kbps. cbs - Committed Burst Size in kBytes. eir - Excess Information Rate in kbps. ebs - Excess Burst Size in kBytes. color-mode - Determine whether the regulator is color-aware or color-blind. coupling-flag - Determine whether the coupling flag will be used or not for this regulator.

Revision 1 15

MetroNID TE v6.4.2 CLI Command Guide Bandwidth Regulator Clear Regulator Statistics

3.17 Bandwidth Regulator Clear Regulator Statistics bandwidth-regulator clear regulator statistics - Clear bandwidth regulator statistics Description Clear the bandwidth regulator statistics. If is not specified, all bandwidth regulators statistics will be cleared. Syntax bandwidth-regulator clear regulator statistics [] Parameters -

3.18 Bandwidth Regulator Delete Regulator bandwidth-regulator delete regulator - Delete the specified bandwidth regulator Description bandwidth-regulator delete will delete the specified bandwidth regulator instance. Syntax bandwidth-regulator delete regulator Parameters -

Revision 1 16

MetroNID TE v6.4.2 CLI Command Guide Bandwidth Regulator Edit Regulator

3.19 Bandwidth Regulator Edit Regulator bandwidth-regulator edit regulator - Change a bandwidth regulator configuration Description With bandwidth-regulator edit, you can change the parameters of an existing bandwidth regulator instance. Supported rate values: - 0 to 8 Mbps (steps of 125 kbps) - 9 to 135 Mbps (steps of 1 Mbps) - 150 to 1 Gbps (steps of 25 Mbps) The burst size must be greater than the port Maximum Transfer Unit (MTU). Syntax bandwidth-regulator edit regulator { {name } | {cir } | {cbs } | {eir } | {ebs } }+ Parameters - cir - Committed Information Rate in kbps. cbs - Committed Burst Size in kBytes. eir - Excess Information Rate in kbps. ebs - Excess Burst Size in kBytes.

3.20 Bandwidth Regulator Show Regulator Configuration bandwidth-regulator show regulator configuration - Show bandwidth regulator configuration Description Without arguments or with the modifier summary, this command displays the bandwidth-regulator configuration summary in a table format. When specifying a bandwidth-regulator name, this command displays the detailed configuration for that bandwidth-regulator. Syntax bandwidth-regulator show regulator configuration [] Parameters -

Revision 1 17

MetroNID TE v6.4.2 CLI Command Guide Bandwidth Regulator Show Regulator Statistics

3.21 Bandwidth Regulator Show Regulator Statistics bandwidth-regulator show regulator statistics - Show bandwidth regulator statistics Description Display the bandwidth regulator statistics. Syntax bandwidth-regulator show regulator statistics { { type {clearable | persistent | historic}} | { buckets } | { period }}+ Parameters - - type - Type of statistics to display: Clearable : Current statistics since last clear command. Persistent: Current statistics since system start. Historic: History buckets statistics. If the number of buckets is not specified, the last 4 buckets will be displayed, starting from the specified period. If no period is specified, the last 4 buckets will be displayed. buckets - Number of bandwidth regulator buckets to display. period - Reference period for the bandwidth regulator history buckets. Zero for the most recent period available.

Revision 1 18

MetroNID TE v6.4.2 CLI Command Guide Beacon Add L3

3.22 Beacon Add L3 beacon add l3 - Add a new beacon layer-3 instance and specify its attributes. Description Configure a beacon layer-3 instance for management purpose. A beacon may be configured to discover remote devices by sending a special frame on the network using the IP settings provided. Syntax beacon add l3 name {} {domain-id {}} | {state {enable|disable}} | {rate {}} | {dst-ip {}} | {use-interface {enable|disable}} | {interface {}} | {use-relay-ip {enable|disable}} | {relay-ip {}} | {relay-dst-subnet {}} | {ip-config-mode {local|auto|dhcp|auto-static}} | {subnet {}} | {netmask {}} | {gateway {}} | {ip-exclusion {}} | {dhcp-hostname-option } | {dhcp-client-id-option } | {dhcp-hostname } | {dhcp-client-id } | {id-mismatch {enable|disable} | {adv-ip {}} }}+ Parameters name - The name to assign to the beacon instance. domain - The name of the discovery domain ID. state - Enable or disable beacon frame transmission. rate - Transmission rate of beacon frames, in seconds . dst-ip - When neither of the use-interface and use-relay-ip options are used, the beacon frames are sent to this address. use-interface - Enable usage of IP settings defined by the system interface specified by the interface argument. interface - The name of a system interface. The interface must exist on this system. The IP settings of this interface will be used to compute the directed broadcast IP address to use to send the beacon frames. use-relay-ip - Enable sending of frame directly to the DHCP Relay IP address specified in the relay-ip argument.

Revision 1 19

MetroNID TE v6.4.2 CLI Command Guide Beacon Add L3

relay-ip - The DHCP Relay Agent IP address. The beacon frames are sent to this DHCP Relay IP address in order to reach remote subnets The DHCP Relay must be configured to relay the beacon layer-3 frames which are based on DHCPOFFER frames. relay-dst-subnet - When used with a DHCP Relay Agent, this is the destination subnet i.e. the subnet to reach on the other side of the DHCP Relay. ip-config-mode - The IP configuration mode to be uses by the remote device. subnet - IP subnet used in Auto and Auto-Static IP configuration modes. netmask - IP netmask used in Auto and Auto-Static IP configuration modes. gateway - IP gateway used in Auto and Auto-Static IP configuration modes. ip-exclusion - This is a comma-separated list of IP addresses that the remote unit must exclude when computing an IP address in Auto and Auto-Static IP configuration modes. Up to 100 IP addresses can be specified. IP address ranges can be expressed with dash (-) separated IP addresses. dhcp-hostname-option - Tell the remote NID what option to use as a hostname in its DNS configuration. Used only in DHCP IP configuration mode. dhcp-client-id-option - Tell the remote NID what option to use as a client ID in its DNS configuration. Used only in DHCP IP configuration mode. dhcp-hostname - The hostname to use when the hostname option is chosen. Used only in DHCP IP configuration mode. dhcp-client-id - The client ID to use when the client ID option is chosen. Used only in DHCP IP configuration mode. id-mismatch - When enabled, forces the remote system to accept beacon even if domain IDs do not match. adv-ip - IP address of a inventory collecting unit

Revision 1 20

MetroNID TE v6.4.2 CLI Command Guide Beacon Delete L3

3.23 Beacon Delete L3 beacon delete l3 - Delete a beacon layer-3 instance. Description Delete an existing beacon layer-3 instance. Syntax beacon delete l3 Parameters - The name of the beacon instance to delete.

3.24 Beacon Edit L3 beacon edit l3 - Edit the attributes of an existing beacon layer-3 instance. Description Configure a beacon layer-3 instance for management purpose. A beacon may be configured to discover remote devices by sending a special frame on the network using the IP settings provided. Syntax beacon edit l3 {name {}} | {domain-id {}} | {state {enable|disable}} | {rate {}} | {dst-ip {}} | {use-interface {enable|disable}} | {interface {}} | {use-relay-ip {enable|disable}} | {relay-ip {}} | {relay-dst-subnet {}} | {ip-config-mode {local|auto|dhcp|auto-static}} | {subnet {}} | {netmask {}} | {gateway {}} | {ip-exclusion {}} | {dhcp-hostname-option } | {dhcp-client-id-option } | {dhcp-hostname } | {dhcp-client-id } | {id-mismatch {enable|disable} | {adv-ip {}} }}+

Revision 1 21

MetroNID TE v6.4.2 CLI Command Guide Beacon Edit L3

Parameters - The name of the beacon instance to edit. name - The name to assign to the beacon instance. domain - The name of the discovery domain ID. state - Enable or disable beacon frame transmission. rate - Transmission rate of beacon frames, in seconds . dst-ip - When neither of the use-interface and use-relay-ip options are used, the beacon frames are sent to this address. use-interface - Enable usage of IP settings defined by the system interface specified by the interface argument. interface - The name of a system interface. The interface must exist on this system. The IP settings of this interface will be used to compute the directed broadcast IP address to use to send the beacon frames. use-relay-ip - Enable sending of frame directly to the DHCP Relay IP address specified in the relay-ip argument. relay-ip - The DHCP Relay Agent IP address. The beacon frames are sent to this DHCP Relay IP address in order to reach remote subnets The DHCP Relay must be configured to relay the beacon layer-3 frames which are based on DHCPOFFER frames. relay-dst-subnet - When used with a DHCP Relay Agent, this is the destination subnet i.e. the subnet to reach on the other side of the DHCP Relay. ip-config-mode - The IP configuration mode to be uses by the remote device. subnet - IP subnet used in Auto and Auto-Static IP configuration modes. netmask - IP netmask used in Auto and Auto-Static IP configuration modes. gateway - IP gateway used in Auto and Auto-Static IP configuration modes. ip-exclusion - This is a comma-separated list of IP addresses that the remote unit must exclude when computing an IP address in Auto and Auto-Static IP configuration modes. Up to 100 IP addresses can be specified. IP address ranges can be expressed with dash (-) separated IP addresses. dhcp-hostname-option - Tell the remote NID what option to use as a hostname in its DNS configuration. Used only in DHCP IP configuration mode. dhcp-client-id-option - Tell the remote NID what optio

Documents

MetroNID TE v6.4.2 CLI Command Guide