MATE Release 5 - Cisco€¦ · SAM Certification MATE 5.4 was certified with Alcatel-Lucent’s...

Release Notes

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

MATE Release 5.5

Platform Support

Following is a list of supported platforms. Changes since the last release are the removal of Solaris

support, and the addition of 64-bit Windows.

Operating System Software MATE Collector MATE Live Stand-alone

MATE Design

Linux-x86_64 RHEL with latest patches X X X

Windows-x86_64 XP and 7.0 X

Windows-x86 XP and 7.0 X

Mac OS X x86_64 10.6.7 X

Red Hat and Debian-based Linux distributions should work, but are not officially supported.

Previous Release Support

MATE 5.2 has been added to the list of releases with limited continuing support.

Release Supported Until

MATE 5.2 08/30/2014

MATE 5.1 04/23/2014

MATE 5.0 10/15/2013

MATE 4.5 and previous EOL

How to Upgrade

Plan Files

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

MATE Live

For upgrade and installation information, contact your support representative.

MATE Collector Server

When upgrading a MATE Collector server, the command archive_init -upgrade should always be

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

MATE 5.5 Release Notes


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

MATE Design

Simulation of Class-Based Forwarding (CBF) for LSP Traffic

CBF configurations enable a router to allow or disallow entry of traffic into LSPs based on the DiffServ

settings. MATE Design now models this functionality through user-defined mappings of demand service

classes to LSP classes. These mappings define whether to allow or disallow demand entry into LSPs.

LSP Loadshare Optimization

This new routing optimization tool automates the process of finding and setting optimal loadshare ratios

between parallel LSPs to balance traffic and avoid congestion.

Miscellaneous

A new option in the export_route CLI tool allows filtering on the list of paths produced. Please see

the Schema Changes section.

Shortest TE Path Metric column in the LSPs table is now "na" only if the source and destination are

disconnected. Otherwise, a simulation should always calculate it.

Ability to duplicate multiple circuits at one time.

Minor changes to the exp_opt and exp_opt_tactical CLI tool options. Please see the CLI Tools

Changes section.

MATE Live

Datastore

The datastore was moved to a commercial database that improves performance, scalability, reliability, and

maintainability. For upgrade and installation information, contact your support representative.

Miscellaneous

The handling of actual path and shortest TE path calculations was improved.

MATE Collector

MAC Address Accounting

Peer BGP routers are now identified and polled for traffic by source MAC address, whereas previously

the traffic for multiple BGP ASNs was aggregated on a single interface. This feature improves ASN

traffic modeling for service providers who establish eBGP peering with multiple ASNs through shared

high-capacity interfaces at IXPs. This feature is available for Cisco and Juniper Layer 2 (MAC

accounting) traffic measurements over shared interfaces.



SNMPv3 Authentication

The MATE authentication tools were updated to support SNMPv3 authentication, which supports a

strong security model that includes message integrity, authentication of source, and packet encryption.

The mate_auth_init tool now creates an authentication file containing credentials for either SNMPv2c

or SNMPv3.

IPv6 Extensions

Several tools were extended for IPv6, including the following.

MATE Collector server support for IPv6 transport for router login

Parsing of IS-IS IPv6 extensions in the database for IPv6 topology creation (Cisco IOS XR only)

IPv6 BGP peer discovery using SNMP

Segregation of IPv4 and IPv6 flow traffic and creation of separate demands

SAM Certification

MATE 5.4 was certified with Alcatel-Lucent’s 5620 Service Aware Manager (SAM) R11.0. In the

process, several tools were removed. Please see the Schema section.

Licenses

MATE licenses are now feature based.

MATE licenses are now through the FlexNet Publisher.

o RLM is no longer part of the MATE licensing system.

o If MATE Design users have a floating license, you must set up the FlexNet Publisher license server.

License extensions are now lic, not msl.

Once licenses are installed, their names change to MATE_Dedicated.lic or MATE_Floating.lic,

depending on the license type.

Schema Changes

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

New Columns

Table New Column Description

LSPs Class LSP class. This is a manually set property. Demand service classes are mapped to LSP classes in the <ServiceClassLSPClassMapping> table.



New Tables

New Table Description

<LSPClasses> List of LSP classes in the plan file.

<NetIntMacAddresses> All discovered MAC addresses associated with border router MAC accounting, interface for BGP pseudonode, and its IP address.

<NetIntMacMeasurements> Raw traffic measurements over a number of samples and their average for all discovered MAC addresses.

