mate release 6 - · pdf filemate release 6.0 platform support release supported until mate 5.4...

Release Notes

© 2014 Cisco and/or its affiliates. All rights reserved. Cisco Confidential – Proprietary Information 1

MATE Release 6.0

Platform Support

Release Supported Until

MATE 5.4 08/05/2015

MATE 5.3 03/05/2015

MATE 5.2 08/30/2014

MATE 5.1 and previous EOL

Future Upgrades

In release 6.1, the minimum operating system required for Linux installations will be RHEL6.5.

How to Upgrade

Plan files—Plan files from previous versions are read and upgraded automatically on opening in release

6.0.

MATE Live datastore—To upgrade the datastore from a release prior to 5.6, contact your support

representative.

Collector snapshots—If using an upgraded snapshot process, run archive_init -upgrade on

individual archive repositories before adding them to the server. This ensures that the internal archive

database schema is current, but does not upgrade the underlying plan files. The archive_insert

tool does not automatically run a simulation before inserting a plan file. To check in a plan file

containing a simulation, run mate_sim on the plan file before running archive_insert.

Add-ons and scripts—Add-ons and scripts may be affected by the schema changes and CLI tool

changes that are described in their respective sections.

Enhancements

The WAE SDN platform enables you to abstract and simplify a WAN environment while making it fully

open and programmable. You can automate operations, such as managing, controlling, analyzing, and

improving network performance and capacity planning. This is a Beta product and available through

special request. For information, contact your Cisco representative.

MATE 6.0 Release Notes


MATE Design

For information on these features, see the MATE Design User Guide.

MPLS simulation enhancements

o Improved Fast Reroute simulation, enabling the avoidance of configured SRLGs.

o New segment-routing (SR) simulations use SR LSPs that are configured with segment lists.

o New autobandwidth simulations

Can configure LSPs to use autobandwidth.

New convergence modes that simulate network state after autobandwidth convergence.

o Simulate configuration of LSPs to use IGP metrics, rather than TE metrics, in CSPF route

calculations.

o Simulations report on how much LSP versus non-LSP traffic each interface is carrying.

o New RSVP-TE optimization tool

Optimizes explicit LSP paths.

Uses CSPF-like optimization (minimizes TE metric or latency subject to RSVP bandwidth

constraints).

Optimized centrally rather than distributed, like RSVP TE, between nodes.

This is an experimental tool with limited functionality in this release. (For this reason, it is not in

the documentation.)

Layer 1 simulation enhancements

o Extended L1 schema

Wavelength (lambda) assignments and constraints on lambda blocking.

Constraints on simulated routing, similar to GMPLS routing, which optimizes routes subject to

optical feasibility constraints.

o Exporting of Lambda assignments per each L1 link, for example, to evaluate fragmentation of

wavelength use across L1 links. For information, see the MATE Integration and Development Guide.

o Faster bulk mapping of L1 circuits to L3 circuits.

Visualization enhancements

o Sites can be nested within other sites, providing a simpler, easier to read plot representation.

o Nodes can reside both inside and outside of sites. The external arrangement could be useful for small

networks where routers are not geographically dispersed.

o Extra node-to-site assignment rules allow special treatment of external AS nodes and allow node

assignment based on the number of connections to existing sites. Note that these options existed in in

release 5.5, but were removed in release 5.6.

Substantial improvements to the MATE API, which is in a Technology Preview stage. For information,

see $CARIDEN_HOME/docs/api/html/index.html.



MATE Live

For information on these features, see the MATE Live User Guide.

New Inventory feature gives a hierarchical representation of the current hardware in the network and

the interconnections. This feature is useful for finding empty slots that are available for accommodating

future growth.

Ability to track per-queue interface statistics.

Report enhancements

o New Deviation report detects sudden changes in property values. This report is particularly useful for

detecting rapid increases and decreases in LSP and interface traffic.

o Group multiple properties for reports, thus enabling you to further segment the data.

o Aggregate percentage of growth in ad hoc reports.

o Project traffic on user-specified future dates in traffic reports.

New Explore Report feature for identifying if reports are returning a significant number of objects

based on a report filter.

Usability enhancements

o On the Map page, interfaces are graphed in relationship to their capacity.

o New look-and-feel throughout the UI and new navigation mechanisms.

o View interface types as a property.

Visualization enhancements

o Sites can be nested within other sites, providing a simpler, easier to read plot representation.

o Nodes can reside both inside and outside of sites.

Users can track external data as custom tables, which can be used in the UI's Explore and reporting

features. (External data is data collected outside of plan files.) An example use would be to track the

number of routes per node over time. This API enables you to use the MATE Live infrastructure to

manage all data from one location. For more information, contact your support representative.

New MATE Live Objects

New Object Properties

Interface queues

