Release Notes

Learn about new features and enhancements, fixed issues, and known issues in Oracle Communications Unified Assurance.

6.1.0.0.0 - April 10, 2025

Release 6.1.0.0.0 includes new features, enhancements, bug fixes, and documentation updates.

New Features in 6.1.0.0.0

This section describes the new features for release 6.1.0.0.0.

Migration to OpenSearch and Observability Analytics

This release replaces Elasticsearch with OpenSearch as the Historical database for analytics, including Event Analytics (now called Observability Analytics), Flow Analytics, and Log Analytics. OpenSearch is an open source program with industry-wide active support and updates. It provides advanced machine learning capabilities for anomaly detection and supports flexible use and licensing models, including clustering.

Other related components that have been replaced include:

New installations of version 6.1.0.0.0 automatically include OpenSearch and all required supporting framework. You use AnalyticsWizard to set up your OpenSearch cluster, and the cluster can consist of multiple nodes.

Because licensing for Elasticsearch will no longer be available, all customers must move to version 6.1 and migrate to OpenSearch before March 31, 2026. On this date, Elasticsearch license keys will expire. Elasticsearch will stop accepting new data, and you will lose access to existing unmigrated data.

If you are using an earlier version of Unified Assurance, including versions 4, 5, and 6.0.X, you must upgrade or update to 6.1 on Linux 8. This may involve several phases, including an operating system upgrade. See Supported Migration Paths in Unified Assurance Migration Guide and About Upgrading Unified Assurance in Unified Assurance Installation Guide for full details.

After updating to version 6.1.0.0.0, you migrate to OpenSearch as follows:

See About Migration in Unified Assurance Migration Guide for information about migration.

Note the following:

Migration from Redis to Coherence

This release replaces Redis with Oracle Coherence as the in-memory data cache for microservices. You do not need to perform any migration tasks other than undeploying the Redis microservice and deploying the new Coherence microservices.

Coherence provides thread-safe, distributed caching that supports scalability, high availability, database sharding, SSL security, and parallel query processing. Coherence runs as a cluster, automatically managed by Coherence Operator.

Note:

Unlike Redis, Coherence does not support full text search in cache lookups in FCOM overrides. Instead, you use CohQL queries to search in existing indices.

For more information about the Coherence microservices in Unified Assurance, see the following topics in Unified Assurance Implementation Guide:

For more information about Coherence, see the following resources:

Universal Topology Enhancements

This release includes the following enhancements and fixes to Universal Topology:

Vision Enhancements

This release introduces the following enhancements for Vision:

Externally Requested Enhancements in 6.1.0.0.0

This release includes the externally requested enhancements described in the following table.

Bug Number SR Number Description
35402279 3-33093674081
3-37477909751
When searching for devices in the Devices UI, you can choose to show all properties under devices, or only show properties that match the search terms by selecting or deselecting the Show All Properties option beside the search bar. By default, this option is deselected. For example, if you deselect the new option and search for an IP address, the only property that appears under the matching device is IP Address. If you select the new option, all properties appear, such as meta tags, DNS Name, and so on. This lets you condense the list more easily and only see the properties relevant to your search.
35737649
35667938
3-34047984151 You can now create multiple instances of each external authentication type (SAML, Active Directory, and LDAP). These authentication types also support externally-authenticated transient users (users who do not have corresponding Unified Assurance accounts). See Configuring External Authentication Types in Unified Assurance Security Guide.
36500544 3-36402062318 You can now create custom functions that apply custom behavior when you interact with to Universal Topology nodes and edges. See Universal Topology Enhancements and Overriding a User Interface and Overriding Universal Topology Graphs in Unified Assurance Developer's Guide.
36506183 3-36402062238 When navigating a topology graph with a geographic layout, you can hold the Shift key while clicking and dragging the mouse to select an area to zoom in on. See Universal Topology User's Guide in Unified Assurance Implementation Guide for information.
36656911 3-36788994837 Discovery and monitoring for Frequentis devices is now supported. To accommodate non-unique interface names, the SNMP Poller sets the interface name by combining the hwInterfaceName, hwInterfaceId, and hwInterfaceModuleId fields. It also maps the integer values from the HwInterfaceType and HwModuleType fields to strings. See About Supporting Frequentis Devices in Unified Assurance Device Support Overview for more information.
36829892 3-37368182581 The CORBA Collector microservice now consumes alarms from the Huawei NCE platform. To support this:
  • You can set the port and Object Request Broker (ORB) host as required for your environment when deploying the microservice. Previously, Kubernetes assigned these dynamically.
  • FCOM Processor core rules have been enhanced.
See CORBA Collector in Unified Assurance Implementation Guide for more information.
36294305 3-39750195051
3-35714761491
Performance was improved when querying for vertexes. Now, when loading vertices, the UI includes vertex type in the call to speed up response time.
36778083 3-37208528191 The Trap Collector microservice and Event Trap Aggregator server were only loading SNMP V3 profiles during startup or service configuration reloads. Now, it loads them periodically at the interval set in the PROFILE_CACHE_TTL configuration parameter for the microservice, or the CheckTime parameter for the service.
35934116 3-34615908401
3-35020570811
All Store and Forward messages were logged at the WARN level, resulting in excessive warnings after every event. Now, only transitioning into and out of Store and Forward mode is logged at the WARN level, and other Store and Forward messages are logged at the INFO level.
36741116 3-37087883773 When configuring device configuration actions, the fields could only be 45 characters long. Now they can be up to 255 characters long.
36754522 3-37141467251 Grafana could only support a single Metrics database, so was not supporting failover scenarios in redundant environments. This issue has been fixed. Now, Apache Web Server provides load balancing to automatically fail over to the secondary Metrics database if the primary is not available.
36974811 3-37766399941 The RCA Availability Engine microservice now includes interface status in the message it sends to the FCOM processor. The status for the current and last poll period is sent.
36565777 3-36251161331 Some JavaScript modules were triggering false security vulnerability warnings. Unused ones were removed.
34879327 3-31492333348 In event lists, the paging limit menu was not reflecting the actual number of events being displayed, or including the default option set in the user or user group preferences. This issue has been fixed.
36631341 3-36790337961
3-37741771461
3-36790337980
When adding default event fields using the UI, you could not set a default float value for decimal fields. It was automatically changing decimals to integers. This issue has been fixed.
35555829 3-33545027441 Previously, if you were not already logged in and attempted to access a link to a Grafana, Kibana, or Vision UI, you were redirected to the homepage after logging in rather than the link you followed. This issue has been fixed.
35285497 3-32740279551 Grafana dashboards could not be embedded within Unified Assurance dashboards. This issue has been fixed.
35379138 3-33025140831 Previously, TrapReplay could only send SNMP traps to the default port (162). Now you can set the port when you run the application using the -p or --Port option.
36797106 3-37290438041 In a previous release, the device zone ID column replaced device zone name column in the device catalog. This has been reverted in the device catalog and SNMP profiles UIs.
35345391 3-39678900481
3-34474845671
3-35600264697
3-32928993951
3-36295493481
Previously, events were synchronized to the Historical database without their corresponding journals. Now, journals are also synchronized. Journals also contain two new fields to describe the source (such as a user, event tool, mechanization, or ticket gateway) and the action that added the journal entry.
34606285 3-36605285681
3-35114040561
3-33475348111
2-10349687
Previously, there was no tool to automatically add new nodes to the Historical database clusters. Now, you can use AnalyticsWizard to set up clusters and add new nodes. when you run AnalyticsWizard on a new server with the Database.Historical role, it automatically detects whether a cluster already exists. If no cluster exists, AnalyticsWizard automatically sets one up. If a cluster already exists, AnalyticsWizard prompts you to add the server as a new node in the cluster and performs the required configurations. See Adding Nodes to the Historical Database Cluster in Unified Assurance Implementation Guide for more information.
36925358 3-37566616981 Previously, the Cisco Meraki Poller microservice collected both events and metrics from Cisco Meraki devices. Now, this functionality has been split among two microservices, the Cisco Meraki Poller and Cisco Meraki Event Collector. If you do not want to collect events, you only need to deploy the Cisco Meraki Poller. See Cisco Meraki Poller and Cisco Meraki Event Collector in Unified Assurance Implementation Guide for more information.
37018477 3-37907672101 The Cisco Meraki Poller microservice has been integrated into the Discovery microservice pipeline. You can now use the Discovery microservice to discover Cisco Meraki devices and the Cisco Meraki Event Collector microservice to collect events to be processed by the FCOM microservice. See Understanding the Event Pipeline and Understanding the Discovery Pipeline in Unified Assurance Concepts for more information about the pipelines.

