MetroNID TE v6 4 2 CLI Command Guide PDF
MetroNID TE v6 4 2 CLI Command Guide PDF
MetroNID TE v6 4 2 CLI Command Guide PDF
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.
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:
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.
MetroNID TE v6.4.2 CLI Command Guide
Contents
Revision 1 v
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 vi
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 vii
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 viii
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 ix
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 x
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 xi
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 xii
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 xiii
MetroNID TE v6.4.2 CLI Command Guide
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.
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
MetroNID TE v6.4.2 CLI Command Guide
Below is a list of all MetroNID TE CLI commands, grouped according to their primary
function.
Revision 1 1
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 2
MetroNID TE v6.4.2 CLI Command Guide
1.5 Utilities
Command Name Description
Revision 1 3
MetroNID TE v6.4.2 CLI Command Guide
Revision 1 4
MetroNID TE v6.4.2 CLI Command Guide
\ Escape a meta-character.
<command-name> <key-word>
<attribute-name> <key-word>
Revision 1 5
MetroNID TE v6.4.2 CLI Command Guide
<decimal> {0-9}+
<ip-addr> <0-255>.<0-255>.<0-255>.<0-255>
<mac-addr> <0-FF>:<0-FF>:<0-FF>:<0-FF>:<0-FF>:<0-FF>
<port> <0-65535>
<ipv6-addr> <0-FFFF>[:<0-FFFF>]+[:<0-FFFF> | :]
<ipv6-prefixLen> <0-128>
<url> <dns-name>[:<port>]/[<path>]<file-name>
<path> {<string>/}+
<file-name> <string>
<dns-name> <string>[.<string>]+
<port-name> <string>
<connector-name> <string>
Revision 1 6
MetroNID TE v6.4.2 CLI Command Guide
3 CLI Commands
This section describes all CLI commands; commands are listed by name in alphanumerical order.
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 <acl-name>
Parameters
<acl-name> - <string>
Description
Delete an existing interface definition from the ACL service.
Syntax
acl delete interface <interface-name>
Parameters
<interface-name> - <string>
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 <acl-name>
Parameters
<acl-name> - <string>
Revision 1 7
MetroNID TE v6.4.2 CLI Command Guide ACL Edit Interface
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.
Syntax
acl edit interface <interface-name> {
{acl_name <acl-name>} |
{acl_types <acl-types>} |
{state {enable|disable}}
}+
Parameters
<acl-name> - <string>
<acl-types> - {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
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 <acl-name> {
{name <new-acl-name>} |
{index {<1-20>|<rule_name>} {
{type {ipsrc|macsrc}} |
{value <rule-value>} |
{action {drop|accept}} |
{rule_name <rule-name>} |
{priority <1-255>} |
{state {enable|disable}}
}+
}+
Parameters
<acl-name> - <string>
<new-acl-name> - <string>
<rule-value> - {<ip-addr>|<mac-addr>|<subnet-addr/subnet-addr-prefix>}
<rule-name> - <string>
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
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 [<interface-name> [stats]]
Parameters
<interface-name> - <string>
stats - Display rules statistics based on the assigned 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 [<acl-name>]
Parameters
<acl-name> - <string>
Revision 1 10
MetroNID TE v6.4.2 CLI Command Guide Alarm Edit
Description
Alarm edit allows you to change the configuration of an alarm.
Syntax
alarm edit <alarm-number> {{disable | enable} |
{service-affecting {yes | no}} |
{severity {minor | major | critical | informational}} |
{state {enable | disable}} |
{description <description-text>}}+
Parameters
<alarm-number> - <decimal>.<decimal>.<decimal>
<description-text> - <string>
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
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 <1-5000>} |
{threshold-off <1-15000>}}
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.
Description
Display the alarm reporting behavior.
Syntax
alarm show configuration [<alarm-id>] [more]
Parameters
<alarm_id> - <decimal>.<decimal>.<decimal>
Revision 1 12
MetroNID TE v6.4.2 CLI Command Guide Alarm Show Reporting
Description
Display the alarm reporting parameters.
Syntax
alarm show reporting
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 [<alarm_number> | active | all | more]
Parameters
<alarm_number> - <decimal>.<decimal>.<decimal>
Revision 1 13
MetroNID TE v6.4.2 CLI Command Guide Application Edit File Transfers
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 <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.
Description
application edit allows selecting and managing validation on how
certificates are used by the web GUI application.
Syntax
application edit web {{name <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
Description
Shows a summary of the SSL certificates applications. All applications making
possible use of certificates are listed here.
Syntax
application show
Description
With bandwidth-regulator add, you can create a new bandwidth regulator
instance.
The burst size must be greater than the port Maximum Transfer Unit (MTU).
Syntax
bandwidth-regulator add regulator <regulator-name> {
{cir <0 to max-port-speed>} |
{cbs <2-500>} |
{eir <0 to max-port-speed>} |
{ebs <2-500>} |
{color-mode {aware | blind}} |
{coupling-flag {true | false}} }+
Parameters
<regulator-name> - <string>
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
Description
Clear the bandwidth regulator statistics. If <regulator-name> is not
specified, all bandwidth regulators statistics will be cleared.
Syntax
bandwidth-regulator clear regulator statistics [<regulator-name>]
Parameters
<regulator-name> - <string>
Description
bandwidth-regulator delete will delete the specified bandwidth regulator
instance.
Syntax
bandwidth-regulator delete regulator <regulator-name>
Parameters
<regulator-name> - <string>
Revision 1 16
MetroNID TE v6.4.2 CLI Command Guide Bandwidth Regulator Edit Regulator
Description
With bandwidth-regulator edit, you can change the parameters of an existing
bandwidth regulator instance.
The burst size must be greater than the port Maximum Transfer Unit (MTU).
Syntax
bandwidth-regulator edit regulator <regulator-name> {
{name <regulator-name>} |
{cir <0 to max-port-speed>} |
{cbs <2-500>} |
{eir <0 to max-port-speed>} |
{ebs <2-500>} }+
Parameters
<regulator-name> - <string>
cir - Committed Information Rate in kbps.
cbs - Committed Burst Size in kBytes.
eir - Excess Information Rate in kbps.
ebs - Excess Burst Size in kBytes.
Syntax
bandwidth-regulator show regulator configuration [<regulator-name>]
Parameters
<regulator-name> - <string>
Revision 1 17
MetroNID TE v6.4.2 CLI Command Guide Bandwidth Regulator Show Regulator Statistics
Description
Display the bandwidth regulator statistics.
Syntax
bandwidth-regulator show regulator statistics <regulator-name> {
{ type {clearable | persistent | historic}} |
{ buckets <0-16>} |
{ period <period-id>}}+
Parameters
<regulator-name> - <string>
<period-id> - <decimal>
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
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 {<beacon-name>}
{domain-id {<domain>}} |
{state {enable|disable}} |
{rate {<transmission rate>}} |
{dst-ip {<ip-addr>}} |
{use-interface {enable|disable}} |
{interface {<interface name>}} |
{use-relay-ip {enable|disable}} |
{relay-ip {<ip-addr>}} |
{relay-dst-subnet {<ip-addr>}} |
{ip-config-mode {local|auto|dhcp|auto-static}} |
{subnet {<ip-addr>}} |
{netmask {<ip-addr>}} |
{gateway {<ip-addr>}} |
{ip-exclusion {<ip-addr1, ip-addr2, ...>}} |
{dhcp-hostname-option <none,custom,serial-number,current>} |
{dhcp-client-id-option <none,custom,serial-number>} |
{dhcp-hostname <hostname>} |
{dhcp-client-id <client-id>} |
{id-mismatch {enable|disable} |
{adv-ip {<ip-addr>}} }}+
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
<3, 60, 600, 3600>.
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
Revision 1 20
MetroNID TE v6.4.2 CLI Command Guide Beacon Delete L3
Description
Delete an existing beacon layer-3 instance.
Syntax
beacon delete l3 <beacon-name>
Parameters
<beacon-name> - The name of the beacon instance to delete.
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 <beacon-name>
{name {<beacon-name>}} |
{domain-id {<domain>}} |
{state {enable|disable}} |
{rate {<transmission rate>}} |
{dst-ip {<ip-addr>}} |
{use-interface {enable|disable}} |
{interface {<interface name>}} |
{use-relay-ip {enable|disable}} |
{relay-ip {<ip-addr>}} |
{relay-dst-subnet {<ip-addr>}} |
{ip-config-mode {local|auto|dhcp|auto-static}} |
{subnet {<ip-addr>}} |
{netmask {<ip-addr>}} |
{gateway {<ip-addr>}} |
{ip-exclusion {<ip-addr1, ip-addr2, ...>}} |
{dhcp-hostname-option <none,custom,serial-number,current>} |
{dhcp-client-id-option <none,custom,serial-number>} |
{dhcp-hostname <hostname>} |
{dhcp-client-id <client-id>} |
{id-mismatch {enable|disable} |
{adv-ip {<ip-addr>}} }}+
Revision 1 21
MetroNID TE v6.4.2 CLI Command Guide Beacon Edit L3
Parameters
<beacon-name> - 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
<3, 60, 600, 3600>.
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 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 <custom>
option is chosen. Used only in DHCP IP
configuration mode.
Revision 1 22
MetroNID TE v6.4.2 CLI Command Guide Beacon Send L3
Description
Immediately sends one beacon layer-3 frame based on the configuration
of the chosen beacon instance.
Syntax
beacon send l3 one-shot <beacon-name>
Parameters
<beacon-name> - The name of the beacon instance configuration to
use for sending the one frame. The beacon-name must
refer to an existing instance and the instance must
be enabled.
Description
Immediately sends one beacon layer-3 frame based on the configuration
of the chosen beacon instance.
Syntax
beacon send l3 one-shot <beacon-name>
Parameters
<beacon-name> - The name of the beacon instance configuration to
use for sending the one frame. The beacon-name must
refer to an existing instance and the instance must
be enabled.
Revision 1 23
MetroNID TE v6.4.2 CLI Command Guide Beacon Show L3 Configuration
Description
Specifying a beacon name provides detailed configuration about this beacon,
otherwise the command provides a summary of configurations for all beacons.
Syntax
beacon show l3 configuration [<beacon-name>]
Parameters
<beacon-name> - The name of the beacon instance to show.
Description
Display the CPU usage over a period of time. Available periods are:
- Last second
- Last completed 15 seconds period average
- Last completed 30 seconds period average
- Last completed 60 seconds period average
- Last completed 5 minutes period average
Syntax
board show cpu
Description
Displays unit board information: MAC base address, unit identifier, firmware
version, assembly, and serial number. Also displays sub-assembly information,
if any.
Syntax
board show info
Revision 1 24
MetroNID TE v6.4.2 CLI Command Guide Board Show Start Time
Description
Display the system start time in the following format:
Syntax
board show start-time
Description
Display information about power supplies and the temperature sensor.
Syntax
board show status
Description
Display the system uptime in the following format: up xx days, HH:MM
Syntax
board show uptime
Description
Display the system uptime in the following format: up xx seconds
Syntax
board show uptime-seconds
Revision 1 25
MetroNID TE v6.4.2 CLI Command Guide Bridge Clear Statistics
Description
For a specific bridge name, this command clears all statistics.
Syntax
bridge clear statistics [<bridge-name>]
Parameters
<bridge-name> - <string>
Description
With bridge edit, you can change the parameters of an existing bridge
instance.
Syntax
bridge edit <bridge-name> {
{aging-time <decimal>} |
{forward-delay <decimal>} |
{hello-time <decimal>} |
{path-cost <sub-intf> <decimal>} |
{port-priority <sub-intf> <decimal>} |
{priority <decimal>} |
{protocol {stp | rstp}} |
{mac-addr {bridge-ga | provider-bridge-ga}} |
{message-max-age <decimal>} }+
Parameters
<bridge-name> - <string>
aging-time - Bridge aging time can vary from 30 to 600 seconds.
forward-delay - Forward time can vary from 4 to 30 seconds.
hello-time - Hello time can vary from 1 to 2 seconds.
path-cost - Path cost of the port can vary from 1 to 200 Million.
port-priority - Port priority, value must be between 16 and 240.
in steps of 16
priority - Bridge priority, value must be between 4096 and 61440,
in steps of 4096.
protocol - Configure STP or RSTP.
mac-addr - Destination MAC address used to transmit BPDU. Can be the
Bridge Group Address or the Provider Bridge Group address.
message-max-age - Maximum message age can vary from 6 to 40 seconds.
Revision 1 26
MetroNID TE v6.4.2 CLI Command Guide Bridge Show Configuration
Description
Without arguments, this command displays a configuration summary for all
bridges in a table format. With a specific bridge name argument, this command
displays the detailed configuration information for that specific bridge.
Syntax
bridge show configuration [<bridge-name>]
Parameters
<bridge-name> - <string>
Description
For a specific bridge name, this command displays all statistics.
Syntax
bridge show statistics [<bridge-name>]
Parameters
<bridge-name> - <string>
Description
Without arguments, this command displays a status summary for all bridges in
a table format. With a specific bridge name argument, this command displays
the detailed status information for that specific bridge.
Syntax
bridge show status [<bridge-name>]
Parameters
<bridge-name> - <string>
Revision 1 27
MetroNID TE v6.4.2 CLI Command Guide Cable Test Perform
Description
Perform time domain reflectometry diagnostics for a copper port.
Syntax
cable-test perform [<connector-name> | <port-name>]
Description
Show cable diagnostics information
Syntax
cable-test show [<connector-name> | <port-name>]
Description
certificate delete allows you to remove a SLL certificate present in the unit.
Syntax
certificate delete {name}
Parameters
name - The common name of the certificate to be removed.
Revision 1 28
MetroNID TE v6.4.2 CLI Command Guide Certificate Import
Description
certificate import allows you to download and activate a SSL certificate
from a remote server through ftp, ftps, http, https, or tftp protocol.
Syntax
certificate import {
{type {pkcs7 | pkcs12 | PEM | DER}} |
{url <url>} |
{passcode}}+
Parameters
type - The type of the certificate being imported. Possible values are:
pkcs12: Used to import client certificates including the private
key and the CA chain of certificates.
pkcs7: Used to import multiple CA certificates.
x509-PEM: Used to import either:
- A client or server certificate and its private key.
- A single or multiple CA certificate.
x509-DER: Used to import single CA certificates.
url - URL to reach the server and directory e.g.
tftp://192.168.1.1/certs/certificate.p7
ftp://192.168.1.1/certs/certificate.p7
passcode - The passcode to decipher the certificate. Leave blank if the
certificate is not encrypted. A separate query prompt will be
displayed to allow the passcode to be specified. It cannot be
specified directly on the command line.
Description
Shows a summary of the SSL certificates present in the unit if no name is
specified. If a common name is specified, the certificate contents are
displayed.
Syntax
certificate show {[name]}
Parameters
name - The common name of the certificate to be displayed.
Revision 1 29
MetroNID TE v6.4.2 CLI Command Guide CFM Add DMM
Description
Create delay measurement for a MEP.
Syntax
cfm add dmm {
{mep-idx <mep-index>} |
{index <decimal>} |
{rmep-id <1-8191>} |
{priority <0-7> } |
{enable {yes | no}} |
{name <string>} |
{interval <decimal>} |
{reference-period <decimal> } |
{ow-delay {enable | disable}} |
{ow-max-delay <decimal>} |
{ow-delay-threshold <decimal>} |
{ow-ad-threshold <decimal>} |
{ow-dv {enable | disable}} |
{ow-max-dv <decimal>} |
{ow-dv-threshold <decimal>} |
{ow-adv-threshold <decimal>} |
{tw-delay {enable | disable}} |
{tw-max-delay <decimal>} |
{tw-delay-threshold <decimal>} |
{tw-ad-threshold <decimal>} |
{tw-dv {enable | disable}} |
{tw-max-dv <decimal>} |
{tw-dv-threshold <decimal>} |
{tw-adv-threshold <decimal>}}+
<mep-index> = <decimal>
Parameters
mep-idx - Specifies the local MEP index from which DMM should
be initiated.
index - A free DMM index. If the index is omitted, a free
index is allocated automatically.
rmep-id - Specifies the remote MEPID to which DMM should be sent.
priority - Specifies DMM VLAN priority. This parameter applies
only to VLAN based MEPs.
name - A name assigned to reference this instance.
enable - Enable or disable generating DMM frames.
interval - Interval in milliseconds at which DMM should be sent.
reference-period - Reference period in minutes.
ow-delay - Enable or disable one-way delay results.
Revision 1 30
MetroNID TE v6.4.2 CLI Command Guide CFM Add DMM
Revision 1 31
MetroNID TE v6.4.2 CLI Command Guide CFM Add Domain
Description
Create a maintenance domain. A Maintenance Domain defines a level and a name
for a network or part of a network for which faults in connectivity are to be
managed. A Maintenance Domain is required to create a MA with CCM MAID that
includes the Maintenance Domain name.
Syntax
cfm add domain {
{name <string> } |
{index <decimal>} |
{format {string | dns-name}} |
{level <0-7>} |
{mhf-creation <none | default | explicit>} |
{sndr-id-perm {none | chassis | manage | chassis-manage>}}+
Parameters
name - Unique name assigned to this Maintenance Domain.
index - A free domain index. If the index is omitted, a free index
is allocated automatically.
format - The Maintenance Domain name format.
level - Maintenance Level given to this Maintenance Domain.
mhf-creation - Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 32
MetroNID TE v6.4.2 CLI Command Guide CFM Add MA
Description
Create a Maintenance Association. A Maintenance Association defines a set of
MEPs, each configured with the same MAID and MD Level, established to verify
the integrity of a single service instance. An MA can also be thought of as
a full mesh of Maintenance Entities among a set of MEPs configured.
Syntax
cfm add ma {
{name <string> } |
{index <decimal>} |
{md-idx <decimal> } |
{ccm-interval <decimal> } |
{vlan-type {c-vlan | s-vlan | none}} |
{vid-list {<0-4095> [, <0-4095>]+}} |
{mepid-list {<1-8191> [, <1-8191>]+}} |
{mhf-creation <none | default | explicit | defer>} |
{sndr-id-perm {none | chassis | manage | chassis-manage | defer}}}+
Parameters
name - MEG name. The name should include the ICC and UMC in a single
string, as specified in Y.1731.
index - A free maintenance association index. If the index is omitted,
a free index is allocated automatically.
md-idx - Parent maintenance domain index.
ccm-interval - Interval in milliseconds at which the CCMs are sent.
vlan-type - Specify the VLAN type associated with this maintenance
association. If the value "none" is specified, the association
is not attached to any VLAN and the contents of the VLAN ID
list are ignored.
vid-list - A comma-separated list of VLAN ID values. If the VLAN ID list
is left empty, the association is not attached to a VLAN and
the VLAN type is set to "none" implicitly. If a vid-list is
provided without specifying the vlan-type, it is set to c-vlan
implicitly.
mepid-list - A comma-separated list of MEPID values.
mhf-creation - Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
- defer : Use the Maintenance Domain parameter to determine
MHFs creation.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 33
MetroNID TE v6.4.2 CLI Command Guide CFM Add MEG
Description
Create Y.1731 MEG.
Syntax
cfm add meg {
{name <string> } |
{name-format <icc-based | string> } |
{index <decimal>} |
{level <0-7> } |
{ccm-interval <decimal> } |
{vlan-type {c-vlan | s-vlan | none}} |
{vid-list {<0-4095> [, <0-4095>]+}} |
{mepid-list {<1-8191> [, <1-8191>]+}} |
{mhf-creation <none | default | explicit | defer>} |
{sndr-id-perm {none | chassis | manage | chassis-manage | defer}}}+
Parameters
name - MEG name. The name should include the ICC and UMC in a single
string, as specified in Y.1731.
name-format - MEG name format. The valid values are:
- icc-based : ITU Carrier Code format (Y.1731).
- string : RFC-2579 Display String.
index - A free maintenance association index. If the index is omitted
a free index is allocated automatically.
level - Maintenance Level given to this MEG.
ccm-interval - Interval in milliseconds at which the CCMs are sent.
vlan-type - Specify the VLAN type associated with this MEG. If the value
"none" is specified, the MEG is not attached to a VLAN and the
contents of the VLAN ID list are ignored.
vid-list - A comma-separated list of VLAN ID values. If the VLAN ID list
is left empty, the MEG is not attached to a VLAN and the VLAN
type is set to none implicitly.
mepid-list - A comma-separated list of MEPID values.
mhf-creation - Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
- defer : Use the Maintenance Domain parameter to determine
MHFs creation.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 34
MetroNID TE v6.4.2 CLI Command Guide CFM Add MEP
Description
Create Maintenance association End Point.
Syntax
cfm add mep {{ma-idx <decimal>} |
{meg-idx <decimal> }} {
{index <decimal>} | {mep-id <1-8191> } |
{name <string>} |
{direction <up | down> } |
{port <port-name> } |
{pvid <0-4095> } |
{active <yes | no> } |
{cci-enable <yes | no> } |
{ccm-seq-number <enable | disable> } |
{csf-enable <yes | no> } |
{priority <0-7> } |
{lowest-alarm-pri <lowest-alarm-pri-choice>} |
{fng-alarm-time <decimal> } |
{fng-reset-time <decimal> } |
{fault-propagation <enable | disable> } |
{fp-port <port-name> } }+
Parameters
meg-idx - MEG index. Identifies the MEG that MEP belongs to. Only
one of meg-idx or ma-idx should be specified.
index - A free MEP index. If the index is omitted, a free index
is allocated automatically. This should not be confused
with the MEPID specified using mep-id.
ma-idx - Maintenance Association index. Identifies the Maintenance
Association to which this MEP belongs. Either a meg-idx
or a ma-idx should be specified.
mep-id - MEP identifier <1-8191>.
name - A name assigned to reference this instance.
direction - Direction, up or down.
port - Indicates the port used by this MEP.
pvid - Primary VLAN ID <0-4095>.
active - Indicates the administrative state of the MEP. "yes"
indicates that the MEP is to function normally, and
"no" that it is to cease functioning.
cci-enable - Indicates if the MEP will generate CCM messages.
ccm-seq-number - Enable or disable CCM sequence number. When enabled, a
MEP transmits CCMs with a sequence number that increments
by one for each CCM. When disabled, a MEP transmits CCMs
with a sequence number set to zero.
csf-enable - Enable or disable CSF. When enabled, a MEP transmits
Revision 1 35
MetroNID TE v6.4.2 CLI Command Guide CFM Add Packet Loss
Description
Create packet loss measurement for a MEP. Packet loss measurements are based
on Remote MEP CCM sequence number. Remote MEP should have CCM sequence number
generation enabled to perform packet loss measurements.
Syntax
cfm add pkt-loss {
{mep-idx <mep-index>} |
{index <decimal>} |
{rmep-id <1-8191>} |
{enable {yes | no}} |
{reference-period <decimal> } |
{threshold <decimal>} |
{threshold-ratio <decimal>} }+
<mep-index> = <decimal>
Parameters
mep-idx - Specifies the local MEP index from which packet loss should
be performed.
index - A free packet loss index. If the index is omitted, a free
index is allocated automatically.
rmep-id - Remote MEP Maintenance association End Point Identifier.
enable - Indicates if the configured packet loss measurements are
performed.
reference-period - Packet loss reference period in minutes.
threshold - Maximum number allowed of packets lost before raising an
alarm during the reference period.
threshold-ratio - Maximum % of packets lost before issuing an alarm during
the reference period.
Revision 1 36
MetroNID TE v6.4.2 CLI Command Guide CFM Add SLM
Description
Creates an SLM instance.
Syntax
cfm add slm mep-idx <decimal> rmep-id <decimal> {{index <decimal>}
{name <string>}
{priority <decimal>}
{reporting-period <decimal>}
{interval <decimal>}
{state <enable| disable>}
{near-end-threshold <decimal>}
{far-end-threshold <decimal>}
}+
Parameters
index -
The SLM instance index.
name -
A unique name to identify an SLM instance.
mep-idx -
The local MEP index.
rmep-id -
The remote MEP ID.
priority -
The priority of the SLM frames.
interval -
The SLM frames transmission rate.
state -
The state of the instance (disabled by default).
reporting-period -
A reporting period over which periodic counters are
evaluated in addition to the monotonic counters.
near-end-threshold - The near-end frame loss threshold. (1 = 0.000001%)
far-end-threshold - The far-end frame loss threshold. (1 = 0.000001%)
Description
Clear individual MEP statistics.
Syntax
cfm clear mep statistics <mep-index>|<name>
<mep-index> = <decimal>
<name> = <string>
Parameters
<mep-index> - Identifies a MEP.
<name> - Identifies a MEP by name.
Revision 1 37
MetroNID TE v6.4.2 CLI Command Guide CFM Clear Packet Loss Result
Description
Clear continuous packet loss measurement results. Periodic and historical
measurement results are not affected.
Syntax
cfm clear pkt-loss result [<pl-index> | <name>]
<pl-index> = <decimal>
<name> = <string>
Parameters
<pl-index> - Specifies the packet loss instance.
<name> - Specifies the packet loss instance by name.
Description
Clear slm results.
Syntax
cfm clear slm result <identifier>
Parameters
<identifier> - A unique name to identify an instance of SLM or the SLM index.
Description
Clear global CFM statistics. This does not affect individual MEP statistics.
Syntax
cfm clear statistics
Revision 1 38
MetroNID TE v6.4.2 CLI Command Guide CFM Clear VSP Result
Description
Clear VSP results.
Syntax
cfm clear vsp result [<identifier>]
<identifier> = <decimal>
Parameters
<identifier> - An optional unique index identifying the instance.
Description
Delete a delay measurement instance.
Syntax
cfm delete dmm <dmm-index> | <name>
<dmm-index> = <decimal>
<name> = <string>
Parameters
<dmm-index> - Identifies the DMM instance to delete.
<name> - Identifies the DMM instance to delete by name.
Revision 1 39
MetroNID TE v6.4.2 CLI Command Guide CFM Delete Domain
Description
Delete a Maintenance Domain. When a Maintenance Domain is deleted, all the
objects (MAs, MEPs, DMMs, and Packet Loss instances) inside that Maintenance
Domain are deleted. Pseudo Maintenance Domains "Y.1731 level 0" to
"Y.1731 level 7" cannot be deleted.
Syntax
cfm delete domain <md-index>
<md-index> = <decimal>
Parameters
<md-index> - Identifies the Maintenance Domain to delete.
Description
Delete a Maintenance Association (MA). When an MA is deleted, all the objects
(MEP, DMM, and Packet Loss instances) inside that MA are deleted.
Syntax
cfm delete ma <ma-index>
<ma-index> = <decimal>
Parameters
<ma-index> - Identifies the Maintenance Association to delete.
Revision 1 40
MetroNID TE v6.4.2 CLI Command Guide CFM Delete MEG
Description
Delete a MEG. When a MEG is deleted, all the objects (MEP, DMM, and Packet
Loss instances) inside that MEG are deleted.
Syntax
cfm delete meg <meg-index>
<meg-index> = <decimal>
Parameters
<meg-index> - Identifies the MEG to delete.
Description
Delete a Maintenance association End Point. When a MEP is deleted, all the
objects (DMM and Packet Loss instances) inside that MEP are deleted.
Syntax
cfm delete mep <mep-index>|<name>
<mep-index> = <decimal>
<name> = <string>
Parameters
<mep-index> - Identifies the MEP to delete.
<name> - Identifies the MEP to delete by name.
Revision 1 41
MetroNID TE v6.4.2 CLI Command Guide CFM Delete Packet Loss
Description
Delete a Packet Loss measurement instance.
Syntax
cfm delete pkt-loss <pl-index>|<name>
<pl-index> = <decimal>
<name> = <string>
Parameters
<pl-index> - Identifies the packet loss instance to delete.
<name> - Identifies the packet loss instance to delete by name.
Description
Delete an SLM instance.
Syntax
cfm delete slm <identifier>
Parameters
<identifier> - A unique identifier for the SLM instance or SLM index.
Revision 1 42
MetroNID TE v6.4.2 CLI Command Guide CFM Edit Defaults
Description
The MHF default parameters control the MHF creation for VIDs that are not
attached to an MA. For each port, a VID is attached to an MA at a specific MD
level, if at this level a MEP exist on that port or if an Up MEP exist on
another port.
For a given VID, the default MHF MD level plus the set of Maintenance
Associations that include that VID define the VID's active MD levels. The MD
level at which MHFs could be created on a port for a given VID is the VID's
lowest active MD level that is higher than any MEP configured on that port.
If at this level the VID is attached to an MA, the MA parameters control the
MHF creation. Otherwise, the MHF default parameters control the MHF creation.
Syntax
cfm edit defaults {
{level <0-7>} |
{mhf-creation <none | default | explicit>} |
{sndr-id-perm <none | chassis | manage | chassis-manage>}}+
Parameters
level - Indicates the default active MD level used by the MHF creation
algorithm when no other lower active MD level apply.
mhf-creation - Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 43
MetroNID TE v6.4.2 CLI Command Guide CFM Edit DMM
Description
Modify a delay measurement instance.
Syntax
cfm edit dmm <dmm-index>|<name> {
{enable {yes | no}} |
{interval <decimal>} |
{name <string> } |
{reference-period <decimal> } |
{ow-delay {enable | disable}} |
{ow-max-delay <decimal>} |
{ow-delay-threshold <decimal>} |
{ow-ad-threshold <decimal>} |
{ow-dv {enable | disable}} |
{ow-max-dv <decimal>} |
{ow-dv-threshold <decimal>} |
{ow-adv-threshold <decimal>} |
{tw-delay {enable | disable}} |
{tw-max-delay <decimal>} |
{tw-delay-threshold <decimal>} |
{tw-ad-threshold <decimal>} |
{tw-dv {enable | disable}} |
{tw-max-dv <decimal>} |
{tw-dv-threshold <decimal>} |
{tw-adv-threshold <decimal>}}+
<dmm-index> = <decimal>
<name> = <string>
Parameters
<dmm-index> - Specifies the DMM instance to modify.
<name> - Specifies the DMM instance to modify by name.
enable - Enable or disable generating DMM frames.
interval - Interval in milliseconds at which DMMs should be sent.
name - A name assigned to reference this instance.
reference-period - Reference period in minutes.
ow-delay - Enable or disable one-way delay results.
ow-max-delay - Maximum one-way delay.
ow-delay-threshold - Maximum consecutive one-way delay samples allowed
greater than ow-max-delay.
ow-ad-threshold - Maximum one-way average delay.
ow-dv - Enable or disable one-way delay variation results.
ow-max-dv - Maximum one-way delay variation allowed.
ow-dv-threshold - Maximum consecutive one-way delay variation samples
Revision 1 44
MetroNID TE v6.4.2 CLI Command Guide CFM Edit Domain
Description
Edit a maintenance domain. Once created, only the sender ID permissions can
be modified.
Syntax
cfm edit domain <md-index>
{mhf-creation <none | default | explicit>} |
{sndr-id-perm {none | chassis | manage | chassis-manage>}}+
<md-index> = <decimal>
Parameters
<md-index> - Maintenance domain index.
mhf-creation - Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 45
MetroNID TE v6.4.2 CLI Command Guide CFM Edit MA
Description
Modify Maintenance Association attributes.
Syntax
cfm edit ma <ma-index> {
{ccm-interval <decimal> } |
{mepid-list {<1-8191> [, <1-8191>]+}} |
{mhf-creation <none | default | explicit | defer>} |
{sndr-id-perm <none | chassis | manage | chassis-manage | defer>}}+
<ma-index> = <decimal>
Parameters
ma-index -
Maintenance Association index. Identifies the MA to modify.
ccm-interval -
Interval in milliseconds at which the CCMs are sent.
mepid-list -
A comma-separated list of MEPID values.
mhf-creation -
Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
- defer : Use the Maintenance Domain parameter to determine
MHFs creation.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 46
MetroNID TE v6.4.2 CLI Command Guide CFM Edit MEG
Description
Modify Y.1731 MEG attributes.
Syntax
cfm edit meg <meg-index> {
{ccm-interval <decimal>} |
{mepid-list {<1-8191> [, <1-8191>]+}} |
{mhf-creation <none | default | explicit | defer>} |
{sndr-id-perm <none | chassis | manage | chassis-manage | defer>}}+
<meg-index> = <decimal>
Parameters
meg-index -
MEG index. Identifies the MEG to modify.
ccm-interval -
Interval in milliseconds at which the CCMs are sent.
mepid-list -
A comma-separated list of MEPID values.
mhf-creation -
Indicates if the management entity can create MHFs for VIDs on
which no Up MEP is configured. The valid values are:
- none : No MHFs can be created.
- default : Create MHFs if there is no lower active MD level or
if there is a MEP at the next active MD level on
the port.
- explicit: Create MHFs only if there is a MEP at the next
active MD level on the port.
- defer : Use the Maintenance Domain parameter to determine
MHFs creation.
sndr-id-perm - Sender ID permission. Indicates what, if anything, is to be
included in the Sender ID TLV transmitted in CCMs, LBMs, LTMs,
and LTRs.
Revision 1 47
MetroNID TE v6.4.2 CLI Command Guide CFM Edit MEP
Description
Modify a Maintenance association End Point.
Syntax
cfm edit mep <mep-index> | <name> {
{pvid <0-4095> } |
{active <yes | no> } |
{cci-enable <yes | no> } |
{csf-enable <yes | no> } |
{ccm-seq-number <enable | disable> } |
{name <string> } |
{priority <0-7> } |
{lowest-alarm-pri <lowest-alarm-pri-choice>} |
{fng-alarm-time <decimal> } |
{fng-reset-time <decimal> } |
{fault-propagation <enable | disable> } |
{fp-port <port-name> } }+
<mep-index> = <decimal>
<name> = <string>
Parameters
mep-index - MEP index. Identifies the MEP to modify.
pvid - Primary VLAN ID <0-4095>.
active - Indicates the administrative state of the MEP. "true"
indicates that the MEP is to function normally and "false"
that it is to cease functioning.
cci-enable - Indicates if the MEP will generate CCM messages.
ccm-seq-number - Enable or disable CCM sequence number. When enabled, a MEP
transmits CCMs with a sequence number that increments by
one for each CCM. When disabled, a MEP transmits CCMs with
a sequence number set to zero.
name - A name assigned to reference this instance.
csf-enable - Enable or disable CSF. When enabled, a MEP transmits
ETH-CSF when a link failure is detected.
priority - CCM, LTM, and CSF priority.
lowest-alarm-pri - The lowest priority defect alarm that specifies the lowest
priority defect that is allowed to generate a Fault Alarm.
Possible values are: all, macRemErrXconAis, remErrXconAis,
errXconAis, xconAis, ais, or none.
fng-alarm-time - Time that defects must be present before an alarm is
raised (in ms).
fng-reset-time - Time that defects must be absent before resetting an
alarm (in ms).
fault-propagation - Enable or disable EVC fault propagation.
fp-port - Fault propagation port. Indicates toward which port EVC
faults should be propagated.
Revision 1 48
MetroNID TE v6.4.2 CLI Command Guide CFM Edit Packet Loss
Description
Modify a packet loss measurement instance. Packet loss measurements are based
on Remote MEP CCM sequence number. Remote MEP should have CCM sequence number
generation enabled to perform packet loss measurements.
Syntax
cfm edit pkt-loss <pl-index>|<name> {
{enable {yes | no} } |
{reference-period <decimal> } |
{name <string> } |
{threshold <decimal>} |
{threshold-ratio <decimal>} }+
<pl-index> = <decimal>
<name> = <string>
Parameters
<pl-index> - Specifies the packet loss instance to modify.
<name> - Specifies the packet loss instance by name.
enable - Indicates if the configured packet loss measurements are
performed.
reference-period - Packet loss reference period in minutes.
name - A name assigned to reference this instance.
threshold - Maximum number allowed of packets lost before raising an
alarm during the reference period.
threshold-ratio - Maximum % of packets lost before issuing an alarm during
the reference period.
Revision 1 49
MetroNID TE v6.4.2 CLI Command Guide CFM Edit SLM
Description
Edit an SLM instance.
Syntax
cfm edit slm <identifier>
{{name <string>} |
{reference-period <decimal>} |
{state <enable | disable>} |
{near-end-threshold <decimal>} |
{far-end-threshold <decimal>} |
{interval <decimal>}}+
Parameters
<identifier> -
A unique identifier for the SLM instance or SLM index.
name -
A unique name to identify an SLM instance.
state -
The state of the instance (Disabled by default).
reference-period -
A reference period over which periodic counters are
evaluated in addition to the monotonic counters.
near-end- threshold - The near-end frame loss threshold. (1 = 0.000001%)
far-end- threshold - The far-end frame loss threshold. (1 = 0.000001%)
interval - The SLM frames transmission rate.
Description
Edit the VSP configuration.
Syntax
cfm edit vsp {{meg-level <decimal | all>} |
{state <enable | disable>}}+
Parameters
state - The state of the instance (disabled by default).
meg-level - The MEG level used.
Revision 1 50
MetroNID TE v6.4.2 CLI Command Guide CFM LBM
Description
Initiate a CFM loopback request from a MEP. The MEP is specified by MEP index
or by MEP name. The target address is identified by MAC address or by remote
MEPID. When identifying the target by remote MEPID, the remote MEP MAC address
should be resolved into the remote MEP database. Otherwise, an invalid state
error will be returned.
Syntax
cfm lbm {mep-idx <mep-index> | mep-name <name>}
{ {{rmep-id <1-8191>} |
{dst-mac-addr <mac-addr>}} |
{nbr-msg <decimal>} |
{interval <100-5000>} |
{vlan-priority <0-7>} |
{vlan-de {enable | disable}} |
{data <string>} |
{data-length <1-1488>}}+
<mep-index> = <decimal>
<name> = <string>
Parameters
mep-index - Specifies the local MEP index from which the loopback request
should be initiated.
mep-name - Specifies the local MEP instance by name from which the
loopback request should be initiated.
rmep-id - Specifies a remote MEP for loopback target.
dst-mac-addr - Specifies a MAC address for loopback target.
nbr-msg - Specifies the amount of loopback messages (LBM) to send.
Default value is 1 message.
interval - Specifies the interval between LBMs in milliseconds.
Default value is 1000.
vlan-priority - Specifies the VLAN priority of LBMs.
Revision 1 51
MetroNID TE v6.4.2 CLI Command Guide CFM LTM
Description
Initiate a CFM link trace request from a MEP. The MEP is specified by MEP
index or by MEP name. The target address is identified by MAC address or by
remote MEPID. When identifying the target by remote MEPID, the remote MEP MAC
address should be resolved into the remote MEP database. Otherwise, an invalid
state error will be returned.
In verbose mode, the command waits a few seconds to display replies before
completing. In non verbose mode, the command completes immediately and returns
a link trace transaction identifier. In both cases, the link trace transaction
identifier allows displaying results from recent link traces using the
"cfm show ltr" command.
Syntax
cfm ltm {{mep-idx <mep-index> | mep-name <name>}
{{rmep-id <1-8191>} |
{dst-mac-addr <mac-addr>}} |
{ttl <1-255>} |
{fdb-only <yes | no> } |
{verbose <yes | no>} }+
<mep-index> = <decimal>
<name> = <string>
Parameters
mep-idx - Specifies the local MEP index from which the link trace
request should be initiated.
mep-name - Specifies the local MEP instance by name from which the link
trace request should be initiated.
rmep-id - Specifies a remote MEP for target for the link trace.
dst-mac-addr - Specifies a MAC address for target for the link trace.
ttl - Specifies the link trace time to live.
fdb-only - Specifies whether or not the LTM should set the flag
"UseFDBonly" (IEEE 802.1ag) or the flag "HWonly" (Y.1731).
verbose - Allows verbose mode. Default is non verbose.
Revision 1 52
MetroNID TE v6.4.2 CLI Command Guide CFM Show Defaults
Description
The MHF default parameters control the MHF creation for VIDs that are not
attached to a Maintenance Association. For each port, a VID is attached to an
MA at a specific MD level, if at this level a MEP exist on that port or if an
Up MEP exist on another port.
For a given VID, the default MHF MD level plus the set of Maintenance
Associations that include that VID define the VID's active MD levels. The MD
level at which MHFs could be created on a port for a given VID is the VID's
lowest active MD level that is higher than any MEP configured on that port.
If at this level the VID is attached to an MA, the MA parameters control the
MHF creation. Otherwise, the MHF default parameters control the MHF creation.
Syntax
cfm show defaults
Description
Display a summary of the configured DMM instances. When an instance identifier
is specified, a detailed configuration report is displayed.
Syntax
cfm show dmm configuration [<dmm-index> | <name>]
Parameters
<dmm-index> - <decimal> Identifies a delay measurement instance.
<name> - <string> Identifies a delay measurement instance by name.
Revision 1 53
MetroNID TE v6.4.2 CLI Command Guide CFM Show DMM Result
Description
Display delay measurements results.
Syntax
cfm show dmm result [ [<dmm-index> | <name>] {
{ type {historic}} |
{ buckets <0-16>} |
{ period <period-id>}}+ ]
<dmm-index> = <decimal>
<name> = <string>
<period-id> = <decimal>
Parameters
<dmm-index> - Specifies the delay measurement instance.
<name> - Specifies the delay measurement instance by name.
type - Type of statistics to display:
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 available 4
buckets will be displayed.
buckets - Number of DMM buckets to display.
period - Reference period for the DMM history buckets.
Zero for the most recent period available.
Description
Display a summary of the configured Maintenance Domain instances. When a
domain index is specified, a detailed configuration report is displayed.
Syntax
cfm show domain configuration [<md-index>]
<md-index> = <decimal>
Parameters
<md-index> - Identifies a Maintenance Domain.
Revision 1 54
MetroNID TE v6.4.2 CLI Command Guide CFM Show Latest Error
Description
Display data about latest CFM PDU discarded. A CFM PDU can be discarded if it
is malformed or if no maintenance point is associated to it.
Syntax
cfm show latest error
Description
Show link trace responses associated with a recent link trace request.
Syntax
cfm show ltr {mep-idx <mep-index> | mep-name <name>} [ltm-id <decimal>]
<mep-index> = <decimal>
<name> = <string>
Parameters
mep-idx - Identifies a MEP by MEP index.
mep-name - Identifies a MEP by name.
ltm-id - Link trace transaction identifier. If omitted, the latest
transaction from that MEP is retrieved.
Description
Display a summary of the configured Maintenance Association instances. If an
instance index is specified, a detailed configuration report is displayed.
Syntax
cfm show ma configuration [<ma-index>]
<ma-index> = <decimal>
Parameters
<ma-index> - Identifies a Maintenance Association.
Revision 1 55
MetroNID TE v6.4.2 CLI Command Guide CFM Show MEG Configuration
Description
Display a summary of the configured MEG instances. If an instance index is
specified, a detailed configuration report is displayed.
Syntax
cfm show meg configuration [<meg-index>]
<meg-index> = <decimal>
Parameters
<meg-index> - Identifies a MEG.
Description
Display a summary of the configured MEP instances. If an instance identifier
is specified, a detailed configuration report is displayed.
Syntax
cfm show mep configuration [<mep-index> | <name>]
<mep-index> = <decimal>
<name> = <string>
Parameters
<mep-index> - Identifies a MEP.
<name> - Identifies a MEP instance by name.
Revision 1 56
MetroNID TE v6.4.2 CLI Command Guide CFM Show MEP Database
Description
Display a MEP database summary. If an remote MEPID is specified, a detailed
report is displayed.
Syntax
cfm show mep database <mep-index> | <name> [rmep-id <1-8191>]
<mep-index> = <decimal>
<name> = <string>
Parameters
<mep-index> - Identifies a MEP.
<name> - Identifies a MEP instance by name.
rmep-id - Identifies a remote MEPID.
Description
Display a summary of MEP statistics. If an instance identifier is specified,
a detailed statistics report is displayed.
Syntax
cfm show mep statistics [<mep-index> | <name>]
<mep-index> = <decimal>
<name> = <string>
Parameters
<mep-index> - Identifies a MEP.
<name> - Identifies a MEP instance by name.
Revision 1 57
MetroNID TE v6.4.2 CLI Command Guide CFM Show MEP Status
Description
Display a summary of MEP status. If an instance identifier is specified, a
detailed status report is displayed.
Syntax
cfm show mep status [<mep-index> | <name>]
<mep-index> = <decimal>
<name> = <string>
Parameters
<mep-index> - Identifies a MEP.
<name> - Identifies a MEP instance by name.
Description
Display a summary of the configured packet loss instances. If an instance
identifier is specified, a detailed configuration report is displayed.
Syntax
cfm show pkt-loss configuration [<pl-index> | <name>]
<pl-index> = <decimal>
<name> = <string>
Parameters
<pl-index> - Identifies a packet loss instance.
<name> - Identifies a packet loss instance by name.
Revision 1 58
MetroNID TE v6.4.2 CLI Command Guide CFM Show Packet Loss Result
Description
Display Lacket Loss measurement results.
Syntax
cfm show pkt-loss result [ [<pl-index> | <name>] {
{ type {historic}} |
{ buckets <0-16>} |
{ period <period-id>}}+ ]
<pl-index> = <decimal>
<name> = <string>
<period-id> = <decimal>
Parameters
<pl-index> - Specifies the packet loss instance.
<name> - Specifies the packet loss instance by name.
type - Type of statistics to display:
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 available 4
buckets will be displayed.
buckets - Number of PL buckets to display.
period - Reference period for the PL history buckets.
Zero for the most recent period available.
Description
Display SLM configuration. If an instance identifier is specified, a detailed
configuration report is displayed for the specified instance. Otherwise, a
configuration summary for all instances is displayed.
Syntax
cfm show slm configuration [<identifier>]
Parameters
<identifier> - An optional instance name or index to display.
Revision 1 59
MetroNID TE v6.4.2 CLI Command Guide CFM Show SLM Result
Description
Display SLM counters. If an instance name or index is specified, detailed
counters are displayed for the specified instance. Otherwise, a summary of all
available counters for all instances are displayed.
Syntax
cfm show slm result [<identifier> [type {continuous | periodic|
historic} {bucket | period} <decimal>]]
Parameters
<identifier> - An optional instance name or index to display.
type - Type of statistics to display.
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 available 4
buckets will be displayed.
buckets - Number of SLM buckets to display.
period - Reference period for the SLM history buckets.
Zero for the most recent period available.
Description
Display the CFM stack summary information.
Syntax
cfm show stack
Description
Display global CFM statistics.
Syntax
cfm show statistics
Revision 1 60
MetroNID TE v6.4.2 CLI Command Guide CFM Show VSP Configuration
Description
Display VSP configuration.
Syntax
cfm show vsp configuration
Description
Display VSP results.
Syntax
cfm show vsp result
Description
Stops all active CFM loopback request.
Syntax
cfm stop lbm
Revision 1 61
MetroNID TE v6.4.2 CLI Command Guide Configuration Cancel
Description
The configuration cancel command also allows you to cancel
the latest request to rollback or factory default the current
configuration.
Syntax
configuration cancel
Description
The configuration changes command allows you to see the
number of configuration changes that took place since the
system is up.
Syntax
configuration changes
Revision 1 62
MetroNID TE v6.4.2 CLI Command Guide Configuration Export/Import/Reset/Rollback/Cancel
Description
The configuration command allows you to export the existing unit configuration
to a file or to import a previously exported configuration file. When
importing a configuration file, it must be a configuration file that was
previously exported from the same unit type.
The configuration command also allows you to reset your current configuration
to the factory default settings.
The configuration rollback command also allows you to reset your current
configuration to the same state as the last time it was booted.
The configuration cancel command also allows you to cancel the latest request
to rollback or factory default the current configuration.
Syntax
configuration {import | export}
[{ ftp | ftps | http |
https | sftp | tftp }://[<user-name>:<password>@]<url>]
configuration reset
configuration rollback
configuration cancel
Examples
configuration import http://mypc.com/newconfig.cfg
configuration import ftp://username:password@mypc.com/newconfig.cfg
configuration export ftps://username:password@mypc.com:990/newconfig.cfg
configuration export sftp://username:password@mypc.com:22/newconfig.cfg
Parameters
<user-name> - <string>
<password> - <string>
Revision 1 63
MetroNID TE v6.4.2 CLI Command Guide Configuration Generate-Script
Description
The configuration command allows you to export the existing unit configuration
in a CLI-importable format either on screen or to an external server.
Syntax
configuration generate-script
{module <cli-cmd-names> }
{export-to-server [{ ftp | ftps | http |
https | sftp | tftp }
://[<user-name>:<password>@]<url>]}
<cli-cmd-names> = <cli-cmd-name>[,<cli-cmd-name>]+
Parameters
cli-cmd-name - A CLI command whose configuration should be generated.
It is possible to specify many commands.
Alternatively, if no command is specified, all
configuration will be generated.
<user-name> - <string>
<password> - <string>
Example
configuration generate-script module port,interface,soam export-to-server
tftp://192.168.1.240/soam_config.txt
Revision 1 64
MetroNID TE v6.4.2 CLI Command Guide Configuration Import
Description
The configuration import command allows to import a configuration file that
was previously exported from a unit of the same type.
Syntax
configuration import
{http | tftp | ftp | sftp}://[<user-name>:<password>@]<url>
Examples
configuration import http://mypc.com/newconfig.cfg
configuration import ftp://username:password@mypc.com/newconfig.cfg
Parameters
<user-name> - <string>
<password> - <string>
Description
The configuration reset command also allows you to reset your current
configuration to the factory default settings.
Syntax
configuration reset
Description
The configuration rollback command also allows you to reset your
current configuration to the same state as the last time it was
booted.
Syntax
configuration rollback
Revision 1 65
MetroNID TE v6.4.2 CLI Command Guide Console Disable
Description
Disable CLI on the serial console.
Syntax
console disable
Description
Enable CLI on the serial console.
Syntax
console enable
Description
Show serial console configuration.
Syntax
console show
Revision 1 66
MetroNID TE v6.4.2 CLI Command Guide COS Profile Add/Edit DSCP
Description
With these commands, you can create a new DSCP CoS profile or change the
parameters of an existing DSCP CoS profile.
Syntax
cos-profile {add|edit} dscp <cos-profile-name> {
{name <cos-profile-name>} |
{encode-dei {enable | disable} } |
{input-list {<0-63> [,|- <0-63>]}+ } |
{pre-marking {green | yellow} } |
{green-out <0-7> } |
{yellow-out <0-7> } |
{default-pre-marking {green | yellow} } |
{default-green-out <0-7> } |
{default-yellow-out <0-7> }}+
Parameters
<cos-profile-name> - <string>
name - New name when editing an exiting profile.
encode-dei - Set DEI bit to 1 if the outgoing frame color is yellow.
input-list - A comma-separated list of DSCP or DSCP range (x-y)
values.
pre-marking - Pre-marking color to be applied to frames if the input
DSCP is in input-list.
green-out - PCP value to be used if the outgoing frame color is
green and the input DSCP is in input-list.
yellow-out - PCP value to be used if the outgoing frame color is
yellow and the input DSCP is in input-list.
default-pre-marking - Pre-marking color to be used for all frames if the
input DSCP is not in input-list.
default-green-out - PCP value to be used if the outgoing frame color is
green and the input DSCP is NOT in input-list.
default-yellow-out - PCP value to be used if the outgoing frame color is
yellow and the input DSCP is NOT in input-list.
Revision 1 67
MetroNID TE v6.4.2 CLI Command Guide COS Profile Add/Edit PCP
Description
With these commands, you can create a new PCP CoS profile or change the
parameters of an existing PCP CoS profile.
Syntax
cos-profile {add|edit} pcp <cos-profile-name> {
{name <cos-profile-name>} |
{decode-dei {enable | disable} } |
{encode-dei {enable | disable} } |
{input-list {<0-7> [,|- <0-7>]}+ } |
{pre-marking {green | yellow} } |
{green-out <0-7> } |
{yellow-out <0-7> } |
{default-pre-marking {green | yellow} } |
{default-green-out <0-7> } |
{default-yellow-out <0-7> }}+
Parameters
<cos-profile-name> - <string>
name - New name when editing an existing profile.
decode-dei - Use incoming DEI as a pre-marking color (0=green,
1=yellow).
encode-dei - Set DEI bit to 1 if the outgoing frame color is yellow.
input-list - A comma-separated list of IP precedence or IP
precedence range (x-y) values.
pre-marking - Pre-marking color to be applied to frames if the input
PCP is in input-list.
green-out - PCP value to be used if the outgoing frame color is
green and the input PCP is in input-list.
yellow-out - PCP value to be used if the outgoing frame color is
yellow and theinput PCP is in input-list.
default-pre-marking - Pre-marking color to be used for all frames if the
input PCP is not in input-list.
default-green-out - PCP value to be used if the outgoing frame color is
green and the input PCP is NOT in input-list.
default-yellow-out - PCP value to be used if the outgoing frame color is
yellow and the input PCP is NOT in input-list.
Revision 1 68
MetroNID TE v6.4.2 CLI Command Guide COS Profile Add/Edit Precedence
Description
With these commands, you can create a new IP precedence CoS profile or change
the parameters of an existing IP precedence CoS profile.
Syntax
cos-profile {add|edit} precedence <cos-profile-name> {
{name <cos-profile-name>} |
{encode-dei {enable | disable} } |
{input-list {<0-7> [,|- <0-7>]}+ } |
{pre-marking {green | yellow} } |
{green-out <0-7> } |
{yellow-out <0-7> } |
{default-pre-marking {green | yellow} } |
{default-green-out <0-7> } |
{default-yellow-out <0-7> }}+
Parameters
<cos-profile-name> - <string>
name - New name when editing an existing profile.
encode-dei - Set DEI bit to 1 if the outgoing frame color is yellow.
input-list - A comma-separated list of IP precedence or IP
precedence range (x-y) values.
pre-marking - Pre-marking color to be applied to frames if the
input IP precedence is in input-list.
green-out - PCP value to be used if the outgoing frame color is
green and the input IP precedence is in input-list.
yellow-out - PCP value to be used if the outgoing frame color is
yellow and the input IP precedence is in input-list.
default-pre-marking - Pre-marking color to be used for all frames if the
input IP precedence is not in input-list.
default-green-out - PCP value to be used if the outgoing frame color is
green and the input IP precedence is NOT in input-list.
default-yellow-out - PCP value to be used if the outgoing packet color is
yellow and the input IP precedence is NOT in
input-list.
Revision 1 69
MetroNID TE v6.4.2 CLI Command Guide COS Profile Delete
Description
Delete the specified CoS profile.
Syntax
cos-profile delete <cos-profile-name>
Parameters
<cos-profile-name> - <string>
Description
Displays CoS profile configuration. Specifying a profile name will display a
detailed configuration for this profile. Otherwise, a configuration summary
for all CoS profiles will be displayed.
Syntax
cos-profile show configuration [<cos-profile-name>]
Parameters
<cos-profile-name> - <string>
Revision 1 70
MetroNID TE v6.4.2 CLI Command Guide CPU Edit OAM Options
Description
The CPU OAM options modify the criterion used to submit various frames
to the CPU for processing. These options are configurable per port.
Syntax
cpu edit oam-options <port-name>
{mgmt-mode {auto|mac-oui|policy}}
<port-name> = <string>
Parameters
<port-name> - A system port name to which these options apply.
mgmt-mode - This parameter modifies the method used to select multicast and
broadcast frames required by system management interfaces, such
ARP and NDP, that are submitted to the CPU.
- auto : The system determines automatically the best
policies to apply based on system interface
configuration and hardware filtering resources.
- mac-oui: Only frames with a source MAC address containing
a NID's MAC OUI are submitted to the CPU.
- policy : No broadcast nor multicast frames are selected by
default for this port. The user is responsible to
configure policies with the action “mgmt-oam”,
“mgmt-oam-drop” or “mgmt-oam-fwd” required by system
network interfaces configured on the specified port.
Note: Using mgmt-mode auto or mac-oui does not preclude configuring policies
with one of the mgmt-oam actions listed above.
Description
Shows the configuration of CPU OAM options. The CPU OAM options modify the
criterion used to submit various frames to the CPU for processing. These
options are configurable per port.
Syntax
cpu show oam-options [<port-name>]
<port-name> = <string>
Parameters
<port-name> - A system port name.
Revision 1 71
MetroNID TE v6.4.2 CLI Command Guide Date
3.112 Date
date - Print or set the system date and time
Description
Same as the Unix date command. Display the current time in the given FORMAT
or set the system date.
Syntax
date {option}... {MMDDhhmm[[CC]YY][.ss]} { '+format' }
Parameters
-d - Print the specified date.
-R - Output RFC-2822 compliant date string.
-s - Set the current date to the specified date.
-u - Print or set Coordinated Universal Time.
%% a literal %
%a locale's abbreviated weekday name (Sun..Sat)
%A locale's full weekday name, variable length (Sunday..Saturday)
%b locale's abbreviated month name (Jan..Dec)
%B locale's full month name, variable length (January..December)
%c locale's date and time (Sat Nov 04 12:02:33 EST 1989)
%C century (year divided by 100 and truncated to an integer) [00-99]
%d day of month (01..31)
%D date (mm/dd/yy)
%e day of month, blank padded ( 1..31)
%F same as %Y-%m-%d
%g the 2-digit year corresponding to the %V week number
%G the 4-digit year corresponding to the %V week number
%h same as %b
%H hour (00..23)
%I hour (01..12)
%j day of year (001..366)
%k hour ( 0..23)
%l hour ( 1..12)
%m month (01..12)
%M minute (00..59)
%n a newline
%N nanoseconds (000000000..999999999)
%p locale's upper case AM or PM indicator (blank in many locales)
%P locale's lower case am or pm indicator (blank in many locales)
%r time, 12-hour (hh:mm:ss [AP]M)
%R time, 24-hour (hh:mm)
%s seconds since `00:00:00 1970-01-01 UTC' (a GNU extension)
%S second (00..60); the 60 is necessary to accommodate a leap second
%t a horizontal tab
Revision 1 72
MetroNID TE v6.4.2 CLI Command Guide DNS Disable
Example
set the date to December 1st 2006,15:48PM : date -s 120115482006
show the current day only : date '+%d'
Description
dns disable allows you to stop using the server for the DNS service.
Syntax
dns disable
Revision 1 73
MetroNID TE v6.4.2 CLI Command Guide DNS Edit
Description
dns edit allows you to choose the server and the interface to use for the DNS
service.
Syntax
dns edit [ {dhcp {enable <interface-name> | disable}} |
{domain <string>} |
{hostname <string>} |
{dhcp-hostname <string>} |
{dhcp-hostname-option <custom|serial-number|current>}
{dhcp-client-id <string>} |
{server1 <ip-addr>} |
{server2 <ip-addr>} ]+
Parameters
<interface-name> - <string>
dhcp - Enable/disable use of DNS settings obtained via DHCP.
<interface-name> specifies the interface to use for
obtaining DHCP information.
domain - The domain name associated with the DNS.
hostname - The name of the unit.
dhcp-client-id - The DHCP client identifier (option 61). An empty
string forces MAC address as client ID.
dhcp-hostname - The DHCP client custom host name (option 12) to use
when selecting custom dhcp-hostname-option.
dhcp-hostname-option - The DHCP hostname option to set on the DHCP client.
server1 - The first DNS address used if no DHCP server set.
server2 - The second DNS address used if no DHCP server set.
Description
Show the DNS configuration
The "Domain", "DNS server 1" and "DNS server 2" fields are only used if
"Use DHCP result" is set to Disabled.
Syntax
dns show
Revision 1 74
MetroNID TE v6.4.2 CLI Command Guide Dry-Contact-Input Edit
Description
With dry-contact-input edit, you can change the parameters of one of the
available dry-contact input.
Syntax
dry-contact-input edit <id> {
{state {enable|disable}} |
{normal-state {close|open}} |
{sampling-period <100-1000>} }+
Parameters
<id> - <decimal>
state - Enable/disable the use of the dry-contact input. When
enabled, the alarm point for this input are created and
the input is monitored according to the following monitoring
configurations.
normal-state - Selects the normal state of the input. An alarm is raised,
when the input state is different from the normal state for
more than 3 consecutives samples. The input sampling rate
is determined by the value of the input sampling period.
sampling-period - Determines the time, in milliseconds, between two
consecutive readings of the input state. The values must be
specified within the range of 100 and 1000 milliseconds in
steps of 100 milliseconds.
Description
Display all configuration parameters of the available dry-contact input.
Syntax
dry-contact-input show configuration
Description
Display status of the available dry-contact input.
Syntax
dry-contact-input show status
Revision 1 75
MetroNID TE v6.4.2 CLI Command Guide Exit/Quit
3.119 Exit/Quit
exit - Logout of the CLI
quit - Logout of the CLI
Description
Logout of the CLI.
Syntax
exit
quit
Description
When fault propagation is enabled for a port, its link status (up or down)
depends on the opposite port status or EVC status. Fault propagation could
be based on link status only, or link status and EVC status.
In link status only operation mode, a link down on the opposite port is
propagated to the specified port. Link status fault propagation is allowed
in both direction. It can be enabled on a port and its opposite port.
In EVC status operation mode, the status of PAA probe(s) and/or CFM MEP(s)
are propagated to the specified port. At least one PAA probe or CFM MEP
should be free of connectivity error to enable the specified port. If there
is no PAA probe and no CFM MEP configured in EVC fault propagation mode for
the specified port, that port will stay down. When enabled for a port, fault
propagation should be disabled on opposite port.
Syntax
fault-propagation edit <port-name> {
{state <enable | disable> }
{mode <evc | link> }
{fp-port <fp-port-name> }}+
Parameters
<port-name> - Port to which these options apply.
state - Enable or disable fault propagation for the specified port.
mode - Fault propagation operation mode.
fp-port - Port from witch the fault is to be propagated.
Revision 1 76
MetroNID TE v6.4.2 CLI Command Guide Fault Propagation Enable/Disable
Description
When fault propagation is enabled for a port, a link down on the opposite port
will be propagated to that port.
These commands are deprecated and have been kept for backward compatibility
purpose. The command "fault-propagation edit" should be used instead.
Syntax
fault-propagation {enable | disable} {<port-name>}
Description
Show fault propagation configuration.
Syntax
fault-propagation show [<port-name>]
Description
filter delete ipv4 will delete the specified IPv4 filter.
Syntax
filter delete ipv4 <filter-name>
Parameters
<filter-name> - <string>
Revision 1 77
MetroNID TE v6.4.2 CLI Command Guide Filter Delete L2
Description
filter delete l2 will delete the specified Layer 2 filter.
Syntax
filter delete l2 <filter-name>
Parameters
<filter-name> - <string>
Description
With these commands, you can create a new filter or change the parameters of
an existing filter instance.
Syntax
filter {add|edit} ipv4 <filter-name> {
{dst-ipv4-addr <ip-addr> {disable | enable} } |
{dst-ipv4-mask <ip-addr>} |
{src-ipv4-addr <ip-addr> {disable | enable} } |
{src-ipv4-mask <ip-addr>} |
{protocol <0-255> {disable | enable}} |
{header-length <0-15> {disable | enable}} |
{ttl <0-255> {disable | enable}} |
{ip-cos-mode {dscp-mode | precedence-mode}} |
{dscp <0-63> {disable | enable}} |
{dscp-last <0-63> {disable | enable}} |
{dscp-oper {lt | gt | eq | range}} |
{precedence <0-7> {disable | enable}} |
{precedence-last <0-7> {disable | enable}} |
{precedence-oper {lt | gt | eq | range}} |
{ecn <0-3> {disable | enable}} |
{icmp-type <0-255> {disable | enable}} |
{icmp-code <0-255> {disable | enable}} |
{destination-port <0-65535> {disable | enable}} |
{source-port <0-65535> {disable | enable}} |
{vlan1-cfi <0-1> {disable | enable}} |
{vlan2-cfi <0-1> {disable | enable}} |
{vlan1-id <0-4095> {disable | enable}} |
{vlan1-id-last <0-4095> {disable | enable}} |
{vlan1-id-oper {lt | gt | eq | range}} |
{vlan2-id <0-4095> {disable | enable}} |
Revision 1 78
MetroNID TE v6.4.2 CLI Command Guide Filter Add/Edit IPv4
Parameters
<filter-name> - <string>
disable | enable - To enable or disable the field in the check.
dst-ipv4-addr - The IPv4 destination address.
dst-ipv4-mask - Wildcard mask to be applied to the IPv4 destination
address. Valid mask are prefix from 0 to 32 bits
(ex. 0.0.0.0 - 255.255.255.255).
src-ipv4-addr - The IPv4 source address.
src-ipv4-mask - Wildcard mask to be applied to the IPv4 destination
address. Valid mask are prefix from 0 to 32 bits
(ex. 0.0.0.0 - 255.255.255.255).
protocol - Layer 4 protocol value (0 - 255).
header-length - IPv4 header length in 32bit units (5 - 15).
ttl - IPv4 time to live value (0 - 255).
icmp-type - ICMP type (0 - 255).
icmp-code - ICMP code (0 - 255).
destination-port - Destination port for UDP protocol (0 - 65535).
source-port - Source port for UDP protocol (0 - 65535).
ip-qos-mode - Choose between DSCP (RFC2474) or precedence (RFC791).
intrepretation for the IP TOS field.
dscp - The Diff-Serv CodePoint value (0 - 63).
dscp-last - The last DSCP value, used in range operation.
dscp-oper - Diff-Serv CodePoint operator. Valid operator type are:
gt (greater than), lt (less than), eq (equal) or range
(inclusive range).
precedence - The Precedence value (0 - 7).
precedence-last - The last Precedence value, used in range operation.
precedence-oper - Precedence field operator. Valid operator type are:
gt (greater than), lt (less than), eq (equal) or range
(inclusive range).
ecn - Explicit Congestion Notification value (0 - 3).
vlan1-cfi - First VLAN CFI may be 0 or 1. It is usually set to 0.
vlan2-cfi - Second VLAN CFI may be 0 or 1. It is usually set to 0.
vlan1-id - First VLAN ID may be any value between 0 and 4095.
vlan1-id-last - First VLAN ID last value, used in range operation.
vlan1-id-oper - First VLAN ID operator. Valid operator type are: gt
(greater than), lt (less than), eq (equal) or range
(inclusive range).
vlan2-id - Second VLAN ID may be any value between 0 and 4095.
vlan2-id-last - Second VLAN ID last value, used in range operation.
vlan2-id-oper - Second VLAN ID operator. Valid operator type are: gt
Revision 1 79
MetroNID TE v6.4.2 CLI Command Guide Filter Add/Edit L2
Description
With these commands, you can create a new filter or change the parameters of
an existing filter instance.
Syntax
filter {add|edit} l2 <filter-name> {
{dst-mac-addr <mac-addr> {disable | enable} } |
{dst-mac-mask <mac-addr>} |
{src-mac-addr <mac-addr> {disable | enable} } |
{src-mac-mask <mac-addr>} |
{ethertype <0-65535> {disable | enable} } |
{vlan1-cfi <0-1> {disable | enable}} |
{vlan2-cfi <0-1> {disable | enable}} |
{vlan1-id <0-4095> {disable | enable}} |
{vlan1-id-last <0-4095> {disable | enable}} |
{vlan1-id-oper {lt | gt | eq | range}} |
{vlan2-id <0-4095> {disable | enable}} |
{vlan2-id-last <0-4095> {disable | enable}} |
{vlan2-id-oper {lt | gt | eq | range}} |
{vlan1-priority <0-7> {disable | enable}} |
{vlan1-priority-last <0-7> {disable | enable}} |
{vlan1-priority-oper {lt | gt | eq | range}} |
{vlan2-priority <0-7> {disable | enable}} |
{vlan2-priority-last <0-7> {disable | enable}} |
{vlan2-priority-oper {lt | gt | eq | range}}
{vlan1-ethertype {c-vlan | s-vlan | both | disable}} |
Revision 1 80
MetroNID TE v6.4.2 CLI Command Guide Filter Add/Edit L2
Parameters
<filter-name> - <string>
disable | enable - To enable or disable the field in the check.
dst-mac-addr - Ethernet MAC destination address.
dst-mac-mask - Wildcard mask to be applied to the MAC destination
address. Valid mask is a prefix of 16, 24, 25, 45, 48,
or multicast bits (ex. FF:FF:00:00:00:00,
FF:FF:FF:FF:FF:FF, 01:00:00:00:00:00).
src-mac-addr - Ethernet MAC source address.
src-mac-mask - Wildcard mask to be applied to the MAC source address.
Valid mask is a prefix of 16, 24, 25, 45, 48, or
multicast bits (ex. FF:FF:00:00:00:00,
FF:FF:FF:FF:FF:FF, 01:00:00:00:00:00).
ethertype - The Encapsulated Ethernet type identifies the 16-bit
sub-protocol label field or the original IEEE 802.3
length field.
vlan1-cfi - First VLAN CFI may be 0 or 1. It is usually set to 0.
vlan2-cfi - Second VLAN CFI may be 0 or 1. It is usually set to 0.
vlan1-id - First VLAN ID may be any value between 0 and 4095.
vlan1-id-last - First VLAN ID last value, used in range operation.
vlan1-id-oper - First VLAN ID operator. Valid operator type are: gt
(greater than), lt (less than), eq (equal) or range
(inclusive range).
vlan2-id - Second VLAN ID may be any value between 0 and 4095.
vlan2-id-last - Second VLAN ID last value, used in range operation.
vlan2-id-oper - Second VLAN ID operator. Valid operator type are: gt
(greater than), lt (less than), eq (equal) or range
(inclusive range).
vlan1-priority - First VLAN priority can vary between 0 and 7.
vlan1-priority-last - First VLAN priority last value, used in range operation.
vlan1-priority-oper - First VLAN priority operator. Valid operator type are:
gt (greater than), lt (less than), eq (equal) or range
(inclusive range).
vlan2-priority - Second VLAN priority can vary between 0 and 7.
vlan2-priority-last - Second VLAN priority last value, used in range
operation.
vlan2-priority-oper - Second VLAN priority operator. Valid operator type are:
gt (greater than), lt (less than), eq (equal) or range
(inclusive range).
vlan1-ethertype - First VLAN Ethertype, The Ethernet type identifies the
following VLAN if we expect a C-VLAN an S-VLAN or if
we accept both.
vlan2-ethertype - Second VLAN Ethertype, The Ethernet type identifies the
Revision 1 81
MetroNID TE v6.4.2 CLI Command Guide Filter Show
Description
This command displays a filter configuration. Specifying a filter name
provides detailed configuration about this filter. Otherwise, the command
displays summary configuration for all filters.
Syntax
filter show {l2 | ipv4} [<filter-name>]
Parameters
<filter-name> - <string>
Description
Use this command to activate the firmware file that was previously
downloaded to the flash. Once it is activated, the unit will reboot.
Syntax
firmware activate
Revision 1 82
MetroNID TE v6.4.2 CLI Command Guide Firmware Clear Download
Description
Use this command to delete the previously-downloaded firmware file from the
flash memory.
Syntax
firmware clear-download
Description
Use this command to download a different firmware file to the unit for
activation at a later date. The unit's rollback firmware version (if any)
is overwritten.
Syntax
firmware download
{ftp | ftps | http | https | sftp | tftp}://[<user-name>:<password>@]<url>
Examples
firmware download http://domain.com/AEN_6.4.2_35876.afl
firmware download ftp://username:password@domain.com/AEN_6.4.2_35876.afl
firmware download ftps://username:password@domain.com:990/AEN_6.4.2_35876.afl
firmware download sftp://username:password@domain.com:22/AEN_6.4.2_35876.afl
Parameters
<user-name> - <string>
<password> - <string>
Revision 1 83
MetroNID TE v6.4.2 CLI Command Guide Firmware Rollback
Description
Use this command to revert the unit's firmware and configuration values
back to the previous version.
NOTES:
- Firmware prior to version 4.0 cannot be rolled back.
- The firmware on a unit that has been factory reset cannot be rolled back
(the rollback version is unavailable).
- If a firmware file has been downloaded as part of a two-step firmware
upgrade, the rollback version is no longer available.
Syntax
firmware rollback
Description
Use this command to upgrade the unit to a different firmware version.
Syntax
firmware upgrade
{ftp | ftps | http | https | sftp | tftp}://[<user-name>:<password>@]<url>
Examples
firmware upgrade http://domain.com/AEN_6.4.2_35876.afl
firmware upgrade ftp://username:password@domain.com/AEN_6.4.2_35876.afl
firmware upgrade ftps://username:password@domain.com:990/AEN_6.4.2_35876.afl
firmware upgrade sftp://username:password@domain.com:22/AEN_6.4.2_35876.afl
Parameters
<user-name> - <string>
<password> - <string>
Revision 1 84
MetroNID TE v6.4.2 CLI Command Guide Firmware Version
Description
Use this command to display the unit's current firmware version,
as well as the rollback version or downloaded version (if any).
Syntax
firmware version
Description
Configure the GPS receiver settings.
Syntax
gps {edit} { { state { enable | disable } } |
}
Parameters
state - Enable or disable GPS synchronization.
Description
Display the state of the GPS, whether it is enabled or not.
Syntax
gps show configuration
Description
Show the status of the GPS.
Syntax
gps show status
Revision 1 85
MetroNID TE v6.4.2 CLI Command Guide Help
3.137 Help
help - Help will help you with commands you are not familiar with.
Syntax
help <command>
Parameters
<command> - <string>
Description
history edit file allows to change parameters used to generate and upload the
report files to a remote server.
Syntax
history edit file {
{period-mode {new | fixed | all}} |
{local-periods <1-672>} |
{include-disabled {enabled | disabled }} |
{include-previous {enabled | disabled }} |
{url <url>} }+
Parameters
period-mode - Selects the mode in which the periods are retrieved to
generate a report file.
new: only the periods since the last report.
fixed: fixed number of periods.
all: all available periods.
local-periods - Specifies the number of local periods to process in fixed
mode.
include-disabled - Specifies if the report should include the
statistics for disabled objects.
include-previous - Specifies if the report should include the periods
included in a previous aborted file transfer. This is
only used if period-mode is "new".
url - URL to reach the server and directory e.g.
http://mypc.com
ftp://username:password@mypc.com
sftp://username@mypc.com
tftp://mypc.com
scp://username@mypc.com:/target_directory
scp-password - Password used for SCP and SFTP transfers.
Revision 1 86
MetroNID TE v6.4.2 CLI Command Guide History Edit Local
Description
With history local edit, you can change the parameters of the history buckets
mechanism.
Syntax
history edit local {
{paa-state {disable | enable}} |
{paa-filing {disable | enable}} |
{paa-period <1-60>} |
{policy-state {disable | enable}} |
{policy-filing {disable | enable}} |
{policy-period <1-60>} |
{regulator-state {disable | enable}} |
{regulator-filing {disable | enable}} |
{regulator-period <1-60>}
{soamdmm-state {disable | enable}} |
{soamdmm-filing {disable | enable}} |
{soamdmm-period <1-60>}
{soampl-state {disable | enable}} |
{soampl-filing {disable | enable}} |
{soampl-period <1-60>} |
{soamsa-state {disable | enable}} |
{soamsa-filing {disable | enable}} |
{soamsa-period <1-60>} |
{soamsametric-state {disable | enable}} |
{soamsametric-filing {disable | enable}} |
{soamsametric-period <1-60>} |
{soamslm-state {disable | enable}} |
{soamslm-filing {disable | enable}} |
{soamslm-period <1-60>} |
{port-state {disable | enable}} |
{port-filing {disable | enable}} |
{port-period <1-60>}}+
Parameters
paa-state - Enable or disable PAA history.
paa-filing - Enable filesystem storage of the PAA history buckets.
paa-period - Reference period for the PAA history buckets.
policy-state - Enable or disable policy history.
policy-filing - Enable filesystem storage of the policy history
buckets.
policy-period - Reference period for the policy history buckets.
regulator-state - Enable or disable regulator history.
regulator-filing - Enable filesystem storage of the regulator history
buckets.
regulator-period - Reference period for the regulator history buckets.
soamdmm-state - Enable or disable SOAM DMM history.
Revision 1 87
MetroNID TE v6.4.2 CLI Command Guide History Edit Local
Revision 1 88
MetroNID TE v6.4.2 CLI Command Guide History Edit Scheduling
Description
With the history edit scheduling command, you can modify how reporting
history bucket data is scheduled.
Syntax
history edit scheduling {
{local-state {disable | enable}} |
{local-hours {<hour-value>}+} |
{local-minutes {<minutes-value>}+} |
{local-offset <0-(local-period - 1)>} |
{local-random-offset <0-900>} |
{local-period <5|10|15|20|30|60>}|
{local-mode <hourly|periodic>}}+
Parameters
local-state - Enables or disables the scheduling mechanism on the
local device.
local-hours - Sets the hour(s) at which the local statistics are
reported {00H00|01H00|02H00 ...}.
local-minutes - When in hourly mode, sets the minute(s) at which the
local statistics are reported with 15-minute.
granularity {00H00|00H15|00H30|00h45}.
local-offset - Sets the offset to add to the local-minutes.
Adding an offset spreads out the load on the file
servers by distributing the upload moments over time.
local-random-offset - Randomly generates an extra offset between 0 and the
specified value that is added to the local offset.
Expressed in seconds.
local-period - When in periodic mode, the period at which the local
statistics are retrieved. Similar to local-minutes,
but statistics are reported every local-period
minutes for the selected local-hours.
When in hourly mode, this parameter is ignored and
the value of local-period is 15 minutes.
local-mode - Sets either periodic or hourly mode. In periodic
mode, the minutes that trigger statistics reporting
are set using local-period; whereas in hourly mode,
the minutes that trigger statistics reporting are set
using local-minutes.
Revision 1 89
MetroNID TE v6.4.2 CLI Command Guide History Show File
Description
history show file displays the report file generation configuration
parameters.
Syntax
history show file
Description
history show local displays the local history configuration parameters.
Syntax
history show local
Description
history show scheduling displays the scheduling configuration parameters.
Syntax
history show scheduling
Revision 1 90
MetroNID TE v6.4.2 CLI Command Guide Interface Add/Edit
Description
Configure an IP interface for management purpose. Interfaces can be set to
to acquire their IP configuration from a DHCP server or can be manually
configured with a static IP. The subnet can be defined using the Address
Prefix Length along with the IP (e.g. 192.168.1.100/24) or by entering the
network mask using the netmask keyword.
Notes:
- IPv4 aliases: Interfaces can be configured for dual-homing by
specifying an alias name instead of an interface name. Currently only
an alias ID of 0 (zero) can be defined. When specifying an alias, only
the address, netmask and gateway parameters can be configured. An aliased
interface is always set up as a static IP address (no DHCP) and is on a
distinct interface.
Syntax
interface {add|edit} <interface-name>|<alias-name>
{ {name <interface-name>|<alias-name>} |
{dhcp {enable|disable}} |
{dhcp-rt-info {enable|disable}} |
{dhcp-static {enable|disable}} |
{address {<ip-addr>|<ip-addr-prefix>}} |
{netmask {<ip-addr>}} |
{gateway {<ip-addr>}} |
{vlan1-id <vlan-id>} |
{vlan2-id <vlan-id>} |
{vlan1-ethertype {c-vlan | s-vlan}} |
{vlan2-ethertype {c-vlan | s-vlan}} |
{vlan1-priority <0-7>} |
{vlan2-priority <0-7>} |
{type {standard|vlan|bridge|vlan-in-vlan|bridge-vlan}} |
{name <interface-name> } |
{port <port-name> } |
{sub-intf <sub-intf-name-list> } |
{ip-override {enable|disable} } |
{force {enable|disable} } |
{state {enable|disable} } |
{stp {enable|disable} } |
{bridge-intf <interface-name>} +
Parameters
<interface-name> - <string>
<alias-name> - <string>:0
<ip-addr-prefix> - <ip-addr>/{1-32}
<vlan-id> - <decimal>
<port-name-list> - <string> [, <string>]*
Revision 1 91
MetroNID TE v6.4.2 CLI Command Guide Interface Add/Edit
Revision 1 92
MetroNID TE v6.4.2 CLI Command Guide Interface Advertisement Edit
Description
Configure an advertisement instance on the interface for management purpose.
An advertisement instance may be configured to send interface information
to another system for inventory purposes. The advertisement instance is
coupled with the interface of the same name, so any change to the interface
name or port will affect the advertisement instance.
Syntax
interface {edit} <advertisement-name> { {state {enable|disable}} |
{ip-state {enable|disable}} |
{ip-address <IPv4 address>} |
{rate <transmission rate>} |
{format {ACP} |
{use-beacon-rate {enable|disable} }}+
Parameters
<advertisement-name> - <string>
state - Enable or disable layer-2 advertisement frame transmission
ip-state - Enable or disable layer-3 advertisement frame transmission
rate - Transmission rate of advertisement frames, in seconds
<3, 60, 600, 3600>
format - Only ACP is supported for now.
use-beacon-rate - When enabled, makes the advertisement transmission rate the
same as the beacon reception rate.
ip-address - The destination IP address to be used in layer-3
advertisement frames.
Description
Specifying an interface or alias name provides detailed configuration about
this advertisement, otherwise the command provides summary configuration for
all advertisements in a table format.
Syntax
interface advertisement show [<interface-name>|<alias-name>]
Parameters
<interface-name> - <string>
<alias-name> - <string>:0
Revision 1 93
MetroNID TE v6.4.2 CLI Command Guide Interface Beacon Edit
Description
Configure a beacon instance on the interface for management purpose. A beacon
may be configured to discover remote devices by sending a special frame on the
network, through the interface it is tied to. The beacon is coupled with the
interface of the same name, so any change to the interface name or port will
affect the beacon instance.
Syntax
interface beacon {edit} <interface-name> { {state {enable|disable}} |
{rate <transmission rate>} |
{domain-id <domain>} |
{subnet {<ip-addr>}} |
{netmask {<ip-addr>}} |
{gateway {<ip-addr>}} |
{dhcp-hostname-option <none,custom,serial-number,current>} |
{dhcp-client-id-option <none,custom,serial-number>} |
{dhcp-hostname <hostname>} |
{dhcp-client-id <client-id>} |
{ip-config-mode {local|auto|dhcp|auto-static}} |
{id-mismatch {enable|disable} }}+
Parameters
<interface-name> - <string>
<domain> - <string>
state - Enable or disable beacon frame transmission
rate - Transmission rate of beacon frames, in seconds
<3, 60, 600, 3600>
subnet - IP subnet used in auto IP config mode
netmask - IP netmask used in auto IP config mode
gateway - IP gateway used in auto IP config mode
ip-config-mode - Tell which IP configuration mode to use on the
remote device.
id-mismatch - When enabled, tells the remote system to authorize
beacon even if domain IDs do not match.
dhcp-hostname-option - Tell the remote NID what option to use as a hostname
in its DNS configuration.
dhcp-client-id-option - Tell the remote NID what option to use as a client
ID in its DNS configuration.
dhcp-hostname - The hostname to use when the hostname <custom> option
is chosen.
dhcp-client-id - The client ID to use when the client ID <custom>
option is chosen.
ip-exclusion - In Auto and Auto IP Static configuration modes, a
comma-separated list of IP addresses to exclude on
the remote NIDs can be specified. Up to 100 IP
addresses can be specified. IP address ranges can
be expressed with dash (-) separated IP addresses.
Revision 1 94
MetroNID TE v6.4.2 CLI Command Guide Interface Beacon Show
Description
Specifying an interface or alias name provides detailed configuration about
this beacon, otherwise the command provides summary configuration for
all beacons in a table format.
Syntax
interface beacon show [<interface-name>|<alias-name>]
Parameters
<interface-name> - <string>
<alias-name> - <string>:0
Description
Delete an existing interface or alias. When deleting the interface, if an
alias had been previously configured, it will also be deleted.
Syntax
interface delete <interface-name>|<alias-name>
Parameters
<interface-name> - <string>
<alias-name> - <string>:0
Revision 1 95
MetroNID TE v6.4.2 CLI Command Guide Interface Discovery Edit
Description
Configure the attributes related to beacon discovery on the auto interface.
The discovery instance may be configured to listen for beacons on selected
ports and automatically configure an interface upon reception of a valid
beacon.
Syntax
interface {edit} { {state {enable|disable}} |
{media-selection {enable|disable}} |
{id-matching {enable|disable}} |
{domain-id <domain_id>} |
{forward-on-bridge {enable|disable}} |
{discovery-ports <port_list>} |
{level [All,<0-7>]} |
{forward-match-ports {port_list|null}} |
{forward-mismatch-ports {port_list|null}}}+
Parameters
state - Enable or disable discovery on the auto interface
media-selection - Enable or disable auto media selection for beacon
discovery. Note that when the Discovery state is
disabled, auto media-selection is also disabled.
id-matching - When enabled, validate beacon by matching the domain
ID from the beacon with the locally-configured ID.
domain-id - The local domain ID, used to match the beacon domain
ID.
discovery-ports - Ports on which to listen for beacon frames. At least
one port must be selected. Multiple ports in the list
must be separated by commas.
level - Specifies level [All, [0-7]] given to ACP frames.
forward-on-bridge - When enabled, forward all beacons and information
frames on the bridge, if the auto interface is part
of a bridge
forward-match-ports - Forward all beacons and information frames on these
selected ports when domain IDs match. Multiple ports
in the list must be separated by commas. The list
can be cleared by using the value "null" for this
parameter. This is overridden by the
forward-on-bridge attribute, if enabled.
forward-mismatch-ports - Forward all beacons and information frames on these
selected ports when domain IDs do not match. Multiple
ports in the list must be separated by commas. The
list can be cleared by using the value "null" for
this parameter.This is overridden by the
forward-on-bridge attribute, if enabled.
Revision 1 96
MetroNID TE v6.4.2 CLI Command Guide Interface Discovery Show
Description
Show the attributes related to beacon discovery on the auto interface.
Syntax
interface discovery {show}
Parameters
Description
Convert IP address into physical address for all interfaces.
Syntax
interface refresh
Revision 1 97
MetroNID TE v6.4.2 CLI Command Guide Interface Show
Description
This command displays a summary of the configuration for all interfaces in a
table format. Specifying an interface or alias name will display the detailed
configuration for this interface.
Syntax
interface show [<interface-name>|<alias-name>]
Parameters
<interface-name> - <string>
<alias-name> - <string>:0
Description
Change inventory related settings
Syntax
inventory edit {{state <enable | disable>}
{adv-filter <enable | disable> } }+
Parameters
Revision 1 98
MetroNID TE v6.4.2 CLI Command Guide Inventory Show
Description
Shows an inventory of remote devices from which an advertisement has been
received. If a serial number is specified, detailed inventory information
will be displayed for the corresponding remote device.
Syntax
inventory show <serial-number>
Parameters
<serial-number> - <string>
3.156 Keepalive
keepalive - Allow to keep a CLI session alive.
Description
The CLI session is kept alive using this simple command.
Syntax
keepalive
Revision 1 99
MetroNID TE v6.4.2 CLI Command Guide L2PT Add/Edit
Description
Create or modify a Layer-2 Protocol Tunneling rule. Configure the rule
operation mode and parameters.
Syntax
l2pt{add|edit} <rule-name> {
{state {disable | enable}} |
{catchall {disable | enable}} |
{mode {drop | forward | tunnel | peer} } |
{protocol {stp | lacp | lamp | oam | auth | e-lmi | lldp | cdp | bpdu |
gmrp | gvrp | uld | pagp | pvst | vtp | dtp | stp-uf |
pb-ga | pb-gvrp | cisco-cfm | pause}} |
{inport <port-name> } |
{outport <port-name> } |
{unique-id [<1-64>]} |
{replacement-mac {cisco | accedian}} |
{evc-mapping {none | push | pop}} |
{vlan1-type {c-vlan | s-vlan}} |
{vlan2-type {c-vlan | s-vlan}} |
{vid-list <list>}
{vlan-filtering {disable | enable}} |
{rule-vid-from <vid>} |
{rule-vid-to <vid>} |
{rule-vid-pcp <pcp>} |
{rule-vid-cfi <cfi>} |
{rule-type {c-vlan | s-vlan}}
{cos-mapping <cos-mode>} |
{cos-map-pcp <pcp>} |
{cos-map-cfi <cfi>} |}+
Parameters
<rule-name> - L2PT rule name.
state - Enable or disable the L2PT rule.
catchall - Enable or disable the catchall mode of a rule.
mode - Selects the operation mode of the L2PT rule:
drop: Frames matching the specific rule are dropped.
forward: Frames are sent unaltered from the incoming port
to the outgoing port. Optionally, EVC mapping can
be enabled on forwarding rules.
tunnel: Frames matching the specific rule get their
destination MAC address replaced by the MAC
specified in the rule parameters when ingressing
the specified inport. Frames matching the specific
rule get their original destination MAC address
put back when ingressing the specified outport.
Tunneling rules are bidirectional.
Revision 1 100
MetroNID TE v6.4.2 CLI Command Guide L2PT Add/Edit
Revision 1 101
MetroNID TE v6.4.2 CLI Command Guide L2PT Clear
Description
Allows to clear a L2PT rule statistics.
Syntax
l2pt clear [<rule-name>]
Parameters
<rule-name> - L2PT rule name.
Description
Allows to delete a L2PT rule.
Syntax
l2pt delete {<rule-name>}
Parameters
<rule-name> - L2PT rule name.
Revision 1 102
MetroNID TE v6.4.2 CLI Command Guide L2PT Edit Global
Description
Allows to control L2PT global parameters, affecting the feature's general
settings.
Syntax
l2pt edit-global {
{state {disable | enable}} |
{management-state {disable | enable}} |
{port <port-name> state {disable | enable}} }
Parameters
state - Enable or disable L2PT on all traffic ports or
on a specific port if used with the port parameter.
management-state - Enable or disable L2PT on all management ports.
<port-name> - Port to which this options apply.
Description
Specifying a L2PT rule provides detailed configuration about this L2PT rule,
otherwise the command provides summary configuration for all L2PT rules in a
table format.
Syntax
l2pt show configuration [<rule-name>]
Parameters
<rule-name> - L2PT rule name.
Description
The command provides summary statistics for all L2PT rules in a
table format.
Syntax
l2pt show statistics
Revision 1 103
MetroNID TE v6.4.2 CLI Command Guide LACP Clear Statistics
Description
Clear the LACP aggregation group statistics. If <agg-identifier> is not
specified, all aggregation group statistics will be cleared.
Syntax
lacp clear statistics [<agg-identifier>]
Parameters
<agg-identifier> - <string>
Description
Edit a LACP aggregation group configuration.
Syntax
lacp edit <agg-identifier> {name <string>} |
{period <decimal>} |
{system-priority <decimal>} |
{timer-mode <custom|short|long>}}+
Parameters
<agg-identifier> - Aggregator group instance name.
name - Internal aggregator group name.
period - Period between two LACP messages in milliseconds.
system-priority - Priority assigned to this system.
timer-mode - Time to wait before sending LACPDU (custom, short, long).
Revision 1 104
MetroNID TE v6.4.2 CLI Command Guide LACP Show Configuration
Description
Display an LACP aggregation group configuration.
Syntax
lacp show configuration [<agg-identifier>]
Parameters
<agg-identifier> - <string>
State - The state of the aggregator. The possible states are
Enabled and Disabled.
Timeout - The time to wait before sending LACPDU. The choices are
Long (802.3ad Long Timeout), Short (802.3ad Short Timeout)
and Custom (Accedian Custom timeout allowing for sub-50ms
protection switching).
System priority - The priority of the LACP system. The end of the LACP link
that has the highest priority determines which link is
active. The higher the number, the lower the priority.
Range: 1 to 65535.
Port name - The name of the port.
Port priority - The port in the LAG that should be active for the LACP
system. The priority can change dynamically depending on
the revertive mode configuration.
Port number - The number of the port.
Description
This command displays the statistics of link aggregation group (LAG), which
contains:
- aggregator-name : The name of the LAG
- Tx LACPDU : Number of LACPDU transmitted
- Rx LACPDU : Number of LACPDU received
- Rx bad LACPDU : Number of unrecognized or invalid LACPDU received
Syntax
lacp show statistics [<agg-identifier>]
Parameters
<agg-identifier> - <string>
Revision 1 105
MetroNID TE v6.4.2 CLI Command Guide LACP Show Status
Description
Display LACP aggregation group status which contains:
Note: State variables for the port are encoded as individual bits within a
single octet as follows:
Revision 1 106
MetroNID TE v6.4.2 CLI Command Guide LACP Show Status
Special note: The received values of Defaulted and Expired state are not used
by LACP. However, knowing their values can be useful when diagnosing protocol
problems.
Syntax
lacp show status [<agg-identifier>]
Parameters
<agg-identifier> - <string>
Revision 1 107
MetroNID TE v6.4.2 CLI Command Guide Loopback Edit
Description
loopback edit allows you to edit OAM loopback configurations
Syntax
loopback edit <instance-name> {{timeout <decimal>} |
{ type {iometrix-l1 | exfo-l2 | exfo-l3 | anacise-l2 |
anacise-l3 | custom}} |
{ state {enable | disable}} |
{ filter {l2 | ipv4} <filter-name>} |
{ swap_mac {enable | disable}} |
{ swap-ip {enable | disable}} |
{ swap-port {enable | disable}} |
{ drop-opposite-traffic {enable | disable}} |
{ remote-lpbk-acterna {enable | disable}} |
{ remote-lpbk-perejil {enable | disable}} |
{ remote-lpbk-sunrise {enable | disable}} |
{ remote-lpbk-veex {enable | disable}} |
{ remote-lpbk-oam {enable | disable}} |
{ discovery-lpbk {enable | disable}} |
{ tagged-cmds {enable | disable} }} |
{ persistent {enable | disable} }} |
{ perejil-loopback-port {0..65535}}}+
Parameters
<instance> - <string>
<filter-name> - <string>
type - Set loopback type to:
. iometrix-l1 : Loop back all frames that have a
destination MAC address of 00:30:79:FF:FF:FF.
. exfo-l2 : Loop back all frames that have a source MAC
OUI of 00:03:01.
. exfo-l3 : Loop back all UDP echo service packets.
. anacise-l2 : Loop back all frames that have a source
MAC OUI of 00:18:75.
. anacise-l3 : Loop back all UDP echo service packets.
. custom : Loop back all traffic that match a user
defined filter.
timeout - Set a timeout period for the loopback to stay active
state - Enable or disable the OAM loopback
filter - Specify an associated filter type and name
swap-mac - Enable or disable MAC address swapping
swap-ip - Enable or disable IP address swapping
swap-port - Enable or disable port swapping
drop-opposite-traffic - Enable or disable dropping of opposite traffic
remote-lpbk-acterna - Enable or disable remote loopback for JDSU/Acterna
remote-lpbk-perejil - Enable or disable remote loopback for Perejil
remote-lpbk-sunrise - Enable or disable remote loopback for Sunrise
Revision 1 108
MetroNID TE v6.4.2 CLI Command Guide Loopback Show
NOTE: swap-* actions apply only to custom loopbacks (user defined filter).
Description
loopback show allows you to see the configuration of the OAM loopback.
Syntax
loopback show [<instance-name>]
Parameters
<instance-name> - <string>
Description
This command displays the results of the MAC Learning debug tool.
Syntax
mac-learning show results
Revision 1 109
MetroNID TE v6.4.2 CLI Command Guide MAC Learning Start
Description
This command starts the MAC Learning debug tool on a port.
Syntax
mac-learning start port <port-identifier>
Parameters
<port-identifier> - <string>
Description
This command stops the MAC Learning debug tool.
Syntax
mac-learning stop
Revision 1 110
MetroNID TE v6.4.2 CLI Command Guide Media-Selection Select
Description
Media-selection is used to select which media connectors will be used to carry
traffic. When changing the operation mode, all associations between connectors
and ports will be reflected in the port configuration and status table. The
media-selection options depends on the operation mode. The tables below show
the media-selection options and the connector-to-port mapping for the each
operation mode.
Note : The name of the ports in the tables below are as defined in a factory
default configuration.
Syntax
media-selection select <connectivity>
Parameters
<connectivity> - {media-selection-option}
Revision 1 111
MetroNID TE v6.4.2 CLI Command Guide Media-Selection Show
Description
Show the current setting for the media-connection.
Syntax
media-selection show
Description
Configure the system settings in the unit.
Syntax
mode {edit} { { svlan-type <ethertype-value> } |
{ bwr-adjustment <enable | disable> } |
{ next-op-mode <standard | aggregator3x1 | aggregator2x1>} |
{ webs-port <port-value> } |
{ igmp-version <0-3> } }
Parameters
svlan-type - Set the S-VLAN ethertype value system wide.
next-op-mode - You can select the next operation mode to apply to this
board after the next reboot.
<ethertype-value> - Ethertype value (0x88a8 or 0x9100)
igmp-version - Set interface IGMP version (0-3). 0 means do not force
any version, use kernel default.
bwr-adjustment - Enable or disable the bandwidth regulator rate adjustment
to preserve a specific bandwidth rate when a VLAN tag is
pushed onto an EVC.
webs-port - Set the web server port.
<port-value> - A UDP port. Using port 80 will configure the web server
to use unsecured http connections whereas other port
values will result in the webserver using secured https
connections (the standard https port is 443).
Revision 1 112
MetroNID TE v6.4.2 CLI Command Guide Mode Show
Description
Displays the general system settings currently configured in the unit.
Syntax
mode show
Description
Modifies the configuration of the traffic monitors.
Syntax
monitor edit <monitor-name> {
{name <monitor-name>} |
{state <enable | disable>} |
{destination <port>}}+
Parameters
<monitor-name> - <string>
name - Modify the name of the monitor.
state - Enable or disable monitoring.
destination - Specify the destination of the monitored traffic. This can be
any of the traffic ports (PORT-1, PORT-2, PORT-3, PORT-4).
Description
Displays the configuration of the traffic monitors. If a monitor name is
specified, detailed monitor configuration is displayed. Otherwise, a
configuration summary is displayed in a table format.
Syntax
monitor show configuration [<monitor-name>]
Revision 1 113
MetroNID TE v6.4.2 CLI Command Guide MOTD Edit
Description
Edit the "Message of the Day" that is displayed when users log in the unit.
Syntax
motd edit <new-message>
Parameters
<new-message> - <string>
Description
Show the "Message of the Day" that is displayed when users log in the unit.
Syntax
motd show
Description
Edit management traffic regulation parameters.
Syntax
mtr edit { {state {enable | disable} } |
{rate <64-10000>} |
{latency <50-2000>} |
{burst <1522-4000>} }+
Parameters
state - Enable or disable management traffic regulation.
rate - Specifies the average data rate in kilobits/second.
latency - Specifies the transmit queue size by indicating the maximum time, in
milliseconds. Packets must wait inside the transmit queue.
burst - Specifies the maximum burst size in bytes.
Revision 1 114
MetroNID TE v6.4.2 CLI Command Guide MTR Enable/Disable
Description
Enable or disable management traffic regulation.
This is equivalent to mtr edit state {enable | disable}.
Syntax
mtr {enable | disable}
Description
Show management traffic regulation configuration.
Syntax
mtr show
Description
Add an NTP (Network Time Protocol) to synchronize the clock with the remote
server.
Syntax
ntp add {<server-address>}
Parameters
<server-address> - <ip-addr> | <dns-name>
The name or the IP address of the NTP server to add.
Revision 1 115
MetroNID TE v6.4.2 CLI Command Guide NTP Delete
Description
Remove an NTP (Network Time Protocol) server from the list of servers.
Syntax
ntp delete {<server-address>}
Parameters
<server-address> - <ip-addr> | <dns-name>
Description
Stop using the NTP service
Syntax
ntp disable
Description
Stop the NTP server
Syntax
ntp disable-server
Revision 1 116
MetroNID TE v6.4.2 CLI Command Guide NTP Edit
Description
Change time or NTP related settings
Syntax
ntp edit {{tai-offset <decimal>}
{sync-mode <normal | highres>}
{dscp <0-63>}
{dst <enable | disable>}
{vlan-priority <0-7>}
{time-interval <10-300>}
{nbr-messages <5-60>}
{utc-hour <(-12)-(+14)>}
{utc-min <0-59>}
{dst-hour <0-23>}
{dst-min <0-59>}
{dst-start-month <month>}
{dst-start-week <1-5>}
{dst-start-day <day>}
{dst-start-hour <0-23>}
{dst-start-min <0-59>}
{dst-end-month <month>}
{dst-end-week <1-5>}
{dst-end-day <day>}
{dst-end-hour <0-23>}
{dst-end-min <0-59>}}+
Parameters
tai-offset - Offset in seconds to convert UTC time to TAI (Temps Atomique
International).
sync-mode - Synchronization mode. In normal mode, the time is retrieved
from the NTP server and the local clock adjusted accordingly,
without further processing. In high resolution mode,
hardware-assisted synchronization is performed to achieve
better accuracy.
dscp - When using NTP, the priority can be set in the DiffServ Code
Point.
dst - For regions of the world implementing Daylight Saving Time,
(DST), this can be enabled. Be aware that syslog and other
services that timestamp events using the current date and
time will be affected during transitions of DST periods.
There will possibly be an hour gap or duplicate time stamps
because the clock was set back.
vlan-priority - When using NTP, the priority of the packets can be set in the
VLAN priority bits if the link is through a VLAN.
time-interval - The time interval between requests to the NTP server
(in seconds).
Revision 1 117
MetroNID TE v6.4.2 CLI Command Guide NTP Enable
Description
Choose the NTP (Network Time Protocol) server you want to use for the clock
synchronization. You can enable up to two servers, but only one will be active
at a time. This command also starts the NTP service.
Syntax
ntp enable { {<server-address>} |
{<server-address>} }
Parameters
<server-address> - <ip-addr> | <dns-name>
Revision 1 118
MetroNID TE v6.4.2 CLI Command Guide NTP Enable Server
Description
Start the NTP server service.
Syntax
ntp enable-server
Description
Show the current configuration and status for the NTP (Network Time Protocol)
service.
Syntax
ntp show
Revision 1 119
MetroNID TE v6.4.2 CLI Command Guide OAM Add/Edit
Description
Add a new OAM instance or edit attributes of an existing OAM instance.
Syntax
oam {add|edit} <instance-name>
(not optional for add) {{port <port-name>} |
{name <oam-name>} |
{state {enable|disable}} |
{mode {active|passive}} |
{max-pdu-size <decimal>} |
{event-re-transmit <decimal>} |
{efe-threshold <decimal>} |
{efe-window <decimal>} |
{efpe-threshold <decimal>} |
{efpe-window <decimal>} |
{efsse-threshold <decimal>} |
{efsse-window <10-9000>} }+
Parameters
<instance-name> - <string>
<oam-name> - <string>
name - New name assigned to the OAM instance
port - Port to bind this OAM instance
state - Administrative state
mode - OAM instance mode, active or passive
max-pdu-size - Max OAM PDU size
event-re-transmit - Number of Event re-transmits
efe-threshold - Errored Frame Event threshold
efe-window - Errored Frame Event window
efpe-threshold - Errored Frame Period Event threshold
efpe-window - Errored Frame Period Event window
efsse-threshold - Errored Frame Seconds Summary Event threshold
efsse-window - Errored Frame Seconds Summary Event window
Revision 1 120
MetroNID TE v6.4.2 CLI Command Guide OAM Clear Statistics
Description
Clear the statistics of an OAM instance. If <instance-name> is not specified,
all OAM instances statistics will be cleared.
Syntax
oam clear statistics [<instance-name>]
Parameters
<instance-name> - <string>
Description
Remove the OAM instance.
Syntax
oam delete {<instance-name>}
Parameters
<instance-name> - <string>
Description
Show the configuration of the OAM instance.
Syntax
oam show configuration [<instance-name>]
Parameters
<instance-name> - <string>
Revision 1 121
MetroNID TE v6.4.2 CLI Command Guide OAM Show Events
Description
OAM show events is a summary of all the events exchanged on an OAM connection.
You can see all details of received and transmit events.
Syntax
oam show events [<instance-name>]
Parameters
<instance-name> - <string>
Description
Show the statistics of the OAM instance.
Syntax
oam show statistics [<instance-name>]
Parameters
<instance-name> - <string>
Description
OAM show status is a summary of the status of each OAM instance.
Syntax
oam show status [<instance-name>]
Parameters
<instance-name> - <string>
Revision 1 122
MetroNID TE v6.4.2 CLI Command Guide PAA Add/Edit L2
Description
Create or modify a PAA probe. Configure the probe operation mode, its
addressing parameters and various measurement parameters.
Syntax
paa {add|edit} l2 <probe-name> {
{state {disable | enable}} |
{mode { source | sink | bi-dir } } |
{local-index <decimal> } |
{peer-index <decimal> } |
{port <port-name> } |
{dst-mac-addr <mac-addr> } |
{vlan1-id [<0-4095>] [enable|disable] } |
{vlan1-priority <0-7> } |
{vlan2-id [<0-4095>] [enable|disable] } |
{vlan2-priority <0-7> } |
{vlan1-type {c-vlan | s-vlan}} |
{vlan2-type {c-vlan | s-vlan}} |
{pkt-size <66-1500> } |
{validate-vlan1-id {disable | enable} } |
{rx-vlan1-id [<0-4095>] } |
{couple-tx-rx-vlan1-id {disable | enable} } |
{validate-vlan1-priority {disable | enable} } |
{rx-vlan1-priority <0-7> } |
{couple-tx-rx-vlan1-priority {disable | enable} } |
{validate-vlan2-id {disable | enable} } |
{rx-vlan2-id [<0-4095>] } |
{couple-tx-rx-vlan2-id {disable | enable} } |
{validate-vlan2-priority {disable | enable} } |
{rx-vlan2-priority <0-7> } |
{couple-tx-rx-vlan2-priority {disable | enable} } |
{sampling-period <decimal> } |
{cc-threshold <decimal> } |
{pkt-loss-ref-period <decimal> } |
{pkt-loss-threshold <decimal> } |
{ow-ref-period <decimal> } |
{ow-max-delay <decimal> } |
{ow-delay-threshold <decimal> } |
{ow-ad-threshold <decimal> } |
{ow-max-dv <decimal> } |
{ow-dv-threshold <decimal> } |
{ow-adv-threshold <decimal> } |
{tw-ref-period <decimal> } |
Revision 1 123
MetroNID TE v6.4.2 CLI Command Guide PAA Add/Edit L2
{tw-max-delay <decimal> } |
{tw-delay-threshold <decimal> } |
{tw-ad-threshold <decimal> } |
{tw-max-dv <decimal> } |
{tw-dv-threshold <decimal> } |
{tw-adv-threshold <decimal> }
{fault-propagation <enable | disable> }
{fp-port <port-name> } }+
Parameters
<probe-name> - Probe name.
state - Enable or disable the PAA probe.
mode - Indicates if a probe generates (source) or
collects (sink) measurement packets or does
both (bi-dir).
local-index - Specifies the local identifier for the probe.
If it is omitted or set to 0 when the instance
is added, the system will automatically
allocate a value to the local identifier.
The range is 0 to 100.
peer-index - Specifies the remote peer identifier for the
probe. If peer-index is omitted or set to 0 when
the instance is added, the remote peer
identifier will be discovered dynamically based
on the probe name during the PAA association
phase.
port - Outgoing port name.
dst-mac-addr - The peer MAC address. When set to
FF:FF:FF:FF:FF:FF, layer-2 peer address
discovery will be done automatically,
i.e. it will find the peer MAC address.
vlan1-id - First VLAN ID. When enabled, layer-2 PAA frames
are encapsulated into the specified VLAN.
vlan2-id - Second VLAN ID. When enabled, layer-2 PAA
frames are encapsulated into a second VLAN.
Applies only when vlan1-id is enabled.
vlan1-type - First VLAN type. When vlan1-id is enabled,
specifies the VLAN type of the first VLAN tag.
vlan2-type - Second VLAN type. When vlan2-id is enabled,
specifies the VLAN type of the second VLAN tag.
vlan1-priority - First VLAN priority bits. Applies only when
vlan1-id is enabled.
vlan2-priority - Second VLAN priority bits. Applies only when
vlan2-id is enabled.
validate-vlan1-id - Enable or disable VLAN 1 id validation.
couple-tx-rx-vlan1-id - Couple Tx and Rx VLAN 1 id values for
VLAN 1 id validation.
rx-vlan1-id - Expected VLAN 1 id value received by
the remote.
validate-vlan1-priority - Enable or disable VLAN 1 priority validation.
couple-tx-rx-vlan1-priority - Couple Tx and Rx Vlan 1 priority values for
VLAN 1 priority validation.
Revision 1 124
MetroNID TE v6.4.2 CLI Command Guide PAA Add/Edit L2
Revision 1 125
MetroNID TE v6.4.2 CLI Command Guide PAA Add/Edit UDP
Description
Create or modify a PAA probe. Configure the probe operation mode, its
addressing parameters and various measurement parameters.
Syntax
paa {add|edit} udp <probe-name> {
{state {disable | enable}} |
{mode { source | sink | bi-dir } } |
{local-index <decimal> } |
{peer-index <decimal> }
{dst-ipv4-addr <ip-addr> } |
{udp-dest-port <decimal> } |
{udp-src-port <decimal> } |
{dscp <0-63> } |
{ecn <0-3> } |
{vlan1-priority <0-7> } |
{validate-vlan1-priority {disable | enable} } |
{rx-vlan1-priority <0-7> } |
{couple-tx-rx-vlan1-priority {disable | enable} } |
{validate-dscp {disable | enable} } |
{rx-dscp <0-7> } |
{couple-tx-rx-dscp {disable | enable} } |
{pkt-size <66-1472> } |
{sampling-period <decimal> } |
{cc-threshold <decimal> } |
{pkt-loss-ref-period <decimal> } |
{pkt-loss-threshold <decimal> } |
{ow-ref-period <decimal> } |
{ow-join-period <decimal> } |
{ow-max-delay <decimal> } |
{ow-delay-threshold <decimal> } |
{ow-ad-threshold <decimal> } |
{ow-max-dv <decimal> } |
{ow-dv-threshold <decimal> } |
{ow-adv-threshold <decimal> } |
{tw-ref-period <decimal> } |
{tw-max-delay <decimal> } |
{tw-delay-threshold <decimal> } |
{tw-ad-threshold <decimal> } |
{tw-max-dv <decimal> } |
{tw-dv-threshold <decimal> } |
{tw-adv-threshold <decimal> } |
{igmp-ref-period <decimal> } |
Revision 1 126
MetroNID TE v6.4.2 CLI Command Guide PAA Add/Edit UDP
{join-max-delay <decimal> } |
{join-delay-threshold <decimal> } |
{join-ad-threshold <decimal> } |
{leave-max-delay <decimal> } |
{leave-delay-threshold <decimal> } |
{leave-ad-threshold <decimal> } }+
Parameters
<probe-name> - Probe name.
state - Enable or disable the PAA probe.
mode - Indicates if a probe generates (source) or
collects (sink) measurement packets or does
both (bi-dir).
local-index - Specifies the local identifier for the probe.
If it is omitted or set to 0 when the instance
is added, the system will automatically
allocate a value to the local identifier.
The range is 0 to 100.
peer-index - Specifies the remote peer identifier.
dst-ipv4-addr - The peer IPv4 destination address.
udp-dest-port - Specifies destination UDP port
(default 8793, valid ports > 1023).
udp-src-port - Specifies source UDP port
(default 8793, valid ports > 1023).
dscp - The Diff-Serv CodePoint value.
ecn - The Explicit Congestion Notification value.
vlan1-priority - First VLAN priority bits. This applies only if
the outgoing interface is encapsulated in a
VLAN.
validate-vlan1-priority - Enable or disable VLAN 1 priority validation.
couple-tx-rx-vlan1-priority - Couple Tx and Rx VLAN 1 priority values for
VLAN 1 priority validation.
rx-vlan1-priority - Expected VLAN 1 priority value received by
the remote unit.
validate-dscp - Enable or disable DSCP validation.
couple-tx-rx-dscp - Couple Tx and Rx DSCP values for DSCP
validation.
rx-dscp - Expected DSCP value received by the
remote unit.
pkt-size - Packet size. Does not include the headers
(UDP, IP, Ethernet) and the FCS bytes.
sampling-period - Interval at which PAA measurement packets are
sent.
cc-threshold - Continuity check threshold. Number of
consecutive sampling periods without receiving
peer packets before declaring loss of
continuity.
pkt-loss-ref-period - Packet loss reference period.
pkt-loss-threshold - Packet loss threshold in %.
ow-ref-period - One-way reference period.
ow-max-delay - Maximum one-way delay.
ow-delay-threshold - Maximum consecutive one-way delay samples
Revision 1 127
MetroNID TE v6.4.2 CLI Command Guide PAA Add/Edit UDP
Revision 1 128
MetroNID TE v6.4.2 CLI Command Guide PAA Delete
Description
Remove a PAA probe.
Syntax
paa delete {<probe-name>}
Parameters
<probe-name> - <string>
Revision 1 129
MetroNID TE v6.4.2 CLI Command Guide PAA Show Configuration
Description
Display a summary of the configured PAA instances. When an instance name is
specified, a detailed configuration report is displayed.
Syntax
paa show configuration [<probe-name>]
Parameters
<probe-name> - <string>
Description
Display PAA PDU counters and errors.
Syntax
paa show counters [<probe-name>]
Parameters
<probe-name> - <string>
Revision 1 130
MetroNID TE v6.4.2 CLI Command Guide PAA Show Result
Description
Display PAA probe measurements and status.
Syntax
paa show results [<probe-name>] {
{ type {historic}} |
{ buckets <0-16>} |
{ period <period-id>}}+
Parameters
<probe-name> - <string>
<period-id> - <decimal>
type - Type of statistics to display:
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 PAA buckets to display.
period - Reference period for the PAA history buckets.
Zero for the most recent period available.
Description
Display PAA probe status.
Syntax
paa show status [<probe-name>]
Parameters
<probe-name> - <string>
Revision 1 131
MetroNID TE v6.4.2 CLI Command Guide Permission-Group Add
Description
Add a permission group.
Syntax
permission-group {add} <group-name> {
{ACL|Alarms|All-add|All-edit|All-enable|CFM|Config|
Filters|Firmware|
History|Log|L2PT|Management|OAM|PAA|Policies|Port|Protection|
RFC-2544|SAT-Protocol|SAT-reporting|Service Availability|
Service mapping|Sessions|Shaping|Traffic|Twamp|Users|Y.1564},+ }
Parameters
<group-name> - <string>
Description
Delete an existing permission-group
Syntax
permission-group delete <group-name>
Parameters
<group-name> - <string>
Revision 1 132
MetroNID TE v6.4.2 CLI Command Guide Permission-Group Edit
Description
Configure a permission group.
Syntax
permission-group {edit|delete} <group-name> {
{add-permission|delete-permission}
{Acl|Alarms|All-add|All-edit|All-enable|CFM|Config|
Filters|Firmware|
History|Log|L2PT|Management|OAM|PAA|Policies|Port|Protection|
RFC-2544|SAT-Protocol|SAT-reporting|Service Availability|
Service mapping|Sessions|Shaping|Traffic|Twamp|Users|Y.1564},+ }
Parameters
<group-name> - <string>
add-permission - Permission added to the permission-group.
delete-permission - Permission deleted from the permission-group.
Description
Specifying a permission-group name provides detailed configuration about this
group. Otherwise, the command provides a summary configuration for all
permission-groups in a table format.
Syntax
permission-group show [<group-name>]
Parameters
<group-name> - <string>
3.210 Ping
ping - send ICMP ECHO_REQUEST to network hosts
Usage
ping [OPTION]... host
Options
-c COUNT Send only COUNT pings
-s SIZE Send SIZE data bytes in packets (default=56)
-q Quiet mode, only displays output at start and when finished
Revision 1 133
MetroNID TE v6.4.2 CLI Command Guide Policy Clear Statistics
Description
Clear policy statistics. If <traffic-name> and <policy-id> are not specified,
all policies statistics for all traffic-names will be cleared. If,
<traffic-name> is specified, the policies statistics for this <traffic-name>
will be cleared.
Syntax
policy clear statistics [<Traffic-name>] [<policy_id>]
Parameters
<Traffic-name> - <string>
<policy-id> - <decimal>
Description
This command defines the traffic filter and the action associated with an
access policy.
Syntax
policy edit { Traffic-A | Traffic-B} <policy-id> {
{ state {enable | disable}} |
{ out-port <port-name>} |
{ filter {l2 | ipv4 | vlan} <filter-name>} |
{ action {permit | drop | MGMT-OAM | MGMT-OAM-drop |
MGMT-OAM-fwd | none}} |
{ monitor {enable <port-name> | disable}} |
{ evc-encapsulation {none | push | pop | replace | pop-replace |
push-preserve | preserve-vlan-new-cfi-pcp}} |
{ evc-ethertype {c-vlan | s-vlan} |
{ evc-vlan-id <0-4095>} |
{ cos-mapping {preserve | direct | map}} |
{ map1-state {enable | disable}} |
{ map1-type {pcp-vlan | pcp-vlaninvlan | precedence | dscp}} |
{ map1-cos-profile <cos-profile-name>} |
{ map1-regulator-set {enable <regulator-set-name> | disable}} |
{ map2-state {enable | disable}} |
{ map2-type {pcp-vlan | pcp-vlaninvlan | precedence | dscp}} |
{ map2-cos-profile <cos-profile-name>} |
{ map2-regulator-set {enable <regulator-set-name> | disable}} |
{ green-cfi <0-1>} |
{ yellow-cfi <0-1>} |
Revision 1 134
MetroNID TE v6.4.2 CLI Command Guide Policy Edit
{ green-pcp <0-7>} |
{ yellow-pcp <0-7>} |
{ pre-marking {green | yellow | red} |
{ regulator {enable <regulator-name> | disable}}
}+
Parameters
<policy-id> - <decimal>
<filter-name> - <string>
<regulator-name> - <string>
state - Enable or disable the policy.
out-port - Outgoing port for this policy.
filter - Specify an associated filter type and name.
action - Drop or Permit the traffic matching the filter.
monitor - Allow monitoring the traffic on a monitor port.
evc-encapsulation - Ethernet Virtual Connection encapsulation.
Possible values are:
- push: Add VLAN tag.
- pop: Remove outer VLAN tag.
- replace: Replace outer VLAN tag.
- pop-replace: Pop outer VLAN tag and replace inner VLAN
tag.
- push-preserve : Add VLAN tag using the VLAN ID of the
inner VLAN (if any).
- preserve-vlan-new-cfi-pcp : Preserve the VLAN ID and
remark the CFI and PCP values.
- none: No tags are added to the incoming frames.
evc-ethertype - Ethertype to use in the VLAN tag. Applies only if
evc-encapsulation is set to push, push-preserve, replace
or pop-replace.
evc-vlan-id - VLAN ID in the VLAN tag. Applies only if
evc-encapsulation is set to push, push-preserve, replace
or pop-replace.
cos-mapping - CoS mapping action. The action can be "preserve", "direct"
or "map".
map1-state - First choice mapping state.
map1-type - First choice mapping type. Which incoming traffic
attribute to use for traffic mapping.
map1-cos-profile - First choice mapping CoS profile. Use this profile to map
the incoming traffic based on the traffic attribute
selected in map1-type.
map1-regulator-set- First choice mapping regulator set. Regulator set to use
for traffic regulation based on the traffic attribute
selected in map1-type.
map2-* - Second choice mapping. Applies only if cos-mapping action
is set to map.
green-cfi - Direct or default CFI/DEI bit for outgoing green traffic.
The default behavior is active when the cos-mapping is set
to preserve or map and the incoming traffic is neither
handled by the first nor by the second mapping choices.
green-pcp - Direct or default PCP bits for outgoing green traffic.
yellow-cfi - Direct or default CFI/DEI bit for outgoing yellow traffic.
Revision 1 135
MetroNID TE v6.4.2 CLI Command Guide Policy Show Configuration
Description
Display policy configuration. If a policy-id is specified, detailed policy
configuration is displayed, otherwise a configuration summary is displayed
in a table format.
Syntax
policy show configuration {Traffic-A | Traffic-B} [<policy-id>]
Parameters
<policy-id> - <decimal>
Description
Display policy packet and byte counters.
Syntax
policy show statistics {Traffic-A | Traffic-B} <policy-id> {
{ type {clearable | persistent | historic}} |
{ buckets <0-16>} |
{ period <period-id>}}+
Parameters
<policy-id> - <decimal>
<period-id> - <decimal>
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 policy buckets to display.
period - Reference period for the policy history buckets.
Zero for the most recent period available.
Revision 1 136
MetroNID TE v6.4.2 CLI Command Guide Port Clear Statistics
Description
Clear port statistics. If <port-name> is not specified, all ports statistics
will be cleared.
Syntax
port clear statistics [<port-name>]
Description
Edit port attributes. A port can be identified by its name or by the connector
name. The port speed and duplex mode are not relevant when auto-negotiation is
enabled. Forcing the port speed to 1G is not allowed because auto-negotiation
is mandatory for Gigabit Ethernet.
Syntax
port edit <port-identifier> {{name <port-name>} |
{alias <port-alias>} |
{state {enable | disable}} |
{mtu <64-10240>} |
{lp-threshold <64-10240>} |
{llr {enable|disable}} |
{llr-period <decimal>} |
{auto-nego {enable|disable}} |
{speed {10M|100M|1G}} |
{duplex {half|full}} |
{mdi {auto|mdi|mdix}} |
{advertisement {<advertisement-value>}+} |
{pause-mode {local|transparent|disable}} |
{protection {enable|disable}} |
{protection-mode {link-status|lacp-status}} |
{working-connector <connector-name>} |
{revertive {enable|disable}} |
{revert-period <decimal>} |
{link-time-out <decimal>}
{lldp-state {enable|disable}}
{lldp-rate <decimal>}
{force-tx-on {enable|disable}} }+
Parameters
<port-identifier> - <string>
<port-alias> - <string>
<advertisement-value> - {10M-HD|10M-FD|100M-HD|100M-FD|1G-HD|1G-FD|pause|
asym-pause}
name - New name assigned to the port.
Revision 1 137
MetroNID TE v6.4.2 CLI Command Guide Port Edit
Revision 1 138
MetroNID TE v6.4.2 CLI Command Guide Port Show Configuration
Description
Without arguments or with the modifier summary, this command displays the port
configuration summary in a table format. When specifying a port name or a
connector name, this command displays detailed configuration for that port.
Syntax
port show configuration [<port-name>]
Description
Display port statistics.
Syntax
port show statistics [<port-name>] {
{ type {clearable | persistent | historic}} |
{ buckets <0-16>} |
{ period <period-id>}}+
Parameters
<port-name> - <string>
<period-id> - <decimal>
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 port buckets to display.
period - Reference period for the port history buckets.
Zero for the most recent period available.
Revision 1 139
MetroNID TE v6.4.2 CLI Command Guide Port Show Status
Description
Display port status.
Syntax
port show status [<port-name>]
Description
Change PTP related settings
Syntax
ptp edit { {state <enable|disable>} |
{pma <master-address>} |
{sma <master-address>} |
{utc <enable|disable>} |
{announce <-3,-2,-1,0,1,2 or 3>} |
{sync <-4,-3,-2,-1,0 or 1>} |
{pdn <0-255>} |
{sdn <0-255>} |
{dscp <0-63>} |
{vlan-priority <0-7>} }
Parameters
state - Enable or disable the PTP feature.
pma - Primary master address (time server for the PTP client).
sma - Secondary master address (time server for the PTP client).
<master-address> - <ip-addr> | <dns-name>
utc - Enable or disable the use of UTC offset from the master.
announce - Specifies the interval of Announce message from the
master.
Possible values:
-3 (8 messages / second)
-2 (4 messages / second)
-1 (2 messages / second)
0 (1 message / second)
1 (1 message / 2 seconds) <- default value
2 (1 message / 4 seconds)
3 (1 message / 8 seconds)
sync - Specifies the interval of Sync message from the master.
Possible values:
-4 (16 messages / second)
-3 (8 messages / second)
-2 (4 messages / second)
Revision 1 140
MetroNID TE v6.4.2 CLI Command Guide PTP Reset
-1 (2 messages / second)
0 (1 message / second) <- default value
1 (1 message / 2 seconds)
pdn - Specifies the domain number of the primary PTP master.
Possible values: 0 to 255
Default value : 4
sdn - Specifies the domain number of the secondary PTP master.
Possible values: 0 to 255
Default value : 4
dscp - When using PTP, the priority of the packets can be set in
the DiffServ Code Point.
vlan-priority - When using PTP, the priority of the packets can be set in
the VLAN priority bits if the link is through a VLAN.
Note: Communication with the grandmaster clock is only supported via unicast
negotiation (defined in clause 16.1 of IEEE 1588-2008).
Multicast negotiation is not supported.
Description
Resets to default PTP settings.
Syntax
ptp reset
Description
Show the current configuration and status for the PTP (Precision Time
Protocol) service.
Syntax
ptp show
Revision 1 141
MetroNID TE v6.4.2 CLI Command Guide RADIUS Edit
Description
radius edit allows you to change RADIUS parameters required to authenticate
authorize management access to the unit.
NOTE: The new parameters are only effective on the next login attempt.
Syntax
radius edit {
{auth-method {pap}} |
{auth-server1-host {<ip-addr> | <dns-name>}} |
{auth-server1-port <decimal>} |
{auth-server1-secret <string>} |
{auth-server1-source <ip-addr>} |
{auth-server2-host {<ip-addr> | <dns-name>}} |
{auth-server2-port <decimal>} |
{auth-server2-secret <string>} |
{auth-server2-source <ip-addr>} |
{radius-timeout <decimal>} |
{radius-retries <decimal>} |
{realm <string>} |
{vendor-specific {enable | disable}} }+
Parameters
auth-method - Authentication method to use.
auth-server1-host - RADIUS host server to authenticate to.
auth-server1-port - RADIUS server UDP port to connect to.
auth-server1-secret - Shared secret for server1.
auth-server1-source - Optional bind address for the primary RADIUS server.
auth-server2-host - Used only if first host server does not respond.
auth-server2-port - RADIUS server UDP port to connect to.
auth-server2-secret - Shared secret for server2.
auth-server2-source - Optional bind address for the secondary RADIUS server.
radius-timeout - Time to wait for the RADIUS server to respond before
retrying connection. After the number of retries has
been exhausted, a connection to the next configured
server will be attempted, in which the same timeout
and retry scheme will apply.
radius-retries - Number of times to retry the server before trying the
next configured server.
realm - Append this to user name. Mostly left blank.
vendor-specific - Enable or disable the Vendor-Specific attribute in
Access-Request.
Revision 1 142
MetroNID TE v6.4.2 CLI Command Guide RADIUS Show
Description
Show the RADIUS configuration.
Syntax
radius show
Description
Configure the working rate used by different modules in the unit.
Syntax
rate {edit} { { generator <layer-1 | layer-2> } |
{ regulator <layer-1 | layer-2> } |
{ shaper <layer-1 | layer-2> } }
Parameters
generator - Set the working rate for the RFC-2544 generator and testsuite,
and Y.1564 testing.
regulator - Set the working rate for all bandwidth regulator.
shaper - Set the working rate for the shaper.
Description
Display the working rate used by different modules in the unit.
Syntax
rate show
3.227 Reboot
Reboots the unit
Revision 1 143
MetroNID TE v6.4.2 CLI Command Guide Regulator-Set Add/Edit DSCP
Description
With these commands, you can create a new regulator set or change the
parameters of an existing regulator set.
Syntax
regulator-set {add|edit} dscp <regulator-set-name> {
{name <regulator-set-name>} |
{input-list {<0-63> [,|- <0-63>]}+ } |
{regulator {disable | enable} [<regulator-name>]} |
{default-regulator {enable | disable}
[<regulator-name>]} }+
Parameters
<regulator-set-name>- <string>
<regulator-name> - <string>
input-list - A comma-separated list of DSCP values and DSCP range
(x-y) values.
regulator - Bandwidth regulator to be used for all packets that have
a DSCP in input-list.
default-regulator - Bandwidth regulator to be used for all packets that do
NOT have a DSCP in input-list.
Revision 1 144
MetroNID TE v6.4.2 CLI Command Guide Regulator-Set Add/Edit PCP
Description
With these commands, you can create a new regulator set or change the
parameters of an existing regulator set.
Syntax
regulator-set {add|edit} pcp <regulator-set-name> {
{name <regulator-set-name>} |
{input-list {<0-7> [,|- <0-7>]}+ } |
{regulator {disable | enable} [<regulator-name>]} |
{default-regulator {enable | disable}
[<regulator-name>]} }+
Parameters
<regulator-set-name>- <string>
<regulator-name> - <string>
input-list - A comma-separated list of PCP values and PCP range (x-y)
values.
regulator - Bandwidth regulator to be used for all packets that have
a PCP in input-list.
default-regulator - Bandwidth regulator to be used for all packets that do
NOT have a PCP in input-list.
Revision 1 145
MetroNID TE v6.4.2 CLI Command Guide Regulator-Set Add/Edit Precedence
Description
With these commands, you can create a new IP precedence regulator set or
change the parameters of an existing IP precedence regulator set.
Syntax
regulator-set {add|edit} precedence <regulator-set-name> {
{name <regulator-set-name>} |
{input-list {<0-7> [,|- <0-7>]}+ } |
{regulator {enable | disable} [<regulator-name>]} |
{default-regulator {enable | disable}
[<regulator-name>]} }+
Parameters
<regulator-set-name>- <string>
<regulator-name> - <string>
input-list - A comma-separated list of IP precedence values and IP
precedence range (x-y) values.
regulator - Bandwidth regulator to be used for all packets that have
an IP precedence in input-list.
default-regulator - Bandwidth regulator to be used for all packets that do
NOT have an IP precedence in input-list.
Description
Delete the specified regulator set.
Syntax
regulator-set delete <regulator-set-name>
Parameters
<regulator-set-name> - <string>
Revision 1 146
MetroNID TE v6.4.2 CLI Command Guide Regulator-Set Show Configuration
Description
Displays regulator set configuration. Specifying a regulator set name displays
the detailed configuration for this regulator set. Otherwise, the command
displays a configuration summary for all regulator sets.
Syntax
regulator-set show configuration [<regulator-set-name>]
Parameters
<regulator-set-name> - <string>
Description
rfc2544 generator edit controls the traffic generator output.
Notes:
All units contain pre-programmed RFC-2544 loopbacks for "layer-2" and
"l2-accedian" frames. When testing with "l2-generic" frames or layer-3
packets, you need to configure a custom loopback in the peer unit. This
loopback must perform a swap action on the MAC addresses, IP addresses and
port numbers, as applicable. Refer to the "oam loopback" command for more
information on how to create a custom loopback.
Packet and Flow are sub-sections of the generator and have their own exclusive
set of parameters, as described below.
Syntax
rfc2544 generator edit {{port <port-name>} |
{packet1 <packet-params>} |
{packet2 <packet-params>} |
{flow1 <flow-params>} |
{flow2 <flow-params>}} }+
Parameters
<port> - Name of the port to which to send the flow(s).
<packet-params> - Generator packet header configuration (see below).
<flow-params> - Generator flow profile configuration (see below).
Packet Syntax
rfc2544 generator edit <packet-name>
{ {dst-mac-addr <mac-addr>} |
{packet-type {layer-2 | layer-3 | l2-accedian |
Revision 1 147
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Generator Edit
Packet Parameters
packet-name - packet[n] where "n" is included in <1-2> (not modifiable).
packet-type - Used to define specific fields in the test packet.
NOTE: ip-multicast packet-type is only used to generate
traffic frames, not to analyze received frames.
ethertype - The Ethernet type identifies the frame contents. For
example, this field can be 0x0800 for an IPv4 packet or
0x0806 for an ARP packet.
dst-mac-addr - This is the Ethernet MAC destination address.
vlan1-header - Enable or disable VLAN 1 parameters in the frames.
vlan1-ethertype* - First VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan1-cfi - First VLAN CFI may be 0 or 1. It is usually set to 0.
vlan1-id - First VLAN ID may be any value between 0 and 4095.
vlan1-priority - First VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
vlan2-header - Enable or disable VLAN 2 parameters in the frames.
vlan2-ethertype* - Second VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for
802.1AD network.
vlan2-cfi - Second VLAN CFI may be 0 or 1. It is usually set to 0.
vlan2-id - Second VLAN ID may be any value between 0 and 4095.
vlan2-priority - Second VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
dscp - The Diff-Serv CodePoint value (0 - 63).
ecn - The Explicit Congestion Notification value (0 - 3).
ttl - This is the IPv4 time to live value (0 - 255).
dst-ipv4-addr - The IPv4 destination address.
src-ipv4-addr - The IPv4 source address (valid only for IP multicast
destination and l3-generic).
Revision 1 148
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Generator Edit
* Ethertype values 0x9100 and 0x88A8 are considered an S-VLAN. The S-VLAN
Ethertype used here is the value configured in the global setting.
Flow Syntax
rfc2544 generator edit <flow-name> {
{description <description-text>} |
{traffic-type {constant {rate <0 to max-port-speed>}} |
burst {{packets <1 to max-packets>} |
{burst-gap <1 to 60000>}} |
{packet-size {fixed <64-10240>} |
random {{min-size <64-10240>} |
{max-size <64-10240>}}} |
{payload-pattern {fixed-data <hexadecimal>} |
incremental {bytes | words} |
random {2e11-random | 2e11inv-random |
2e15-random | 2e15inv-random |}}
{duration {continuous} |
{seconds <1-86400>} |
{bytes <64-4000000000>} |
{packets <1-4000000000>}}}+
Parameters
flow-name - flow[n] where "n" is included in <1-2> (not modifiable).
description - <string> Description identifying the packet and its
characteristics.
traffic-type - Type of traffic to generate.
packet-size - Define the packet size, this includes the Ethernet header
and the FCS. The size can be a fixed value or a random
value, chosen between a minimum and a maximum value.
payload-pattern - Define the pattern to fill the remaining spaces in the
transmitted packet. The pattern can be a 32-bit value, an
incremental byte, an incremental word or a random pattern
from the list.
duration - Duration of the flow can be specified in seconds, in
bytes, in packets or can be continuous until user
interruption.
type - Type of flow testing being done:
. Out-of-service: two-way loopback using the full link
bandwidth.
. In-service: one-way test for sharing a traffic
regulator with client traffic. Note that when the flow
type is In-service, you must select a Regulator.
regulator-name - Regulator selected for in-service testing.
Revision 1 149
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Generator Show Configuration
Description
This command displays the RFC-2544 generator configuration. Specifying a
packet or flow name will display a detailed configuration for this packet or
flow descriptor. Otherwise, the command will display the generator summary
configuration.
Syntax
rfc2544 generator show configuration [<packet-name>] [<flow-name>]
Parameters
<packet-name> - packet[n] where "n" is included in <1-2>.
<flow-name> - flow[n] where "n" is included in <1-2>.
Description
This command displays the RFC-2544 generator results. Specifying a flow name
will display detailed results for this flow. Otherwise, the command will
display a summary of the generator results.
Syntax
rfc2544 generator show results [<flow-name>]
Parameters
<flow-name> - flow[n] where "n" is included in <1-2>.
Description
Start RFC-2544 generator.
Syntax
rfc2544 generator start
Revision 1 150
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Generator Stop
Description
Stop RFC-2544 generator.
Syntax
rfc2544 generator stop
Description
Clear RFC-2544 monitor statistics.
Syntax
rfc2544 monitor clear statistics <monitor-name>
Parameters
<monitor-name> - <string> Name of the monitor to clear. When no monitor name
is specified, the function will clear all RFC-2544 monitors.
Description
rfc2544 monitor edit controls the traffic monitor behavior.
Syntax
rfc2544 monitor edit <monitor-name> { {name <monitor-name>}
{description <monitor-desc>}
{port <port-name>} |
{packet <packet-params>} |
{mode {bypass | terminal} |
{state {enable | disable}}
}+
Parameters
name - <string> Unique name for this monitor.
description - <string> Description identifying the monitor and its
characteristics.
port - Name of the input port from which to monitor traffic.
packet - Monitor packet header configuration (see below).
Revision 1 151
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Monitor Edit
Packet Syntax
rfc2544 monitor edit <monitor-name> packet
{ {packet-type {layer-2 | layer-3 | l2-accedian |
l2-generic | l3-generic}} |
{ethertype <0-65535>} |
{dst-mac-addr <mac-addr>} |
{vlan1-header {enable | disable}} |
{vlan1-ethertype {0x8100 | 0x88a8 | 0x9100}} |
{vlan1-priority <0-7>} |
{vlan1-id <0-4095>} |
{vlan1-cfi <0-1>} |
{vlan2-header {enable | disable}} |
{vlan2-ethertype {0x8100 | 0x88a8 | 0x9100}} |
{vlan2-priority <0-7>} |
{vlan2-cfi <0-1>} |
{vlan2-id <0-4095>} |
{dscp <0-63>} |
{ecn <0-3>} |
{ttl <0-255>} |
{dst-ipv4-addr <ip-addr>} |
{destination-port <0-65535>} |
{src-ipv4-addr <ip-addr>} |
{source-port <0-65535>} |
{y1731-level <0-7>}}+
Packet Parameters
packet-type - Used to define specific fields in the test packet.
ethertype - The Ethernet type identifies the frame contents. For
example, this field can be 0x0800 for an IPv4 packet or
0x8902 for a L2 frame.
dst-mac-addr - This is the Ethernet MAC destination address.
vlan1-header - Enable or disable VLAN 1 parameters in the frames.
vlan1-ethertype* - First VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan1-cfi - First VLAN CFI may be 0 or 1. It is usually set to 0.
vlan1-id - First VLAN ID may be any value between 0 and 4095.
vlan1-priority - First VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
vlan2-header - Enable or disable VLAN 2 parameters in the frames.
vlan2-ethertype* - Second VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan2-cfi - Second VLAN CFI may be 0 or 1. It is usually set to 0.
vlan2-id - Second VLAN ID may be any value between 0 and 4095.
Revision 1 152
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Monitor Show Configuration
* Ethertype values 0x9100 and 0x88A8 are considered an S-VLAN. The S-VLAN
Ethertype used here is the value configured in the global setting.
Description
This command displays the RFC-2544 monitor configuration. Specifying a
monitor name provides detailed configuration about this monitor descriptor.
Otherwise, the command provides the monitor configuration summary.
Syntax
rfc2544 monitor show configuration [<monitor-name>]
Parameters
<monitor-name> - <string>
Description
This command displays the RFC-2544 monitor results. Specifying a monitor name
provides detailed results from this monitor. Otherwise, the command provides
the monitor results summary.
Syntax
rfc2544 monitor show results [<monitor-name>]
Parameters
<monitor-name> - <string>
Revision 1 153
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Add
Description
rfc2544 testsuite add creates a new RFC-2544 testsuite instance.
Syntax
rfc2544 testsuite add <testsuite-name>
{ {name <testsuite-name>}
{description <testsuite-desc>}
{port <port-name>} |
{jumbo <0-10240>} |
{binary-duration <decimal>} |
{strict-failure {enable | disable}} |
{verbose {enable | disable}} |
{peer <packet-params> } |
{back2back {{duration <decimal>} |
{repeat <decimal>} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
{delay {{duration <decimal>} |
{frameloss <decimal>} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
{throughput {{duration <decimal>} |
{frameloss <decimal>} |
{minimum <decimal>} |
{maximum <decimal>} |
{step <decimal>} |
{fine-stepping {enable | disable}} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
{frameloss {{duration <decimal>} |
{step <decimal>} |
{sizes {64bytes | 128bytes |
Revision 1 154
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Add
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
}+
Parameters
name - <string> Unique name for this testsuite.
description - <string> Description identifying the testsuite and its
characteristics.
port - Name of the port to which to send the flow(s).
jumbo - Size of the jumbo frames <0-10240>.
binary-duration - Duration of each trial during the binary search for the
maximum throughput. By default, this is set to 2 seconds.
Binary duration can vary from 1 to 10 seconds.
strict-failure - Failure on Duplicate or Out-Of-Order.
verbose - Display all attempts in report file.
peer - Peer packet header configuration (see packet syntax and
parameters below).
back2back - Back-to-back test settings.
duration : Duration of the test in milliseconds.
repeat : Number of bursts to perform for each packet
size.
sizes : Frame sizes to use. Any combination is valid.
state : Enable or disable back2back test settings.
delay - Delay and delay variation test settings.
duration : Duration of the test in seconds.
frameloss: Acceptable difference between measured frame
loss (0.1%).
sizes : Frame sizes to use. Any combination is valid.
state : Enable or disable delay test settings.
throughput - Throughput test settings.
duration : Duration of the test in seconds.
step : Granularity of the min-max range.
fine-stepping: Enable fine stepping in case of low
bandwidth testing (below 12 Mbps).
minimum : Minimum rate in Mbps.
maximum : Maximum rate in Mbps.
frameloss: Acceptable difference between measured frame
loss (0.1%).
sizes : Frame sizes to use. Any combination is valid.
state : Enable or disable throughput test settings.
frameloss - Frameloss test settings.
duration : Duration of the test in seconds.
step : Granularity of the min-max range.
sizes : Frame sizes to use. Any combination is valid.
state : Enable or disable frameloss test settings.
Revision 1 155
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Add
Packet Syntax
rfc2544 testsuite add <testsuite-name> peer
{ {packet-type {layer-2 | l2-accedian | l2-generic |
layer-3 | l3-generic}} |
{dst-mac-addr <mac-addr>} |
{ethertype <0-65535>} |
{vlan1-header {enable | disable}} |
{vlan1-ethertype <0-65535>} |
{vlan1-priority <0-7>} |
{vlan1-id <0-4095>} |
{vlan1-cfi <0-1>} |
{vlan2-header {enable | disable}} |
{vlan2-ethertype <0-65535>} |
{vlan2-priority <0-7>} |
{vlan2-cfi <0-1>} |
{vlan2-id <0-4095>} |
{dscp <0-63>} |
{ecn <0-3>} |
{ttl <0-255>} |
{dst-ipv4-addr <ip-addr>} |
{src-ipv4-addr <ip-addr>} |
{destination-port <0-65535>} |
{source-port <0-65535>} |
{y1731-level <0-7>}}+
Packet Parameters
packet-type - Used to define specific fields in the test packet.
dst-mac-addr - This is the Ethernet MAC destination address.
ethertype - The Ethernet type identifies the frame contents. For
example, this field can be 0x0800 for an IPv4 packet or
0x0806 for an ARP packet.
vlan1-header - Enable or disable VLAN 1 parameters in the frames.
vlan1-ethertype* - First VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan1-cfi - First VLAN CFI may be 0 or 1. It is usually set to 0.
vlan1-id - First VLAN ID may be any value between 0 and 4095.
vlan1-priority - First VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
vlan2-header - Enable or disable VLAN 2 parameters in the frames.
vlan2-ethertype* - Second VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan2-cfi - Second VLAN CFI may be 0 or 1. It is usually set to 0.
vlan2-id - Second VLAN ID may be any value between 0 and 4095.
vlan2-priority - Second VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
dscp - The Diff-Serv CodePoint value (0 - 63).
ecn - The Explicit Congestion Notification value (0 - 3).
ttl - This is the IPv4 time to live value (0 - 255).
dst-ipv4-addr - The IPv4 destination address.
src-ipv4-addr - The IPv4 source address (valid only for l3-generic).
Revision 1 156
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Delete
* Ethertype values 0x9100 and 0x88A8 are considered an S-VLAN. The S-VLAN
Ethertype used here is the value configured in the global setting.
Description
This command deletes an existing RFC-2544 testsuite instance or an existing
RFC-2544 testsuite report.
Syntax
rfc2544 testsuite delete { {<testsuite-name>} |
reports {<report-name>}}+
Parameters
testsuite-name - <string> Unique name for this testsuite.
report-name - <string> Unique name for this report.
Description
rfc2544 testsuite edit changes the configuration of an existing RFC-2544
testsuite instance.
Syntax
rfc2544 testsuite edit <testsuite-name>
{ {name <testsuite-name>}
{description <testsuite-desc>}
{port <port-name>} |
{jumbo <0-10240>} |
{binary-duration <decimal>} |
{strict-failure {enable | disable}} |
{verbose {enable | disable}} |
{peer <packet-params> } |
{back2back {{duration <decimal>} |
{repeat <decimal>} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
Revision 1 157
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Edit
}
{delay {{duration <decimal>} |
{frameloss <decimal>} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
{throughput {{duration <decimal>} |
{frameloss <decimal>} |
{minimum <decimal>} |
{maximum <decimal>} |
{step <decimal>} |
{fine-stepping {enable | disable}} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
{frameloss {{duration <decimal>} |
{step <decimal>} |
{sizes {64bytes | 128bytes |
256bytes | 512bytes |
1024bytes | 1280 bytes |
1514bytes | jumbo}}
{state {enable | disable}} |
}
}
}+
Parameters
name - <string> Unique name for this testsuite.
description - <string> Description identifying the testsuite and its
characteristics.
port - Name of the port to which to send the flow(s).
jumbo - Size of the jumbo frames <0-10240>.
binary-duration - Duration of each trial during the binary search for the
maximum throughput. By default, this is set to 2 seconds.
Binary duration can vary from 1 to 10 seconds.
strict-failure - Failure on Duplicate or Out-Of-Order.
verbose - Display all attempts in report file.
peer - Peer packet header configuration (see packet syntax and
parameters below).
back2back - Back-to-back test settings.
duration : Duration of the test in milliseconds.
repeat : Number of bursts to perform for each packet
size.
sizes : Frame sizes to use. Any combination is valid.
Revision 1 158
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Edit
Packet Syntax
rfc2544 testsuite edit <testsuite-name> peer
{ {packet-type {layer-2 | l2-accedian | l2-generic |
layer-3 | l3-generic}} |
{dst-mac-addr <mac-addr>} |
{ethertype <0-65535>} |
{vlan1-header {enable | disable}} |
{vlan1-ethertype <0-65535>} |
{vlan1-priority <0-7>} |
{vlan1-id <0-4095>} |
{vlan1-cfi <0-1>} |
{vlan2-header {enable | disable}} |
{vlan2-ethertype <0-65535>} |
{vlan2-priority <0-7>} |
{vlan2-cfi <0-1>} |
{vlan2-id <0-4095>} |
{dscp <0-63>} |
{ecn <0-3>} |
{ttl <0-255>} |
{dst-ipv4-addr <ip-addr>} |
{src-ipv4-addr <ip-addr>} |
{destination-port <0-65535>} |
{source-port <0-65535>} |
{y1731-level <0-7>}}+
Revision 1 159
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Show Configuration
Packet Parameters
packet-type - Used to define specific fields in the test packet.
dst-mac-addr - This is the Ethernet MAC destination address.
ethertype - The Ethernet type identifies the frame contents. For
example, this field can be 0x0800 for an IPv4 packet or
0x0806 for an ARP packet.
vlan1-header - Enable or disable VLAN 1 parameters in the frames.
vlan1-ethertype* - First VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan1-cfi - First VLAN CFI may be 0 or 1. It is usually set to 0.
vlan1-id - First VLAN ID may be any value between 0 and 4095.
vlan1-priority - First VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
vlan2-header - Enable or disable VLAN 2 parameters in the frames.
vlan2-ethertype* - Second VLAN protocol ID set to 0x8100 for 802.1Q network,
0x9100 for 802.1Q tunneling network, or 0x88A8 for 802.1AD
network.
vlan2-cfi - Second VLAN CFI may be 0 or 1. It is usually set to 0.
vlan2-id - Second VLAN ID may be any value between 0 and 4095.
vlan2-priority - Second VLAN priority. The range is 0 to 7, with 7 being the
highest priority. Normal traffic has priority 0.
dscp - The Diff-Serv CodePoint value (0 - 63).
ecn - The Explicit Congestion Notification value (0 - 3).
ttl - This is the IPv4 time to live value (0 - 255).
dst-ipv4-addr - The IPv4 destination address.
src-ipv4-addr - The IPv4 source address (valid only for l3-generic).
destination-port - This is the destination port for UDP protocol (0 - 65535).
source-port - This is the source port for UDP protocol (0 - 65535).
y1731-level - Y.1731 Maintenance Entity Group level (0-7).
* Ethertype values 0x9100 and 0x88A8 are considered an S-VLAN. The S-VLAN
Ethertype used here is the value configured in the global setting.
Description
This command displays the RFC-2544 testsuite configuration. Specifying a
testsuite name displays the detailed configuration for this testsuite.
Otherwise, the command provides a summary of the configured testsuites.
Syntax
rfc2544 testsuite show configuration [<testsuite-name>]
Parameters
<testsuite-name> - <string> Name of the specific testsuite for which to
display the configuration.
Revision 1 160
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Show Reports
Description
This command displays the RFC-2544 testsuite reports. Specifying a report name
displays the complete report on the screen. Otherwise, the command provides a
summary of the configured reports.
The displayed status for each report can be one of the following:
Failed : An error occurred during the testsuite execution.
Running : The testsuite is currently running.
Stopped : A user stopped the testsuite during its execution.
Completed : The Testsuite has completed.
Syntax
rfc2544 testsuite show reports [<filename>]
Parameters
<filename> - <string> Unique filename associated with the report.
Description
This command starts the specified and creates a new report.
Syntax
rfc2544 testsuite start filename <filename> suite <testsuite-name>
{ {description <report-desc>} |
{technician <report-tech>} |
{note <report-note>} }+
Parameters
filename - <string> Unique filename for the report.
suite - <string> Name for the testsuite to run.
description - <string> Description for this report.
technician - <string> Name of the technician running this testsuite.
note - <string> Note associated to this testsuite. This note
will be included in the report.
Revision 1 161
MetroNID TE v6.4.2 CLI Command Guide RFC-2544 Test Suite Stop
Description
This command stops the execution of a running RFC-2544 testsuite.
Syntax
rfc2544 testsuite stop <filename>
Parameters
filename - <string> Unique filename associated with the testsuite.
Description
This command is used to upload an RFC-2544 report file to a remote location.
Syntax
rfc2544 testsuite upload <filename> <url>
Parameters
filename - <string> Unique filename associated with the testsuite.
url - URL to reach the server and directory, e.g.
ftp://username:password@mypc.com
sftp://username:password@192.168.10.10
tftp://192.168.1.5
scp://username:password@192.168.10.10:/target_directory
The filename of the report will be automatically appended to
the specified URL.
Revision 1 162
MetroNID TE v6.4.2 CLI Command Guide Route Add/Edit
Description
The route add/edit command lets you add or modify the system routing table.
Syntax
route {add|edit} <route-name> { {type {host | net}} |
{destination <ip-addr>} |
{netmask <ip-addr>} |
{gateway <ip-addr>} |
{interface <interface-name>} }+
Parameters
<route-name> - <string> The name of the route. It can be a brief
description of the route, e.g. "Default".
<interface-name> - <string> The interface with which the route is associated.
This is only for specific situations when a target exists
on a different network for that interface. In most
situations, the interface is determined automatically.
type - Route type may either be Network for a range of addresses
or Host for a specific IP address.
destination - Network or host address of the route. Use 0.0.0.0 to
denote the default route.
netmask - Mask assigned to the route. Only used for network routes.
gateway - Gateway address associated with this route or default
gateway address.
interface - The interface with which the route is associated. This is
only for specific situations when a target exists on a
different network for that interface. In most situations,
the interface is determined automatically.
Description
The route delete command lets you delete configured routes in the system.
Syntax
route delete <route-name>
Parameters
<route-name> - <string>
Revision 1 163
MetroNID TE v6.4.2 CLI Command Guide Route Show Configuration/Active
Description
The route show command lets you show active and configured routes in the
system.
Syntax
route show active
route show [configuration [<route-name>]]
Parameters
<route-name> - <string>
Description
Add a performance metric to Service Availability instance.
Syntax
sa add metric <sa-name> <metric-name> {
{paa-plr <paa-id>} |
{paa-ow-delay <paa-id>} |
{paa-ow-dv <paa-id>} |
{paa-tw-delay <paa-id>} |
{paa-tw-dv <paa-id>} |
{cfm-plr <pl-id>} |
{dmm-ow-delay <dmm-id>} |
{dmm-ow-dv <dmm-id>} |
{dmm-tw-delay <dmm-id>} |
{dmm-tw-dv <dmm-id>} |
{slm-near-end-plr <slm-id>} |
{slm-far-end-plr <slm-id>} |
{threshold <decimal>} }+
Parameters
<sa-name> - The name of a service availability instance.
<metric-name> - A unique name to identify a metric instance inside a
service availability instance.
Revision 1 164
MetroNID TE v6.4.2 CLI Command Guide SA Add Metric
Revision 1 165
MetroNID TE v6.4.2 CLI Command Guide SA Add Service
Description
Creates a Service Availability instance.
Syntax
sa add service <sa-name> {
{window-size <decimal>} |
{reporting-period <decimal>} |
{hli-window-size <decimal>} |
{time-interval <decimal>}}+
Parameters
<sa-name> - A unique name to identify a service availability instance.
window-size - The number of consecutive Time Intervals used to assess
Service Availability for this instance. Default value
is 10.
reporting-period - A reporting period over which periodic availability
counters are evaluated in addition to the monotonic
counters.
time-interval - The interval of time during which the metric is evaluated.
Default value is 1 second. Allowed values are 1, 5, 10, 20,
or 60 seconds.
hli-window-size - The number of consecutive Time Intervals used to assess
Consecutive High Loss Intervals for this instance.
Default value is 3.
Description
Clear service availability counters.
Syntax
sa clear service counters [name <sa-name>] [type {periodic|monotonic|all}]
<sa-name> = <string>
Parameters
name - The name of a service availability instance. If omitted, clears
all instances of the selected counters.
type - The type of counter to clear:
periodic : Clear periodic counters. Default.
monotonic: Clear monotonic counters.
all : Clear all counters.
Revision 1 166
MetroNID TE v6.4.2 CLI Command Guide SA Delete Metric
Description
Remove a performance metric from a Service Availability instance.
Syntax
sa delete metric <sa-name> <metric-name>
<sa-name> = <string>
<metric-name> = <string>
Parameters
<sa-name> - The name of a service availability instance.
<metric-name> - The name of the metric to remove.
Description
Delete a Service Availability instance.
Syntax
sa delete service <sa-name>
<sa-name> = <string>
Parameters
<sa-name> - A unique name identifying a service availability instance.
Revision 1 167
MetroNID TE v6.4.2 CLI Command Guide SA Edit Metric
Description
Modify a performance metric on a Service Availability instance.
Syntax
sa edit metric <sa-name> <metric-name> {
name <metric-name> threshold {<plr-thld> | <delay-thld>}}
<sa-name> = <string>
<metric-name> = <string>
<delay-thrld> = <decimal>
<plr-thld> = <decimal>
Parameters
<sa-name> - The name of a service availability instance.
<metric-name> - The name of metric instance inside the service availability
instance.
name - The new name to assign to the metric instance
threshold - A packet loss ratio threshold or a delay threshold depending
on metric type.
Revision 1 168
MetroNID TE v6.4.2 CLI Command Guide SA Edit Service
Description
Modify a Service Availability instance.
Syntax
sa edit service <sa-name> {{name <string>} |
{window-size <decimal>} |
{time-interval <decimal>} |
{hli-window-size <decimal>} |
{reporting-period <decimal>}
{state <is | oos>} }+
<sa-name> = <string>
Parameters
<sa-name> - The name of a service availability instance.
name - A new name to assign to the service instance.
window-size - The number of consecutive seconds over which to assess
availability. Default 10.
time-interval - The interval of time during which the metric is evaluated.
Default value is 1 second. Allowed values are 1, 5, 10, 20,
or 60 seconds.
hli-window-size - The number of consecutive time intervals used to assess
Consecutive High Loss Intervals for this instance.
Default value is 3.
reporting-period - A reporting period over which availability counters are
evaluated in addition to the monotonic counters.
Default is 15 minutes.
state - The instance state:
is : In service, availability must be assessed.
oos: Out of service, availability assessment is
suspended. This is the default state.
Revision 1 169
MetroNID TE v6.4.2 CLI Command Guide SA Show Metric Configuration
Description
Display detailed performance metric configuration.
Syntax
sa show metric configuration <sa-name> <metric-name>
<metric-name> = <string>
<sa-name> = <string>
Parameters
<sa-name> - The name of a service availability instance.
<metric-name> - The name of the metric to display.
Description
Display metric counters for a service availability instance. When a metric
instance name is specified, detailed availability counters are displayed for
the specified instance. Otherwise, a summary of all metric counters for the
service instance are displayed.
Syntax
sa show metric counters <sa-name> [<metric-name>] [type historic
{buckets | period } value]
Parameters
<metric-name> - An optional metric instance name to display.
type historic - The type of history statistics to retrieve.
The options are buckets or periods.
value - the period index or the number of buckets to display.
Revision 1 170
MetroNID TE v6.4.2 CLI Command Guide SA Show Service Configuration
Description
Display service availability configuration. When an instance name specified,
a detailed configuration report is displayed for the specified instance.
Otherwise, a configuration summary for all instances is displayed.
Syntax
sa show service configuration [<sa-name>]
<sa-name> = <string>
Parameters
<sa-name> - Optional service instance name to display.
Description
Display service availability counters. When an instance name is specified,
detailed availability counters are displayed for the specified instance.
Otherwise, a summary of all availability counters for all instances are
displayed. Additionally, if the history feature is enabled, history
information may be displayed by specifying the type.
Syntax
sa show service counters [<sa-name>] [type historic {buckets | period }
value]
<sa-name> = <string>
Parameters
<sa-name> - An optional instance name to display.
type historic - The type of history statistics to retrieve.
The options are buckets or periods.
value - the period index or the number of buckets to display.
Revision 1 171
MetroNID TE v6.4.2 CLI Command Guide SAT Protocol Clear Statistics
Description
This command is used to clear all the SAT protocol server statistics.
Syntax
sat-protocol clear statistics
Description
This command is used to modify the SAT protocol configuration parameters.
Syntax
sat-protocol edit {
{state {enable | disable}} |
{sat-udp-port <1025-32767>} |
{ow-udp-port <1025-32767>}}+
Parameters
state - Enable the SAT protocol on this unit.
sat-udp-port - This is the UDP port used for this protocol (1025-32767).
ow-udp-port - This is the One-way traffic UDP port (1025-32767).
Description
This command displays the protocol configuration.
Syntax
sat-protocol show configuration
Revision 1 172
MetroNID TE v6.4.2 CLI Command Guide SAT Protocol Show Sessions
Description
This command displays the protocol current server sessions.
Syntax
sat-protocol show sessions
Description
This command displays the SAT protocol server statistics.
Syntax
sat-protocol show statistics
Revision 1 173
MetroNID TE v6.4.2 CLI Command Guide SAT Reporting Edit
Description
This command allows to change the parameters of the SAT reporting feature.
Syntax
sat-reporting edit {
{rfc2544-reporting {disable | enable}} |
{rfc2544-txt-transfer {disable | enable}} |
{rfc2544-xml-transfer {disable | enable}} |
{y1564-reporting {disable | enable}} |
{y1564-txt-transfer {disable | enable}} |
{y1564-xml-transfer {disable | enable}} |
{url <url>} |
{scp-password <password>}}+
Parameters
rfc2544-reporting - Enable transfer of RFC-2544 report.
rfc2544-txt-transfer - Send RFC-2544 text file to the server.
rfc2544-xml-transfer - Send RFC-2544 XML file to the server.
Description
The command displays the SAT reporting configuration.
Syntax
sat-reporting show configuration
Revision 1 174
MetroNID TE v6.4.2 CLI Command Guide Session Edit
Description
session edit allows you to change the maximum number of sessions allowed at
one time as well as the timeout values for idle sessions.
Syntax
session edit {
{auth-order {local | radius | local-radius |
radius-local | strict-radius-local |
tacacs+ | local-tacacs+ |
tacacs+-local | strict-tacacs+-local}} |
{maxsessions <decimal>} |
{maxclisessions <decimal>} |
{maxwebsessions <decimal>} |
{timeoutcli <decimal>} |
{timeoutweb <decimal>} |
{telnet-server {enable | disable}} }+
Parameters
auth-order - Authentication client to use in order of availability.
maxsessions - Maximum number of CLI sessions that are supported
at the same time.
maxclisessions - Maximum number of WEB sessions that are supported
at the same time.
maxwebsessions - Total number of CLI and WEB sessions that are supported
at the same time.
timeoutcli - Maximum number of seconds that a CLI session can remain
idle before it is automatically logged out.
timeoutweb - Maximum number of seconds that a WEB session can remain
idle before it is automatically logged out.
telnet-server - Enable or disable the telnet server on the unit.
Description
session show configuration will show the maximum number of sessions allowed
at a time as well as the timeout values for idle sessions.
Syntax
session show configuration
Revision 1 175
MetroNID TE v6.4.2 CLI Command Guide Session Show Status
Description
session show status will show the status and information about all logged in
users.
Syntax
session show status
Description
session terminate will terminate the specified GUI or CLI session. The session
identifier is listed in session show status.
Syntax
session terminate {<session-id>}
Parameters
<session-id> - <decimal>
Description
session writelock ensures that no other sessions can make modifications to
the unit configuration at the same time.
Syntax
session writelock
Description
session writeunlock returns the writelock so that another session can take
hold of it.
Syntax
session writeunlock
Revision 1 176
MetroNID TE v6.4.2 CLI Command Guide SFP Dump
Description
sfp dump prints SFP memory contents.
Syntax
sfp dump {<connector-name> | <port-name>}
Description
sfp show prints SFP thresholds and status, as well as vendor information.
Syntax
sfp show [<connector-name> | <port-name>]
Revision 1 177
MetroNID TE v6.4.2 CLI Command Guide SNMP Edit
Description
snmp edit allows you to change the SNMP agent configuration.
Syntax
snmp edit {
{state {disable | enable}} |
{use-host-name {enable | disable} |
{agent-port <1-65535>} |
{contact-info <string>} |
{ro-community <string>} |
{rw-community <string> } |
{system-location <string>} |
{system-name <string>} |
{authentication-trap {enable | disable}} |
{link-trap {enable | disable}}+
Parameters
state - Enable or disable the SNMP agent.
use-host-name - Use the configured host name as system-name.
agent-port - Makes the agent listen on the specified UDP port on all
interfaces.
Note: Changing this value restarts the SNMP agent.
contact-info - The textual identification of the contact person for
this managed node, together with information on how to
contact this person (see RFC-1213 for more details).
ro-community - Community string used for Read-Only operations.
rw-community - Community string used for Read-Write operations.
system-location - The physical location of this node. For instance, it
can be the address of the building and the floor number
(see RFC-1213 for more details).
system-name - An administratively-assigned name for this managed
node. By convention, this is the node's fully-qualified
domain name (see RFC-1213 for more details).
authentication-trap - Enable this option to have a trap generated when
authentication to the agent fails. Map to the generic
trap 4(1.3.6.1.6.3.1.1.5.5).
link-trap - Enable this option to have a trap generated when link
status changes.
Maps to generic traps 2(1.3.6.1.6.3.1.1.5.3 linkDown)
and 3(1.3.6.1.6.3.1.1.5.4 linkUp).
Revision 1 178
MetroNID TE v6.4.2 CLI Command Guide SNMP Show
Description
snmp show displays the SNMP configuration
Syntax
snmp show
Description
This command allows you to change the automatic SNMP trap handler
configuration.
Syntax
snmp-trap edit auto {
{host-state {enable | disable}} |
{host-community <string>} |
{host-port <1-65535>}
{trap-version {v1 | v2c}}
{host-name-refresh}
}+
Parameters
host-state - Enable/Disable the sending of SNMP traps to the configured
host.
host-community - Community string used to send SNMP traps to configured
host.
host-port - This command defines the UDP port to use when sending SNMP
traps (the well-known SNMP trap port 162 is used by
default).
trap-version - Set the version (v1 or v2c) of the configured host SNMP
traps.
host-name-refresh - Refresh of the configured host name for SNMP traps.
Revision 1 179
MetroNID TE v6.4.2 CLI Command Guide SNMP Trap Edit V1
Description
This command allows you to change the SNMP v1 trap handler configuration.
Syntax
snmp-trap edit v1 <host-id> {
{host-state {enable | disable}} |
{host-community <string>} |
{host-name <string>} |
{host-port <1-65535>}}+
Parameters
host-state - Enable/Disable the sending of traps to the configured host.
host-community - Community string used to send SNMP traps to configured host.
host-name - This command defines the host name or IP address of the
server to which the traps (and/or inform notifications) are
sent. The unit sends a Cold Start trap when it starts and
upon authentication failure.
host-port - This command defines the UDP port to use when sending traps
(the well-known SNMP trap port 162 is used by default).
Description
This command allows you to change the SNMP v2c trap handler configuration.
Syntax
snmp-trap edit v2c <host-id> {
{host-state {enable | disable}} |
{host-community <string>} |
{host-name <string>} |
{host-port <1-65535>}}+
Parameters
host-state - Enable/Disable the sending of traps to the configured host.
host-community - Community string used to send SNMP traps to configured host.
host-name - This command defines the host name or IP address of the
server to which the traps (and/or inform notifications) are
sent. The unit sends a Cold Start trap when it starts and
upon authentication failure.
host-port - This command defines the UDP port to use when sending traps
(the well-known SNMP trap port 162 is used by default).
Revision 1 180
MetroNID TE v6.4.2 CLI Command Guide SNMP Trap Show
Description
snmp-trap show displays the SNMP trap handler configuration.
Syntax
snmp-trap show
Description
After issuing this command, the following statistics will be cleared:
- All ports statistics
- All policies statistics
- All bandwidth regulators statistics
- All OAM instances statistics
Syntax
statistics clear
Revision 1 181
MetroNID TE v6.4.2 CLI Command Guide SyncE Edit
Description
Configure the Synchronous Ethernet settings.
Syntax
synce {edit} { { state { enable | disable } } |
{ prc <port> } |
{ src {<port> | none}} |
{ revertive { enable | disable } } |
{ force-clock { none | primary | secondary } }
}
Parameters
state - Enable or disable the SyncE feature.
prc - Port from which the Primary Reference Clock is recovered.
src - Port from which the Secondary Reference Clock is
recovered. None if only the prc is desired.
revertive - Enable or disable the revertive clock source selection.
force-clock - Set the forced clock source selection, or none for
automatic clock source selection.
Revision 1 182
MetroNID TE v6.4.2 CLI Command Guide Syntax
3.287 Syntax
syntax - Display CLI syntax
Description
Display CLI syntax explanations.
Syntax
syntax
Description
syslog edit controls the system logger. All messages are reported into the
system logger and they are kept or trashed depending on the system logger
level. The system logger also supports remote logging. You can send messages
to an external computer.
The syslog level you choose enables all messages from the specified level and
all messages from lower levels.
When dev-facility is enabled, all messages are logged using the user-defined
facility instead of the default ones.
Syntax
syslog edit {{dev-facility {enable | disable} <facility>}
{remote {disable | enable}} |
{host {<host-name>}} |
{priority {<level>}} }+
Parameters
<host-name> - <ip-addr> | <FQHN>
<FQHN> - <string>
<level> - <Emergency|Alert|Critical|Error|Warning|Notice|Info|Debug>
<facility> - <LOCAL0|LOCAL1|LOCAL2|LOCAL3|LOCAL4|LOCAL5|LOCAL6|LOCAL7>
dev-facility - Enable or disable device facility to log all messages
Revision 1 183
MetroNID TE v6.4.2 CLI Command Guide Syslog Show Configuration
Description
syslog show prints the syslog configuration.
Syntax
syslog show configuration
Description
syslog show log display the system log.
Syntax
syslog show log
Description
syslog show log continuous displays the system log without page breaks.
Press CTRL-C to interrupt.
Syntax
syslog show log continuous
Description
This command displays system status (operational readiness)
Syntax
system show status
Revision 1 184
MetroNID TE v6.4.2 CLI Command Guide TACACS+ Edit
Description
Use the tacacs-plus edit command to modify the TACACS+ parameters required
to authenticate, then authorize management access to the unit.
NOTE: The new parameters take effect upon the next login attempt.
Syntax
tacacs-plus edit {
{auth-method {pap}} |
{auth-server1-host {<ip-addr> | <dns-name>}} |
{auth-server1-port <decimal>} |
{auth-server1-secret <string>} |
{auth-server1-source <ip-addr>} |
{auth-server2-host {<ip-addr> | <dns-name>}} |
{auth-server2-port <decimal>} |
{auth-server2-secret <string>} |
{auth-server2-source <ip-addr>} |
{timeout <decimal>} |
{retries <decimal>} }+
Parameters
auth-method - Authentication method to use.
auth-server1-host - TACACS+ host server to authenticate to.
Enter '0.0.0.0' or '::' to disable this server.
auth-server1-port - TACACS+ server TCP port to connect to.
auth-server1-secret - Shared secret for server1.
auth-server1-source - Optional bind address to access server1.
auth-server2-host - Only used if the first host server does not respond.
Enter '0.0.0.0' or '::' to disable this server.
auth-server2-port - TACACS+ server TCP port to connect to.
auth-server2-secret - Shared secret for server2.
auth-server2-source - Optional bind address to access server2.
timeout - The time to wait for the TACACS+ server to respond
before retrying the connection, in seconds. After
the number of retries has been exhausted, a
connection to the next configured server will be
attempted, in which the same timeout and retry scheme
will apply.
retries - Number of times to retry the server before trying
with the next configured server.
Revision 1 185
MetroNID TE v6.4.2 CLI Command Guide TACACS+ Show
Description
Displays the current TACACS+ configuration.
Syntax
tacacs-plus show
Description
Test similar to a ping but at a higher level in the protocol stack. The test
attempts to connect to a TCP port to verify if a service is reachable.
Syntax
tcp-connect host {host | net} |
{port <tcp-port>} |
{timeout <time-in-seconds>} }
Parameters
host - The remote address or domain name to test.
port - TCP port (service) to test.
timeout - Time in seconds before giving up.
Revision 1 186
MetroNID TE v6.4.2 CLI Command Guide Traceroute
3.296 Traceroute
traceroute - Trace the route to HOST
Description
traceroute tracks the route packets take through an IP network on their
way to a given host.
Usage
traceroute [-FIldnrv] [-f 1st_ttl] [-m max_ttl] [-p port#] [-q nqueries]
[-s src_addr] [-t tos] [-w wait] [-g gateway] [-i iface]
[-z pausemsecs] host [data size]
Options
-F Set the don't fragment bit
-I Use ICMP ECHO instead of UDP datagrams
-l Display the ttl value of the returned packet
-d Set SO_DEBUG options to socket
-n Print hop addresses numerically rather than symbolically
-r Bypass the normal routing tables and send directly to a host
-v Verbose
-m Max time-to-live (max number of hops)
-p Base UDP port number used in probes (default 33434)
-q Number of probes per 'ttl' (default 3)
-s IP address to use as the source address
-t Type-of-service in probe packets (default 0)
-w Time in seconds to wait for a response (default 3 sec)
-g Loose source route gateway (8 max)
Description
traffic edit allows you to configure options related to traffic policy lists.
Syntax
traffic edit mode [policy_list] {
{vid-set {inner | outer}} }+
Parameters
vid-set - When using traffic policies with VLAN sets, this option is used to
inspect the inner or the outer VLAN for each policy list. The
default is outer VLAN. When using the option as inner VLAN, the
outer VLAN will be ignored.
Revision 1 187
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Clear Port Statistics
Description
This command clears statistics for the traffic originating from the CPU,
looped back traffic and generator traffic, towards the Network port.
Syntax
traffic-shaping clear port statistics [<port-name>]
Parameters
<port-name> - <string>
Description
Modify the PCP to shaper mapping
Syntax
traffic-shaping {edit} map {
{decode-dei <disable | enable> } |
{dei-pcp-list {<0-15> [,|- <0-15>] } |
{pre-color <green | yellow> } |
{map-name <map name> } |
{new-name <new map name> } |
{shaper <shaper-name> }}+
Parameters
Syntax
traffic-shaping {edit} map {
Revision 1 188
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Edit Map
Parameters
Revision 1 189
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Edit Port
Description
Modify a port shaping configuration.
Syntax
traffic-shaping {edit} port <port-name> {
{cir <0-1000000> } |
{cbs <0-10240> } |
{cpu-cir {disable | enable} } |
{realtime-cir {disable | enable} } }+
Parameters
Description
Modify queue configurations.
Syntax
traffic-shaping edit queue <queue-name> {
{blue-freeze-time {0-655}} |
{blue-decrement {0-127}}
{blue-increment {0-127}}
{blue-max-level {16-2038}} |
{blue-min-level {16-2038}} |
{cbs {0-63}} |
{cir {0-1000}} |
{cir-max {0-1000}} |
{color {green | yellow}} |
{coupling-flag {enable | disable}} |
{ebs {0-63}} |
Revision 1 190
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Edit Queue
{eir {0-1000}} |
{eir-max {0-1000}} |
{green-max-level {16-2038}} |
{name <string>} |
{port <port-name>} |
{priority {0-7}} |
{shaping-mode {ingress | egress}} |
{shaping-state {enable | disable}} |
{yellow-max-level {16-2038}}}+
Parameters
blue-freeze-time - Minimum interval time (ms) between two successive
updates of the marking probability.
blue-decrement - The marking probability is decremented by this
value if the queue is idle.
blue-increment - The marking probability is incremented by this
value if there is a buffer overflow.
blue-max-level - The maximum acceptable level before increasing the
marking probability.
blue-min-level - The minimum acceptable level before decreasing the
marking probability.
cbs - Committed Burst Size in 1 kB.
cir - Committed Information Rate in 1Kbps. Step of
125Kbps
cir-max - Maximum Committed Information Rate in 1Kbps. Step
of 125Kbps
color - Used whn shaping is disabled, to set the color of
the queue. When set to yellow and priority is set
to 0, this create a 'best effort queue'.
coupling-flag - When enabled, unused token from CIR bucket are
passed to EIR bucket.
ebs - Excess Burst Size in 1 kB.
eir - Excess Information Rate in 1Kbps. Step of 125Kbps
eir-max - Maximum Excess Information Rate in 1Kbps. Step of
125Kbps
green-max-level - Level for which tail drop begins for green
packets.
name - Modify queue name
port - Queue port assignation.
priority - Priority for scheduling (7-> highest, 0-> lowest)
shaping-mode - Buckets are debitted at pre or post action.
shaping-state - Enable/Disable shaping for this queue.
yellow-max-level - Level for which tail drop begins for yellow
packets.
Revision 1 191
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Edit Shaper
Description
Modify a traffic shaper configuration.
Syntax
traffic-shaping {edit} shaper <shaper-name> {
{state {disable | enable}} |
{name <string> } |
{cir <0 to max-port-speed> } |
{cbs <0-10240> } |
{eir <0 to max-port-speed> } |
{cbs <0-10240> } |
{queue-len <16-2036> } |
{queue-full-thrs <5-98> } |
{queue-empty-thrs <5-98> } |
{pm-freeze-time <1-655>} |
{pm-increment <1-127>} |
{pm-decrement <1-127>}}+
Parameters
Revision 1 192
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Show Blue Statistics
Description
This command displays the instantaneous statistics of the queue management
algorithm (BLUE).
Syntax
traffic-shaping show blue statistics
Description
Show the PCP to shaper mapping.
Syntax
traffic-shaping show map
Description
Display a summary of port shaping configuration parameters. Traffic shaping is
only available on the network port.
Syntax
traffic-shaping show port configuration [<port-name>]
Parameters
<port-name> - <string>
Revision 1 193
MetroNID TE v6.4.2 CLI Command Guide Traffic Shaping Show Port Statistics
Description
This page shows statistics for the traffic originating from the CPU, looped
back traffic and generator traffic, towards the Network port.
Syntax
traffic-shaping show port statistics [<port-name>]
Parameters
<port-name> - <string>
Description
Display a summary of the configured shaper instances. When an instance
identifier is specified, a detailed configuration report is displayed.
Syntax
traffic-shaping show shaper configuration [<shaper-name>]
Parameters
<shaper-name> - <string>
Description
Display the statistics of a specific shaper.
Syntax
traffic-shaping show shaper statistics [<shaper-name>]
Parameters
<shaper-name> - <string>
Revision 1 194
MetroNID TE v6.4.2 CLI Command Guide Traffic Show
Description
Displays which VLAN (inner or outer) is inspected by policy lists.
Syntax
traffic show
Description
Clear TWAMP flows statistics.
Syntax
twamp clear statistics [<identifier>]
<identifier> = <decimal>
Parameters
<identifier> - An optional unique index identifying the instance.
Description
Edit TWAMP configuration
Syntax
twamp edit {
{udp-port <decimal>} |
{state <enable | disable>}}+
Parameters
state - The state of the instance (disabled by default).
udp-port - The UDP port used (1025-32767).
Revision 1 195
MetroNID TE v6.4.2 CLI Command Guide TWAMP Show Configuration
Description
Display TWAMP configuration.
Syntax
twamp show configuration
Description
Display TWAMP statistics.
Syntax
twamp show statistics
Description
The user add command allows you to add users who can access the unit.
You can use user edit when you need to modify a user configuration.
If you use the <password> keyword in one of these commands, you will be
prompted to enter your password after the command. You will need to confirm
your password as well. If you do not use the password keyword with <user add>,
the password will be set the same as the user name.
Syntax
user {add | edit} <user-name> {{first <string>} |
{last <string>} |
{email <string>} |
{phone <string>} |
{clearpass <string>} |
{password}}+
Parameters
<user-name> - <string>
first - First name of the user.
last - Last name of the user.
email - The email address of the user.
Revision 1 196
MetroNID TE v6.4.2 CLI Command Guide User Delete
Description
Syntax
user delete {<user-name>}
Parameters
<user-name> - <string>
Description
user permissions edit allows you to modify the permissions that are
associated with a specified user.
Syntax
user permissions edit {<user-name>} {add-group | delete-group} {<group-name>}
Parameters
<user-name> - <string>
<group-name> - <string>
Description
This command displays the permission of the group to which the specified user
belongs.
Syntax
user permissions show [<user-name>]
Parameters
<user-name> - <string>
Revision 1 197
MetroNID TE v6.4.2 CLI Command Guide User Show
Description
user show displays the contact information for a given user.
Syntax
user show [<user-name>]
Parameters
<user-name> - <string>
Description
Change vcagent related collection setting.
Syntax
vcagent edit collection
Description
Change vcagent related configuration setting.
Syntax
vcagent edit configuration
Description
vcagent show configuration displays the agent configuration parameters.
Syntax
vcagent show configuration
Revision 1 198
MetroNID TE v6.4.2 CLI Command Guide VCAgent Show Descriptors
Description
vcagent show desriptors displays the agent JSON descriptors.
Syntax
vcagent show descriptors
3.323 Version
version - Display CLI version
Description
Display CLI version.
Syntax
version
Description
The vid-set command is used to add a new VID set.
Syntax
vid-set add <vset-name> {
{policy-list <policy list>} |
{vlan-type {c-vlan | s-vlan}} |
{vid-list <vlist>}}+
Parameters
<vset-name> - <string>
policy-list - Name of the policy list to which the VID set will be
associated.
vlan-type - VLAN type associated with the VID set.
vid-list - List of VIDs to include in this VID set. Specify a list of
VIDs in the following format: [- ], [- ]...
(e.g. 1,2,100-200 will include VIDs 1, 2, and 100 to 200).
Revision 1 199
MetroNID TE v6.4.2 CLI Command Guide VID-Set Delete
Description
vid-set delete allows you to delete an existing VID set.
Syntax
vid-set delete <vset-name>
Parameters
<vset-name> - <string>
Description
vid-set edit allows you to change the parameters in existing VID sets.
Syntax
vid-set edit <vset-name> {
{name <vset-name>} |
{vid-list <vlist>}}+
Parameters
<vset-name> - <string>
name - New name given to this VID set.
vid-list - List of VIDs to include in this VID set. Specify a list of
VIDs in the following format: [- ], [- ]...
(e.g. 1,2,100-200 will include VIDs 1, 2, and 100 to 200).
Description
Specifying an interface provides detailed configuration about this VID set.
Otherwise, the command provides a summary configuration for all VID sets in a
table format.
Syntax
vid-set show set [<interface-name>]
Parameters
<interface-name> - <string>
Revision 1 200
MetroNID TE v6.4.2 CLI Command Guide VID-Set Show VID
Description
Specifying an interface provides detailed configuration about this VID set.
Otherwise, the command provides a summary configuration for all VID sets in a
table format.
Syntax
vid-set show vid [<interface-name>]
Parameters
<interface-name> - <string>
Revision 1 201
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Add Test
Description
With y1564 add test, you can create a new Y.1564 test and set its parameters.
Syntax
y1564 add test <test-name> {
{description <string>} |
{configuration {enable | disable}} |
{step-duration {1-60} |
{performance {enable | disable}} |
{test-duration {1-1440} |
{parallel {enable | disable}} |
{port <port-name>} |
{delay-type {one-way-delay | two-way-delay}} |
{time-sync-mandatory {enable | disable}} |
{packet-type {layer-2 | layer-3 | l2-accedian | l2-generic}} |
{dst-ipv4-addr <ip-addr>} |
{destination-port <0-65535>} |
{source-port <0-65535>} |
{dscp <0-63>} |
{dst-mac-addr <mac-addr>} |
{y1731-level <0-7>}}+
Parameters
description - Short description of the Y.1564 test.
configuration - Enable Y.1564 configuration test.
step-duration - Duration of each step during the configuration test in
seconds.
performance - Enable Y.1564 performance test.
test-duration - Duration of each step during the performance test in
minutes.
parallel - Enable Y.1564 parallel service configuration test.
port - Name of the port to which to send the test traffic.
delay-type - Type of delay measurement.
time-sync-mandatory - Enable time synchronization verification.
packet-type - Used to define specific fields in the test packet.
dst-ipv4-addr - The IPv4 destination address.
destination-port - The destination port for UDP protocol (0 - 65535).
source-port - The source port for UDP protocol (0 - 65535).
dscp - The Diff-Serv CodePoint value (0 - 63).
dst-mac-addr - This is the Ethernet MAC destination address.
y1731-level - Y.1731 Maintenance Entity Group level (0-7).
Revision 1 202
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Delete Report
Description
Delete an instance of Y.1564 test report.
Syntax
y1564 delete report <report-name>
<report-name> = <string>
Parameters
<report-name> - A unique name to identify an instance of Y.1564 test report.
Description
Delete an instance of Y.1564 test.
Syntax
y1564 delete test <test-name>
<test-name> = <string>
Parameters
<test-name> - A unique name to identify an instance of Y.1564 test.
Revision 1 203
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Edit Report
Description
After a Y.1564 test has completed, the report can be edited to modify or add
information such as: name, description, note, technician's name.
Syntax
y1564 edit report filename <filename> {
{description <desc>} |
{note <note>} |
{technician <tech. name>}}+
Parameters
description - <string> Information about test being described.
note - <string> Additional Information about test being described.
technician - <string> Name of technician executing test.
Description
With y1564 edit service, you change the configuration of a service under a
specific test.
Syntax
y1564 edit service <test-name> <service-id> {
{name <service-name>} |
{state {enable | disable}} |
{policing {enable | disable}} |
{step {enable | disable}} |
{availability {enable | disable}} |
{cir <0 to max-port-speed>} |
{cbs <0 to max>} |
{eir <0 to max-port-speed>} |
{ebs <0 to max>}|
{size-type {fixed}} |
{packet-size <64 to 10240>} |
{ftd <decimal>} |
{ftd-type {max|avg}} |
{fdv <decimal>} |
{fdv-type {max|avg}} |
{flr <exponent>} |
{m-factor <decimal>} |
{dst-ipv4-overwrite {enable|disable}} |
Revision 1 204
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Edit Service
{dst-ipv4-addr <ip-addr>} |
{dscp-overwrite {enable|disable}} |
{dscp <0-63>} |
{dst-mac-addr-overwrite {enable|disable}} |
{dst-mac-addr <mac-addr> } |
{y1731-level-overwrite {enable|disable}} |
{y1731-level <0-7>} |
{vlan1-header {enable|disable}} |
{vlan1-ethertype {c-vlan|s-vlan}} |
{vlan1-priority <0-7>} |
{vlan1-id <0-4095>} |
{vlan1-cfi <0-1>} |
{vlan2-header {enable|disable}} |
{vlan2-ethertype {c-vlan|s-vlan}} |
{vlan2-priority <0-7>} |
{vlan2-cfi <0-1>} |
{vlan2-id <0-4095>} |
{fe-vlan1-priority-check {disable | enable}} |
{fe-vlan1-dei-check {disable | enable}} |
{fe-vlan1-id-check {disable | enable}} |
{fe-vlan2-priority-check {disable | enable}} |
{fe-vlan2-dei-check {disable | enable}} |
{fe-vlan2-id-check {disable | enable}} |
{fe-dscp-check {disable | enable}} |
{fe-vlan1-priority <0-7> {disable | enable}} |
{fe-vlan1-dei <0-1> {disable | enable}} |
{fe-vlan1-id <0-4095> {disable | enable}} |
{fe-vlan2-priority <0-7> {disable | enable}} |
{fe-vlan2-dei <0-1> {disable | enable}} |
{fe-vlan2-id <0-4095> {disable | enable}} |
{fe-dscp <0-63> {disable | enable}}}+
Parameters
name - The name of a service.
disable | enable - To enable or disable the field in the check.
state - Enable this service for this specific test.
policing - Enable policing testing.
step - Enable step testing.
availability - Enable Availability measurement.
cir - committed information rate in kbps.
cbs - committed burst size in kBytes.
eir - excess information rate in kbps.
ebs - excess burst size in kBytes.
size-type - Packet sizes is limited to fixed only, no support
for EMIX available in this product.
packet-size - For a fixed packet, specify the packet size.
Maximum packet size is 10240.
ftd - Maximum/average two-way Frame Transfer Delay (FTD)
allowed (in micro-seconds).
Revision 1 205
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Edit Service
Revision 1 206
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Edit Service
Revision 1 207
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Edit Test
Description
With y1564 edit test, you can change the parameters of an existing test.
Syntax
y1564 edit test <test-name> {
{name <test-name>} |
{description <string>} |
{configuration {enable | disable}} |
{step-duration {1-60} |
{performance {enable | disable}} |
{test-duration {1-1440} |
{parallel {enable | disable}} |
{port <port-name>} |
{delay-type {one-way-delay | two-way-delay}} |
{time-sync-mandatory {enable | disable}} |
{packet-type {layer-2 | layer-3 | l2-accedian | l2-generic}} |
{dst-ipv4-addr <ip-addr>} |
{destination-port <0-65535>} |
{source-port <0-65535>} |
{dscp <0-63>} |
{dst-mac-addr <mac-addr>} |
{y1731-level <0-7>}}+
Parameters
name - The name of the the test.
description - Short description of the Y.1564 test.
configuration - Enable Y.1564 configuration test.
step-duration - Duration of each step during the configuration test in
seconds.
performance - Enable Y.1564 performance test.
test-duration - Duration of each step during the performance test in
minutes.
parallel - Enable Y.1564 parallel service configuration test.
port - Name of the port to which to send the test traffic.
delay-type - Type of delay measurement.
time-sync-mandatory - Enable time synchronization verification.
packet-type - Used to define specific fields in the test packet.
dst-ipv4-addr - The IPv4 destination address.
destination-port - The destination port for UDP protocol (0 - 65535).
source-port - The source port for UDP protocol (0 - 65535).
dscp - The Diff-Serv CodePoint value (0 - 63).
dst-mac-addr - This is the Ethernet MAC destination address.
y1731-level - Y.1731 Maintenance Entity Group level (0-7).
Revision 1 208
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Generate Report
Description
This command allows to generate a Y.1564 test report.
Syntax
y1564 generate report <filename> [report-type {report-type-txt |
report-type-xml}]
Parameters
filename - <string> Unique filename associated with the report.
report-type - Report type (XML, TXT) to generate.
Description
This command displays the Y.1564 test activation. i.e. its name, status and
description. If a specific test name is specified, a full test activation will
be displayed (name, status, service name, and progression of each test step).
Syntax
y1564 show activation <filename>
Parameters
<filename> - <string> Unique filename associated with the activation.
Description
The command displays the configuration for a specific service.
Syntax
y1564 show service configuration <test-name> <service-id>
Parameters
<test-name> - A unique name used to identify a Y.1564 in the system.
<service-id> - A unique id used to identify a service in this test.
Revision 1 209
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Show Test Configuration
Description
This command displays the Y.1564 test configuration. Specifying a test name
provides detailed configuration about this test. Otherwise, the command
provides a summary of the configured test.
Syntax
y1564 show test configuration <test-name>
Parameters
<test-name> - <string> Name of the specific test to display the configuration.
Description
This command starts the specified Y.1564 test and creates a new report.
Syntax
y1564 start activation filename <filename> test <report-test>
{ {description <report-desc>} |
{technician <report-tech>} |
{note <report-note>} }+
Parameters
filename - <string> Unique filename for the report.
test - <string> Name for the Y.1564 test to run.
description - <string> Description for this report.
technician - <string> Name of the technician running this test.
note - <string> Note associated to this test. This note will be
included in the report.
Revision 1 210
MetroNID TE v6.4.2 CLI Command Guide Y.1564 Stop Activation
Description
This command stops the execution of the specified test.
Syntax
y1564 stop activation filename <filename>
Parameters
filename - <string> Unique filename where the report will be stored.
Description
This command allows to upload a Y.1564 test report to a remote location.
Syntax
y1564 upload report <filename> <url> [report-type {report-type-txt |
report-type-xml}]
Parameters
filename - <string> Unique filename associated with the report.
url - URL to reach the server and directory, e.g.
ftp://username:password@mypc.com
sftp://username:password@192.168.10.10
tftp://192.168.1.5
scp://username:password@192.168.10.10:/target_directory
The filename of the report will be automatically appended
to the specified URL.
report-type - Report type (XML, TXT) to upload to server.
Revision 1 211