<NetIntMacTraffic> Incoming and outgoing traffic rates for discovered MAC addresses.

<ServiceClassLSPClassMapping> List of how demand service classes are mapped to LSP classes, including the priority of the LSP class mapping per service class. This table is created in the GUI using the Manage QoS dialog box, LSP Class tab.

CLI Tools

Removed and Deprecated CLI Tools

Tool Deprecated or

Removed? Recommended New Tool

cpam_change_notifier Removed None; CPAM is no longer supported

cpam_get_plan Removed None; CPAM is no longer supported

sam_deploy_plan Removed None

sam_diagnostics_find Removed curl (open source)

sam_get_lsp Removed sam_getplan

New CLI Tools

New Tool Description

lsp_loadshare_opt Optimizes loadshare settings between LSPs.

New CLI Tool Options

CLI Tool New Option Description

export_routes -object-table <file> Passes a file containing a table that lists the objects to be exported. For shortest paths, this is the <Nodes> table used to select the routes. For all other objects, it is the table of the objects.

-routes-from-nodes <value> For shortest paths, this identifies how to create the routes.

between—Between selected nodes (default)

source—With selected nodes as source

destination—With selected nodes as destination

all—Through all selected nodes

any—Through any selected nodes



CLI Tool New Option Description

find_bgp -get-mac-address

<true/false>

Collect source MAC addresses of BGP peers. Default

is false.

-min-IPv6-prefix-length

<integer>

Minimum IPv6 prefix length to allow in subnet

matching. Default is 64.

flow_get -address-family <value> Comma-separated address-family indicators of demands populated in the <Demands> table. The list

can include ipv4, ipv6, or both. The default is ipv4.

license_install -existing-lic <value> Either merge the new license with the previous or overwrite it. Licenses are now feature-based, so ensure that your license contains all the required features

before using overwrite. The values are merge and

overwrite. The default is merge.

mate -lic-product <value> Specify the base product license to check out and use.

The values are design and live. If a value is not

specified, mate first checks for a MATE Design

license, and if one is not available, it checks for a MATE Live license.

parse_configs -lic-product <value> Specify the base product license to check out and use.

The values are collector and design. The default

is collector.

parse_igp -lic-product <value> Specify the base product license to check out and use.

The values are collector and design. The default

is collector.

snmp_find_bgp -get-mac-address

<true/false>

Collect source MAC addresses of BGP peers. Default

is false.

-min-IPv6-prefix-length

<integer>

Minimum IPv6 prefix length to allow in subnet

matching. Default is 64.

-peer-protocol <value> Comma-separated list that specifies the IP protocol

version. Default is ipv4.

Changed CLI Tool Options

CLI Tool New Option Removed Options

exp_opt -configure-rerouted-LSPs-only

<true/false> -preserve_unchanged_configs

exp_opt_tactical -configure-rerouted-LSPs-only

<true/false> -preserve_unchanged_configs

New CLI Values

CLI Tool Option New Value

login_find_igp_db -igp-protocol isisv6

parse_igp -igp-protocol isisv6

snmp_poll -number-of-samples mac

-poll-function mac

-polling-interval mac



Changed CLI Values

CLI Tool Option New Value

sam_getplan -num-logged-measwin The default value changed from 2 to 1.

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

Documentation

The documentation structure changed significantly this release. Note that when a guide is new, it does not

mean the content is completely new.

Guide Status Description

MATE Installation Guide New Includes information on how to install a stand-alone MATE Design system, set up a MATE Collector server, set up a FlexNet Publisher license server, and install licenses. It also includes basic steps for setting up a discovery process.

Server Setup and Advanced MATE Collector Configuration Guide

New Replaces the previous MATE Server Setup and Administration Guide. It has the same content except that the installation and license information was moved into its own guide.

5.5 release updates

o Authentication chapter—Added SNMPv3 authentication

o Snapshot Files, Flow Collection, and Offline Discovery chapters—Added IPv6 support

MATE Live Administration Guide New Includes user-defined properties and managing users.

MATE Live User Guide Updated Moved administration information to its own guide

5.5 release updates

o Managing Reports chapter—Updated to view report output in tab-delimited format

MATE Plan File and Visualization Guide

New Created to accommodate administrators who need to create templates for use in the Web applications; includes layout and visualization information

New information to better explain the differences between Design and Weathermap layouts

Now reflects a more balanced approach between Design and Weathermap layouts, whereas in the past it was Design centric

5.5 release updates

o Visualization chapter—Updated Plot Options with renaming of online server