Fixed Issues in 6.1.0.0.0

This table describes the externally reported bugs fixed in release 6.1.0.0.0

Bug Number SR Number Description
36550887 3-36317180311 When creating diagrams, you could add them to diagram groups that you did not have access to by setting the Initial Diagram Group field.
Now, this field is automatically set to the value of the RestrictiveDiagramGroupID property for your user group, and you can only select diagram groups that you have access to. If your user group does not have a restrictive diagram group set, Initial Diagram Group defaults to the Root diagram group. If you are a member of multiple subgroups, resulting in multiple restrictive diagram group properties applying, no default value is set for Initial Diagram Group, and you must select a group you have access to.
37173506 3-36331418539
3-33589592941
Users could not view dashboards when they were added as viewers to dashboards with Group Owner set to anything other than [Public to All Groups].
This issue has been fixed.
36729744 3-36927497681 If metric display instances had commas in their names, metric performance graphs failed to load.
This issue has been fixed.
36824759 3-37369717991 When creating or updating a vertex or edge in the Vertices or Edges UIs, float values (decimals) for properties such as longitude and latitude were being truncated to integers.
This issue has been fixed. However, values for properties with more than 16 decimal places will be rounded. To avoid this limit, set the data type to String when creating the property type. See Property Types, Edges, and Vertices in Unified Assurance User's Guide for information.
37111771 3-38147710201 The Event Canal and Event Sink microservices did not support using database shards other than the default first shard as input and output streams.
This issue has been fixed. Now you can include the shard ID in the input stream for Event Canal and output stream for Event Sink when deploying separate instances of the microservices for each shard. See Event Canal and Event Sink for information about deploying these microservices.
37383206 3-38973936131 In Universal Topology graphs, clicking and dragging to use rectangular selection was selecting all nodes instead of just the nodes in the rectangle.
This was an issue in a previous version of Ogma. Universal Topology now uses Ogma version 5.2.0, and the issue has been fixed. Because of the Ogma version upgrade, Oracle recommends testing any Universal Topology overrides you have implemented before moving your Unified Assurance 6.1 environment to production.
37314125 3-38807877337 When making API calls using the limit or start parameters independently, results were unpredictable. Now, you must use both parameters together. If you specify limit without also specifying start, start is automatically set to 0 to start at the first page of results. If you specify start without also specifying limit, start is ignored and all results are returned. These parameters are documented in REST API for Unified Assurance Core.
36082079 3-34700272841 Previously, because entity names had to be unique, you could not import devices with the same name in different zones as entities in Vision. Now, Vision supports entities with zone IDs. You can import devices with the same name if they are in two different zones, and the zone information is shown in the UI. The update process for 6.1 adds the default zone ID (1) to all existing devices in Vision.
See Post Update Tasks for Vision in Unified Assurance Installation Guide for information about updating the ID for existing entities and adding new devices with duplicate names to Vision.
35591693 3-33637576261
3-36610087881
There was a memory leak with the GetVertexInfo function of the Graph library. This issue has been fixed.
34921983 3-38137766091
3-30971280471
Performance of the Topology Gather Network Inventory application was improved. Now, it polls additional data to find the network associated with devices.
36631922 3-36641898661 Previously, cloning an SNMPv3 access profile resulted in the values of the Authorization Password and Privacy Password fields in the new profile to be set to *. This issue has been fixed and now the passwords in the original profile and new profile match.
35069638 3-32120091716
3-32466405408
Previously, upgrading from Assure1 version 5 to Oracle Communications Unified Assurance version 6 was failing with a FATAL error due to the presence of vendorWebCola-ui in the packages table. To fix this issue, vendorWebCola-ui has been removed from the packages table.
36512839 3-36414842311 Previously, Telegraf was attempting to access Docker file systems and was not able to parse MySQL global variables. This issue has been fixed.
36950960 3-37740974891 Previously, when conversions were disabled on an Event Display, the Display would not show the severity colors on the events. This issue has been fixed.
36695259 3-36980245438 Previously, threads using the Metric Transaction Poller were not sharing CustomHash and StorageHash variables. This issue has been fixed.
36431032 3-36092733681 While creating dashboards for availability of specific sets of devices, Device Group Availability % by Group was not expanding groups with 300 or more devices. This issue has been fixed.
35600533 3-33665302811 In graph configuration, unexpected results were returned when filtering the list of vertexes or edges using regex with the pipe (|) operator, or filtering vertex types using the Icon column. Regex filtering has been fixed, and the Vertex Types Icon column now shows an icon only. It does not include the file name and is not filterable or sortable.
37101408 3-36836655291 Running enrichment rules using ExecuteCypherQuery during Neo4j database failover was causing the application to crash. This issue has been fixed.
37085003 3-37449457871
3-39281217801
There was a memory leak in the Event Trap Aggregator service. This issue has been fixed.
36947082 3-37718017511 When creating diagrams, the Initial Diagram Group menu was empty. Now, this field is automatically set to the value of the RestrictiveDiagramGroupID property for your user group, or Root if your user group does not have a restrictive diagram group set.
36638056 3-36818606601 When viewing query results in the Query Tools UI, filtering and sorting was not working. This issue has been fixed.
36433319 3-36819989361 The Query Tools UI was not respecting the SELECT limit for Graph queries, attempting to return all results rather than paging them. This was resulting in the browser crashing with an out of memory error. This issue has been fixed. The limit is respected.
37069634 3-37990142861 Refreshing the Unified Assurance login page was redirecting users the Simple SAML PHP page. This issue has been fixed. Refreshing the login page keeps you on the login page.
36798774 3-37299413061 Database queries embedded in Database Grid dashboard panels were not working. This issue has been fixed.
35251154 3-33023981621 The TrapReplay application was unable to process events with special character strings. This issue has been fixed.
35869803 3-34452695801
3-36316785281
When the DNS or Custom Name for a device started with a number, the event list in the device overview would not load. This issue has been fixed.
36568839 3-36072281361
3-37683650031
A Config column was included for jobs and services in the Broker Control UIs. This issue has been fixed. The column no longer appears for jobs and services.
35469827 3-33309712421 In the Device Management UI, using the Load Device Meta Tags action was not working, generating a SQL exception. This issue has been fixed.
36915718 3-37074892931 The Metric Poller Discovery Agent was locking the entire Device table while performing discovery. This was resulting in various issues, including being able to update existing devices. This issue has been fixed.
36988562 3-37649673321 Graph panels accessed from the Network Details topology tool were not loading correctly for vertexes with a zone ID other than the default first zone. This issue has been fixed.
36647585 3-36818583541 The Trap Collector and SNMP Poller microservice were ignoring SNMP access profiles associated with device zone ID 0 (representing all zones). This issue has been fixed.
36537268 3-36492408219
3-38361685468
The Metric Standard Thresholding Engine was unable to fine global or packaged-scoped variables, and was failing to start. This issue has been fixed.
36142997 3-35231519111 In the Broker Control UI, clicking Reload Config for The Metric Standard Thresholding Engine was not reloading rules. This issue has been fixed.
37201307 3-38423457811 When using an SNMP v3 profile with SHA256 authentication protocol, incoming SNMP traps were not being decoded, resulting in no events being created. This has been fixed.
36891629 3-37550164571 When viewing the last page of an event list, if you deleted all events on the page, the event list was displaying page 0 of 0 and showing No Data. This issue has been fixed. The event list is refreshed to display events on the new last page.
35044027 3-32034835741
3-35001522381
Grafana email notifications were not rendering embedded images. This issue has been fixed.
36532589 N/A HTTP 400 and 500 error pages included custom messages which could potentially contain sensitive information. This issue has been fixed.
37196702 3-38340887601 When creating event filters, setting Viewers was not working as expected, and viewers not in the owner group for the filter were unable to see the filters. This issue has been fixed.
36891543 3-37525992201 When filtering the event list, if you added a new column, you could not immediately filter by that column. This issue has been fixed.
36830001 3-37383812091 When device names contained characters in angle brackets (< >), those characters were parsed as HTML and not appearing in the UI. This issue has been fixed.
37115923 3-37868336691
3-38576950621
There was a memory leak in the Generic SNMP Poller for Juniper devices. This issue has been fixed.
37306376 3-38808824021 Neo4j was reporting different metric measurements to Telegraf than previous versions. The Grafana Neo4j Dashboard has been updated to reflect this change.
35944885 3-36968978891
3-34677460991
The Servers UI was not showing any data while SetupWizard was running for additional servers in the environment. This issue has been fixed.
37018668 3-37579205370
3-38734470191
3-38686014481
The Event Trap Aggregator service was not choosing the correct SNMP V3 profile. This issue has been fixed.
36753916 3-37255526711 If you created a metrics collection but did not select metrics to add to it, it was created in the database, but not visible in the UI. This issue has been fixed.
37280015 3-38750204741 The RCA Availability Engine microservice was producing excessive flapping alarms in various situations. This issue has been fixed.
37355865 3-38825265791 Adding new vertexes was resulting in errors with PHP running out of memory. This issue has been fixed.
36432047 3-36184344331
3-36542173520
If you were using a custom Unified Assurance home directory (different than /opt/assure1), SAML authentication types did not work. This issue has been fixed.
36032879 3-33665680521 The Metric Trend Threshold Engine was crashing if names used special characters or used more than 95 characters. This issue has been fixed.
37535666 3-39426607351 The Event Sink microservice was inserting CURRENT_TIMESTAMP as a literal string rather than replacing it with the current timestamp. This issue has been fixed.
37545123 3-39356567883 The Event Sink microservice was not able to handle custom numeric fields with NULL values. This issue has been fixed.
37161780 3-38353164061
3-39376275151
When editing a CAPE node, the Check syntax button was not working. This issue has been fixed.
37508702 3-38941764831 When creating a dashboard with a Top-N Metrics Table panel, you could only use the first two levels of device groups. This issue has been fixed.
37590599 3-39678114361
3-39727670251
3-40149720151
When viewing devices in the Devices UI, you could not expand devices. This issue has been fixed.
37537856 3-39523193371 The APIs can now handle virtual devices in one restrictive device group while the parent device is in another restrictive device group that a user does not have access to. This means the user can see metric performance data, availability data, and metrics as long as they have the appropriate metric display instances.
36917587 3-38257041701
3-38798917901
If set the Maintenance configuration property to Enabled for the Metric Standard Thresholding Engine service, it was crashing. This issue has been fixed.
37475692 3-39292872591 When you set Check Location for a metric threshold to Application, the IP address in the log was empty. This issue has been fixed.
37301809 3-38569512551 The ReportRunner application was not generating reports when run as a scheduled job or run from the command line. This issue has been fixed.
37288785 3-38603618441 Running the ConfigSELinuxDocker utility was failing due to missing Rancher Kubernetes Engine directories. This issue has been fixed.
36983552 3-37806997361
3-38834915181
3-38946177601
The UI was not allowing you to change the value of Check Location for metric thresholds or set the value to Application on new thresholds. This issue has been fixed.
36781501 3-37088204311
3-39619137411
The passwordDecrypt utility was not working with the Metric Network Interface Poller application for passwords over 29 characters. This issue has been fixed.
37550827 3-38046080181 The Device SNMP Discovery application was not able to access certain updated Huawei devices. This issue has been fixed.
37640398 3-39765133119 When the Ping Poller configured for IPv4 tried to poll an IPv6 device, the polling was failing, but the error message was not displaying properly. This issue has been fixed. The complete error message identifying the issue now shows.
37680078 3-39647441691 The Metric Ping Latency Poller was not receiving data from IPv6 devices. This issue has been fixed.
37685623 3-39851192851 When setting up replication, RedundancyWizard was reading the MySQL binlog position from the primary database rather than the backup snapshot. This resulted in missing events and replication errors. This issue has been fixed.
34606023 2-10351952
3-31132164301
3-31941943881
3-35068840151
2-10350702
2-10346385
2-10344877
2-10352417
2-10351689
2-10350398
2-10344709
Filebeat was unable to send data to multiple outputs, resulting in inconsistent log data in redundant environments. This issue is fixed with the migration to OpenSearch and Fluentbit. Redundancy is supported. See Historical Database Scalability and Redundancy in Unified Assurance Concepts for information.
36618300 3-36723485401 Previously, when you edited a metric to move a threshold from available to selected, the metric type was no longer displaying for selected metrics after saving. This issue has been fixed.
35518690 3-33447491181 The link to the instructions for installing the global certificate on the login page was incorrect. This issue has been fixed. The link now points to Importing the Unified Assurance Global CA Certificate
36503656 3-36412306061 Previously, in dashboards, Device Group Availability panels had an Up button that did not work. It has been removed.
36142859 3-35282830491
3-36425437671
3-35276276801
When importing events from the Event database to the Historical database, custom date fields were being added as text fields rather than as dates. With the introduction of OpenSearch, this issue has been fixed. Custom fields from the Event database are added to OpenSearch as follows:
  • Date, datetime, or timestamp fields are added as date types.
  • Decimal fields are added as decimal fields, not dates.
