Introduction
This document describes the bugs resolved in Cisco WAN Automation Engine (Cisco WAE) Release 7.1.3.
Cisco WAN Automation Engine (WAE) provides the tools to create and maintain a model of the current network through the continual monitoring and analysis of the network and the traffic demands that are placed on it. This network model contains all relevant information about a network at a given time, including topology, configuration, and traffic information. You can use this information as a basis for analyzing the impact on the network due to changes in traffic demands, paths, node and link failures, network optimizations, or other changes.
The Cisco WAE platform is an open, programmable framework that interconnects software modules, communicates with the network, and provides APIs to interface with external applications.
This document contains the following topics:
What’s New in Cisco WAE 7.1.3
The following features are new in Cisco WAE 7.1.3.
WAE services have to be managed using Supervisor. Install and run Supervisor before starting WAE.
For more information, see Cisco WAE 7.1.3 Installation Guide.
A new Cisco Evolved Programmable Network Manager (Cisco EPN Manager) agent is added to support the collection of optical topology for Cisco Network Convergence System (NCS) 2000 series, Release 10.9. This agent also receives notifications from Cisco EPN Manager version 2.2.2.1 when the status of links and circuits change and updates the network model accordingly. When using the Expert Mode, changes to the nodes, circuits, and so on can be seen in the agent-model tab from the following path: wae:wae/agents/optical-agent:optical-agents/optical-agent/<epnm_agent_name>.
Note |
If optical provisioning is not done through Cisco EPN Manager, notifications are not received. |
For more information, see "Network Model Configuration—Cisco WAE UI" chapter in the Cisco WAE 7.1.3 User Guide.
LSP collection (lsp-config-nimo) configuration is updated to integrate with NSO using the NETCONF API.
For more information, see "Network Interface Modules (NIMOs)" chapter ("Segment Routing Traffic Matrix Collection" topic) in the Cisco WAE 7.1.3 User Guide
Segment Routing (SR) Traffic Collection (sr-traffic-matrix-nimo) discovers SR traffic. This NIMO enables the generation of demands between external interfaces of a network from collected telemetry data.
For more information, see:
-
"Network Interface Modules (NIMOs)" chapter ("Segment Routing Traffic Matrix Collection" topic) in the Cisco WAE 7.1.3 User Guide
-
"Telemetry Configuration" chapter in the Cisco WAE 7.1.3 User Guide
The DARE aging processor is enhanced to maintain an in memory map for aged elements instead of doing the CDB scan every time the aging scheduler runs.
For more information, see "Administration" chapter ("Configure Aging" topic) in the Cisco WAE 7.1.3 User Guide.
XATP functionality is moved into the two NIMOs that process data from XTC - topo-bgpls-xtc-nimo
and lsp-pcep-xtc-nimo
, removing the dependency on WMD.
The following NIMOs are enhanced to support native storage format:
-
Traffic Demand NIMO
-
Layout NIMO
-
Inventory NIMO
-
Netflow NIMO
-
SRTM NIMO
For more information, see "Network Interface Modules (NIMOs)" chapter in the Cisco WAE 7.1.3 User Guide.
Multicast NIMO collects multicast flow data from a given network. It is a collection of the following NIMOs:
-
snmp-find-multicast-nimo—Collects multicast data for multicast flows using SNMP.
-
snmp-poll-multicast-nimo—Collects traffic data rate for multicast flows using SNMP.
-
login-find-multicast-nimo—Logs in to router to fetch or parse multicast flow data.
-
login-poll-multicast-nimo—Logs in to router to get multicast traffic rate
For more information, see "Network Interface Modules (NIMOs)" chapter in the Cisco WAE 7.1.3 User Guide.
port-cfg-parse-nimo
is now renamed to topo-cfg-parse-nimo
and the support to read topology from parse configs is added.
For more information, see "Network Interface Modules (NIMOs)" chapter ("Port, LSP, SRLG, and VPN Collection Using Configuration Parsing" topic) in the Cisco WAE 7.1.3 User Guide.
A new aggregator, SAgE (Simple Aggregation Engine), is introduced to receive patches from DARE and NIMOs depending on DARE and aggregate these changes.
For more information, see "Overview" chapter ("Cisco WAE Architecture" topic) in the Cisco WAE 7.1.3 User Guide.
inter-as-nimo
is introduced to enable merging of plan files from different AS and resolve conflicts.
For more information, see "Network Interface Modules (NIMOs)" chapter ("Merge AS Plan Files" topic) in the Cisco WAE 7.1.3 User Guide.
Cisco WAE 7.1.3 is enahanced with various UI changes.
For more information, see "Network Model Configuration—CiscoWAE UI" chapter in the Cisco WAE 7.1.3 User Guide
The status dashboard in WAE helps to identify the processes that cause system leaks or processes that completely use the resources. System health, WAE health, status of NIMO actions and agent actions are captured in the dashboard.
For more information, see "Administration" chapter ("Status Dashboard" section) in the Cisco WAE 7.1.3 User Guide.
WAE 7.1.3 now supports building network model from multiple XTC.
Traffic Poller tuning is enhanced for better computing.
For more information, see "Network Interface Modules (NIMOs)" chapter ("Traffic Collection" topic) in the Cisco WAE 7.1.3 User Guide
Users can now cleanup Map cache based on configurable attribute in config.xml
. By default, the cache for Map display is cleaned up every 3 days. To clean up the cache more frequently, you can configure
as follows:
-
Stop the Cisco WAE web server.
-
Log in to your local server and open
config.xml
file for editing. The default location is/opt/cariden/etc/config/config.xml
. Your location might differ if you chose a different installation directory. -
In the
config.xml
file, locate the section -<application name="Map">
-
Under
<application name="Map">
, do one of the following, depending on whether you are upgrading or performing a fresh installation:-
If you are upgrading from an earlier release, add the following line:
<property name="Map.UiCacheTTL" type="String"><value> <unit></property>
-
If you are performing a fresh installation, edit the existing line:
<property name="Map.UiCacheTTL " type="String"><value> <unit></property>
where
<value>
is a float (a floating-point number, or a number that has a decimal place).<unit>
is either hour, or day. The unit can be singular or plural and is not case-sensitive. For example, hour can be expressed in all of the following ways: hour, Hour, Hours, HOURS.For example, to purge time-series data that is older than 1 hour, enter:
<property name="Map.UiCacheTTL" type="String">1 hour</property>
-
-
Save your changes and close the
config.xml
file. -
Restart the Cisco WAE web server.
The Capacity Planning Optimization tool controls how L1 Circuits and their corresponding paths are created. However, it automatically mimics the L1 Circuit characteristics of existing parallel L1 Circuits when upgrading capacity.
To enhance the Capacity Planning Optimization tool to handle different scenarios, the following CLI options are introduced:
-
-match-existing-l1-circuits
: This is a new option that is added. If set to T, when existing L3 adjacencies are upgraded (by adding parallel Port Circuits or L3 Circuits), corresponding L1 Circuits are created based on associated L1 Circuits of parallel Port Circuits or L3 Circuits. This includes replicating primary and secondary paths with respect to their Standby property as well as their associated Actual L1 Circuit Path Hops and L1 Circuit Path Hops. Default is F. -
-create-l1-circuits
: This is a modified option. If F (default), do not create L1 circuits for new port circuits. If T, create L1 circuits for new port circuits. Ifmatch-existing-l1-circuits
is set to T, this option is only considered for new adjacencies. -
-primary-l1-circuit-paths
: This is a modified option. If F (default), primary L1 circuit paths are dynamically routed. If T, assign L1 circuit path hops to new primary L1 circuit paths to match the explicitly specified routes of existing parallel L1 circuits. Ignored if-create-l1-circuits
is F or ifmatch-existing-l1-circuits
is set to T. -
-secondary-l1-circuit-paths
: If F (default), do not create secondary non-standby L1 circuit paths. If T, create secondary non-standby L1 circuit paths. Ignored if-create-l1-circuits
is F. Ifmatch-existing-l1-circuits
is set to T, this option is only considered for new adjacencies.
Cisco WAE Design GUI is modified as follows:
Do not create L1 circuits, Basic L1 Circuit Creation, and Advanced L1 Circuit Creation.
tab has new options -The load-plan CLI command (wae/components/load-plan) to load plan files can handle only plan files which have the Network
table as defined in schema and the Title
row. However, value for the title (network name) is optional.
Upgrade to Cisco WAE 7.1.3
This procedure outlines the steps necessary to upgrade to Cisco WAE 7.1.3.
Before you begin
-
From Cisco WAE 7.1.3, the WAE services are managed using supervisor. Install and configure supervisor. See Install and Configure Supervisor
-
Download the Cisco WAE 7.1.3 software package from Cisco Download Software site.
-
Make sure Java-8 is installed on the system and
JAVA_HOME
environment variable is pointing to jdk-1.8.
Procedure
Step 1 |
Stop WAE if running. |
||
Step 2 |
Change permission of the install file using the command:
|
||
Step 3 |
Run the installer specifying the target directory.
|
||
Step 4 |
Setup environment and create a runtime directory specifying the path.
|
||
Step 5 |
You are prompted to set the Cisco WAE admin password.
|
||
Step 6 |
After installing and setting up wae (i.e. after running wae-setup), add WAE config to supervisor and update supervisor
|
||
Step 7 |
Start WAE process
|
||
Step 8 |
Check status of WAE process
|
Install and Configure Supervisor
For more information about supervisor, read http://supervisord.org/installing.html.
Procedure
Step 1 |
Install supervisor and verify.
|
||
Step 2 |
Create directories with write permissions for the OS user running WAE.
|
||
Step 3 |
Update supervisor configuration to not run as a root user; point the pid file to Open Remove Modify the line
to
|
||
Step 4 |
Create a soft link from to the |
||
Step 5 |
After installing and setting up wae (i.e. after running wae-setup), add WAE config to supervisor and update supervisor
|
||
Step 6 |
Start Supervisor.
|
||
Step 7 |
Enable supervisor to start during system startup.
|
Supported Node Versions
The following table lists the supported node versions for Cisco WAE 7.1.3.
Feature |
Product |
Tested with version |
Notes |
---|---|---|---|
SRTM |
IOS-XR |
6.5.1 |
|
Netconf LSP |
IOS-XR |
6.5.1 |
NED Version : ncs-4.7.1-cisco-iosxr-7.6 |
IOS-XR |
15.3 |
NED Version : ncs-4.7.1-cisco-ios-6.7 |
|
Juniper Junos Mx960 |
18.1R1.9 |
NED Version: ncs-4.7.1-juniper-junos-4.1 |
|
RT Apps, Multi XTC, Reactive polling. |
IOS-XR |
6.5.1 |
|
Multilayer |
NCS2K |
10.7,10.8,10.9 |
|
EPNM |
2.2.1.1 |
Documentation
To find descriptions of all related Cisco WAE documentation, see the Cisco WAE 7.1.3 Documentation Roadmap.
Note |
We sometimes update the documentation after original publication. Therefore, you should always review the documentation on Cisco.com for any updates. |
Bugs
Resolved Bugs
The following are descriptions of the resolved bugs in Cisco WAE Release 7.1.3:
Bug ID |
Description |
---|---|
CSCvn17584 |
Error on running topo-vpn-nimo. |
CSCvn18171 |
DARE not updating WMD model when LSP is deleted. |
CSCvn26138 |
Unable to run Plan-Archive in WAE 7.1.2. |
CSCvn30441 |
WAE 7.1.1 unable to run topo-bgpls-xtc-nimo and run-xtc-collection due to missing element error. |
CSCvn51907 |
actual_path hops are not available in DARE Aggregator. |
CSCvn62567 |
Wrong Spectral Width ID causing circuit status "unrouted" in WAE Design L1 Circuit Paths. |
CSCvn88920 |
WAE 7.1.2 fails to create new plan files. |
CSCvo01833 |
Wrong number of LSPs reported in model. |
CSCvo01841 |
Unreliable mechanism to produce statistics in a native-format file. |
CSCvo11400 |
WMD shows wrong path for LSPs (RSVP-TE), where as lsp-snmp-nimo, aggregator nimos discovers path correctly. |
CSCvo22803 |
WAE keeps filing /tmp with files. |
CSCvo45650 |
Multiple node perf data issues reported in topo-igp-nimo. |
CSCvm34065 |
DARE not processing changes, displays 'Queue full' in error. |
CSCvn00892 |
login_find_igp_db output sets nodes::AvoidTransit value to "Strict" . |
CSCvn04684 |
cfg-parse agent should ignore hash (#) in description for Huawei. |
CSCvn06202 |
Simulation of Multicast Demands is inconsistent. |
CSCvn07232 |
LSP parse config nimo or parse_config fucntion is unable to parse configs with space in hostname. |
CSCvn12341 |
Capacity Planning Opt Tool Not Creating L1 Circuits in Some Cases |
CSCvn21122 |
WAE 7.1.2 Site lat/long values are missing in DARE. |
CSCvn22430 |
Capacity Optimization Planning does not copy L1 circuit hops. |
CSCvn26803 |
cfg-parse agent incorrectly parses LSP paths on Huawei devices. |
CSCvn28694 |
WAE daemon crashing without notice. |
CSCvn30828 |
Optical NIMO collection not collecting Site-names |
CSCvn56924 |
duplicate ref error thrown when node fails collection. |
CSCvn66222 |
WAE Design L1 Links table displays 'na' instead of Metric for a very short fiber span < 1 km. |
CSCvn75156 |
Executing run-snmp-traffic-poller logs Warning [20]: auth.enc not found under traffic_de-poller.log. |
CSCvn78097 |
topo-bgpls-xtc-nimo not discovering interfaces for large network (500 devices). |
CSCvn79097 |
Traffic NIMO stops inserting traffic in model. |
CSCvn89056 |
WAE live 7.1.2 peering panel from the WAE Live Settings not working. |
CSCvn94403 |
Optical NIMO fails to import circuits with user properties. |
CSCvo04221 |
WAE 7.1.2 design does not populate LAG member port descriptions collected by the topo-igp-nimo. |
CSCvo26901 |
Demand Flow uses Level 2 links during Failure simulation. |
CSCvo32368 |
Windows mate-Design client crashes when you Hover on the "Initializers" menu. |
CSCvn39867 |
WAE does see Juniper loose bypass LSP. |
CSCvo16665 |
WAE GUI has no support to pump SNMP traffic to traffic poller network. |
Using the Cisco Bug Search Tool
You can use the Cisco Bug Search Tool to search for a specific bug or to search for all bugs in a release.
Procedure
Step 1 |
Go to the http://tools.cisco.com/bugsearch. |
||
Step 2 |
Enter your registered Cisco.com username and password, and click Log In. The Bug Search page opens.
|
||
Step 3 |
Use any of these options to search for bugs, and then press Enter (Return) to initiate the search:
|
||
Step 4 |
When the search results are displayed, use the filter tools to narrow the results. You can filter the bugs by status, severity, and so on. To export the results to a spreadsheet, click Export Results to Excel. |
Known Limitations
This section describes known limitations and restrictions for Cisco WAE:
WAE System
License Check Failures on Newer Linux Distributions
Some newer Linux distributions use a new way (using biosdevname) of naming hardware devices, including network interfaces. This causes some software that depends on the traditional naming (for example, eth0 , eth1 ) to fail on license checks.
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 to use ifconfig to verify that the NICs are named eth0 (or eth1 , ...) instead of the biosdevname names (such as p34p1).
NIMO Consolidation
The aggregator uses DARE to consolidate NIMOs into one network model. If you update the topo-igp-nimo node-filter configuration, or if a node goes down after running the initial DARE configuration, you must do the following:
-
Update the topo-igp-nimo exclusion or inclusion list.
-
Run collection on the topo-igp-nimo.
-
Run the WAE CLI tool to resync DARE with the updated NIMO node information:
wae@wae# wae components aggregators aggregator <aggregator_network_name> resync aggregator net
WAE Collection
-
LDP data collection can only be performed by executing CLI tools using the external-executable-nimo.
-
NetFlow collection is not supported on Alcatel-Lucent devices.
-
Due to vendor MIB limitations, WAE cannot represent QoS traffic on interfaces that have more than one VLAN configured. If a network contains such interfaces, their queue traffic statistics are omitted from the collection. The total traffic on these interfaces is still measured. As a result, demands for every class of service estimated through Demand Deduction are less accurate. Estimates of traffic totals over all classes of services, however, are not affected.
-
Collection of interface egress shaping rate for Alcatel-Lucent devices does not support LAG interfaces.
-
Juniper MIBs do not support P2MP LSPs.
-
WAE cannot associate a GRE tunnel with the physical interface it uses to reach the tunnel destination because the IP-Tunnel MIB lacks this information.
-
For Juniper routers, the signaled standby LSP option is not available from the standard MPLS-TE MIB. Only the active path option name is collected.
-
For Cisco IOS XR routers:
-
IGP topology collected through topo-igp-nimo module:
-
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 Cisco IOS XR supports IS-IS IPv6 TE extensions.
-
-
MAC accounting is not supported (although you can collect MAC traffic through an external NIMO).
-
The lsp-snmp-nimo module does not set the Standby value in the <LSPPaths> table for signaled backup paths or collect named affinities configured with affinity-maps.
-
-
BGP peers:
-
The topo-bgp-nimo module does not build BGP pseudo-nodes among internal ASNs.
-
The topo-bgp-nimo module does not collect BGP peers under PE-CE VRFs.
-
-
TE Extended Admin Groups (EAGs), also known as extended affinities, are only supported from Juniper and parse_configs.
-
There is no support for building port circuits for LAG members that are not within the same IGP (inter-AS circuits).
-
It is not possible to distinguish between physically connected and unconnected LAG ports that are down for LAG port matching.
-
With segment routing, concurrent RSVP-TE and SR-TE paths are not supported on the same LSP.
WAE Multilayer Collection
-
The optical plug-in is supported on Oracle JRE 1.8 but not on OpenJDK JRE. Oracle JRE 1.8 is not packaged with Cisco WAE. You can download Oracle JRE 1.8 from Oracle’s website.
If you are using a JRE other than Oracle JRE 1.8 for other Java programs and you want to use the optical plug-in, you must download Oracle JRE 1.8 and add the following lines to the beginning of the <WAE_installation_directory> /packages/optical-ctc-plugin/run.sh file:
#!/bin/bash
export JAVA_HOME=<path_to_JRE_installation_directory>
export PATH=$JAVA_HOME/bin:$PATH
-
Multilayer collection for Cisco devices is supported only on the following platforms:
-
Cisco Network Convergence System (NCS) 2000 platforms running version 10.61, 10.7, and 10.8 for L1 devices when using the CTC optical agent. NCS 2000 platforms running version 10.9 is supported when using the Cisco Evolved Programmable Network Manager optical agent (EPN-M optical agent).
-
Cisco Aggregation Services Routers (ASR) 9000, Cisco Carrier Routing System (CRS), and Cisco NCS 5500 platforms running IOS-XR for L3 devices.
-
-
Multilayer collection is limited to the collection of unprotected circuits.
-
Collection of WSON and SSON circuits are supported.
-
Collection of non-WSON circuits is only supported when using the EPN-M optical agent. It is not supported when using the CTC optical agent.
-
L3-L1 mapping by LMP is supported only if the controller interface name is the same as the actual L3 interface name or of the form "dwdmx/x/x/x" where the "x/x/x/x" subscript matches that of the corresponding L3 interface.
-
Central Frequency ID mapping is currently supported only for circuit paths but not for path hops.
WAE Design
-
macOS Sierra 10.12 and later implements an additional security measure for applications that are not distributed through the App Store; this includes WAE Design.
By default, WAE Design is in a quarantine state as shown by the following command on a terminal:
xattr wae_design.app
The command returns the following output for a quarantined application:
com.apple.quarantine
As a workaround, remove WAE Design from quarantine by entering the following command in the directory where WAE Design is installed:
xattr -r -d com.apple.quarantine wae_design.app
You can now run WAE Design from macOS Sierra 10.12 and later.
-
If you are using macOS X 10.12 or later with the WAE Design GUI and the Parse Configs tool (File > Get Plan from > Configs), add the following lines in ~/.bash_profile:
launchctl setenv JAVA_HOME `/usr/libexec/java_home -v 1.8` export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
FlexLM License Server
You cannot run the floating license server on a setup (Linux VM or actual host) that uses bonded virtual interfaces (that is, a setup with multiple interfaces that have the same MAC address but different IP addresses within a VM). If the WAE Design client tries to check out a license from a setup that uses bonded virtual interfaces, the license checkout fails with the error "No license found."
As a workaround, run the floating license server in a standard Linux VM or host.
WAE Coordinated Maintenance
Cisco WAE Coordinated Maintenance 1.3.1 supports the WAE archive only when the data source is CDB.
Filing a Cisco WAE Bug
While filing CDETS for Cisco WAE, make sure the following information is captured:
-
WAE configuration: supervisord configuration, aggregator configuration and the nimo configuration of concerned network and its source-network, if any.
-
<run-dir>/logs/ directory
-
Plan file(s) for the network(s) of concern
-
<run-dir>/data/stats/
for system stability and resource usage related issues -
<run-dir>/work/dare/
for aggregation related issues. -
<run-dir>/data/networks/*.db
for issues related to networks configured as ‘native’ and the corresponding aggregator (final-network). -
CDB dump of the networks of concern for networks of ‘yang’ format (‘yang’ is the default storage-format).
-
Configuration corresponding to the component of concern. Eg: WMD, archive etc.
-
For collection issues, record file(s) if the nimo supports record-playback.
-
~/.cariden/logs/
for designapid related issues.
Accessibility Features
For a list of accessibility features in Cisco WAE, visit https://www.cisco.com/c/en/us/about/accessibility/voluntary-product-accessibility-templates.html (VPAT) website, or contact accessibility@cisco.com.
All product documents except for images, graphics, and some charts are accessible. If you would like to receive the product documentation in audio format, braille, or large print, contact accessibility@cisco.com.