Release Notes

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

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

Release 6.0.5.0.0 includes the following known issues.

Stop Database Watchdog Before Updating

If the Database Watchdog service is running when you update a non-presentation server, the update will fail. This applies to updates started from the command line and the UI.

To avoid this, stop Database Watchdog on all servers before updating, and start it again after the update is complete.

You can use the Services UI in the Broker Control menu to stop and start the service. See Services in Unified Assurance User's Guide for information about this UI.

See Updating Unified Assurance in Unified Assurance Installation Guide for more information about updating.

Clusterctl Update Not Working

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.
See Elasticsearch under "How To Override Default Vendor Configurations" in Unified Assurance Implementation Guide for more information.
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.