Although the default FirstReported, LastReported, and LastChanged fields are defined as decimal fields, the MySQL Replication Data Importer knows to add them as date fields.
36868657 3-37479498018
3-39178583941
3-40203150741
The cmd.log file for the My SQL Replication Data Importer service was filling up with INFO level messages for every event and was not rotated. With the introduction of OpenSearch, this issue has been fixed. The excessive messages are now logged at DEBUG level only, and the file rotates appropriately.
35622389 3-33697543911
3-38773922781
The MySQL Replication Data Importer service was creating files in the $A1BASEDIR/bin/historical directory, interfering with the ability to use database sharding. With the introduction of OpenSearch, this issue has been fixed.
37213574 3-38490605221 Fields set with the signed tinyint, bigint, and integer type in the Event database were being imported into the Historical database as unsigned values. With the introduction of OpenSearch, this issue has been fixed.
34606126 3-35075157341
3-39871393051
2-10350582
In Elasticsearch, although saved objects, like dashboards, claimed to import successfully, they did not appear in the saved objects list. With the introduction of OpenSearch, this issue has been fixed.
36626823 3-36783540571 In the default FCOM Syslog rule, the Summary property under the event used the ${.syslog.message} variable twice, resulting in incorrect summary fields for events. This issue has been fixed.

Internal Fixes and Enhancements in 6.1.0.0.0

Release 6.1.0.0.0 includes the following additional internally-reported bug fixes and enhancements:

AAA:

Broker:

Dashboards:

Devices:

Diagrams:

Events:

Graph:

Metrics:

Microservices:

Reports:

Rules:

SLM services:

REST API updates:

General updates:

Documentation Updates in 6.1.0.0.0

The documentation has been updated for the new features, enhancements, and issues described above. In addition, the following externally-reported documentation issues have been fixed in this release:

Bug Number SR Number Description
36091008 3-38023275461
3-35081624961
The example URL calls in Linking to a Custom Metric Graph have been updated to use the correct paths, including metric instead of metricBase.
36525629 3-36475060871 The valid units for time ranges for thresholds in Thresholds has been updated to match the validation in the UI. Setting time ranges for thresholds using s for seconds is not valid.
36159486 3-35351716531 The synopsis of the CreateEdgeTree function incorrectly included VertexID1 twice. The second instance has been updated to VertexID2.
36430013 3-36059814361 Installing Unified Assurance with the File Access Policy Daemon (fapolicyd) enabled was not working. Oracle does not recommend this, but a workaround, you can add a policy rule to allow files in the $A1BASEDIR/tmp directory to be run. See Configuring fapolicyd for details.
36755531 3-37144502061 The value for DBH in the synopsis of GetJournals has been corrected from $EventDBH to \$EventDBH.
35474890 3-33166308058 Creating microservice clusters to install Vision was not working due to blocked ports. Opening Ports and Configuring firewalld have been updated to include ports required to be opened internally for Vision.
35909544 3-34564849951
3-36855775521
Opening Ports and Configuring firewalld have been updated to include all ports and an additional step for adding interfaces to trusted zones for customers using Tigera Calico or flannel.
35555782 3-33320417151 The REST API for Unified Assurance Core documentation includes more information and an example to explain how to use the batch endpoint.
37034783 3-37991930211 Configuring firewalld has been updated with a step for adding a rich rule to support Virtual Router Redundancy Protocol (VRRP) and keepalived.
36277671 3-35704147551
3-35989304828
3-37517457588
Unified Assurance Security Guide now includes new topics to thoroughly cover permissions and roles, including concepts, an example of creating read-only roles, and a reference document mapping each permission to the UIs it grants access to. See About Permissions and Permissions Reference.
36660596 3-36846539141
3-37542218022
3-39008624191
3-39873378811
A new section, Updating Default IP Ranges, describes the default Docker subnet used by microservice clusters in Unified Assurance, how to check which IP ranges are in use in your environment, and how to change the default Docker subnet and Kubernetes IP ranges if needed.
34606379 2-10350455 The new REST API for Unified Assurance Vision guide provides an example use case for managing Vision links.
34802520 3-31131973191
3-35668082821
Events Examples contains a new example of how to implement CAPE nodes and policies to populate the DeviceType field for events.
34606256 2-10348460 The MySQL Replication Data Importer application is now documented. This application is started automatically by AnalyticsWizard to synchronize data from the Event database to the Historical database.
35470241 3-33245617101
3-39473697321
3-33331205761
The documentation for recreating the Kibana index has been updated for OpenSearch. See Task 7: Recreate the OpenSearch Dashboard Index.
37639977 3-39268296961 The REST API for Unified Assurance Core documentation has been updated wherever names are created to state that they cannot be exclusively numeric.