MATE Design User Guide Updated Moved layout and visualization information to its own guide, and moved installation to its own guide



Guide Status Description

5.5 release updates

o MPLS chapter—Updated with new simulation information on load balancing and on CBF for LSPs

o LSP Optimization chapter—Updated with new tool for optimizing LSP loadshares

MATE Integration and Development Guide

Updated 5.5 release updates

o Add-Ons and GUI Customizations chapter—Updated information about the online detailed geographic map server

o Plan File Schema Reference appendix—Updated with new and changed MATE tables

o CLI Help Reference appendix—Updated with new and changed MATE CLI tools

Issues Fixed

Issues Fixed Since 5.4.1

MATE Design

Key Summary

MATE-10442 MATE Design terminated when running Simulation Analysis on both demand worst-case latency and VPN worst-case utilization and latency

MATE-10487 Plan file closes when opening a site

MATE Design Archive

Key Summary

MATE-7881 "Failed to get a license" error generated for all dynamic content

MATE-9569 Display issues in the Time-Sequence Plot view

MATE-10009 Error upon changing QoS level for the weathermap

MATE Live

Key Summary

MATE-8029 Application hangs after some time

MATE-9558 Unable to report on a user-defined property if named "Type"

MATE-9661 Encountered an SQLite error upon clicking "Go to LSPs" from Interfaces

MATE-9696 mlversion.xml file not populated

MATE-9754 Error upon changing QoS level for the weathermap

MATE-10040 LSPs are not consistent with those in MATE Design

MATE-10107 LSP health reports generate ArrayIndexOutOfBoundsException errors

MATE-10202 Scheduled weekly reports are not running

MATE-10314 Error upon applying filter to the Destination column on the Explore Demands page

MATE-10354 Unable to sort columns for the user-defined properties

MATE-10437 Encountered error while sorting an interface Metric column



MATE Collector

Key Summary

MATE-6188 snmp_poll truncating unsigned value to 32 bits

MATE-6500 Parsing LSP paths when there are two secondary paths renders incorrect PathOption value (Juniper)

MATE-9777 Interface affinities missing from collection

MATE-10021 login_find_igp_db on Huawei fails

MATE-10074 VPWS discovery has only one node for each VPWS circuit

MATE-10226 parse_configs is rejecting circuit terminated on repeated IP addresses

MATE-10261 parse_configs should remove quote characters in interface descriptions

MATE-10331 Error in parsing configuration files

MATE-10368 Change sam_getplan traffic statistics collection default to 1

MATE-10451 login_find_igp_db fails to write the IS-IS Level 2 portion of the record

MATE-10478 parse_configs creates extra LSP paths (Juniper)

MATE-10502 Login tools are terminating.

System

Key Summary

MATE-9889 license_check writes to stderr instead of stdout

MATE-10425 License error that ml_explore is missing when it is not

Issues Fixed Since 5.4

MATE Design

Key Summary

MATE-9417 Large proportion of LSPs put onto only 1 of 10 parallel links between the same 2 nodes

MATE-9600 LSP simulation diagnostics do not show the CSPF constraints that cause the actual path not to be followed

MATE-9639 import_demand_groupings has an incorrect option

MATE-9665 In Perl library, updating a row's values does not update table indexes that depend on the updated columns

MATE-9667 In Perl library, changing an existing table's name causes fatal error

MATE-9685 Issues with Demand Estimation when using the training_us_wan_L1.pln file

MATE-9782 Demands from failed site within IS-IS L1 topology are routed

MATE-9786 Nodes Operational status needs to be F when its site is failed

MATE-9835 Network failures should cause LSPs to become unrouted when in FRR simulation mode

MATE-9879 FRR LSPs do not carry simulation traffic

MATE-9887 FRR LSPs should reroute under Full Convergence simulation mode

MATE-9888 Missing CLI option and dialog option in explicit optimization tools

MATE-9890 table_extract not accepting proper input

MATE-9896 license_check does not report MAC addresses

MATE-9905 Demand groupings Traffic Grown (%) property not updated in Demand Groupings table



Key Summary

MATE-9919 mate::report::Demand Deduction::Interfaces sometimes shows 'TraffMeasScaled' column, sometimes shows 'TraffMeas' column

MATE-9927 BGP peer not sourcing all demands

MATE-9935 License install problems on Mac

MATE-9944 MATE stops when duplicating sites or duplicating nodes

MATE-9986 License expiration warning is going out to stdout, rather than to stderr

MATE-10025 Cannot insert loose hop in a named path