Error Packets In

Error Packets Out

Interface Queue

Node

Packets In

Packets Out

Traffic In

Traffic Out

New MATE Live Properties

Object New Property

Interfaces Type



Collector

Collector Server

For information on these features, see the Collector UI Configuration Guide.

Discovery enhancements

o Newly discovered nodes are automatically added without having to re-create a node list.

o Configure the additional collection of specific nodes based on IPv4 addresses, which can be useful

for collecting performance and utilization statistics for nodes that are not in the IGP database.

o New option to configure collections to run at user-specified times.

o New user customizations

Collector can use modified network access files, enabling you to customize the collection to

specific parameters within your network.

Advanced configuration capabilities enable you to customize the collection process by adding new

tools, scripts, and options.

Usability enhancements

o New look-and-feel throughout the UI for consistency with the MATE applications and System UI.

o Accessible directly from the MATE home web page, rather than in a separate browser.

o Reset (clear) the current configuration.

Reliability enhancement to save configuration files on the server and upload them at a later time, which

can be helpful when recovering configurations or doing upgrades.

Snapshot

For information on these features, see the Advanced Collector Configuration Guide.

LAGs

o Alcatel-Lucent (direct from node)

snmp_find_interfaces and snmp_poll support collection of LAG ports and their traffic

statistics.

snmp_find_rsvp collects RSVP LSP egress traffic statistics as the sum of per-forwarding class

traffic measurements.

o Juniper—snmp_find_interfaces enhancements to optimize collection of LAG ports.

Cisco IOS XR RSVP LSPs—snmp_find_rsvp optionally collects signaled backup LSP path hops

and associated path option values.

flow_get enhancements improve integration of the traffic matrix by collecting from interfaces that

are non-overlapping with the backbone perimeter discovered via IGP. This solution supports scenarios

where edge devices do not export NetFlow data, as well as scenarios where capacity planning or traffic

engineering needs to be restricted to a sub-set of the discovered network.

SRLGs

o Cisco and Juniper—Discovery of which SRLGs are configured on which nodes for improved Fast

Reroute simulations in MATE Design.

o Juniper—parse_configs enhancements to collect SRLGs by name, as well as previously

supported fate-sharing groups.



Juniper MAC Accounting—find_bgp and snmp_poll enhancements to collect MAC addresses and

source MAC traffic statistics for more granular visibility at IXP peering connections.

Cisco and Juniper L3VPNs—parse_configs enhancements to associate external interfaces with

VRFs for offline modeling.

SAM-OSS Interface

sam_getplan collects manual and dynamic bypass Fast Reroute LSPs and their actual path hops.

Improved integration of sam_getplan within the snapshot process for a more complete multi-vendor

collection. This includes RSVP TE LSPs, LAG ports, interfaces queues, VPNs, and their traffic

statistics.

MATE System

Licensing improvements

o Floating licenses for MATE Design can be installed without the actual file. You only need to know

the host and MAC address of the license server, and optionally the TCP port. For information, see

the MATE GUI Installation Guide.

o You can read details on the licensed features either through the CLI or through the MATE web

System UI.

The System UI shows the status of the CPU load average, amount of available memory, and amount of

disk space available for the server device. For information, see the System Administration Guide.

Schema Changes

Consult the $CARIDEN_HOME/docs/table_schema.html file for a complete reference.

New Tables

New Table Columns Type Description

<ActualL1CircuitHops> Discovered actual L1 circuit hops. Although these are not discovered by Collector, if you have a discovered set of L1 circuit hops, you can add them to this table for use in MATE Design.

HopLink Plan Name of the L1 link hop.

HopNodeA Plan L1 node hop or Node A of L1 link hops.

HopNodeB Plan Node B of L1 link hops.

Lambda Plan Wavelength at this hop. If not specified, there is no change in wavelength.

Name Key L1 circuit name.

NodeA Key Node A of the L1 circuit.

NodeB Key Node B of the L1 circuit.

Step Key Sequence of the hop in the L1 circuit.

<L3L1Links> Models the physical relationship between L3 nodes and L1 nodes.

L1Node Key L1 node connected to an L3 node.

Node Key L3 node connected to an L1 node.



New Table Columns Type Description

<NodeConfiguredSRLGs> List of SRLGs configured on nodes.

Node Key Node name.

SRLG Key SRLG name.

<SegmentListHops> Hops in the segment lists used by segment-routed (SR) LSPs.

Name Key Segment list name.

SegmentNode Plan The segment hop's destination node. If you need to specify an initial segment hop, this can be equal to the source node.

SegmentInterface Plan Egress interface of the segment node. This defines an interface segment and can be empty if the next segment is a node segment.

Step Key Specifies the order of the segment hop within the list.

<SegmentLists> Segment lists used by SR LSPs.