Additionally, the documentation for Performance Common Object Model (PCOM) curation has been updated with detailed information about the PCOM schema and definitions, an example file, and enhanced guidance on the PCOM curation process. See Performance for complete information.

Known Issues in 6.1.0.0.0

Due to the potentially high number of log entries and internal OpenSearch PPL query limit settings, the graphs and visualizations in the Logs UI for the default PPL query may not behave as expected. When viewing logs:

6.0.5.0.0 - September 30, 2024

Release 6.0.5.0.0 includes new features and enhancements, bug fixes, and known issues.

New Features and Enhancements in 6.0.5.0.0

This section describes the new features and enhancements for release 6.0.5.0.0.

Publishing Events in TMF688 and TMF642 Format for Inventory Systems

This release includes a new microservice that converts standard Unified Assurance events into a format compliant with the TM Forum (TMF) 688 Event Management API specification, with embedded schemas for alarm events and performance threshold events from the TMF 642 Alarm Management API specification. The microservice publishes the converted events to an Apache Pulsar topic for consumption downstream. You can deploy the Kafka Bridge microservice (previously called Kafka Adapter) to consume the events and publish them to your external Kafka server, where external inventory applications, such as Oracle Communications Unified Inventory Management, can read the events from the Kafka topic and act on them accordingly.

Note:

Unified Assurance does not provide a TMF API and does not consume events in TMF formats. The TMF Event Flow translates Unified Assurance events into TMF-compliant format and publishes them to an output stream for external applications to consume.

See Understanding the Event Pipeline in Unified Assurance Concepts for information about how the new microservice fits into the overall flow, and Kafka Bridge and TMF688 Event Processor in Unified Assurance Implementation Guide for information about the microservices.

Vision Enhancements

This release introduces the following enhancements for Vision:

Microservices Enhancements

This release includes the following new microservices to integrate with external systems:

The following microservices have been enhanced:

General microservice enhancements:

SELinux Support

Unified Assurance version 6.0.5.0.0 is supported on environments with SELinux set to enforcing.

See the following topics in Unified Assurance Installation Guide:

New Device Support

This release introduces support for new devices, fault MIBs, and performance metrics, including performance metrics for Ixia devices. See Unified Assurance Device Support Overview.

Enhancements

This release includes the externally requested enhancements described in the following table.

Bug Number SR Number Description
35595998 3-33655875331 You can now add a new Device Overview tool to the context menus for events in the event list. This tool opens the Device Overview dashboard for the device related to the event. To see the tool, from the Configuration menu, select Events, then select Tools.
36505016 3-36392833291 You can now see weather overlays on Universal Topology maps. To enable weather overlays, add the application key (APPID) for your OpenWeather account in one of the following locations:
  • The OpenWeatherMapAppID global property. To find this property, from the Configuration menu, select Global Properties, then select OpenWeatherMapAppID.
  • When configuring a Graph dashboard, in the Layout area, from the Type menu, select Geographic Map. Expand Advanced Configuration and scroll down to the OpenWeatherMap AppId field.
For more information about Universal Topology maps and graph dashboards, see Universal Topology User Guide in Unified Assurance Implementation Guide.
36504960 3-36395420801 You can now filter nodes on Universal Topology graphs by selecting vertex properties and values from lists. You can select multiple values for a single property. On a graph dashboard, click Filter Graph. From the Add Filter menu, select Vertex Properties, then select a property and values to filter by. See Topology Graph in Unified Assurance Implementation Guide for more information about filtering the graph.
35125862 3-32240297301 The MySQL Replication Data Importer now includes ShardID in the event data sent to ElasticSearch, to indicate which database shard an event comes from. ShardID now appears for events in Kibana dashboards for Event Analytics. A new View History event tool that includes ShardID in the path has also replaced the old View History tool (renamed to View History - Legacy). To see the tool, from the Configuration menu, select Events, then select Tools.
34606022 2-10346402
3-34954573671
3-35617259141
3-36064969391
3-34875079161
To support multitenancy for the Kibana and Grafana dashboards used in Unified Assurance:
  • You can embed Kibana and Grafana dashboards in Unified Assurance dashboards and optionally display the Kibana and Grafana dashboards alone, without the Unified Assurance navigation menus. See Displaying Analytics Data in a URL Panel in Unified Assurance User's Guide.
  • When configuring roles, you can use the separate Viewer permissions under the eventAnalytics package and the metricAnalytics package to restrict users to either Event Analytics or Metric Analytics, rather than one permission granting access to both. See Navigation Permissions in Unified Assurance User's Guide for information about specifying these permissions.
35089040 3-32168526591
3-33613774411
3-36693062711
Unified Assurance SSL certificates generated by CreateSSLCertificate now include SubjectAltName (SAN). Previously this was not added until the certificate was signed.
35208836 3-32390853781 You can now control whether fields in the event list can be used for sorting or filtering. You do this by setting the Sortable and Filterable options for the columns in the Displays UI. For example, to prevent performance issues, you can disable filtering and sorting on fields that contain a large number of characters. See Displays in Unified Assurance User's Guide for information about the UI.
34606354 2-10350737
3-33256584701
You can now control whether users can edit event fields in expanded event views. You do this by setting the Editable option for the columns in the Displays UI. Some fields, including EventID and ShardID, can never be editable. See Displays in Unified Assurance User's Guide for information about the UI.
34606068 3-37453597241
2-10346040
The Trap Collector microservice now supports SNMP2 and 3 informs. See Trap Collector for information about this microservice.
35470240 3-33310531811
3-37239696911
You can now use Meta Tag names or values when searching for devices in the device list (select Devices from the main Unified Assurance menu). See Devices Search in Unified Assurance Concepts for information about the properties you can use to search for devices.
36248862 3-35564206671 SQL tools used in the event list now run in batches, and you can set the batch size set in the new EventUpdateBatchSize global property. This allows you to select hundreds of events in the event list to run tools (such as to acknowledge or delete events) without performance issues.
35761665 3-34121090322 In Vision, you can now select multiple markers by drawing a rectangle or free-form boundary around them. See Vision Enhancements.
36324323 3-35830296141 In Vision, you can now add custom tools to the context menu for aggregate markers or multiple selected markers. See Vision Enhancements.
36325837 3-35829757461 In Vision, you can now select multiple markers by holding CTRL and clicking. See Vision Enhancements.
36325909 3-35830440031 In Vision, you can now add custom attributes as metadata for markers, and you can search markers on the map using this metadata. See Vision Enhancements.
36098506 3-35081450641 In Vision, you can now add pLinks to custom layers. See Vision Enhancements.
34606048 2-10345514
3-31792099381
3-36305200741
Unified Assurance Developer's Guide now includes SDK information about building custom UIs, creating UI overrides, and building custom packages. See Core Interface SDK Overview.

Documentation Updates

This release includes documentation to describe all of the new features and enhancements, documentation bug fixes, and the following additional major documentation updates:

Fixed Issues in 6.0.5.0.0

This table describes the externally reported bugs fixed in release 6.0.5.