MATE-10028 Worst-Case Traffic view not available after creating growth plans and running Simulation Analysis on the plan in the process

MATE-10029 Failing a primary external endpoint member does not fail over to the other external endpoint member

MATE-10033 Unable to edit external endpoints properly

MATE-10060 Visualization issues when there are many parallel interfaces between sites

MATE-10065 insert_multicast_demands creates demands directly to ASN nodes instead of external AS

MATE-10069 When deleting an inactive circuit, the inactive (black cross) icon does not disappear

MATE-10086 create_growth_plans -create-plan-from DemandGroupingTrafficTable results

in demands with zero traffic unless the initial plan starts with traffic

MATE-10129 Duplicate interface names can be created through the GUI

MATE-10136 metric_opt not handling anycast demands

MATE-10142 auth_try_communities does not accept a .pln file

MATE-10185 build_model not working properly

MATE-10206 LSP simulation diagnostics are incomplete

MATE-10222 Improper Level 1 and Level 2 routing

MATE-10232 Cannot bulk-edit port circuit settings

MATE-10235 Service Class section of Manage QoS dialog box continues to show service-class-to-queue mapping after removing queues

MATE Design Archive

Key Summary

MATE-8776 embedded_web_server -help updates needed

MATE-8999 Traffic statistics not displayed on interfaces for WC Util and Failure Impact analysis

MATE-9672 Colors stored in plan file are not displayed in the weathermap

MATE-9752 Selecting a plan file from the calendar or entering a new time to select a plan file does not work in Chrome

MATE-10010 Incorrect tooltip displayed for the "YY/MM/DD HH:MM" text field

MATE-10091 Typo in error message when entering an invalid date



MATE Live

Key Summary

MATE-8029 MATE Live is hanging

MATE-8352 embedded_web_server leaves /data/archive.db directory and file in whichever directory

the command is run

MATE-8356 Script error when opening all graphs in Explore

MATE-9355 Show Only feature in Explore does not work when Interface Type is selected

MATE-9480 Report using a user-defined property that was defined using a % (modulus) in its expression does not work

MATE-9537 Sorting numbers using scientific notation does not work

MATE-9572 Explore performance is inadequate

MATE-9592 Show a "no data" message, rather than an empty graph, when no data is found

MATE-9595 Problems with ml_update without arguments and with incorrect arguments

MATE-9599 Ad hoc report produces no data when using "Destination->All" filter for demands

MATE-9666 Stacked graphs not rendering correctly

MATE-9678 Explore graphs do not match data in the tables

MATE-9679 Scheduled reports not maintaining day of month

MATE-9695 Do not allow an upgrade on the same database using ml_update more than once

MATE-9736 Unable to schedule reports

MATE-9740 "Invalid file format. Unexpected symbol" error occurs after clicking "E" button on Map page

MATE-9815 ml_insert_plan fails to insert a plan file

MATE-9826 Ad hoc report on SNMPError for last 1 day runs on all data

MATE-9830 Reports are hanging

MATE-9833 Medium- and High-risk thresholds for LAG Imbalance health report needs to be inclusive of 0

MATE-9842 Creating a new LAG Imbalance report shows the report type as unknown in My Reports

MATE-9844 Frequent messages about an unresponsive or busy script in Map

MATE-9846 Cannot use the Map's calendar to change timestamps

MATE-9861 No TraffIn data available

MATE-9873 Javascript charting performance improvements

MATE-9902 Typo in threshold error message when creating a report

MATE-9913 Unable to zoom in on interface graphs from the Map page

MATE-10202 Scheduled weekly reports are not running

MATE-10303 Weathermap does not display inactive links

MATE-10311 Error occurring upon logging into MATE Live and being redirected to My Reports page

MATE Collector

Key Summary

MATE-9297 parse_configs not properly processing an interface on IOS

MATE-9340 sam_getplan -num-logged-traff-level option name needs to change to -logged-

measwin-length

MATE-9636 parse_configs not properly discovering hostname on IOS-XR

MATE-9663 Juniper interfaces not being discovered as TE Enabled

MATE-9676 Running parse_configs with post-snmp_find_interfaces plan file as input causes error



Key Summary

MATE-9703 snmp_find_rsvp is setting FRR Link Protect status to "T" for all LSPs

MATE-9712 Do not scale demands in flow_get if associated interface traffic is NA

MATE-9737 find_bgp and login_find_bgp_ext are not parsing BGP next-hop correctly

MATE-9769 find_bgp is ignoring devices with custom net_access.txt file