Name Key Segment list name.

<SimAnalysisWCUtilL1Link> Worst-case failure impact on L1 links over all simulated failures.

Name Key Name of L1 link.

NodeA Key Node A of L1 link.

NodeB Key Node B of L1 link.

WCFailure Plan Failures causing worst-case utilization (WCUtilSim) over all simulated failures.

WCNumL1Cir Plan Maximum number of L1 circuits on an L1 link over all simulated failures.

WCUtilSim Plan Worst-case utilization of an L1 link over all simulated failures.

Removed Columns

Table Removed Column

<L1Links> Capacity

CircuitAvailBW

CircuitResv

CircuitUtil

ResvBW

ResvBWSim

<PlotLayouts> LayoutSite

<PlotLayoutElements> LayoutSite



Column Description Changes

Table Column New Description

<Nodes> X Node X coordinate within the network plot (previously this coordinate was within the site).

Y Node Y coordinate within the network plot (previously this coordinate was within the site).

New Columns

Table New Column Type Description

<Interfaces> TraffSimLSP Derived Simulated LSP traffic through the interface.

TraffSimNonLSP Derived Simulated non-LSP traffic through the interface.

<L1CircuitHops> Lambda Plan If MATE Design automatically creates the first L1 circuit hop to be the first L1 node in the path, then this Lambda is inherited from the Lambda property of its L1 circuit. If you create the initial L1 node as the first hop, then you can set this property to any value. Thereafter, the specified Lambda is used for all of the subsequent hops if no other change is specified. This value is set to “na” if it is not explicitly set.

LambdaSim Derived Simulated wavelength number, which is copied from one of these values in this order of priority.

The hop’s Lambda value.

The Lambda of the first preceding L1 circuit hop that has a Lambda value.

The Lambda property of its L1 circuit.

If Auto Lambda is used, then this value changes in alignment with how the L1 circuit LambdaSim changes.

This value is set to “na” if no Lambda values have been specified for this L1 circuit or if the L1 circuit cannot be routed.

<L1Circuits> AutoLambda Plan If lambda blocking occurs and if AutoLambda is T (true), the L1 circuit attempts to use another lambda if it is available.

FeasibilityLimit Plan Identifies the acceptable quality of the L1 circuit.

FeasibilityMetricSim Derived Sum of the FeasibilityMetric values of all L1 links over which the L1 circuit is routed.

FeasibleTransmission Derived Identifies whether the L1 circuit can be transmitted. If the L1 circuit’s FeasibilityLimit is more than the sum of the FeasibilityMetric values for the L1 links that it traverses, this value is T (true) and the L1 circuit can route. This value is set to “na” if there is no Feasibility Limit.




Note: This property is not applicable if an L1 circuit is using actual L1 circuit hops.

Lambda Plan The Lambda value of the first hop in the L1 circuit is copied to here. If there are no L1 hops or if there are no Lambdas assigned to L1 hops, then it is the wavelength of the L1 circuit. If there are L1 hops and they have changed Lambda values, the L1 circuit uses the most recently used L1 hop Lambda. The maximum Lambda value (integer) allowed for an L1 circuit is limited by the lowest ResvNumL1CircuitsSim value of all L1 links in its path.

LambdaBlocking Derived True (T) means this L1 circuit cannot be routed either because it has the same Lambda value as another L1 circuit going over an L1 link or the LambdaSim exceeds the ResvNumL1CircuitsSim on any L1 link in its path. This is "na" if the wavelength (Lambda) is not specified.

LambdaSim Derived Simulated wavelength number, which is copied from one of these values in this order of priority.

LambdaSim value of the first actual L1 circuit hop.

LambdaSim value of the first L1 circuit hop.

Lambda value of this L1 circuit.

If AutoLambda is invoked, then MATE Design changes the LambdaSim in order to route the L1 circuit.

This value is set to “na” if the L1 circuit cannot be routed.

Routed Derived Identifies whether the L1 circuit follows actual path, simulated path, or is not routed.

<L1Links> AvailL1Circuits Derived Number of L1 circuits that can have paths through this L1 link.

ResvL1CircuitsSim - NumL1Circuits = AvailL1Circuits

CircuitBWSim Derived Total amount of BWSim for all L3 circuits routed through the L1 link.

FeasibilityMetric Plan Identifies how much an L1 circuit is degraded when it passes through this L1 link.

MaxL1Circuits Plan Total number of L1 circuits that the L1 link can carry. If not specified, the L1 link has no circuit restriction.

ResvL1Circuits Plan Number of L1 circuits that can be reserved to be routed over the L1 link. The maximum Lambda value (integer) allowed for an L1 circuit is limited by the lowest ResvNumL1CircuitsSim value of all L1 links in its path.