Bug Number SR Number Description
34606169 3-35826989688
3-35473443321
3-37845762801
2-10351724
The DefaultTheme setting for the UI was being applied unpredictably. This issue has been fixed.
Now, the DefaultTheme global property has been removed. The theme (light or dark) is chosen as follows:
  • Before a user logs in:
    • The browser's theme applies to the login page.
    • Users can override the theme manually by clicking Override Theme. This override will be preserved when they log in.
  • After a user logs in:
    • If the user did not manually override the theme, the theme is updated based on the DefaultTheme setting in the preferences for the user or user group.
    • Users can manually override the theme for the session by clicking Override Theme on their User Profile page. The override applies until they log out.
    • If the user or user group does not include the DefaultTheme preference, or no value is specified for it:
      • If the browser uses a standard theme, that theme applies.
      • If the browser uses a custom theme, Unified Assurance defaults to the light theme.
36426380 3-36272399991
3-37246656927
3-36169885491
When filtering devices by DNSName and CustomName, the API and UI were failing. This issue has been fixed.
36252741 3-35587614691 Previously, you could remove the group owner or user owner from various UI components, and the component was automatically made visible to all users. This has been fixed.
Now, a group or user owner is always required for UI components where you can set it, and attempting to remove it results in a validation error. See Configuring Ownership and Viewer Access in Unified Assurance Security Guide for more information about user and group owner settings.
36409354 3-31644613201
3-34547062871
Standard Threshold Engine was consuming more memory over time. This issue has been fixed.
35904570 3-34551067190 In the event list, private filters were not loading the icon in the Events column to indicate event states. This issue has been fixed.
36255549 3-35609024041 In Adhoc Graph dashboards, the Next Hops options were not appearing consistently, and selecting them was not expanding the expected next hop consistently. This issue has been fixed.
35777598 3-34175552841 When event view tools had path values with more than 250 characters, they were truncated and did not work. This issue has been fixed.
Now, the limit for tool paths is 1,500 characters, and attempting to use anything longer results in a validation error.
35636551 3-33764550721 On dashboards, database panels were only filtering the visible data in the first page instead of the entire set of data. This issue has been fixed.
35570900 3-34418897661
3-33589592941
3-37394893271
3-36331418539
Previously, it was possible to have illogical combinations of User Owner and Group Owner, resulting in unpredictable visibility of components. For example, after setting a Group Owner, you could set User Owner to a user not in the selected user group. This issue has been fixed. See Configuring Ownership and Viewer Access in Unified Assurance Security Guide for more information about user and group owner settings.
34807567 3-31078770251
3-36892515401
Graph dashboards were returning internal server 500 errors while viewing more than three hops. This issue has been fixed.
34606087 2-10350856 Previously, edge types and vertex types could have spaces, commas, and backticks in their names. This resulted in errors and unpredictable functionality when editing and deleting them.
This issue has been fixed. Now, you cannot use spaces, commas, or backticks in edge type and vertex type names. Attempting to do so returns a validation error.
36327624 3-35758447121 The FCOM Processor was crashing due to concurrent map reading and writing. This issue has been fixed.
36613144 3-36715124797 The Trap Collector microservice was crashing due to concurrent map reading and writing. This issue has been fixed.
36631507 3-36783789642 In FCOM Processor rules, using named groups for the regex syntax in the preprocessor was no longer supported.
This issue has been fixed. You can now also use standard Perl operators, such as ne and eq, in addition to = and !=.
36626742 3-36783789611 In the FCOM Processor, for trap overrides, you were unable to use variables defined in preprocessors in the event object or post-processor. This issue has been fixed.
36983135 3-36783789669 The FCOM Processor did not support using parentheses to extract substrings. This issue has been fixed.
36983124 3-36783586691 Previously, in FCOM rules, if you provided an EventKey in the events object, it was ignored.
This issue has been fixed. Now the value you add will be used for EventKey.
36155912 3-35344614771 Exporting dashboards was not working. This issue has been fixed.
36386845 3-35991159801 In the event list, changes to values with DateTime conversions were not persisting. This issue has been fixed.
36309154 3-35772546901 Event tools with Path Type set to Local and Target set to New Tab or Current Tab were returning an error when selected from menus in the event list. This issue has been fixed.
36274157 3-35694078691 In version 5.5.19, the DeviceStateID field was not supported in the Devices API.
This issue has been fixed. The DeviceStateID field has been reintroduced. It is required in POST requests to create devices and you can use it as a filter in GET requests for devices. See the endpoints under Device Catalog in REST API for Unified Assurance Core.
36067090 3-35040462811 In the event list, if you selected a severity at the bottom of the list and then selected a different display from the Display menu or a different filter from the filters on the left, the same severity remained selected.
This issue has been fixed. Now changing the display or filter resets the severity being shown to All.
36130574 3-35231326651
3-36153263341
In the event list, after selecting a different display from the Display menu, the filter bar was not appearing. This issue has been fixed.
36373492 3-33412630851 When creating displays for events, for fields with conversions, you could set Type to DateTime. This was resulting in undesired behavior, such as changing 0 to 1/1/1970 12:00:00 AM instead of a correct conversion.
This issue has been fixed. Now, attempting to set Type for fields with conversions to DateTime returns a validation error.
36256579 3-35623437691 Non-administrator users in restrictive groups were able to clone, create, and delete groups for elements (devices, links, dashboards, event filters, diagrams, diagram menus, filter menus, and topology menus) at the root level. This was resulting in incorrect group hierarchies and making information available to all users instead of restricted groups.
This issue has been fixed. Now, non-administrator users in restrictive groups can no longer clone, create, or delete root-level groups.
36209486 3-35473443321 When users did not have a default time zone set for their user group or user profile, the DefaultTimeZone Global Property was not applying. This issue has been fixed.
36197199 3-35471197661 In the event list, when searching for filters, filters were displayed with incorrect nesting. This issue has been fixed.
35600888 3-33664390331 In graph dashboards, filtering for custom properties in the Property Value field was not working. This issue has been fixed.
34810956 3-32255817548 In an application cluster, the Unified Assurance Broker was not recognizing configuration changes to clustered services, such as moving services to a different server in the cluster. This issue has been fixed.
35822644 3-34210339121
3-35691193841
Diagrams using event widgets with Transient Event List and Meta Tag filter types were not showing accurate states or opening the event list correctly, and the wrong values were appearing in the list of Meta Tag options. This issue has been fixed.
36416911 3-36093710221 Creating vertices for graphs was not validating vertex names and properties correctly due to the way the API checked for constraints when running validation. This issue has been fixed.
36446545 3-36225025641
3-36185119601
When you changed a user's group, the preferences and restrictive IDs inherited from the user group were not updating to those of the new user group. This was also preventing users from updating their own preferences. This issue has been fixed.
36058615 3-35020060511 For SLM service dashboards, SLM Service Gauges were not working as expected when you selected Logarithmic. This issue has been fixed.
36409406 3-36095050371 For SNMP devices, the port configured in their SNMP profile was not being used by the Metric SNMP Network Interface Discovery Agent when discovering interfaces for polling. Instead, port 161 was used.
This issue has been fixed. Now, the port configured in the SNMP profile is used.
36431828 3-36186879891 Dashboards showing metrics for devices and virtual devices where the virtual device was in a different zone from its parent device were not showing the correct data. This issue has been fixed.
36400671 3-36077459131
3-36370364551
Previously, when you used the API to get performance data, you could filter using DeviceZoneName. Now, although you can use a combination of DeviceZoneName and DeviceZoneID when filtering performance data, Oracle recommends specifying the device zone by using a serialized device name (appending the zone ID after the device name, for example, device123;z1 for a device in zone 1). The API documentation now includes examples of different valid combinations for filtering the performance data. See the Performance Data endpoints under Metrics in REST API for Unified Assurance Core.
36533991 3-34451661871 In the event list, after selecting a filter from the list on the left, when you selected a different filter group from the Filter Group menu in the menu bar, the value in the Filter menu did not change.
This issue has been fixed. Now, the value in the Filter menu is cleared, and you must select a different filter from the new filter group to refresh the event list.
36536606 3-34451661871 Dashboards with Event List panels were loading incorrect filter groups when the filter groups were nested. This issue has been fixed.
36571803 3-36626818798 In the Device Catalog configuration UI (from the Configuration menu, select Device Catalog, then Devices), the Zone ID column has replaced the Zone Name column, and you had to select a device to see its zone name.
This issue has been fixed. Now, you can add the Zone Name column to the All Devices table by selecting the menu between any columns, selecting Columns, and enabling Zone Name.
36533909 3-34451661871
3-35450948541
Dashboards with Event List panels that used filter groups with restriction filters were not applying the restriction filters. This issue has been fixed.
36430968 3-36158874450 In systems with two redundant microservice clusters, each containing an Elasticsearch database and the Flow Collector microservice, both Flow Collector microservices were sending data to the same Elasticsearch database.
This issue has been fixed. Now, you can optionally set the ELASTIC_DB_HOST configuration parameter to point to a specific Elasticsearch database when deploying the Flow Collector microservice, and that microservice instance will send data to the specified database.
34606035 2-10350759
3-33104592991
For SLM services, the Event SLM Connector was not identifying events correctly based on SLM filters, and was incorrectly propagating service violations. This issue has been fixed.
35575314 3-33030978481
3-35827618311
The Supervised Event Correlator microservice was requiring supervised correlations to have an associated meta event. This issue has been fixed.
36421844 3-35955916321
3-37098074051
3-37531460581
When devices in different groups had similar names, searching for them in the device list was failing. This issue has been fixed.
34605962 2-10341682 Configured viewers and owners for SLM services were not being respected, resulting in users having access to the wrong services in dashboards.
This issue has been fixed. Additionally, because of database limitations for SLM services, you can only set User Owner and Group Owner for SLM services, you cannot add viewers.
35596325 3-33612818391 The Brokerd service was writing excessive entries in the /var/log/messages log. This issue has been fixed.
36614043 3-36749587081 The FindDeviceID function was looking for a strict match (all had to match), regardless of whether strict was set to 0 or 1. This resulted in the function failing to find a single match in environments where two devices in the same zone had the same IP, but different DNS. The function attempted to match by IP address, printed a warning after finding multiple matches, and failed to look at the DNS.
This issue has been fixed. The strict option is working as expected; when set to 0, a best match that considers all fields is found.
36571030 3-36498566321 In the event list, when updating fields, custom DateTime fields were also updated with incorrect values. This issue has been fixed.
36627478 3-36752014031 Users who were members of groups with RestrictiveFilterGroupID set were not seeing the correctly restricted events in dashboards with Event List panels that used filter groups with restriction filters. This issue has been fixed.
35874999 3-34451661871 On Adhoc event dashboards, the filters available in the Filter Name menu were not properly restricted to the group selected in the Filter Group menu. This issue has been fixed.
36369789 3-35957735531 The Trap Collector microservice was not processing SNMPv3 traps. This issue has been fixed.
36190307 3-35450948541
3-36342498001
When you sorted or filtered the event list and then navigated away, the sorting or filtering was persisted when you returned to the event list until you selected a new filter or display. This issue has been fixed.
35904826 3-34551067171
3-36054401071
In the event list, when selecting a private filter from the Filter Type menu, the filter ID was showing instead of the filter name. This issue has been fixed.
35452209 3-33228170031
3-34878529751
3-35745337281
When creating or editing event displays, changes to columns were only being saved for columns marked as visible. This issue has been fixed.
35156714 3-32373183441
3-34392309281
The group ownership restrictions for event filters was not correctly restricting event filters, resulting in users having access to the wrong filters.
This issue has been fixed. Now, users only have access to the appropriate level of event filter set for their user group.
36575486 3-36680969161 In the SNMP Access configuration UI (from the Configuration menu, select Device Discovery, then SNMP Access), the Zone ID column has replaced the Zone Name column, and you had to select an SNMP profile to see its zone name.
This issue has been fixed. Now, you can add the Zone Name column to the All SNMP Profiles table by selecting the menu between any columns, selecting Columns, and enabling Zone Name. Name.
36650645 3-36836655291
3-37289960381
Failover and failback was not working as expected for the Neo4j (Graph) database. This issue has been fixed.
36644270 3-36837204841
3-37088204311
The passwordDecrypt utility was not working for passwords over 29 characters. This issue has been fixed.
36227397 3-35554654651 In the event list, when you selected a filter from a group other than Global, the filter group was not displayed in the event list header. This issue has been fixed.
35698411 3-33918304321
3-37429832831
3-35138153641
Previously, DNSName and CustomName for devices could be a number. This is no longer allowed. The REST APIs for creating and updating devices now include validation for DNSName and CustomName. Using the UI or the API to create or update a device with number-only values for these properties will return an error. If you update existing devices that have integer DNSName or CustomName values, you will have to update these properties to use non-number-only values instead.
36602131 3-37353233821
3-36317038271
In the event list, if any empty custom event menus (containing no tools) existed for a user's group, right-clicking an event in the event list made the default browser context menu appear rather than the Unified Assurance event list context menu.
This issue has been fixed. Now the proper context menu appears and empty submenus are not shown in the menu.
36307947 3-36922221051
3-37121479601
3-37479985551
3-37129101341
After stopping the MySQL Replication Data Importer service (mysqlreplbeat), you could not restart it from the UI.
This issue has been fixed. A related additional option has been added to the Event Canal microservice to determine where to start streaming when restarting the service. See About Event Canal and the MySQL binlog in Unified Assurance Implementation Guide for information.
36380265 3-37446229981
3-35954901871
3-36194871071
3-36902896721
Exporting UI data was not working. This issue has been fixed.
34734067 3-31035231201
3-36831125721
The Refresh settings for event view tools was not working. All event view tools refreshed the event list and brought you back to the top when you closed the tool window or pop-up, regardless of whether the tool was configured with Refresh selected or not. This issue has been fixed.
36632394 3-36248805711 When filtering events by device name, the device's ShardID was also used. ShardID is not intended for use with events, only with metrics.
This issue has been fixed. Now, ShardID is only used if it is explicitly included for the event or event filter in the API call. If no ShardID is included, it defaults to 0.
36606520 3-36709812201 When you updated fields for an event display other than Group Owner or User Owner on a display when Group Owner was set to Public to All Users in Group, User Owner was changed to you.
This issue has been fixed. The ownership does not change when you update other fields.
36318796 3-35803714881 When you added a user group as a viewer of a variety of elements (for example, links, event displays, event filters, database queries, dashboards, reports, and files), and then deleted that user group, you were no longer able to add new viewers or configure viewers for the element.
This issue has been fixed.
36728820 3-36742142681 The Topology Gather Network Inventory job was failing to discover certain DriveNet devices. This issue has been fixed.
36710566 3-37011012661 When OSPF neighbours that use different versions (OSPF with IPv4 and OSPFv3 with IPv6) are discovered and being polled, the RCA Availability Engine microservice was generating false alarms for missing neighbours. This issue has been fixed.
36772398 3-37396300921
3-37405061001
3-37073881641
In Linux 8 environments, adding a new server with a signed certificate was not working. This issue has been fixed.
36442085 3-35701651911 If you changed the Group Owner or viewers of the Default event display, the status icon for other event filters stopped loading. This issue has been fixed.
34970486 When the Event Sink microservice deduplicates an event, it was not updating the ExpireTime field, resulting in problems clearing incoming event transitions. This issue has been fixed.
35280022 3-32714947131 In Graph API requests for custom dashboards, the Run call was not working. This was because Run was changed to RunQuery.
This issue is fixed. You can use RunQuery instead.
36426380 3-36272399991
3-37246656927
3-36169885491
In the Device Catalog configuration UI, filtering by DNSName or CustomName did not work. This issue has been fixed.
36717677 3-37020049511
3-37672049371
3-36564746561
Generic SNMP Poller was not polling all devices in a cluster. This issue has been fixed.
36912800 3-37575628941 When multiple PingPollderd processes were running on the same server, performance was decreasing and latency was spiking. This was due to overlapping ICMP IDs.
This issue has been fixed. Now, PingPollerD generates incrementing ICMP IDs.
36932033 3-37670407001 On Linux 8, the FreeTDS application was not working to connect to an external database. This issue has been fixed.
36878302 3-37519892539 In a microservice cluster, a backend pod-presets-webhook service was disappearing after reboots, causing the cluster to become unstable.
This issue has been fixed.
36954785 3-37745950061 The documented procedure for upgrading Unified Assurance on Linux 7 to a new Linux 8 system (also called forklift upgrade) had an incorrect step for updating the SVN checkout directory names with the new Linux 8 FQDN. This prevented successful upgrades.
This issue has been fixed. The documentation has been updated with new procedures that include the corrected step and support minimal downtime.
36638185 3-36764428979 When an interface was missing, the RCA Availability Microservice was not creating a Missing alarm and not clearing instance-level alarms.
This issue has been fixed. Now the Missing alarm is created and instance-level alarms are cleared. When the instance reappears, the Missing alarm is cleared and instance-level alarms are reintroduced if still relevant.
36710830 3-36849985091 The Discovery Service microservice was crashing when getting a callback from the SNMP Poller microservice during SNMP discovery. This issue has been fixed.
36710894 3-37000377961 Even when the Discovery Service microservice received a response from the SNMP or ping poller, the value of SNMPStatus was Queued, causing other integrations to be stuck. This issue has been fixed.
36711858 3-37022220901 The DOM Processor microservice was not reading community strings with mixed case correctly, resulting in failed polling of discovered devices. This issue has been fixed.
37039222 3-37575628941
3-38034524741
Ping Poller was consuming more memory over time. This issue has been fixed.
36631914 3-36765158851
3-37881835631
The MIB2FCOM application was failing due to a missing &main::ncmp Perl module. This issue has been fixed.