MATE-9862 parse_configs NetIntInterfaces failure

MATE-9864 parse_configs should not process the same node again when contained in more than one file

MATE-9899 sam_getplan issuing an "Encountered new Port class" error when it is not applicable

MATE-9943 sam_getplan gives error message on -logged-measwin-length when it should not

MATE-9947 sam_getplan VPN node discovery is incomplete when using two or more -vpn-types

MATE-9952 sam_getplan: -vpn-types VLL:Epipe discovers more than EPIPE VPNs

MATE-9971 snmp_poll causes seg faults on full discovery

MATE-9977 parse_configs exception error when parsing configuration files

MATE-10021 login_find_igp_db failure on Huawei

MATE-10030 login_find_multicast_ext and login_poll_multicast_ext are causing a core

dump

MATE-10041 IS-IS Level discovery is not working properly

MATE-10051 flow_get returns exception error

MATE-10066 IS-IS Level 1-2 interfaces not discovered properly

MATE-10093 login_find_multicast_ext post processing performance issues

MATE-10119 sam_getplan performance issues when downloading InterfaceAdditionalStatsRecord object

MATE-10123 snmp_find_interfaces producing incorrect plan file

MATE-10127 Throwing out polling data that is over 100% of the interface capacity even when data is valid

MATE-10137 parse_configs "dropped with enabling conditions not met' error

MATE-10139 parse_configs gives incorrect IGP metric values

MATE-10264 parse_configs does not work on Windows

MATE-10273 parse_configs does not discover LSP setup bandwidth on IOS

MATE-10280 jcmdlinelib not being loaded from various tools

MATE-10328 sam_getplan not importing network interfaces properly when they have the same display name

under the same network element

Known Limitations

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



Windows Memory

The Windows version of MATE is a 32-bit application, which means that it cannot use more than 4 GB of

memory even if that is available in the system. The implication is that tasks requiring large amounts of

memory, such as simulation and optimization of large networks, might fail on Windows even if they

succeed on other platforms.

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

start than what is available. The symptom will be 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

/etc/hosts Requirements in Unix Systems

Various Web services require the server's hostname to be present in the /etc/hosts file. This is

standard configuration practice, but some systems do not have it. Both the unqualified and fully-qualified

hostnames must be present. Make sure that the following line is present in /etc/hosts.

<server IP address> <hostname> <fully-qualified hostname>

Example: 192.168.0.15 mate-server mate-server.my.company.com

IPv6 Network Topology

MATE Collector does not populate IPv6 interface addresses or discover parallel interfaces in the plan file

after parsing the IOS XR IS-IS link-state database. This information is only available when IS-IS IPv6

Traffic Engineering extensions are supported by the platform and are enabled.

Subsequent SNMP tools will collect this information and populate the <Interfaces> table.

Flow Collection

Flow collection and integration tools assume BGP next-hop-self is configured on border routers

exporting flows to properly identify the egress interface.

Juniper ERX Support

The parse_configs tool does not support the Juniper ERX, and SNMP data collection is limited to

relevant standard MIBs.

sam_getplan Does Not Populate NetInt* Tables

The sam_getplan tool does not populate NetInt* tables, and therefore cannot be used to supply data for

use in MATE Live.



Documentation

The MATE Integration and Development Guide includes an appendix of imported Help output, which

includes the following issues.

o The Help output from flow_manage, flow_get, and all MATE Live CLI tools are not imported.

o The sam_get_lsp Help is listed, although it is no longer supported.

o Does not list the new -lic-product option for mate. Please see the Schema Changes section.

o The login_find_igp_db Help lists -lic-product as an option, although it is not.

o The sam_getplan -num-logged-measwin Help shows a default as 2. This was changed to 1.

Please see the Schema Changes section.

The MATE Installation Guide license information does not identify the new -lic-product option.

Please see the Schema Changes section.

The Server Setup and Advanced MATE Collector Configuration Guide, Flow Collector chapter is

missing a new flow_get -address-family option. Please see the above Schema Changes section.

MATE Live information regarding snapshots, the datastore, and CLI tools was removed. Please ask

your support representative for information.

Cariden Technologies is now part of Cisco Systems, Inc.

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

August 2013, Version: 1

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

MATE Release 5 - Cisco€¦ · SAM Certification MATE 5.4 was certified with Alcatel-Lucent’s...

Documents

Transcript of MATE Release 5 - Cisco€¦ · SAM Certification MATE 5.4 was certified with Alcatel-Lucent’s...