ResvL1CircuitsSim Derived If a ResvL1Circuits value is entered, this is copied to the ResvL1CircuitsSim column.

If the ResvL1Circuits is empty, the MaxL1Circuits value is copied to the ResvL1CircuitsSim column.

UtilSim Derived NumL1Circuits (paths on an L1 link) as a percentage of MaxL1Circuits.

WCNumL1Circuits Derived Maximum number of L1 circuits on an L1 link over all simulated failures.

WCUtilSim Derived Worst-case utilization of an L1 link.

<L1Nodes> IPAddress Plan Loopback IP address of the L1 node.

IPManage Plan Management IP address of the L1 node.

Latitude Plan Geographic latitude of the L1 node within the network plot.

Longitude Plan Geographic longitude of the L1 node within the network plot.

Model Plan L1 node model number.

OS Plan L1 node operating system.

Vendor Plan L1 node operating system and software version.

<LSPs> Type Plan Type of LSP; either RSVP or SR (segment route). The default is RSVP.

SLName Plan For an SR LSP, the name of the segment list. If this is empty, then no segment list is defined.

Autobandwidth Plan If T (true), autobandwidth is enabled on the LSP.

TEMetricDisabled Plan Identifies whether the LSP is routed using TE metrics. The default is F (false).

<LSPPaths> SLName Plan For an SR LSP, the name of the segment list. If this is empty, then no segment list is defined.

<Nodes> Latitude Plan Longitude of the node in the network plot.

Longitude Plan Latitude of the node in the network plot.

NetIntSource Plan Source of node information, which is either IGP (default) or Explicit (information is explicitly provided, such as for L2 nodes).

<Ports> L1Node Plan L1 node attached to the port.

RemoteL1Node Derived Remote L1 node (applicable only if a port circuit is defined).

<Sites> ParentSite Plan A site that directly contains another site.



CLI Changes

CLI tools are located in $CARIDEN_HOME/bin. For more information on any CLI tool, execute it with the -help

option.

Removed or Deprecated CLI

Removed or Deprecated CLI Tools

Product CLI Tool Removed or Deprecated

MATE Design export_paths Removed; use export_routes

MATE Live mld_slice Removed

Collector login_find_bgp_ext Deprecated

snmp_find_bgp Deprecated

Removed CLI Options

Product CLI Tool Removed Option

MATE Design exp_opt -primary-setup-bw

exp_opt_tactical -primary-setup-bw

MATE Live ml_insert_plan -allow-insertion

-datastore

-print-table

Removed CLI Values

Product CLI Tool Option Removed Values

MATE Live mld -action uninstall

Collector snmp_find -vpn-type P2P, Layer2, Layer3



New CLI

New CLI Tools

Product CLI Tool Description

MATE Design export_lambda_util Export wavelength utilization for L1 links.

insert_L1circuit_for_circuit Creates an L1 circuit for each selected L3 circuit.

mateapid Starts the mateapi service with an endpoint accessible at a hostname and port for a common communication protocol.

mate_api_python Executes the given python script with the correct environment for MATE API scripts.

rsvp_te_opt Creates or modifies fully explicit RSVP LSP paths for LSPs, and optimizing paths globally for better performance.

New MATE Design CLI Options

CLI Tool New Option Description

assign_sites_L1 -keep-unmatched-nodes If true, keep the unmatched L1 nodes

in their current sites. Default is true.

assign_sites_L3 -keep-unmatched-nodes If true, keep the unmatched nodes in

their current sites. Default is true.

changeover -lic-product Specifies the base product license to

check out and use: Design or WAE. The

default is Design.

copy_fom_template -site-assign-by-neighbor If true, nodes that are not assigned

sites by the template will be assigned, if possible, to the sites that the majority of their neighboring nodes are assigned.

Default is false.

-site-assign-external-as Nodes in external AS’s are assigned to

sites. The values are ASN, Name, and

None.

If using a <NodeSiteMappingRules> table or a <SiteMapping> table, the

default is Name.

If not using a mapping table, the

default is None.

explicit_LSP_path_init -lic-product Specifies the base product license to


default is Design.

exp_opt -disjoint-weight-l1nodes Disjoint priority to give L1 nodes relative to other failure sets. The smaller the number, the higher the priority. Use real

numbers. The default is 3.

explicit_P2MP_LSP_init -lic-product Specifies the base product license to


default is Design.

lsp_mesh_creator -type Specifies which type of LSP to create:

RSVP (default) or SR (segment routed).




-autobandwidth Allows creation of autobandwidth-enabled LSPs in an LSP mesh.

New MATE Live CLI Options


ml_insert_ctl -handler The .json handler file name used to handle the insertion. This is located in

$CARIDEN_HOME/etc/matelive/ml_insert_handlers.

This option is mandatory option if -insert is specified.