Release 6.0.5 includes the following additional internally-reported bug fixes and enhancements:

Known Issues in 6.0.5.0.0

Due to an issue in Rancher Kubernetes Engine (RKE), the clusterctl update command is disabled. This command is commonly used to change a cluster from using a single master to use multiple masters. There is no workaround.

6.0.4.0.2 - February 29, 2024

Release 6.0.4.0.2 includes new features and enhancements, bug fixes, and known issues.

New Features and Enhancements in 6.0.4.0.2

This section describes the new features for release 6.0.4.0.2.

Support for Oracle Linux 8

This release is supported on Oracle Linux 8 as well as Oracle Linux 7. Upgrading installations can choose between Linux 7 and 8, and all new installations must use Linux 8.

For details, see the following topics in Unified Assurance Installation Guide:

For general information about Oracle Linux 8, see the Oracle Linux 8 documentation.

FIPS Compliance

When you install Unified Assurance release 6.0.4.0.2 on Oracle Linux 8, you can enable Linux to be compliant with the Federal Information Processing Standards (FIPS) Publication 140-2. FIPS 140-2 is a U.S. government computer security standard used to validate cryptographic modules that include both software and hardware components.

Installing Unified Assurance on Linux 8 in FIPS mode ensures that the application only uses FIPS-certified modules. This allows the individual components of Unified Assurance 6.0.4 to be compliant with FIPS 140-2, including all databases, layers, and integrated third-party applications.

Some of the benefits of being compliant with FIPS 140-2 are:

For more information about how FIPS is supported in Unified Assurance, see FIPS Compliance in Unified Assurance in Unified Assurance Security Guide.

For more information about how FIPS is supported by Oracle Linux 8, including how to configure a system in FIPS mode, see FIPS 140-2 Compliance in Oracle Linux 8 in Oracle Linux 8 Enhancing System Security.

CORBA Collector

This release introduces the Common Object Request Broker Architecture (CORBA) collector microservice to collect events from external Element Management Systems (EMS) and Network Management Systems (NMS). The CORBA collector lets you collect Multi-Technology Network Management (MTNM) CORBA events and normalize them for handling within Unified Assurance using standard event analysis features such as event enrichment, correlation, and filtering.

For details about the CORBA collector, see CORBA Collector in Unified Assurance Implementation Guide.

Java SDK

This release introduces a software development kit (SDK) based on Java 17 to help you build Java-based microservices for Unified Assurance. The Java SDK includes:

For details about the Java SDK, see Java Microservice SDK in Unified Assurance Developers Guide.

Root Cause Analysis Availability Engine

This release introduces a Root Cause Analysis Availability Engine microservice to automatically correlate device outage events with their root cause. When a device goes down, the microservice looks at the network topology for the device to identify where the outage originated, and enriches the event with information about the root cause and other downstream symptoms. You view the information in the Unified Assurance Event user interface, and you can use it to identify the right place to resolve outages.

For details about root cause analysis, see Understanding Root Cause Analysis in Unified Assurance Concepts.

Device Discovery and Polling Microservices and REST API

This release introduces a new device discovery flow and polling microservices for monitoring device status. You can now discover devices and add them to the Device database by consuming incoming REST API POST requests. The Discovery Service microservice processes the requests, sets up the appropriate device zones, groups, and pollers, and sends the device information to the new DOM processor to be added to the databases. The SNMP, Ping, and VMware Poller microservices monitor the discovered devices at configured intervals and send availability status messages to Pulsar topics for other microservices to consume.

For details about the new flow, see Understanding the Discovery Pipeline in Unified Assurance Concepts.

For details about the new REST API, see REST API for Oracle Communications Unified Assurance Microservices.

Juniper Mist Integration

This release includes integration with Juniper MIST through microservices that connect to the MIST REST API. The Mist Poller microservice polls topology data to be included in the Graph database and the Mist Event Collector microservice polls alarms and events. To support discovery and monitoring, this microservice integrates with other microservices, including discovery, root cause analysis, topology, and the FCOM Processor.

For details about the new microservice, see Mist Poller and Mist Event Collector in Unified Assurance Implementation Guide.

New Device Support

This release introduces support for new devices, fault MIBs, and performance metrics. See Unified Assurance Device Support Overview.

REST API Documentation

This release includes complete documentation for the core Unified Assurance REST APIs. You can use the REST APIs to configure and manage objects in the Unified Assurance database and user interfaces. The features described in the REST API documentation were previously supported, but not fully documented.

See REST API for Unified Assurance Core.

Enhancements

This release includes the externally requested enhancements described in the following table.

Bug Number SR Number Description
35777899 3-34115916061 You can select Font Awesome icons, Unified Assurance icons, or basic icons when configuring device type categories.
See Device Type Categories in Unified Assurance User's Guide for information.
35528848 3-33469767071 You can now easily view metrics graphs on their own and provide links from the UI.
When looking at a metric graph, click the icon with the arrow in the upper right corner to open the graph in a new tab.
See Panel Adhoc Graph in Unified Assurance User's Guide for information about the metric graph UI controls.
35709509 3-33843680941 The TL1Gateway now supports configurable timeouts for login and cmd.
See the TimeOut and SocketTimeout configuration parameters in TL1Gatewayd in Unified Assurance Implementation Guide.
35738888 3-34053682801 Vision now allows you to override CSS using a custom file. You can use this to apply new styles.
You can also change colors of aggregated markers based on different criteria than the default, which is the number of sites.
The aggregate markers on the Custom Layer now behave like the aggregate markers on the Event Layer. They are represented by a circle containing the number of markers and percentages of event severities as pie segments around the circle. The optional severity field controls the color of the rings around the new aggregated markers. You can set the field to number from 0 to 5, which corresponds to event severity, where 0 is normal and 5 is critical.
Custom Layer aggregated markers are gray, while Event Layer aggregated markers are blue.
To add a custom CSS file to Vision, use the following commands on your presentation servers:
mkdir -p /opt/assure1/www/resources/vision/www
vi /opt/assure1/www/resources/vision/www/Custom.css
35800210 3-34241695488
3-34415824611
You now use the second column in events lists to click and drag events to manually correlate them. Previously you could click and drag the event name for correlation, which made it difficult to copy text.
35933262 3-32035865461 When calling FindEdgeID, you can now provide the TypeID without the EdgeType. FindEdgeID automatically looks up EdgeType based on the TypeID.
35954845 3-32932235431 You can use an override file for Elasticsearch for custom configurations that are persisted even after updating to a newer version.
35955224 3-33677398541
3-33251005801
Continuous queries have been removed from InfluxDB and replaced with the Metric Consolidator job to reduce system memory usage.
See MetricConsolidator in Unified Assurance Implementation Guide for more information.
35955259 3-33397138961 When using the Metrics configuration interface, you must apply filters to the list of devices before seeing results.
To apply filters, scroll to the far right of the table and click the filter icon. Enter filter values under any of the columns, and click the Apply Filters button to apply them and display data. Oracle recommends filtering at least by device name.

This release includes the following other enhancements:

Fixed Issues in 6.0.4.0.2

This table describes the externally reported bugs fixed in release 6.0.4.0.2.