-insert Insert the specified plan file using the data collection scheduler.

-plan-file The .pln plan file to insert. This option is mandatory if -insert is

specified.

-time Timestamp for the inserted plan file. This option is mandatory if

-insert is specified.

ml_insert_plan -objects Specify the exact object types to insert separated by commas. If you

enter a list of Interfaces, LSPs, then only interfaces and LSPs

are inserted although there may be data for other objects in the plan file.

New Collector CLI Options


flow_get -ext-node-tags Comma-separated list of user-specified external node tags.

-match-on-bgp-external-info Attempts to match the egress IP addresses with external addresses for BGP peers. The

default is false.

login_find_igp_db -allow-dup-area Determines whether to allow duplicate IS-IS area-ids for Level 1 databases. This is valid

only if using -isis-level both. The

default is false.

sam_getplan -include-frr-lsp Collect Fast Reroute LSPs. The default is

true.

snmp_find_rsvp -backup-paths Collect signaled backup (standby) paths for

LSPs. The default is false.

New MATE System CLI Options


license_check -detail Show descriptions of licensed features. Default is false.

license_install

-server-host

Hostname of the floating license server. Use with

-server-mac if you do not have access to the license.

Cannot be used with -file.

-server-mac

MAC address of the floating license server. Use with

-server-host if you do not have access to the license.

Cannot be used with -file.

-server-port TCP port of the floating license server. The range is from 1 to 65535.



New Values for CLI Options

Product CLI Tool Option New Value Description

Collector flow_get -address-family IPv4+IPv6 Creates a single set of aggregated demands using IPv4 and IPv6 flows. This is the default.

Changed CLI

Product CLI Tool Option Value New Behavior

Collector flow_get -address-family IPv4,IPv6 Creates a list of concurrent demands for IPv4 and IPv6 flows. In previous releases, this created aggregated demands.

parse_configs -include-object srlg Parses Juniper "slrg" and "fate-sharing" group names.

vpn Associates edge router interfaces with configured L3VPN instances.

System license_install -existing-lic Applicable only if using the -file

option.

Open Source

This product includes the following.