Bug Number SR Number Description
34797244 3-31101618201
3-34976193881
Neo4j replication was falling behind under high loads after running the Redundancy Wizard. This issue has been fixed.
35474192 3-33178611441 Metric polling was taking a very long time to update thresholds. This issue has been fixed and performance has been improved.
36240009 3-35589845351 User groups were displaying the wrong properties in the UI. This issue has been fixed.
N/A N/A Apache Pulsar was unable to run in a clustered environment with firewalld installed. Resolve this issue by opening the ports described in Linux Prerequisites in Unified Assurance Installation Guide.
35955275 3-34310406841
3-34267418241
3-34562786781
3-34197579291
3-31644613201
The Metric Standard Thresholding Engine was hanging due to failed configuration checks. This issue has been fixed.
35955253 3-33036265871
3-33652095181
The Metric Standard Thresholding Engine was clearing violations when data was missing because pollers were behind or stopped. This issue has been fixed.
35955205 3-33189404871 The Metric Network Interface Poller and the Metric Standard Thresholding Engine were ignoring the metric custom maximum when calculating utilization. This issue has been fixed.
35955183 3-33921580971 If device names contained special characters like & or ,, a validation error appeared on the Metrics Overview dashboard panel. This issue has been fixed and special characters in device names are now displayed properly.
35954892 3-33988244001 Some event data was not being pushed into the Elasticsearch Database properly, due to inconsistent data types. This issue has been fixed so that the different data types are routed properly.
35954887 3-33976853031 When loading device groups for jobs or services, not all device groups were shown. This issue has been fixed.
35954867 2-10348461 Neo4j connections did not fail over or fail back properly. This issue has been fixed.
35943684 3-34299633351 The FindDeviceID function was not recognizing devices in the device catalog if the device DNS was mixed case. This issue has been fixed.
35933355 3-34263822091 In a multi-shard environment, events were being inserted improperly in the Events database when a single shard was down. This issue has been fixed.
35933307 3-34451542701
3-33594670821
The list of discovery jobs for manual discovery was limited to displaying 25 jobs, so not all jobs were appearing. This issue has been fixed.
35933253 3-32008437961 The Device Group Availability dashboard panel was not accurately displaying availability values for some devices. This issue has been fixed.
35932773 2-10349020 The panels in dashboard tabs were only updating tokens based on URL parameters and not panel parameters. The issue has been fixed so that tokens also use panel parameters, which take precedence. If panel parameters are not present and URL parameters are, then the URL parameters are used.
N/A N/A Documentation was missing details for the Assure1::Metrics::Data Perl library. Details were added. See Data in Unified Assurance Developer's Guide.
35931794 N/A If you were not logged in, or were connected through SAML authentication from another system, dashboard were failing to load the first time, but loading on refresh. This issue has been fixed and the dashboards load the first time.
35931636 3-34024819941
3-34093669791
3-34144757241
3-33656652211
Clicking the Details button of the Metric Graph of any metric related to a device was not showing the required details. This issue has been fixed.
35915361 3-34547265191 After the IP address of a device was changed, the Generic SNMP Poller was still using the old IP address to establish sessions until it was restarted. This issue has been fixed.
35903358 3-35073827301 Several backup services, like the Tl1 Aggregator and Trapd Aggregator backups, were staying active while the primary service was active. This issue has been fixed.
35894029 2-10344865
3-31033248791
When a new database shard was added, dbAdd was not detecting it, and not creating a new database entry. This issue has been fixed.
35853214 3-34393822401 When selecting a restricted group from a nested group list for a user group, the wrong group was selected after refreshing. The last group in the list was selected instead of the user's selection. This issue has been fixed.
36170664 3-35390050421 Edge properties other than the default were not showing in topology graphs of type vertex. This issue has been fixed.
35709591 2-10348799 Redundancy Wizard was only waiting five seconds for the Neo4J database to shut down, and not verifying if the database was offline before backing it up. This issue has been fixed.
35709587 3-33665680521 Metric Trend Threshold Engine jobs crashed when there were no metrics assigned to the threshold. This issue has been fixed. Now a message indicating that there are no configured thresholds is displayed and the job is finished.
35533010 3-33449123061 You could only assign a menu to a single user group and thus could not create shared menus. This issue has been fixed by the enhancement for adding users to more than one group. You can now assign the menu to a user group, and add multiple users to that group so that they all have access to the menu. See Authentication Options and Adding User Accounts in Unified Assurance Security Guide for information about user groups.
35475404 3-33322565241 If device group names contained special characters like &, device tree grids containing them resulted in errors in the UI. This issue has been fixed and special characters in device group names are now displayed properly.
36240009 3-35589845351 The wrong values for properties were showing for user groups in the UI, even if the correct values were visible in the database. Switching to a different user group and back loaded some but not all of the correct values. This issue has been fixed.
35955187 3-33916553971 The correct values to use in the Path and Path Type fields when creating tools was not clear in the documentation, resulting in errors in creating tools. Notably, the path for local tools is assumed to be relative to the $A1BASEDIR/www/tools/event directory. The documentation of the tools was updated. See Tools View in Unified Assurance User's Guide for information about these fields.

The following additional internally-reported bugs are fixed in release 6.0.4.0.2:

Known Issues in 6.0.4.0.2

This section describes the known issues and workarounds for release 6.0.4.0.2.

Trap and Syslog Messages Not Forwarding to Collectors

If you are using Kubernetes version 1.19.16 and trap or syslog messages are already being sent to the server before setting up the Trap Collector or Syslog Collector microservices, new messages may not be sent to the collectors after the microservices are set up. This is especially relevant if you are using a trap forwarder.

The microservice setup adds new connection rules to forward packets to trap and syslog collectors, but if entries already exist, the new rules will be ignored.

To resolve this issue, delete the existing connection tracking entries after setting up each microservice as described in "Syslog Collector" and "Trap Collector" in Unified Assurance Implementation Guide.

To delete the connection tracking entries:

  1. In a multiserver deployment, from the command line, access the node where you installed the collector.

If you did not specify a node when installing the collector, or you do not know which node it was installed on, get a list of pods and their details, including nodes, by running the following command:

a1k get pods -o wide

  1. Run one of the following commands, depending on the collector:
    • For the Trap Collector microservice:
      conntrack -D -p 162
      
    • For the Syslog Collector microservice:
      conntrack -D -p 514
      

This issue is not present in later versions of Kubernetes, including those distributed with the latest release of Unified Assurance. To avoid this issue, you can upgrade to the latest version of Kubernetes on your existing cluster. See Making Customizations to an Existing Cluster in Unified Assurance Implementation Guide.

Deprecated Features in 6.0.4.0.2

Unified Assurance no longer supports the RADIUS user authentication type.

If you are upgrading or updating to version 6.0.4.0.2, any existing user accounts using the RADIUS authentication type are switched to the internal authentication type. Before these accounts can be used again, you must either set passwords for them or change them to a different authentication type.

See "Authentication Options and Adding User Accounts" in Unified Assurance Security Guide for information about authentication types and configuring user passwords.

See "Authentication Types" and "Users" in Unified Assurance User's Guide for information about the related configuration interfaces.

6.0.3.0.0 - September 5, 2023

Release 6.0.3.0.0 includes new features and enhancements, bug fixes, and known issues.

Note:

New Features and Enhancements in 6.0.3.0.0

New features and enhancements in release 6.0.3.0.0:

Fixed Issues in 6.0.3.0.0

Bugs fixed in release 6.0.3.0.0:

Known Issues in 6.0.3.0.0

Known issues in release 6.0.3.0.0:

Analytics -> Events -> Machine Learning

6.0.2.0.0 - March 9, 2023

Release 6.0.2.0.0 includes new features and enhancements and bug fixes.

New Features and Enhancements in 6.0.2.0.0

This release introduces Unified Assurance Flow Analytics. Unified Assurance Flow Analytics is a complete solution to collect, analyze, and provide real-time visibility into whom and what are consuming network bandwidth.

See Understanding Flow Analytics in Unified Assurance Concepts.

New features and enhancements in this release:

Fixed Issues in 6.0.2.0.0

Bug fixes in this release:

6.0.1.0.0 - December 6, 2022

Release 6.0.1.0.0 includes new features and enhancements and bug fixes.

New Features and Enhancements in 6.0.1.0.0

New features and enhancements in this release:

Fixed Issues in 6.0.1.0.0

Bugs fixed in this release:

6.0.0.0.0 - August 1, 2022

Release 6.0.0.0.0 is the initial stable release of Unified Assurance v6. See "What is Unified Assurance" in Unified Assurance Concepts for details.