Software developed by MetaStuff ( http://www.dom4j.org)

Cryptographic software written by Eric Young ([email protected])

Software developed by the OpenSSL project for use in the OpenSSL Toolkit (http://www.openssl.org/)

Software written by Tim Hudson ([email protected])

Software developed by the University of California, Berkeley and its contributors

Issues Fixed

Issues Fixed Since 5.6.3

MATE Design

Key Summary

CSCup59480 copy_from_template -remove-after causes snapshots to fail

CSCup60275 Check License feature does not see all the MAC addresses

CSCup62642 OSPF area for interfaces not properly set when configured through the GUI

CSCup70348 Windows client cannot check out a floating license from the FlexNet Publisher license server

CSCup70898 copy_from_template -remove-after fails to remove circuits that have not been seen

since the specified time

CSCup72828 export_routes -object shortestpaths does not include BGP paths in its output

CSCup75942 Cannot remove the AS property from nodes

CSCup84995 Worst-case results are not interpreted for external endpoint members that are nodes, resulting in “failure to parse” errors



Key Summary

CSCup88166 copy_from_template overwrites the discovered interface capacity

CSCup88206 BGP pseudo-nodes are dropped from the plan file after the template is applied

CSCup93042 Demands are routed over inactive interfaces

CSCup98514 Typo in create_representative_plan -help output

CSCuq04744 copy_from_template -include-extra does not copy ports and port circuits

MATE Design Archive

Key Summary

CSCup88346 Unable to authenticate the REST API and therefore, cannot download or upload templates or plan files

MATE Live

Key Summary

CSCun65796 Actual Paths property shows ML_STRING_NULL_VALUE

CSCuo58422 Map Peering panel shows "ASN" instead of "Name'"

CSCup21041 External Archive field on the Settings page accepts blanks at the end of the path

CSCup30439 ml_insert_plan fails when inserting plan files into a large archive

CSCup53755 Map Events panel does not update totals for interface errors

CSCup57295 After cancelling a report in progress, the Report History page (Report Log page in 6.0) continues to show that the report is running

CSCup67093 mld returns an incorrect disk type when installed

CSCup95498 Backup operations fail when backup schedules overlap for L0 and L1 (ml_backup -L 0 and

ml_backup -L 1 )


MATE Design

Key Summary

CSCuo98438 Simulation Diagnostics does not report why LSPs are unrouted

CSCup16506 Inter-area LSP is neither rerouted nor unrouted when there is a link failure

CSCup21093 Incorrect schema message appearing on opening plan file

CSCup27508 explicit_L1circuit_init fails

CSCup34837 Demands with external endpoints that have common members have incorrect latency values

CSCup40580 L1 node pre-selection is not in effect when creating L1 circuits

CSCup45765 Removing an L1 circuit hop makes <L1CircuitHops> unavailable

CSCup58089 Duplicating a site does not duplicate L1 nodes



MATE Live

Key Summary

CSCum64647 Unwarranted object selection confirmation dialog box appears

CSCup05572 Application looks for datastore when it is not required

CSCup32289 Explore returns error when accessed from the Map after a previous filtering action

CSCze16989 In Explore, more than one source node for LSPs may be shown

MATE Collector

Key Summary

CSCum36454 LSPs with a metric of 0 are not listed in snmp_find_rsvp (Alcatel-Lucent routers)

CSCun29934 Active column in the LSP table has incorrect mapping to admin state

CSCuo59406 NetIntIndex column has incorrect decimal placement in <NetIntMacMeasurements> table

CSCuo68828 sam_getplan command aborts

CSCuo71653 snmp_find_vpn overwrites VPN discovery information collected through sam_getplan

CSCuo71666 snmp_find_interfaces overwrites interface queue information collected through

sam_getplan

CSCuo81611 snmp_poll overwrites statistics collected through sam_getplan

CSCuo83033 snmp_find_interfaces removes existing sam_getplan tables

CSCuo87068 flow_get -backtrack-micro-flows true stops working

CSCuo96128 snmp_find_ldp and poll_ldp do not properly account for LDP flows

CSCuo98672 sam_getplan does not check for VPN license

CSCuo99783 NetIntIntdex column in <NetIntInterfaces> table shows 0 for L2 VPNs when using sam_getplan

CSCup00388 <NetIntInterfaceTraffic> does not show proper VPN interface name from sam_getplan

CSCup06377 <NetIntInterfaceTraffic> table is not populated with port traffic

CSCup13186 net_access.txt filter is not working for Alcatel-Lucent routers

CSCup14844 sam_getplan has performance issues

CSCup17680 Null pointer exception errors when running sam_getplan with IGP protocol when the nodes on

the SAM server do not have the same IGP protocol configured

CSCup20944 net_access.txt file does not correctly process the REGEXP for the NodeRegExp

CSCup24187 sam_getplan has discrepancies in VPN source and destination measured traffic

CSCup36876 <NetIntInterfaces> updates required as part of CSCuo83033 fixes

CSCup38626 <NetIntInterfaces> not showing capacity in Mbps when sam_getplan is used

CSCup39258 <NetIntInterfaces> not showing capacity in Mbps for LAG interfaces when sam_getplan is

used

CSCup49537 VPN traffic is not correctly populated when using sam_getplan

CSCup51929 NetIntAdminStatus and NetIntOperStatus columns in <NetIntInterfaces> table are not properly

populated when using sam_getplan

CSCup53083 snmp_find_nodes and snmp_find_interfaces do not properly poll for Alcatel-Lucent

routers

CSCup58131

sam_getplan produces incomplete L2 VPN information



Key Summary

MATE Collector UI

CSCun21691 Clicking Include/Exclude Nodes activates error message

CSCuo60409 Collection Schedule page does not show state change

CSCuo73534 Persistence manager is not thread safe

CSCup05644 When creating a plan file, the month is improperly written into the minutes field

MATE System

Key Summary

CSCum41361 Clicking headings on the User Management page does not sort the columns

CSCuo60088 Web browser is incorrectly redirecting the URL

CSCup22446 Multiple vulnerabilities in OpenSSL


MATE Design

Key Summary

CSCuo29395 Demands between external endpoints are not in the demand plot

CSCuo30023 When a site failure is recovered, the failure is not removed

CSCuo36290 When configuring LSP service classes, MATE Design stops running

CSCuo54696 Unable to change the case of a node Name property

CSCuo55152 Duplicating a site is not changing name of the duplicated display name

CSCuo55218 Unable to use a Geographic plot background in Greenfield network

CSCuo58297 Node-to-Site Mapping table not properly placing ASNs when using the Assign Sites to Nodes tool

CSCuo60066 copy_from_template overwrites IOS-XR values

CSCuo64005 OSPF area selection not included in generated sam_getplan command line

CSCuo64062 Sites not properly identified when circuits within it are inactive

MATE Design Archive

Key Summary

CSCun76535 XML parsing error occurs when non-ASCII-compliant characters are present

CSCuo41372 Opening MATE Design Archive returns an error when using LDAP authentication

MATE Live

Key Summary

CSCul84284 Object count is incorrect when filtering by user-defined property

CSCul95469 Map errors should be more explicit when no snapshot is found

CSCum88465 mld continues to run after an aborted install

CSCum89085 Remove mld_slice from $CARIDEN_HOME/bin

CSCun18222 Exporting to CSV uses a mixture of tab and comma-delimited formats

CSCuo00708 “Go to most recent plan file” feature is not refreshing



Key Summary

CSCuo41566 Interface Explore is missing a filter for the Node column

CSCuo44103 Explore is missing low-velocity data

CSCuo55143 Updating a template in MATE Live results in a 0 file size template on the server

CSCuo56813 Starting the datastore (mld) after a fresh install produces schema error

CSCuo61109 ml_read gives a Java exception error

MATE Collector

Key Summary

CSCun30882 flow_get should not impose 1:1 relationship between <NetIntInterfaces> and

<NetIntInterfaceTraffic> tables

CSCun79572 flow_get not properly populating <Demands> and <DemandTraffic> tables

CSCun83862 flow_get is returning multiple demands for a single micro-flow

CSCuo13581 snmp_find_interfaces does not capture the interface name on NX-OS

CSCuo14168 Node properties do not include Model or Software version for Linkwood NCS router

CSCuo14384 When Level 1 and Level 2 parallel circuits in an IS-IS database are discovered, only one is used

CSCuo29882 sam_getplan halts under normal operation

CSCuo30550 Interface descriptions in <NetIntInterfaces> are not updated in final plan

CSCuo36716 When the <NodeFlowConfigs> table is missing, flow_manage gives a Java exception error

CSCuo36817 collector_getplan does not accept a timestamp file generated by a previous version of

MATE

CSCuo39724 find_bgp -peer-protocol IPv4, IPv6 creates two pseudonodes

CSCuo44252 flow_get -match-on-bgp-external-info option added

CSCuo45882 MAC accounting traffic is not collected on all pseudonodes

CSCuo55033 parse_configs is not correctly parsing configuration files

CSCuo62349 LAG port traffic in <PortTraffic> table is incorrectly calculated

MATE Collector UI

CSCum99016 Need user-friendly error message when web server has stopped

CSCun46827 UI "cancel" message is ambiguous and has a grammatical error

CSCuo52347 Include extra troubleshooting files is changeable while collection is running

CSCuo52802 Filtering based on timestamps does not work

CSCuo57941 After a license is changed, collection occurs for incorrect number of nodes

MATE System

Key Summary

CSCun76941 LDAP page giving confirmation dialog box when no changes are made

CSCuo49115 License description not displaying for all products

CSCuo70627 License checking is not working correctly for QoS and RSVP



Issues Fixed Since 5.6

MATE Design

Key Summary

CSCun74523 No obvious way to delete paths from the Shortest Paths table

CSCun74565 The Capacity Bound column in the Demand Groupings report is not populated for site-to-site demand groupings

CSCuo05198 Stdin is not read when using table_extract -plan-file -

CSCuo05372 changeover removes LSP paths in the original plan file

CSCuo14704 Slow performance when computing VPN node connections

MATE Live

Key Summary

CSCum02314 Creating a new user with user privilege causes login errors

CSCun22086 Typo in emailed report header

CSCun34310 Explore page does not display current filter after changing the table page

CSCun36872 Explore page is missing objects because the web server thinks it is a different time zone

CSCun37525 Report configuration settings are lost if Explore is used for object selection

CSCun40888 In Ad Hoc reports, grouped objects are not showing the overall utilization percentage for the group

CSCun42576 Viewing empty report shows an error instead of identifying that there is no data

CSCun42782 UI does not show demands as an option to view in Explore or from the MATE home page

CSCun43170 LSP Ad Hoc report using Change Count aggregation value for Setup BW property does not work

CSCun43193 Ad Hoc report filtering on the admin status for interfaces generates exceptions

CSCun43309 Hide Inactive Objects feature does not show the correct object count

CSCun43660 Selecting "all interface types" produces different report results than selecting "no interface types"

CSCun54269 Ad Hoc reports on interfaces are giving a NullPointerException error

CSCun57994 All TraffIn and TraffOut numbers are incorrect after a large quantity of data is accumulated

CSCun59725 Cumulative capacity numbers in Ad Hoc reports are wrong

CSCun59833 LSP Ad Hoc report using Change Count aggregation value for Setup BW property fails

CSCun63882 When grouping objects in Ad Hoc reports, time aggregation calculations for Last, Count, and Change Count are incorrect

CSCun63949 Explore page Show Only Selected feature not working

CSCun63973 Interface AD Hoc report using the wrong aggregation for user-defined properties silently fails

CSCun65788 ASN labels are missing from the Map Peering panel

CSCun68884 ml_insert_plan incorrectly adding actual paths for LSPs

CSCun69350 LSP Ad Hoc report aborts when filtering against admin status

CSCuo02720 ml_insert_plan fails on bad plan file

CSCuo09521 Explore page does not show interfaces when navigating from Map

CSCuo09911 User-defined property utilization values are missing the percent in Explore pages and in report output

CSCuo10163 Map must be refreshed to populate the Layout menu after changing the external archive location

CSCuo12374 Map has performance issues when loading large plan files



MATE Collector

Key Summary

CSCun81919 snmp_poll -poll-function interfaces,mac has performance issues

CSCun81978 NetFlow traffic matrix is not updated with the proper date in the file name

MATE Collector UI

CSCun08953 Counters showing the last snapshot status change to N/A if you leave the Schedule page and come back

CSCun29197 On the What to Collect page, there is no collection warning when polling period exceeds counter update period

CSCun38319 After changing node license, collection is based on previous node license

CSCun42908 If a collection is running, Get Diagnostics feature does not get results from the previous collection

CSCuo12779 Filtering on "hostname ends with" does not work on the Node List page

MATE System

Key Summary

CSCum86359 Unable to authenticate against LDAP active directory server

CSCun26857 System UI shows floating license available, but the Archive UI shows "no license available” error

CSCun37457 Application failed when uploading license

CSCun55040 UI freezes followed by inappropriate confirmation dialog box on the main page

CSCun76973 System UI License page gives conflicting information after installing a license from the CLI

CSCun90114 Must restart embedded_web_server after installing a license

Known Limitations

User Management

Both the System UI and the MATE Design Archive UI have user management capabilities. If both are

used to configure users, MATE uses the most recently updated information. The recommendation is to

use only the System UI to manage users.

Collector

Collector Server

If upgrading the Collector server from release 5.6 to 6.0, remove the $CARIDEN_ROOT/etc/collector/server/db-

persistence/DiscoveryEngineImplementation.db file prior to starting the

embedded_web_server.

OSPFv.2 databases cannot be collected via SNMP. The workaround is to use a manual snapshot.

OSPFv.3 and IPv6 IS-IS databases cannot be collected. The workaround is to use a manual snapshot.

SNMPv.3 device access is not supported. The workaround is to use a manual snapshot and

mate_auth_init.



Snapshots

Limitations specific to IOS XR routers

o IGP topology collected through parse_igp and login_find_igp_db

IS-IS link-state database with TE extensions contains incorrect interface “admin-weights”

(TE metric) on Intel-based routers.

IPv6 IS-IS link-state database does not contain IPv6 interface addresses or parallel interfaces. This

information is only available when IOS XR supports IS-IS IPv6 TE extensions. The

snmp_find_interfaces collects this information.

o MAC Accounting is not supported.

o snmp_find_rsvp does not set the Standby value in the <LSPPaths> table for signaled backup

paths.

BGP peers

o find_bgp does not build BGP pseudo-nodes among internal ASNs.

o find_bgp does not collect BGP peers under PE-CE VRFs.

parse_configs does not accurately detect the bandwidth of some Juniper 'ge' interfaces that have a

capacity of 10 Gbps.

SAM-OSS Integration with Snapshots

sam_getplan does not populate the <NodeTraffic> table. This table is derived and populated when

sam_getplan and SNMP tools are used together.

sam_getplan does not populate the NetIntActivePath column in the <LSPs> table.

If sam_getplan and SNMP tools are used together in the snapshot process for multi-vendor network

collection, then Alcatel-Lucent traffic measurements cannot be aligned with those collected from other

router platforms.

License Check Failures on Newer Linux Distributions

Some newer Linux distributions have started using a new way (via biosdevname) of naming hardware

devices, including the network interfaces. This causes some software that depends on the traditional

naming (for example, eth0, eth1) to fail on license checks, including MATE.

The workaround is to append biosdevname=0 to the kernel line of the grub configuration file and

reboot. (Syntax varies among distributions.)

After reboot, you should be able use ifconfig to verify that the NIC are named eth0 (or eth1, ...)

instead of the biosdevname names (such as p34p1).



Java Memory

Certain tools (such as sam_getplan and parse_configs, for example) may require more memory to

start than what is available. The symptom is an error message similar to the following.

Error occurred during initialization of VM.

Could not reserve enough space for object heap.

Error: Could not create the Java Virtual Machine.

Error: A fatal exception has occurred. Program will exit.

The workaround is to set the maximum memory to a low enough value in the

CARIDEN_JAVA_OPTIONS variable before calling the tool. An example setting is as follows.

set CARIDEN_JAVA_OPTIONS=-Xmx1000m

Documentation

The MATE GUI Visualization Guide does not include the re-introduced features for extra node-to-site

assignment rules that allow special treatment of external AS nodes and that allow node assignment based

on the number of connections to existing sites.

July 2014, Version: 1

For further details, please visit www.cisco.com/go/quantum.

http://www.cisco.com/go/quantum

mate release 6 - · pdf filemate release 6.0 platform support release supported until mate 5.4...

Documents