Geneos 5.x Release Notes

Overview

Geneos release notes contain the list of enhancements of features, and a set of issues fixed in the current release.

This page contains release notes for all Geneos 5.x releases.

For the latest highlights, see What's New in Geneos.

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

Upcoming Geneos release

Geneos follows a two-month release cycle. The next planned release for Geneos 5.11.x is November 2021.

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues. The known issues that are resolved will be added on this page.

Geneos compatibility and lifecycle

The notice of change in the Geneos compatibility identifies the components, plugins, or features that will no longer be supported by ITRS in any future releases.

To view all the changes to Geneos compatibility and lifecycle, refer to Geneos 5.x Compatibility Matrix.

Important

  • The ITRS Maven repository has changed its location from <url>https://itrsgroup.bintray.com/collection</url> to <url>https://maven.itrsgroup.com/repository/public</url>. Please update all the existing links as they will stop working by end of February 2021.
  • Netprobe 5.1.x is not generally available to download except for Netprobe 5.1.0 Linux-64 package certified for deployment on Solace devices. Please download version 5.2.x or newer for all other deployments.
  • Support for Geneos 3.x ended on 30 April 2020. We strongly advise you to upgrade to version 4.x or newer as soon as possible.
  • From the release of Geneos 5.0.x, there will be no interoperability with other Geneos components older than version 3.6.x. In order to successfully deploy or upgrade to Geneos 5.0.x in a staged manner, you must first ensure that no other connecting Geneos components are older than version 3.6.x. This change is a result of the removal of LZO compression support in the inter-component EMF2 communication protocol.
  • Collection Agent plugins require an additional licence to use. Please contact your ITRS Account Manager or ITRS Sales.

If you have any question or concerns, please contact ITRS Support.

End of support

The end of support means that the affected component, plugin, or feature is no longer supported and this ends the release of binaries. The table below lists the affected components, plugins, and features:

Notice of change Affected components Effective date Alternative or Upgrade path
End of support for MiniGeneos MiniGeneos 31 March 2022 Docker images for Gateway and Netprobe are now available. The Gateway can also be run in -demo mode for limited use. Upcoming releases will also focus on a lite version of Gateway Hub for desktop use.
End of support for Red Hat Enterprise Linux (RHEL) 6.x All versions of Netprobe and all other Geneos components 31 December 2021 Upgrade to RHEL 7.x or higher. For more information, see the notice from Red Hat article.
End of support for the Express Reports feature of Gateway Gateway 31 December 2021 Express Reports will continue to be available and supported for Geneos 5.7.x and older until 31 December 2021.
End of support for Control-M Integration (third-party solution) Control-M Integration 1.x and older 30 November 2021 Upgrade to the Control-M plugin for Control-M 9.0.18 and newer.
End of support for Red Hat Enterprise Linux (RHEL) 6.x All versions of Collection Agent, Gateway, Licence Daemon, SSO Agent, Web Dashboard, Webslinger 31 July 2021

Upgrade to RHEL 7.x or higher. For more information, see the notice from Red Hat article.

ITRS will continue to support running the Netprobe and plugins on RHEL 6.x at least until the end of 2021.
       

Geneos 5.10.0

Released: 30 September 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console

  • Azure Monitor plugin

  • Azure Marketplace

  • File Agent

  • FIX Analyser 2Netprobe

  • Gateway

  • Licence Auditor

  • Licence Daemon

  • Netprobe

  • Prometheus plugin

  • Web Server

  • Webslinger

Highlights

These are the highlights of this release:

  • Prometheus plugin

    • Prometheus has become a widely adopted standard in application monitoring, especially in orchestrated environments. If Prometheus is your choice of tool, the Geneos plugin for Prometheus and Alert Manager lets you bring your metrics and Alert Manager events into Geneos for a unified view across your entire stack. It includes the extraction of the data itself, plus the ability to dynamically generate Geneos data structures, minimising configuration, and maintenance. Alert Manager data can also be streamed into FKM plugin for monitoring specific events.

  • Azure Event Hub plugin integration

    • Azure Monitor plugin now supports the ability to consume real-time metrics from the Azure Event Hub service. This is an alternative to polling the Azure Monitor API, enabling Geneos to monitor your Azure cloud environment at scale and in real-time. Built-in mappings for Azure Monitor allow Geneos to dynamically create entities and dataviews to keep configuration to minimum.

  • Azure Marketplace VM

    • You can now deploy the Azure Monitor plugin through the Azure Marketplace. This deployment makes the configuration of the Azure Monitor plugin easier with built-in dynamic entity mapping to minimise Gateway configuration. Different scenarios are also supported for you to deploy your virtual machine.

  • OP5 Monitor plugin

    • ITRS OP5 Monitor is a comprehensive monitoring and alerting tool for your IT networks and infrastructures. Geneos OP5 Monitor plugin allows you to visualise the OP5 Monitor host and service level status in Geneos alongside your application monitoring.

  • REST Extractor plugin now supports POST content-type options for integrating with other applications and services.

  • The Dynamic Entities Health view now includes messagesLost metric to better monitor the dynamically created streams in Geneos.

  • New /liveness endpoint to programmatically test the state of all Geneos components.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-6179 Gateway

The -gateway-name command line option can now be used, in conjunction with the -setup option, to set the Gateway name. This allows the Gateway name to be omitted from an explicitly named setup file.

Without the -setup option, the -gateway-name option continues to direct Gateway to use centralised configuration.
COL-9917 Netprobe

The Netty Project libraries in the Netprobe package have been upgraded to version 4.1.67 to address the following security vulnerabilities:

  • CVE-2021-21490

  • CVE-2021-21295

  • CVE-2021-21290

  • BDSA-2018-4022

COL-9994 Netprobe, Prometheus The Prometheus plugin 2.0.0 binaries are packaged with Netprobe 5.10.x, and are also available to download from the ITRS Downloads.
COL-10413 Gateway Added built-in mapping for Prometheus V2.
COL-10048 Netprobe Netprobe now searches for jvm.dll or libjvm.so on the directory set as JAVA_HOME.
COL-10175 Netprobe The Streams view in the Dynamic Entities Health plugin now includes a messagesLost column that shows the total number of messages that have been lost for each stream. There is a buffer of up to 1000 messages for each stream. Messages will be lost if there are no subscribers, or if a subscriber does not consume the messages as fast as they are produced.
COL-10181 Netprobe The Publisher plugin can now publish match_key and ignore_key to the GRPC Collection Agent (publishing log data to Gateway Hub 3).
COL-10300 Netprobe The Publisher plugin that streams data to Gateway Hub 3 now supports API authentication via Hub Connection details received from the Gateway.
COL-10183 Netprobe The OP5 Monitor plugin is now available that can be used to visualise the OP5 Monitor host and service level status in Geneos.
COL-10345 Netprobe The OP5 Monitor plugin now displays dataview for unhandled hosts and services problems.
COL-10304 Netprobe The REST Extractor plugin now supports POST content-type options, such as application and JSON, for bearer authentication.
COL-10343 Netprobe

The Jersey libraries have been upgraded to version 2.34 to address the following security vulnerabilities:

  • CVE-2021-28168

  • BDSA-2015-0789

COL-10415 Netprobe, Azure Monitor The Azure Monitor plugin 2.1.0 binaries are packaged with Netprobe 5.10.x, and are also available to download from the ITRS Downloads.
AZUREMON-330 Azure Monitor The Azure Monitor plugin and Azure Event Hub plugin now publish similar dimensions.
AZUREMON-350 Azure Monitor Added Azure Event Hub plugin which integrates with the Azure Event Hub. This supports the processing of events from Azure Diagnostics which are published to an Event Hub.
UTL-1206 Gateway, Netprobe, Licence Auditor, Webslinger, Licence Daemon, Web Server, FIX Analyser 2 Netprobe

Geneos components will detect incoming connections that send no data and terminate them after approximately 70 seconds, without logging any error message.

This type of connection may be made by programs that probe TCP ports to make security, or liveness checks.
UTL-1207 Active Console, GSE, Gateway, Netprobe, Licence Auditor, Webslinger, Licence Daemon, FIX Analyser 2 Netprobe, File Agent Added new /liveness endpoint to test the state of all Geneos components.
VI-9335 Web Server The Jetty library in the Web Server has been upgraded to 9.4.43.v20210629 to address the following security vulnerability issues: CVE-2021-34429 (BDSA-2021-2098).
VI-9339 Web Server

The Web Server now has a new config.xml property, deleteUnusedDashboards.

If set to true, dashboard files in the dashboards directory that are not found in config.xml will be deleted automatically. If set to false, the unused or unreferenced dashboard files will not be deleted. By default, this is set to true to preserve the original behaviour of the Web Server.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-4943

Active Console, GSE, Gateway, Netprobe, Webslinger, Licence Daemon, Web Server, FIX Analyser 2 Netprobe

 Fixed an issue that could cause random characters to be logged when the system error codes are translated to strings.
AA-5165 Gateway The formatting of the output of some Gateway commands has been improved so that when they are used in user-defined task commands, the output is more readable.
AA-5640 Gateway

Actions, and effects used by actions, can now invoke any command listed in the internal commands drop-down in the Gateway Setup Editor, or any other command provided by a Netprobe component, as long as its name starts with /PLUGIN: or /PROBE.

However, the Gateway is unable to validate the name or arguments of such a command, any such issues will only be reported when the action is invoked.
AA-5884 Gateway

Gateway reports a validation error if a throttle references an action that does not exist, if a script action running on a Netprobe that does not specify a probe on which to run, or if it references a script effect running on a Netprobe that does not specify a probe on which to run. It also reports a validation warning for any action which references such a throttle.

Although Gateway can usually use the source of the item that triggers the action to determine the probe on which to run a script, it cannot do so in the context of a throttle summary because the throttle can apply to data items from more than one probe.
AA-5908 Gateway

If the primary Gateway in a hot standby pair is restarted after the secondary has become active, the secondary will not release the Netprobes until setup, snooze, and user assignments files have been synchronised.

This involved changes which must be present in both primary and secondary Gateways, both must be the same version for failback to work correctly.
AA-6154 Gateway Gateway now provides a validation warning if redundant Kafka SSL settings are specified, or if Gateway Hub 3 secure communications settings are provided outside of the Basic tab in GSE.
COL-10344 Netprobe TotalSpace in the Disk Plugin now displays the consistent value.
VI-2711 Web Server Web Server no longer throws a null pointer exception if a folder or file with no file extension exists in the dashboard's directory.
VI-2982 Gateway Gateway error messages containing the word existant have been corrected to existent.
VI-9201 Active Console, GSE The GSEDocumentException that occurs and prevents historical files from being written no longer happens.
VI-9321 Active Console, GSE Active Console no longer hangs if the Metrics view table data contains curly brackets in the column headers. Active Console now replaces the curly brackets with parentheses in its rendering of the column header data.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.9.1

Released: 19 August 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console

  • FIX Analyser 2 Netprobe

  • Gateway

  • Netprobe

Highlights

These are the highlights of this release:

  • New IBM i Member Record plugin that can display member information given a list of files or file members.

  • Improved the FIX Analyser 2 message query report so that the messages sent and received in a session can be viewed together.

  • Better grouping of Gateway self-monitoring dataviews.

Breaking changes

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5979 Gateway

The sampler names used in Gateway self-monitoring have been changed, and sampler groups have been introduced.

The sampling interval of the probe data sampler has also been changed from 20 seconds to 5 seconds.
COL-8395 FIX Analyser 2 Netprobe The BidirectionalCompID option is now available in the FIX Analyser 2 Messages report so that the messages sent and received in a session can be viewed together.
COL-8747 Netprobe, FIX Analyser 2 Netprobe

An additional library path, netprobe/lib64/startup, with renamed libraries has been added to the Netprobe package for the generic Linux and Linux on IBM POWER8 platforms. This path should be used in ld when the Netprobe is run with elevated privileges in order to avoid possible breakage of system functions due to a clash with native libraries.
COL-10044 Netprobe

The IBM i File Member plugin has been divided into two separate plugins:

  • IBM i File Member — displays member information given a list of files.

  • IBM i Member Record — displays member information given a list of files or file members.
VI-9207 Active Console, GSE The Commons Codec library in the Active Console has been upgraded to 1.15 to address the security vulnerability issue: BDSA-2012-0001.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5546 Gateway If Gateway detects a fatal error with either the -kerberos-principal or -kerberos-keytab command line option, it will immediately exit, and the system reports the error. Previously, it would appear to start correctly, but Gateway would reject all attempts to apply a new setup.
COL-8540 Netprobe The percentMemory metric in the Top and Processes plugins now display the correct information on sd-pam processes.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.9.0

Released: 5 August 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console

  • Azure Monitor plugin

  • Docker image

  • FIX Analyser 2 Netprobe

  • File Agent

  • Gateway

  • Licence Daemon

  • Netprobe

  • SSO Agent

  • Terracotta Universal Messaging

  • Web Dashboard

  • Webslinger

Highlights

These are the highlights of this release:

  • Enhanced Azure Monitor plugin:

    • Ability to filter based on resource groups and tags.

    • Reduced number of API calls required to collect data.

    • New self monitoring view, including API usage metrics.

  • Improvements to Dynamic Managed Entities:

    • Auto pivot single row dataviews for better visibility in the Active Console.

    • Better management and visibility of any clashes in the entity attributes.

    • Visibility into dynamically created streams, making it easier to diagnose and resolve issues.

  • Trapmon plugin supports SNMP version 3 for authenticating and encrypting data packets over the network.

Breaking changes

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-6008 Active Console, GSE, Gateway, Netprobe, Webslinger, Licence Daemon, Web Server, FIX Analyser 2 Netprobe Added X-Frame-Options, X-XSS-Protection, and X-Content-Type-Options security headers to all HTTP and HTTPS responses from any Geneos components using an EMF2 port.
AA-6107 Netprobe All views in the Dynamic Entities Health plugin now set their samplingStatus headline to "WARNING: No dynamic mappings configured" if no dynamic mappings are configured.
AA-6112 Netprobe Netprobe now attempts to ensure that the attributes of existing Dynamic Entities remain consistent, and the attribute clash errors are now reported when new datapoints conflict with existing information.
AA-6117 Gateway Netprobes now automatically pivot Dynamic Managed Entity dataviews where the dataview row name has no dimensions associated with it.
AA-6131 Gateway

Gateway Publishing now allows the number of rows in a pivoted dataview to increase or decrease.

However, to avoid ingestion errors when publishing to Gateway Hub, all row names that appear in the dataview must be included as (pivoted) column names in the schema for the dataview. Also, the automatic schema inference (introduced in Gateway Hub 2.4.x) will not work for a pivoted dataview if rows are added after the schema has been inferred.
AA-6142 Gateway GSE ignores row mappings and displays a warning message when you map a dimension or property of a datapoint to a row and also to another setting (such as entity, sampler, dataview, ignore).
COL-3565 Netprobe Trapmon plugin on Linux now supports SNMP v3.
COL-5803 FIX Analyser 2 Netprobe Fixed the indentation of the search field in the FIX Analyser 2 web reports.
COL-7933 Integrations

The Apache log4j library in the Terracotta Universal Messaging has been upgraded to 2.14.0 to address the following security vulnerabilities:

  • CVE-2019-17571

  • BDSA-2017-0180

COL-9908 Netprobe The Dynamic Entities Health plugin now provides a Streams view that shows the number of subscribers for each stream.
COL-10109 Azure Monitor, Netprobe

The Azure Monitor 2.0.3 binaries are packaged with Netprobe 5.9.x, and are also available to download from the ITRS Downloads.

This update includes the following changes:

  • Azure Monitor plugin now displays a selfMonitoring sampler that lists the total API counts made by the plugin every collection interval and hour.

  • New configurations have been added. You can now filter by resource groups, and tag values. Adding tags as published properties can be used in dynamic entity mapping.
UTL-1084 Licence Daemon

The Geneos Licence Daemon (LICD) now supports a -report command line option. The default setting is for the summary reports to be available, but not the detailed report (all_licenses.csv).

  • -report none disables all HTTP reports.

  • -report detail enables all HTTP reports, including the detailed report. (This is the behaviour of the previous versions of LICD).
VI-9242 Active Console, GSE, Gateway, Netprobe, Webslinger, Licence Daemon, Web Server, FIX Analyser 2 Netprobe Added Strict-Transport-Security security headers to all HTTP and HTTPS responses from any Geneos component using an EMF2 port.
VI-9276 Active Console, GSE, Web Server

Active Console and Web Dashboard are now packaged with BouncyCastle 1.69 to address the following security vulnerabilities:

  • BDSA-2018-5235

  • BDSA-2021-1516

VI-9319 Web Server

The Spring Security libraries in the Web Server have been upgraded to 5.5.1 to address the security vulnerability issue: CVE-2021-22119.

In Geneos 5.8.2, changes have been made to the security.xml file in the Web Server config folder. We recommend that you use this latest version of security.xml when upgrading to Geneos 5.8.2 or newer. Otherwise, the Web Server will not run properly.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-6115 Gateway Gateway no longer crashes when SQL Server is in the process of shutting down while Gateway is attempting to add more data.
AA-6130 Gateway A check has been added to avoid a possible Gateway crash when a user connection is dropped between issuing a command and the command starting to execute.
COL-7317 Integrations The Terracotta Universal Messaging plugin binaries now contain the following files to run the plugin: properties file, jar files, and log4j configuration files.
COL-10087 Netprobe When metrics arrive from the Collection Agent with units that have no symbol, the unit description will be appended to the value when populating the dataview cell.
COL-10168 Netprobe The Trapmon plugin now displays a consistent time format (24 hour) for arrival time.
UTL-1157 Gateway RHEL 8 binaries now use system libraries.
VI-8917 Active Console, GSE Using duplicate or existing paths in other managed entity tabs no longer causes the entity attributes to disappear from the Group context menu.
VI-9287 Active Console, GSE The State Tree in Logical Mode view no longer shows overlapping Managed Entities when the viewpath, entity properties, or entity attributes are modified.
VI-9296 Active Console, GSE The State Tree in Logical Mode view no longer shows blank Managed Entities when the viewpath, entity properties, or entity attributes are modified.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.8.2

Released: 30 June 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Gateway

  • Kubernetes Collection Agent plugin

  • Netprobe

  • SSO

  • Web Dashboard

Highlights

These are the highlights of this release:

  • You can now publish log data to Splunk. The log data collected for File Keyword Monitor (FKM) can now be published to Splunk for storage and analysis. The data sent to Splunk is enriched with Geneos context so that you can search by managed entities, attributes, severities, and any matching triggers, or ignored keywords.

  • Enhanced Kubernetes monitoring. You can now monitor for specific namespaces, additional metrics for resource quota, node and container level CPU, and memory capacity limits.

Breaking changes

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-8653 Netprobe You can now set the day of the week by specifying the Reset days field in Fix Analyser which works with Reset time. This allows the reset to be configured on the least active day and time of the week, allowing for session states to be maintained for longer.
COL-9604 Netprobe The Publisher plugin now supports publishing FKM log data to Splunk.
COL-9914 Gateway, Netprobe Managed entity attributes are now included in the FKM outbound stream log data published to both Elasticsearch and Splunk.
COL-9915 Netprobe The FKM plugin now has an option to only publish the lines that are matched by trigger keys and ignore keys to the FKM outbound stream. This is useful when exporting log data to external log storage systems, such as Elasticsearch and Splunk.
COL-9999 Netprobe Updated the Kubernetes mapping configuration Gateway template file in the Netprobe Kubernetes package.
COL-10002 Netprobe Kubernetes Kubernetes 2.1.1 binaries are packaged with Netprobe 5.8.x.
C2-224 Kubernetes Collection Agent

The Kubernetes plugin now collects the following node metrics:

  • kubernetes_node_cpu_capacity

  • kubernetes_node_memory_capacity

  • kubernetes_node_memory_allocatable

C2-228 Kubernetes Collection Agent

The Kubernetes plugin now collects the following container metrics:

  • kubernetes_container_cpu_limit

  • kubernetes_container_memory_request

  • kubernetes_container_memory_limit

C2-229 Kubernetes Collection Agent

The Kubernetes plugin now collects the following metrics for Resource Quota metrics:

  • kube_resource_quota_hard

  • kube_resource_quota_used

  • kube_resource_quota_used_percent

C2-273 Kubernetes Collection Agent

The Kubernetes plugin now collects the kubernetes_pod_ip metric.

 
C2-274 Kubernetes Collection Agent Metrics can be collected for specific namespaces, and non-namespaced metrics (for example, node metrics) can be disabled.
C2-283 Kubernetes Collection Agent The Kubernetes client has been upgraded to 11.0.0.
UTL-1156 SSO Agent The SSO Agent libraries have been upgraded to guava-30.0-jre.jar to address the security vulnerability issue: CVE-2018-10237 (BDSA-2018-1358).
VI-9022 Web Dashboard

The Spring Security libraries in the Web Server have been upgraded to 5.5.0 to address the following security vulnerability issues:

  • CVE-2020-5408 (BDSA-2020-1094)

  • CVE-2021-22112 (BDSA-2021-0417)

This includes changes to the security.xml file in the Web Server config folder. We recommend that you use this latest version of security.xml when upgrading to Geneos 5.8.2 or newer. Otherwise, the Web Server will not run properly.

     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
COL-9677 Netprobe Netprobe now uses -setup-server-verify parameter value to verify servers when running Netprobe as self-announcing servers on Windows.
C2-284 Kubernetes Collection Agent Fixed an issue where the collected metrics for CPU and memory container requests or limits may contain inaccurate values.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.8.1

Released: 10 June 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console

  • Azure Monitor plugin

  • Collection Agent

  • Netprobe

  • Web Dashboard

Highlights

These are the highlights of this release:

  • With the addition of the Geneos Azure Monitor plugin, you can now monitor your Azure Cloud services alongside on-premise, hybrid, and multi-cloud environments for full end-to-end visibility:

    • This plugin can monitor and collect metrics from over 30 Azure services, such as VM, Network, Storage, Database, and Automation.

    • Minimal configuration with built-in Dynamic Entity mappings for more automated discovery.

    • Close to real-time alerts using Geneos powerful rule and alert capabilities.

    • Minimise cost by using single enterprise tool for monitoring.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-9992 Netprobe, Azure Monitor Azure Monitor 2.0.2 binaries are packaged with Netprobe 5.8.1, and are also available to download from the ITRS Downloads.
COL-9997 Netprobe, Collection Agent Collection Agent 2.2.2 binaries are packaged with Netprobe 5.8.1, and are also available to download from the ITRS Downloads.
VI-9293 Web Server

The Jetty library in the Web Server has been upgraded to 9.4.41.v20210516 to address the following security vulnerability issues:

  • CVE-2021-28163 (BDSA-2021-0850)

  • CVE-2021-28164 (BDSA-2021-0849)

  • CVE-2021-28165 (BDSA-2021-0848)
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
C2-277 Collection Agent Log messages about file deletion are now logged at debug instead of showing a warning.
C2-279 Collection Agent Object pooling is now disabled by default and it must be enabled if needed.
VI-9205 Active Console, GSE List view no longer contains duplicate items with the same paths.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.8.0

Released: 27 May 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console

  • Docker Image

  • Gateway

  • Netprobe

Highlights

These are the highlights of this release:

  • Support HTTPS access to remotely hosted Active Console resources, such as Gateway connection files and remote dockables.

  • Enhanced IBM i File Member plugin to monitor the capacity of file member records.

  • Undo and redo key functions for editable text fields in the Active Console and Gateway Setup Editor.

  • Updated Docker images for Gateway and Netprobe.

Breaking changes

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5479 Gateway

With the removal of the Express Reports feature of Gateway, the jQuery 1.2.6 library is no longer in use. This resolves the following security vulnerabilities: BDSA-2014-0063, BDSA-2020-0686, and BDSA-2015-0567.

AA-5915

 Netprobe Large numbers are now displayed properly in the Active Console when using Dynamic Managed Entities.

AA-6047

 Gateway Updated Docker base image for Gateway and Netprobe docker images.
AA-6076 Gateway The Express reports feature of Gateway is no longer supported. Express Reports will continue to be available and supported for Geneos 5.7.x and older until 31 December 2021.
AA-6079 Gateway

When a change to the value of a headline triggers a change to its severity, the actual value that triggered the rule will now be available in the published severity message, even if the value has changed again before the message is published.

Additionally, when a rule is triggered by a change to the value of its primary target, the correct value will be published even if the value changes again before the rule runs (this is unlikely, but possible if the rule threads are enabled).
COL-9818 Netprobe Enhanced IBM i File Member plugin to show the number and capacity of file members.
COL-9824 Netprobe Fixed an issue in the IBM i File Member plugin where percentUsage is showing a non-numeric value or NaN.
VI-8778 Active Console, GSE You can now edit the title of Widget objects such as Line charts, Pie charts, and gauges using the Object Inspector dockable.
VI-8993 Active Console, GSE Improved the Gateway connection file error messages in the Active Console.
VI-9197 Active Console, GSE The undo and redo key functions, CTRL +Z and CTRL + Y, are now supported in Active Console and Gateway Setup Editor for the following: text fields, multiline text, and editable drop-down fields.
VI-9255 Active Console, GSE Active Console can now use Gateway connection files hosted over HTTPS.
VI-9283 Active Console, GSE Active Console can now use remote dockables hosted over HTTPS.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5876 Gateway Set execution bit on kafkacat shipped with the Gateway.
AA-6062 Gateway Added a message to warn the user that setting pivot on the schema of a dataview that has expect rows set is not supported.
AA-6105 Gateway Fixed an issue where Gateway could crash when under heavy load and importing a large number of dataviews from another Gateway.
COL-9111 Netprobe The RMC plugin now handles RMC restarts without affecting other RMC dataviews.
COL-9231 Netprobe Fixed IBM i Systems CPU and Hardware schema publishing error at start-up.

COL-9653

COL-9686

 Gateway Active Time configuration is now successfully sent from the Gateway to Self-Announcing Netprobe.
COL-9823 Netprobe Fixed an issue in IBM i File Member plugin where the negative numbers are shown in the recordCapacity field.
COL-9826 Netprobe Added percentage % symbol to IBM i File Member plugin percentUsage field.
VI-9294 Active Console, GSE Active Console no longer hangs when you right-click a Gateway or dataview.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.7.2

Released: 18 May 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Gateway
  • MDM Feed Adapter API Kit
  • Netprobe

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-6098 Gateway Added built-in mapping for Azure Monitor V2.
COL-8009 MDM Feed Adapter API Kit

Removed /docs file from the API kit to remove security vulnerability.

COL-9764 Netprobe Publisher plugin now supports secured gRPC client connection for publishing log data to Gateway Hub 3 using the Collection Agent. Java 8u252 or newer is required.
UTL-1198 Gateway, Netprobe Gateway and Netprobe now support PostgreSQL 12.
UTL-1199 Gateway, Netprobe Gateway and Netprobe now support MS SQL Server 2019.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
COL-9829 Gateway Column types in the Hardware plugin data schema (for publishing to Gateway Hub) now match for Linux and Windows NT.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.7.1

Released: 28 April 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Centralised Config Migration Tool
  • Gateway
  • Gateway Recorder
  • Licence Daemon
  • Netprobe
  • SSO Agent
  • Web Server

Highlights

These are the highlights of this release:

  • Migration tool for centralised Gateway configuration.

  • New IBM i File Member plugin for monitoring the capacity of records within file members.

Centralised config migration tool

Gateway configuration files can be stored and managed centrally in the Gateway Hub. The migration of Gateway configuration into Gateway Hub requires careful planning. In large enterprise environments, this can take a number of days for each Gateway.

In this release, a new standalone migration tool is now available to help with this process. The tool can be run to check the readiness of a Gateway to migrate its configuration, and when ready, to perform the migration itself. The tool is designed to be used by a Geneos administrator to allow for phased migration in large environments.

For more information, see Migrate Gateways to Centralised Configuration.

IBM i File Member

A new plugin is now available in the IBM i. The IBM i File Member displays the members of the specified database file of the IBM i system.

Breaking changes

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5924 Gateway The Centralised Config Migration tool is now available. It can be used to check the readiness of a Gateway to migrate its configuration, and when ready, to perform the migration itself.
COL-9605 Netprobe

The Publisher plugin now supports publishing to Gateway Hub 3.x using the Collection Agent.

A new configuration layout for Elasticsearch is also introduced. The Publisher plugin configuration prior to version 5.7.1 is not compatible with version 5.7.1 and higher. We recommend that you update the configuration after upgrading to Geneos 5.7.1 and higher.
COL-9655 Netprobe IBM i File Member plugin has been added which can be used to monitor record capacities for the IBM i members.
UTL-1046 Licence Daemon LICD logs the name of the components when these disconnect from LICD.
UTL-1197 SSO Agent The json-smart library in the SSO Agent has been upgraded to 2.4.2 to address the security vulnerability issue: CVE-2021-27568.
VI-9222 Web Server The config.user.groups and dashboard.user.groups properties in the Web Dashboard now check Gateway Hub roles for dashboard and configuration page access.
VI-9292 Active Console, GSE, Web Server The json-smart library in the Active Console and Web Server has been upgraded to 2.4.2 to address the security vulnerability issue: CVE-2021-27568.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description

AA-6083

AA-6092

 Gateway

Fixed an issue where the Gateway Hub validation of hot standby Gateways failed.

Gateway validation in the Gateway Hub now correctly validates for a hot standby Gateway.

COL-1079

COL-6227

 Netprobe Fixed incorrect reporting of elapsedTime age in the Process plugin when DST is in effect.
COL-9723 Netprobe Removed values for pageFileBytesPeak and workingSetPeak for the Summary row when using a Windows Netprobe.
COL-9737 Netprobe Fixed an issue when using the Publisher plugin to publish stream messages to Gateway Hub 3.x.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.7.0

Released: 7 April 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Gateway
  • Netprobe
  • Web Dashboard

Highlights

These are the highlights of this release:

  • Schema-less publishing to Gateway Hub.

  • Simplified Dynamic Entities.

  • Plugin improvements.

  • Improve handling of fonts in the Web Dashboard.

  • Ability to disable weak cipher suites when encrypting communication between Geneos components.

  • New plugins and integrations documentation page.

Schema-less publishing to Gateway Hub

Data schemas describe the data published from Gateway to Gateway Hub. The Gateway comes packaged with built-in schemas for many out-of-the-box plugins. When a data schema does not exist (in the case of custom plugins such as API and Toolkit), you can create user-defined schemas and add these to the sampler. In large environments, this could mean many hundreds of sampler configurations.

To simplify this process, Gateways can now publish data to the Gateway Hub with no schema. The Gateway Hub 2.4.x and newer versions will have the ability to auto-generate a schema based on the sample data. This approach allows for faster deployment while allowing you to fine-tune and correct any data schema issues over time.

Simplified Dynamic Entities

The Dynamic Entities feature enables Gateways to automatically create Geneos data structures such as entities, attributes, samplers, and dataviews based on the mapping configuration, which describes how dimensional data received from Collection Agent are mapped to Geneos data structures.

In this release, the mapping configuration has been simplified considerably. The minimum configuration required is to map dimensions to an entity, while the rest of the Geneos data structures can be automatically derived. For more information, see Mapping type configuration in Dynamic Entities.

Plugin improvements

This release introduced several updates to plugins:

  • Improved NTP time offset metric in the Hardware plugin, including support for chrony on Linux machines.

  • REST Extractor plugin now supports client- and server-level certificate authentication.

  • Improved the IBM i plugins to support filtering of data to minimise impact on monitored systems.

New plugins and integrations page

The unified documentation page for plugins and integrations is now available beginning Geneos 5.6.x versions of the documentation. This page contains the list of Netprobe built-in plugins, integrations, and new Collection Agent plugins.

To improve user experience, the new plugins and integrations page comes with improved search and filter categories. For more information, see Plugins and integrations.

Breaking changes

If you are upgrading from an earlier version of Geneos, please read Geneos Upgrade Notes for compatibility changes you should be aware of before upgrading.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-6007 Gateway

Gateway can now publish dataviews that do not have a publishing schema. However, schema errors are still handled normally:

  • Gateway Hub 2.4.x will infer a schema by inspecting the values in the first few samples.

  • Gateway Hub 2.3.x will continue to report ingestion errors if a dataview is published without a schema.
COL-6539 Netprobe The NTP data is now available in the Netprobe logs when using the Hardware plugin.
COL-9182 Netprobe The Hardware plugin now has the capability to check available timeSyncSource in the Netprobe machine.
COL-9183 Netprobe The Hardware plugin now supports chrony.
COL-9307 Netprobe The REST Extractor plugin can now handle JSON responses that are empty, but otherwise valid.
COL-9355 Netprobe The REST Extractor plugin now supports client and server authentication.
COL-9576 Netprobe Filtering options are now available in the IBM i Subsystem.
COL-9684 Netprobe Improved the filtering options in the IBM i Queue.
UTL-1186 Gateway You can now set the cipher list in listener using the OPENSSL_CIPHERenvironment variable.
VI-9270 Active Console, GSE, Web Server Web Dashboard now uses Open Sans as its default font. Only the .ttf or .ttc file formats in the fonts folder will be registered, and those fonts can be used by existing dashboards.
VI-9275 Web Server

The Jetty library in the Web Server has been upgraded to 9.4.38.v20210224 to address the following security vulnerability issues:

  • CVE-2020-27218 (BDSA-2020-3580)

  • CVE-2020-27223 (BDSA-2020-4221)
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-6034 Netprobe Self-Announcing Netprobes no longer assert that the reason for not choosing a Gateway is due to lack of support for multiple Managed Entities.
COL-6415 Netprobe MQ Queue and MQ Channel plugins now support MQC SP with SSL.
COL-9356 Netprobe The Processes plugin now displays data under the user column correctly.
COL-9454 Gateway, Netprobe Added second timeout for Dynamic Entity metric data.
COL-9581 Netprobe Java plugins dataviews are now created when Managed Entity names contain period.
COL-9676 Netprobe The REST Extractor plugin no longer encounters null pointer exceptions when using PUT and POST methods without body or payload.
COL-9738 Netprobe Netprobe no longer crashes when the TCP or UDP files in the /proc/net directory are missing.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.6.1

Released: 2 March 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Gateway
  • Netprobe
  • Web Dashboard
  • Control-M plugin
  • VMware plugin

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-7307 Integrations The Xerceslmpl library has been upgraded to 2.12.1 to address the security vulnerability issue: CVE-2012-0881.

COL-7931

COL-7932

 

Integrations

 The Apache log4j-core library has been upgraded to 2.14.0 to address the security vulnerability issue: CVE-2017-5645.
COL-9561 Netprobe The IBM i JDBC plugin dataview update performance has been improved.
VI-9031 Web Server

The ActiveMQ library has been upgraded to 5.16.1 to address the following security vulnerability issues:

  • BDSA-2021-0225

  • CVE-2020-1941

  • CVE-2020-13920

     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5969 Gateway Gateway no longer checks port availability and SSL certificates when validating Gateway in the Gateway Hub centralised configuration environment. These checks are not required for validating configuration with different versions of Gateway.
COL-9572 Integrations VMware plugin no longer creates duplicate container view objects.
UTL-1158 Gateway, Netprobe The Gateway and Netprobe packages for CentOS or RHEL 8 are now available.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.6.0

Released: 9 February 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Collection Agent
  • Docker Image
  • Gateway
  • Kubernetes plugin
  • Netprobe
  • SSO Agent
  • Web Dashboard
  • Webslinger

Highlights

These are the highlights of this release:

  • IBM i JDBC plugin can now publish query results to Geneos streams to be consumed by other plugins, such as File Keyword Monitor and State Tracker.

  • SQL Toolkit plugin now supports Windows authentication for Linux environments.

  • Gateways now support connecting to Gateway Hub using Hub Application Keys. This simplifies the configuration required to securely connect to Gateway Hub.

  • You can now adjust the width of the Metrics view navigation pane to improve visibility.

IBM i JDBC plugin

You can now enable the publishing of query results to a stream. When streaming is enabled, headlines for stream information appear in the query dataview.

For more information, see IBM i documentation.

SQL Toolkit plugin

SQL Toolkit plugin on Linux environment now supports Windows authentication through Kerberos when connecting to MS SQL Server database. This enables a more secure connection to MS SQL Server from Linux environments.

For more information, see SQL Toolkit documentation.

Metrics dockable

Beginning Geneos 5.6.x, you can now adjust the width of the navigation pane in the View > Metrics by dragging the line border to the left or right.

For more information, see Metrics dockable documentation.

Breaking changes

These are the breaking changes in this release:

New ITRS Maven repository

The ITRS Maven repository has changed its location from <url>https://itrsgroup.bintray.com/collection</url> to <url>https://maven.itrsgroup.com/repository/public</url>. Please update all the existing links as they will stop working by end of February 2021.

Workspace directory

Beginning Geneos 5.6.x, Active Console now sets the new workspace default directory to the following paths:

  • On Windows: ~\ITRS\ActiveConsole

  • On macOS and Linux: ~/ITRS/ActiveConsole/

The new default workspace directory is used when creating a new workspace, but all existing workspaces are not affected. For more information, see Workspace directory in Active Console.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5788 Gateway Gateways now support connecting to Gateway Hub using Hub Application Keys.
AA-5830 Netprobe Collection Agent DataPoint dimensions have been added to the Geneos dataview rows as runtime parameters.
AA-5899 Gateway, Webslinger Gateway can use both LDAP groups and Hub defined roles when deciding which Gateway roles to assign to a user.
AA-5949 Docker Image Improved the wait code in the Gateway container that is used when waiting for a Gateway Hub to become available.
COL-4658 Netprobe Windows Netprobes run as service or in the command line can now use variables set in the registry, system level environment, or in local user session environment.
COL-8295 Netprobe SQL Toolkit plugin connecting to MS SQL Server database now supports Windows authentication through Kerberos in Linux Netprobes.
COL-9297 Netprobe IBM i JDBC plugin now supports an option to publish query results to Geneos streams to be consumed by other plugins, such as File Keyword Monitor and State Tracker.
COL-9394 Netprobe You can now set the qualified path name as the rowname in the IBM i Queue plugin. This is done with the useFullPathForRowname setting, and prevents duplicate rows arising from similar queue names.

COL-9397

UTL-1173

 Netprobe

SSO Agent

The Bouncy Castle libraries have been upgraded to 1.68 to address the security vulnerability issue: CVE-2019-17359.
COL-9425 Netprobe Webmon plugin on Linux can now accept principals and keytabs to facilitate automatic Kerberos ticket renewal.
COL-9482 Netprobe Upgraded the Collection Agent to 2.2.1 and the Kubernetes plugin to 2.0.6.
UTL-1174 SSO Agent

The Undertow Core libraries have been upgraded to 2.2.-FINAL to address the following security vulnerabilities:

  • CVE-2019-3888

  • CVE-2019-10212

  • CVE-2019-10184

VI-9084 Active Console, GSE You can now set up a CyberArk Local Credential Provider password agent to retrieve passwords for database connections for historical charts, and querying events in the Active Console.
VI-9110 Web Server You can now set up a CyberArk Local Credential Provider password agent to retrieve passwords for database connections for historical charts and in the Web Dashboard.
VI-9189 Active Console, GSE Active Console sets the new default workspace directory to ~\ITRS\ActiveConsole for Windows and ~/ITRS/ActiveConsole/ for macOS and Linux. The new default workspace directory is used when creating a new workspace, but all existing workspaces are not affected.
VI-9193 Active Console, GSE The Initial Download size (kb) label has been changed to Initial Download size (max of 1024 kb).
VI-9203 Active Console, GSE You can now adjust the width of the Metrics view navigation pane by dragging the line border to the left or right.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
C2-251 Collection Agent Periodic collectors now use a different sleep strategy to mitigate inconsistent collection intervals.
C2-255 Collection Agent The Bouncy Castle libraries have been upgraded to 1.68 to address the security vulnerability issue: CVE-2020-28052.
COL-1667 Netprobe Netprobe now exits when terminated with CTRL+C while using the SQL Toolkit plugin.
COL-1674 Netprobe The SQL Server port now works when using a non-standard (non-default) port number in the SQL Toolkit plugin.
COL-8069 Netprobe Netprobe now displays warning messages in the Netprobe logs when it disconnects from the Gateway. Previously, these messages were tagged as Info.
COL-8265 Netprobe Netprobe libcurl library now uses OpenSSL.
COL-9179 Netprobe Netprobe no longer crashes when terminated with CTRL+C while using the SQL Toolkit plugin.
COL-9447 Netprobe Extra None: string is no longer added to messages received by the Netprobe from the Kubernetes plugin.
COL-9456 Netprobe The Disk plugin publishing schema has been updated to accept float64 and int64 values.
COL-9498 Netprobe Fixed the WebMon segmentation fault when using gss-negotiate and Netprobe is terminated with CTRL+C.
VI-1957 Active Console, GSE Duplicate commands from different Gateways with different groupings now display correctly in the Active Console context menu.
VI-9145 Active Console, GSE Selecting Chart > Interpolate now enables interpolation for all of the chart's datasets.
VI-9194 Active Console, GSE The maximum value of the Initial Download size field in the View File dialog box has been set to 1024.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.5.2

Released: 7 January 2021

This release delivers the updated binaries in the ITRS Downloads page for:

  • Netprobe

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-9404 Netprobe

IBM i Message plugin now applies the maxRowLimit setting earlier in the message retrieval process. This optimises the retrieval of a high volume of messages.

This change is only applicable on Linux platforms.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.5.1

Released: 17 December 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Collection Agent
  • Gateway
  • Netprobe
  • Web Server

Highlights

These are the highlights of this release:

  • The new IBM i JDBC plugin lets you query DB2 databases running in IBM i.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-5798 Netprobe The TCP Links plugin no longer uses netstat tools package by default for Linux Netprobe.
COL-9296 Netprobe The new IBM i JDBC plugin now supports publishing query results from DB2 for i.
COL-9302 Gateway All the cells in a row in a dynamically populated dataview now have the same dimensions including the names and values.
COL-9424 Netprobe Collection Agent 2.2.0 is now packaged with Netprobe 5.5.1.
VI-9195 Active Console, GSE The jackson libraries have been upgraded to 2.11.3 to address the security vulnerability issue: BDSA-2020-2965.
VI-9196 Web Server

The jetty libraries have been upgraded to 9.4.34 to address the following security vulnerability issues:

  • CVE-2020-27216

  • BDSA-2020-3580

     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
C2-219 Collection Agent Transient collector exceptions are now included in the error logs.
C2-249 Collection Agent Fixed the deserialisation error caused by extreme samples in a TimerHistogram.
COL-8381 Netprobe RMS restart command for Netprobe running as a service now works correctly.
COL-9121 Netprobe FLM publishing schema now contains consistent data types.
COL-9292 Netprobe RMS Shutdown now works properly on Windows Netprobe Service.
COL-9407 Netprobe Fixed the deserialisation error that caused the Netprobe to drop the connection to the Collection Agent.
COL-9408 Netprobe Fixed the high CPU usage in the Dynamic Entities module when receiving a large number of updates.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.5.0

Released: 25 November 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • File Agent
  • FIX Analyser 2
  • Integration: Azure Monitor
  • Kubernetes Collection Agent plugin
  • Licence Auditor
  • Licence Daemon
  • Gateway
  • Netprobe
  • SSO Agent
  • Web Dashboard
  • Webslinger

Highlights

These are the highlights of this release:

  • Gateway Database Logging for MSSQL Server now supports the Kerberos authentication.
  • Improved support for Geneos components to work in deployments where communication is required to pass through load balancers.
  • Improved support for user-friendly display names in the Active Console for probe, entity, and sampler.

Gateway

Gateway now supports the Kerberos authentication when connecting to Microsoft SQL Server for database logging. The default ODBC driver string has been updated to ODBC Driver 17 for SQL Server.

For more information, see Gateway Database Logging.

SSO Agent

The SSO Agent provides tokens used to authorise the users to access Geneos components. In this release, the SSO Agent now works correctly behind a load balancer with multiple nodes making it easier for a token to be used by a different client than the one to which it was issued.

For more information, see Tokens and token lifetimes in SSO Agent User Guide.

Breaking changes

These are the breaking changes in this release:

New binary file name for Geneos components

As part of the improvements to automate our deployment process, the binary file naming convention in ITRS Downloads has been changed from geneos-<component>-<version>.<os>.tar.gz to geneos-<component>-<version>-<os>.tar.gz. This change applies beginning Geneos 5.5.x.

File Keyword Monitor settings

The files > file > groups setting in the FKM plugin has been deprecated. This setting was originally provided for easy migration for the users of Gateway 1.

We recommend that you configure the Gateway user permissions instead of this setting.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-4396 Gateway Gateway now supports the Kerberos authentication (Windows Integrated Authentication) when connecting to Microsoft SQL Server for database logging and retrieving adaptive rules datasets.
AA-5725 Licence Auditor

Licence Auditor is now available for Windows 64-bit.

The previous package for Windows 32-bit is no longer available.
AA-5848 Gateway You can now use the centralised configuration without enabling SSO in the Gateway Hub.
AA-5889 Gateway Added support for GATEWAY_CONFIG and NETPROBE_CONFIG environments in the Geneos docker images.
COL-7672 File Agent

File Agent is now available for Windows 64-bit.

The previous package for Windows 32-bit is no longer available.
COL-8025 Schema The Groups setting in the File Keyword Monitor plugin is now deprecated.
COL-8133 Netprobe The REST Extractor plugin now supports JQ expressions and field names in the Response token field.
COL-8820 Netprobe Self-Announcing Netprobes now support configuration for external passwords using CyberArk.
COL-8898 Integration The Azure Monitor integration now uses compatible Python library versions.
COL-9290 Netprobe The Kubernetes Collection Agent plugin has been upgraded to version 2.0.5.
UTL-1133 Netprobe

Net-SNMP has been upgraded to version 5.9. This is used by both Mibmon and Trapmon plugin. This update addresses the following:

  • BDSA-2004-0008

  • CVE-2020-15862 (BDSA-2020-2085)

  • CVE-2020-15861 (BDSA-2020-2084)
UTL-1167 Active Console, GSE, Gateway, Netprobe, Webslinger, Licence Daemon, FIX Analyser 2 Geneos components now use the TLS SNI feature to indicate the hostname when connecting to a host which is identified by name.
VI-8248 Active Console, GSE You can now open the Active Console and GSE as a standalone application on macOS without getting this warning message: Active Console can't be opened because it is from an unidentified developer.
VI-8609 Active Console, GSE The fields in the Command dialog box have been modified to display the text fields correctly.

VI-8996

VI-9168

 Active Console, GSE The -wsp and -ws flags now support environment variables in specifying paths in the ActiveConsole.gci file.

VI-9159

VI-9161

 Active Console, GSE The Copy from <name> and Create Notifier Filter options in the gw/probe/ME/sampler/dataview context menu now use the display name when it is available.
VI-9162 Active Console, GSE The Copy from <name> > Send Properties to Output Viewer command in gw/probe/ME/sampler/dataview now uses the display name as the tab name when it is available.
VI-9160 Active Console, GSE The Entity Display Name has been added in the Event Tickers Dockable.

VI-9181

VI-9182

 Active Console, GSE The user readable paths throughout the Active Console and Gateway Setup Editor now use the Managed Entity display name when it is available, except if GSE is opened as a standalone application.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5047 Gateway The Kafka adapter used by Gateway now closes down correctly even if message acknowledgements continue to be received from a Kafka broker long after the messages were sent. Also, the Gateway log now shows the name of the Kafka topic if the broker reports that the topic is unknown.
AA-5248 Gateway, FIX Analyser 2, Netprobe When a floating probe connects to a Gateway for which no floating probes are configured, the messages logged by the Gateway and Netprobe no longer refer to a licensing issue, or incorrectly refer to the Netprobe as a Self-Announcing Netprobe.
AA-5521 Gateway On AIX systems, the Netprobe standard output now shows the correct offset from UTC in the default timestamp format.
AA-5763 Gateway Setup permissions on the main Gateway setup file can now be granted by specifying the name of the file, as an alternative to using the Main file check box. This may be useful where permissions are granted in a setup include file.
AA-5805 Gateway In Dynamic Mappings, if both the Display name mapping and the GeneosDisplayName attribute mapping are set, then the mapping that will be used is the GeneosDisplayName attribute (GSE will prompt a warning message).
AA-5808 Gateway The GeneosDisplayName attribute now correctly works when defined in the self-monitoring Managed Entity.
AA-5823 Gateway You can now use the password argument type when invoking a command from an Effect.
AA-5839 Gateway Command arguments of type Parameter are now handled correctly when an Effect invokes a command.
AA-5843 Gateway Gateway now correctly handles a setup change which does not change the database logging passwords, but which enables or disables password lookup through a CyberArk Local Credential Provider.
AA-5874 Gateway Gateway no longer crashes when a command effect is invoked by a throttle summary action.
C2-182 Kubernetes Collection Agent plugin The Apache Commons Codec library has been upgraded to 1.14 to address the security vulnerability issue: BDSA-2012-0001.
C2-202 Kubernetes Collection Agent plugin KubernetesLogCollector now resumes operation if inode is reused after rollover.
COL-1402 Netprobe Processes plugin can now handle long arguments in Linux and AIX.
COL-7602 Netprobe Netprobe no longer opens a database connection when loading a new SQL Toolkit plugin.
COL-8103 Netprobe The REST Extractor plugin can now create dataviews following empty data on start.

COL-8728

COL-8896

Netprobe Bloomberg B-Pipe plugin now handles null element in the Application and Summary dataview.
COL-8808 Netprobe IBM i plugin publishing schema has been updated to be consistent with the Gateway.
COL-9147 Netprobe The expectedTime cell is now correctly displayed in the FTM dataview when approaching the start or the end of Daylight Savings Time and when approaching the next year.
UTL-1168 Gateway, Netprobe, Webslinger, FIX Analyser 2 Geneos components now correctly validates the TLS certificates with expiry dates.
UTL-1169 SSO Agent

SSO Agent now allows the check to be disabled which compares the address of the client to which a token was issued with the address of the client presenting the token.

This change allows the SSO Agent to work correctly behind a load balancer with multiple nodes.
VI-1383 Active Console, GSE The scaling of duplicated dashboard objects has been fixed when the dashboard is zoomed.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.4.0

Released: 30 September 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Collection Agent
  • Docker Image
  • Gateway
  • Netprobe
  • Web Server

Highlights

These are the highlights of this release:

  • Self-monitoring in Geneos is now enabled by default with no configuration required.
  • Both Gateways and Netprobes are now available as Docker images for easy deployment. You can download them from the ITRS docker registry.
  • The Control-M plugin now supports BMC Control-M versions 9.0.19 and 9.0.20.
  • Tibco EMS plugins now support client and server-side SSL authentication for more secure connectivity.
  • FTM plugin can now identify and monitor file transfers that occur on a specific day of the month, specific weekday, or business day of a month.

Geneos containers

Gateways or Netprobes are now available as Docker images to run as containers. This is especially useful for deploying Geneos in orchestrated environments.

To run Geneos containers, you must download the container image from the ITRS docker registry. This prompts you to provide login details, these are the same as the credentials you have been provided to access the ITRS website.

For more information, see Install in Geneos Containers.

Control-M plugin

The Control-M plugin now supports BMC Control-M versions 9.0.19 and 9.0.20. This update also includes new metrics for the estimated start and end times, as well as the ability to find out the reasons why a waiting job has not yet been executed.

For more information, see Metrics and dataviews in the Control-M Plugin Technical Reference documentation.

File Transfer Monitor plugin

Beginning Geneos 5.4.x, the FTM plugin now has the capability to associate working days when monitoring files monthly. Also, this plugin can now count the working days either from the start or the end of the month.

For more information, see Day of month in the File Transfer Monitor (FTM) Plugin Technical Reference documentation.

Breaking changes

These are the breaking changes in this release:

Self-monitoring in Geneos

Beginning Geneos 5.4.x, self-monitoring in Geneos is now enabled by default with no configuration required.

This results in an Entity being dynamically created called <gateway_name> Info which contains samplers and dataviews that are automatically enabled with no configuration required. These samplers and dataviews are created using the existing Gateway plugins which you may already have manually configured in your Gateways.

If you do not wish the Gateway to automatically create a self-monitoring Entity, you can disable this feature in the Gateway > Operating environment section.

For more information, see operatingEnvironment > selfMonitoring in Gateway Operating Environment documentation.

In addition, an Entity is automatically created for all running Gateways to utilise its existing built-in plugins and to dynamically start monitoring its performance. Monitoring includes data on the performance of the Gateways, connected Netprobes, and client applications, such as Active Console, connectivity to Gateway Hub, and summary of key activities including severity, snooze, and user assignments.

E4JMS plugin

Beginning Geneos 5.4.x, the E4JMS plugin supports SSL client authentication. This feature introduces breaking changes to the E4JMS plugin SSL implementation for older Geneos versions.

If you are using SSL connections on your E4JMS plugins, you must update your configuration when using the new schema.

For more information, see E4JMS Plugin Technical Reference.

File Keyword Monitor plugin

Beginning Geneos 5.4.x, the FKM plugin uses Perl Compatible Regular Expressions (PCRE) by default. Be aware that this may introduce breaking changes in your implementation.

For more information, see the following documentation in the File Keyword Monitor:

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5509 Gateway The algorithm used by Gateway to remove duplicates when evaluating XML path expressions has been optimised. This improves performance when parsing large setup files.

AA-5655

COL-8444

 Gateway, Netprobe, Docker Image Docker images containing the Gateway and Netprobe are now available from ITRS Docker website.
AA-5665 Gateway The librdkafka libraries have been updated to 1.5. You may refer to the official documentation of librdkafka libraries in Github for more information.
AA-5697 Gateway The new templates for Kubernetes monitoring and Cloud Foundry monitoring have been added to the Geneos Gateway package.
AA-5727 Gateway Gateway now automatically adds a self-monitoring Managed Entity. You can disable this option if you want to get more control over what self-monitoring is provided.
AA-5737 Gateway Schema The schema for Dynamic Entity mappings now includes an optional section called Entity Display Name Mapping. This is converted by the Gateway to mapping for a special entity attribute, GeneosDisplayName. When this attribute is present on a Dynamic Entity, it sets the display name for the entity.
AA-5738 Gateway

When publishing to Gateway Hub, if an entity has a display name defined, it will be published with an attribute called GeneosDisplayName with a value matching the display name.
AA-5744 Gateway The template setup files supplied with Gateway, templates/gateway.setup.xml.tmpl and templates/gateway.setup.withdefaults.xml.tmpl, now specify the Gateway name as Demo Gateway so that either of them can be used unaltered as the initial setup of a Gateway in demo mode.
AA-5764 Gateway Gateway now logs an error if a call made to the Hub API fails.
AA-5780 Gateway The display name for a Managed Entity can now be set by defining an attribute with the name GeneosDisplayName. Setting either of these now sets the other. If there is a conflict, the attribute takes precedence.

AA-5782

COL-9113

 Gateway, Netprobe Gateway and Netprobe no longer log drop connections when you use the listen port to check if the Gateway or Netprobe is alive.
COL-7601 Netprobe Control-M plugin now includes metrics for estimatedStartTime and estimatedEndTime in the dataview.
COL-8192 Netprobe Control-M plugin now supports Control-M versions 9.0.19 and 9.0.20.
COL-8829 Netprobe Encoded passwords can now be defined in the Netprobe setup file.
COL-8900 Netprobe E4JMS plugins now support client authentication.
COL-8901 Netprobe E4JMS plugins now support optional SSL bypassing host verification, as well as E4JMS server version 8.5.1.
COL-8980 Netprobe Control-M now displays the Waiting Info parameter in the dataview.

COL-9064

COL-9065

 Netprobe

File Transfer Monitor plugin now has the capability to associate working days when monitoring files monthly.

In addition, the FTM plugin can count the working days either from the start or the end of the month.
COL-9070 Netprobe The Collection Agent has been updated to 2.1.2.
COL-9112 Netprobe The display name for a Managed Entity created by a Self-Announcing Netprobe can be set by defining the GeneosDisplayName attribute in the probe setup file.
UTL-1130 Netprobe GLib 1.2.10 and its headers have been removed. These were used by TIB RV, Fidessa, GL SLE TCP, GL Routers, and GL Permissions plugins.
VI-9033 Web Server

The Jetty library in the Web Server has been upgraded to 9.4.30 to address the following security vulnerability issues:

  • CVE-2017-7657 (BDSA-2018-2047)
  • CVE-2017-7658 (BDSA-2018-2050)
  • BDSA-2019-1166
  • BDSA-2018-2904
  • CVE-2017-9735 (BDSA-2017-3655)
  • CVE-2017-7656 (BDSA-2018-2043)
VI-9090 Web Server Improved error handling when a non-numerical value is used for a time, row, and column on TileServlet. This addresses the vulnerability issue: QID 150022.
VI-9111 Active Console, GSE Active Console can now retrieve encrypted passwords from the Gateway.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5383 Gateway The probe hostname is now available to script actions and effects as _NETPROBE_HOST whether or not the rule threads are enabled.
AA-5687 Gateway

Gateway now correctly applies sync level requests from the Active Console

Previously, Gateway would misapply sync level requests, and Gateway Sharing connections for Gateway to Gateway traffic would be marked as having an incorrect sync level. This resulted in data not being sent by the exporting gateway to the importing gateway.
AA-5719 Gateway Gateway now supports the use of an effect for a throttle summary action. The set of environment variables available to an effect in this context is the same as for an action invoked directly.
AA-5760 Gateway Gateway Hub validation of Gateway setup files does not check for the creation of files in the working directory, since this is a local check that Gateway Hub cannot perform.
AA-5761 Gateway Gateway Hub validation of Gateway setup files does not check for a missing data directory, since this is a local check that Gateway Hub cannot perform.
AA-5762 Gateway Gateway Hub validation of Gateway setup files does not check for a missing Scheduled Command log directory, since this is a local check that Gateway Hub cannot perform.
AA-5771 Gateway Gateway now correctly reencodes AES-encoded credentials created using a Gateway key file for the Mibmon plugin.
AA-5783 Gateway Gateway no longer produces a race condition when an action that has been triggered but not processed is deleted by a setup change.
AA-5790 Gateway Dynamic Entity mappings now correctly expand variables in Dynamic Mappings using the environment provided in the Dynamic Mapping Type.
C2-181 Collection Agent The SnakeYAML library has been upgraded to 1.26 to address the security vulnerability issue: CVE-2017-18640.
C2-200 Collection Agent

Fixed a timing issue where metric collection fails if a thread is removed while collecting metrics about that thread.
C2-203 Collection Agent The JVM no longer retains handles to store files that were deleted. The deleted files are now properly released and the disk space is reclaimed.
COL-7016 Netprobe The Process thread count in the monitored Java application no longer increases unexpectedly when a timeout is encountered in the JMX connection.
COL-8912 Netprobe Fixed the auto-restart issue in Netprobe due to the incorrect memory protection logic on high memory usage probes.
COL-9017 Netprobe Netprobe no longer crashes when you use any combination of records and fields in a string value. The string value now accepts records of more than 255 characters.
VI-8067 Active Console, GSE The Title Text and Scale Label Fonts in the Gauge Properties now display the correct values in the Object Inspector.
VI-8949 Active Console, GSE The floating dockables in the Active Console now display the correct severity icons when the Active Console has started.
VI-9075 Gateway Schema

Gateway Setup Editor now marks the static text in the Dynamic Entity mapping in red. This occurs at the following places in the setup:

  • //mapping/entityMapping/directoryMapping/static/data
  • //mapping/samplerMapping/directoryMapping/static/data
  • //mapping/dataviewMapping/directoryMapping/static/data
  • //mapping/labelBuilders/choice/choices/choice/value
  • //mapping/labelBuilders/choice/fallback
  • //mapping/labelBuilders/regex/fallback
VI-9126 Active Console, GSE An error, NullPointerException, no longer occurs when you add historical line charts.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.3.1

Released: 12 August 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Gateway
  • Netprobe

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-8677 Netprobe IBM i Log Reader plugin now supports an optional feature to resume reading from the last read position when Netprobe is restarted.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
COL-8623 Netprobe Data ingestion errors are no longer encountered when sending data from the Processes plugin to the Gateway Hub.
VI-9085 Schema The Gateway setup schema now allows an empty string to be specified as the CyberArk SDK path on Unix. This has the same effect as omitting the setting completely, the documented default value will be used.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.3.0

Released: 28 July 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • FIX Analyser 2
  • Gateway
  • Kubernetes plugin
  • Netprobe
  • Web Server
  • Webslinger

Highlights

These are the highlights of this release:

  • Collect and monitor log files from IBM i systems
  • Automate Netprobe configuration using environment macros
  • Improved CyberArk password vault support

IBM i Log Reader plugin

New IBM i Log Reader plugin collects log files from the IBM i Integrated File System. You can configure IBM i Log Reader sampler to read log files from the IBM i IFS, then send the contents of the log files as a stream for consumption by other plugins, such as the FKM and State Tracker plugins.

You can use File Keyword Monitor and State Tracker plugins to monitor and analyse application logs. Also, this plugin can publish the collected log data to Elasticsearch which makes it easier to aggregate and monitor log files from multiple platforms.

For more information, see IBM i Log Reader documentation.

Netprobe configuration using environment macros

Netprobe setup file now supports using macros to access environment variables available to the host platform. The macros are resolved to values of environment variables from the Netprobe host.

Also, the reference information from hosts, services, and other sources to simplify and automate Self-Announcing Netprobes configurations is now available to use.

For more information, see OS environment variables in Netprobe setup documentation.

CyberArk password vault support

Gateway and Netprobe now support integration with CyberArk Credential Provider (CP) for more secure access to passwords.

For more information, see CyberArk Credential Provider in Secure Passwords documentation.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5679 Gateway

You can now configure Gateway to use the local CyberArk Credential Provider. Once configured:

  • Gateway now uses the CyberArk Application Identity Management CLI SDK to request externally managed passwords.

  • Gateway does not look up external passwords appearing in configuration settings passed to the Netprobe plugins.
AA-5680 Netprobe, FIX Analyser 2, Schema Netprobe plugins that support AES encrypted passwords now also support requesting passwords from a CyberArk Credential Provider running on the same host as the Netprobe.
AA-5683 Gateway, Netprobe, FIX Analyser 2

When Gateway is configured to use a local CyberArk Credential Provider, supported plugins now request the current value of passwords at the time these are needed.

Gateway searches for incorrectly configured passwords on each sample which may impact the performance of other plugins.
AA-5688 Webslinger

Webslinger now supports more characters in the following:

  • Managed Entity names
  • Sampler names
  • Row names
  • Dataview names
  • Managed Entity attribute values
AA-5694 Gateway The CyberArk Application ID is now optional. If not set, then Gateway uses ITRS-Geneos as a default value.
COL-8544 Netprobe Netprobe now has a new IBM i Log Reader plugin which reads logs from IFS files from an IBM i machine.
COL-8545 Netprobe IBM i Log Reader plugin now supports an optional rewind feature to read IFS files at the beginning of a file.
COL-8546 Netprobe The State Tracker plugin can monitor streams from IBM i Log Reader plugin.
COL-8547 Netprobe New IBM i i Log Reader plugin supports log filenames with wildcard support matching for last updated file.
COL-8550 Netprobe Netprobe now supports environment macros in the Netprobe setup file.
COL-8661 Netprobe Netprobe no longer terminates a process ID that was previously used by the Collection Agent that terminated unexpectedly.
VI-9047 Active Console, GSE, Web Server The Postgresql library has been upgraded to v42.2.13 to address the security vulnerability issue: CVE-2020-13692 (BDSA-2020-1318).
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5696 Netprobe Netprobe no longer crashes on executing Show Dynamic Mappings for an item which mapping generates or allows invalid characters in an entity, sampler, or dataview name and which specifies entity attributes.
AA-5701 Gateway Gateway no longer crashes when validating a setup which contains a plugin configured to use an external password specified as an empty string.
AA-5707 Gateway Fixed spelling error in the Gateway example hook script.
C2-194 Kubernetes plugin An unscheduled pod now has the correct dimensions applied.
COL-7593 Netprobe Netprobe log does not get flooded with unnecessary download status when using setup from URL.
COL-8485 Netprobe Fixed an issue where the TIB-RV plugin caused Netprobe 5.x to crash on Linux platforms.
COL-8658 Netprobe FIX Analyser 2 has a new debug setting called deferred_orders that can be used to suppress out of order debug messages.
COL-8739 Netprobe Netprobe no longer crashes after changing FKM configuration with UTF Content-type.
VI-8069 Active Console, GSE The Tick Distance (%) field in Gauge Settings now displays the correct value in the Object Inspector.
VI-8137 Active Console, GSE Active Volume Bars no longer allow the Minimum Value field to contain a higher value than the set Maximum Value field.
VI-8226 Active Console, GSE Multiple selected properties in Object Inspector now display the correct similar values.
VI-8728 Active Console, GSE The Close (X) button for removing elements in the Path Editor is now more visible.
VI-8834 Active Console, GSE The Bar Chart's dataset or bars no longer disappear.
VI-8964 Active Console, GSE The Group Properties Settings in the Object Inspector now correctly apply changes to the dashboard objects.
VI-9056 Active Console, GSE You can now modify or delete the Time Series charts.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.2.2

Released: 3 July 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Gateway 2
  • Netprobe
  • Kubernetes plugin

Breaking changes

These are the breaking changes in this release:

State Tracker plugin

The State Tracker > Rewind option in Gateway Setup Editor is now disabled by default.

For more information, see trackerGroup > trackers > tracker > rewind in State Tracker Technical Reference.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-8043 Netprobe Netprobe now captures JQ exceptions when using the REST Extractor plugin.
COL-8743 Netprobe

The packaged Kubernetes plugin has been updated to 2.0.3.

This fixes an issue where metrics from Kubernetes API can have stale timestamps.
VI-8936 Active Console, GSE Queries used for importing events from Gateway Hub now display in the Output dockable when debug mode is enabled.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5682 Gateway Gateway now always evaluates attributes used by rules from the target managed entity. This occurs even when a rule is evaluated due to a change to a secondary data item addressed by a path alias.
COL-8238 Schema The State Tracker > Rewind option in GSE is now disabled by default.
COL-8349 Netprobe Netprobe no longer crashes when RMC evaluates strings longer than 300 characters. Also, the RMC Fields > Strip functionality now returns the correct value.
COL-8741 Gateway, Netprobe Netprobe no longer rejects Dynamic Entities that generate items with dots in the item (managed entity, sampler, dataview, and row) names.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.2.1

Released: 24 June 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • FIX Analyser 2
  • Gateway 2
  • Netprobe
  • Web Server

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
COL-8267 Netprobe

The jackson-annotations, jackson-core, and jackson-databind have been upgraded to version 2.11.0.

The jackson-databind upgrade also addresses the following security vulnerability issues:

  • BDSA-2019-3215
  • BDSA-2019-3135
UTL-1132 Gateway, Netprobe

PCRE has been upgraded to version 8.44 to address the following security vulnerability issues:

  • CVE-2017-6004 (BDSA-2017-0157)
  • CVE-2016-3191
  • CVE-2016-1283 (BDSA-2016-0158)
UTL-1138 Gateway, Netprobe The cURL libraries have been updated to 7.69.1 to address security vulnerability issue: BDSA-2019-4143.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5654 Gateway Gateway now correctly applies setup changes for floating probes when using a demo licence.
AA-5673 Gateway Gateway now correctly applies setup changes when using a demo licence.
AA-5676 Gateway FTM publishing schema now includes entries for actualFilename column and Previous Day dataview.
COL-7268 FIX Analyser 2 Netprobe FIX Analyser 2 database can now be successfully installed once it satisfies the minimum version required.
COL-7924 Netprobe Netprobe no longer crashes if there is a duplicate definition of an invalid disk partition on a Disk plugin.
COL-8494 Netprobe The memory key setting in the RMC plugin now works correctly.
COL-8567 Netprobe

The default health check interval for Collection Agent lifecycle management is now 20 seconds.

Waiting for the health check interval is now done before the first health check.
COL-8614 Netprobe Netprobe now disables Collection Agent health check monitoring when detached mode is enabled.
VI-9004 Web Server Application folders are no longer accessible through the Web Server URL.
VI-9025 Active Console, GSE Active Console now only downloads a workspace file from a URL once.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.2.0

Released: 2 June 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Collection Agent
  • Gateway
  • Licence Daemon
  • Netprobe
  • VMware plugin
  • Web Server

Highlights

These are the highlights of this release:

  • Active Console workspace improvements
  • Cloud Foundry Plugin
  • Demo mode for Gateway
  • Improved administration for Dynamic Entities
  • Netprobe Discovery
  • State Tracker enhancements

Active Console workspace

Active Console can now load a cached version of the workspace when the URL becomes unreachable so that you are always using the latest standard workspace for your organisation.

For more information, see Workspace Selection in Active Console.

Cloud Foundry plugin

The Cloud Foundry plugin collects logs, metrics, and events from Cloud Foundry environments, using the Cloud Foundry Loggregator. This plugin is compatible with both the open source and commercially licensed editions of Cloud Foundry.

For more information, see Cloud Foundry Collection Agent Plugin.

Demo mode for Gateway

You can now run a Gateway in demo mode which allows limited use of the Gateway in non-production environments without needing to request a licence from ITRS. This makes it easier to evaluate or demo Geneos features.

For more information, see Demo mode in Gateway Licensing.

Dynamic Entities

A Show Dynamic Mappings command is now available for all cells in dataviews created by Dynamic Entity samplers and in the InvalidMetrics dataview created by the Dynamic Entities Health plugin. The output of the command shows the dimensions and properties of the datapoint populating the cell and how the Dynamic Entities mapping configuration is used to create the Geneos data structures.

A new Forget Dynamic Entity command is available on all dynamically created Entities so that you can manually remove entities with a long timeout.

For more information, see Dynamic Entities.

Netprobe Discovery

You can now pass the metadata collected by the Netprobe discovery script and pass it to a web service to retrieve the Netprobe configuration. The metadata will be passed to the web service using a GET request to the URL specified by the user.

For more information, see Netprobe Overview.

State Tracker enhancements

State Tracker now supports dynamic stream names. This means that you do not have to list the name of each individual stream you want to monitor. This is especially useful in case of applications that create streams dynamically using the REST API.

State Tree now works on Dynamic Entities. The data published by the new dynamic plugins: StatsD, Kubernetes, and Cloud Foundry can be sent to State Tracker.

For more information, see State Tracker Plugin User Guide.

Breaking changes

These are the breaking changes in this release:

Dynamic Entities

Gateway, Netprobe, and Licence Daemon have each been updated to support licensing of Collection Agent plugins. All three of these components must be updated to Geneos 5.2.x or higher for the Dynamic Entities feature to be supported in Gateway.

Collection Agent plugins require an additional licence to use. Please contact your ITRS Account Manager or ITRS Sales.

Gateway and Licence Daemon

If you are upgrading to Gateway 5.2.x or higher, you should also upgrade Licence Daemon to version 5.2.x or higher.

StatsD Plugin

The StatsD configuration in the packaged Collection Agent (collection-agent.yml) now uses the default protocol UDP and port 8125. Previously, this was set to protocol TCP and port 7780.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-5531 Gateway You can now run Gateway in Demo Mode which allows user's limited use of the Gateway in non-production environments without needing to request a licence from ITRS.
AA-5535 Gateway, Netprobe A new Forget Dynamic Entity command is available on Dynamic Entities (in the Active Console State Tree) and on cells in the Entities dataview of the Dynamic Entities Health plugin. Running this command will remove the entity, the samplers, and dataviews associated with it. If the Collection Agent is still publishing data which match the relevant mappings, the entity may be re-created almost immediately.
AA-5565 Active Console, GSE Gateway Setup Editor now only includes samplers supported by Dynamic Entities when listing the available sampler references for the mappingTypes > mappingType > samplers setting.
AA-5583 Gateway, Netprobe

A Show Dynamic Mappings command is now available in all cells of dataviews created by dynamic samplers and of the InvalidMetrics dataview created by Dynamic Entities Health plugin.

This command shows:

  • The dimensions and properties of the datapoint populating the cell.
  • For each configured mapping, whether it matched the datapoint.

  • The Geneos names generated by the mapping.
AA-5643 Gateway, Netprobe, Licence Daemon

Gateway, Netprobe, and Licence Daemon have each been updated to support licensing of Collection Agent plugins.

All three of these components must be updated to Geneos 5.2.x for Dynamic Entities to be supported in Gateway.
AA-5648 Netprobe Netprobe now rejects a Dynamic Entity mapping configuration from Gateway 5.2.x and below. Additionally, Self-Announcing Netprobes 5.2.x and higher will not connect to a Gateway 5.2.x and below.
COL-7338 Netprobe A new VM Virtual Disk view is now available in the VMware integration to represent the metrics for virtual disk counters.
COL-8072 Netprobe Netprobe can now use properties from the discovery metadata to add query parameters to the setup URL.
COL-8126 Integration VMware integration can now connect to secure Netprobes.
COL-8303 Netprobe Netprobe now has a detached flag configuration for Collection Agent settings. This flag controls whether the managed Collection Agent terminates when Netprobe is stopped intentionally.
COL-8375 Gateway, Netprobe Dynamic Entities now support State Tracker samplers.
COL-8383 Netprobe State Tracker plugin now supports wildcard characters (* and ?) in stream names. Streams matching a wildcard name pattern will be tracked.
COL-8437 Netprobe Support for wildcard characters in stream names also applies to State Tracker tracker templates.
COL-8533 Netprobe The StatsD configuration in the packaged Collection Agent script now uses the default UDP port 8125 configuration.
COL-8555 Netprobe Collection Agent components have been upgraded to 2.1.0.
UTL-1150 Active Console, GSE librdkafka client libraries used by Geneos have been updated to 1.4.0.
VI-7351 Active Console, GSE Active Console now displays an error message when an invalid workspace from a local workspace or URL is opened.
VI-8604 Active Console, GSE, Gateway Hub In Active Console debug mode, Gateway Hub queries on historical charts now display the request information in the Output dockable.
VI-8858 Web Server Web Dashboard now supports Kerberos authentication for supported Windows browsers.
VI-8912 Active Console, GSE Active Console now loads a cached version of the workspace URL that you can use when the workspace becomes unreachable.
VI-8978 Web Server Jetty libraries have been upgraded to 8.1.18.v20150929.
VI-8980 Active Console, GSE Active Console now prompts the Select Workspace dialog when you click OK in the The workspace URL is unreachable error message instead of closing the application.
VI-8984 Active Console, GSE Active Console error messages for saving a read-only workspace and loading an unreachable connection file have been improved.
VI-9005 Active Console, GSE Active Console now prompts the Select Workspace dialog when you click OK in the Invalid File error message instead of closing the application.
VI-9008 Web Server Web Dashboard now sets the correct distinguished name when generating self-signed certificates.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5625 Gateway Active Time changes are now applied correctly when the change time overlaps with a setup change.
AA-5630 Schema The schema for single line text variables has been fixed so that GSE allows the variables text box to scroll, restoring the behaviour seen before Geneos 5.1.0.
AA-5634 Gateway Gateway now correctly includes commands published by Self-Announcing Netprobes in the list provided to Active Console.
AA-5653 Gateway Gateway no longer crashes when using Sampler > Hide Columns to hide the busiestView column in gateway-ProbeData or the maxCellCount column in gateway-ManagedEntitiesData.
COL-7881 Netprobe Netprobe no longer crashes when executing long user commands.
COL-8368 Netprobe The Top and Processes plugins now report percentMemory values identical those reported by the Unix top command.
COL-8388 Netprobe Accept Files and Accept This File FKM commands now work when clearing triggers.
COL-8422 Netprobe

FKM fileOwner column name is now consistent whether it is added in by default or explicitly added in the Columns section of the Advanced tab.

XPaths using fileowner (such as rules or dashboards) are no longer valid.
COL-8431 Netprobe Improved Netprobe memory consumption when using auto-discovery.
C2-155 Collection Agent Kubernetes When data collection fails for a cluster node, the Kubernetes plugin no longer stops monitoring data from all other nodes in the cluster.
C2-162 Collection Agent Kubernetes The Kubernetes plugin now correctly reports CPU usage for values less than one.
C2-163 Collection Agent Kubernetes The Kubernetes plugin no longer fails to publish pod data from a ReplicaSet, due to a thrown exception when parsing ReplicaSet names.
C2-165 Collection Agent Kubernetes The Kubernetes plugin no longer throws intermittent NullPointer exceptions after pods are deleted or rescheduled. This ensures no metrics data is lost.
VI-8953 Active Console, GSE Clicking File > Workspace > Revert now correctly reverts the current workspace to its original layout.
VI-8954 Active Console, GSE Workspace URLs loaded through Autoload Last Good Workspace now load successfully on startup.
VI-8957 Active Console, GSE Workspaces hosted through URL are now loaded successfully when the -wsurl flag is used.
VI-8988 Active Console, GSE -wsurl in ActiveConsole.gci no longer enables the Autoload Last Good Workspace option in the Active Console configuration.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.1.2

Note: Netprobe 5.1.x is not generally available to download except for Netprobe 5.1.0 Linux-64 package certified for deployment on Solace devices. Please download version 5.2.x or newer for all other deployments.

Released: 28 April 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Gateway 2
  • Netprobe

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
COL-8429 Netprobe

Self-Announcing Netprobes 5.1.2 will only connect to a Gateway in the following circumstances:

  • Self-Announcing Netprobes 5.1.2 configured without Dynamic Entity mapping types will connect correctly to all Gateway versions.
  • Self-Announcing Netprobes 5.1.2 configured with Dynamic Entity mapping types will connect correctly to all Gateway versions that support Dynamic Entities; that is, beginning Geneos 5.1.x.
  • Self-Announcing Netprobes 5.1.2 configured with Dynamic Entity mapping types will refuse to connect to Gateway 5.0 and below. A connection attempt will log a message stating that the Gateway is using an older version.
Note: To connect correctly, check that the Self-Announcing Netprobes 5.1.2 connect to Gateway 5.1.x or higher.
There are other factors that can prevent Self-Announcing Netprobes from connecting to the Gateway. For more information, see Self-Announcing Netprobes in Rejection reasons.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.1.1

Note: Netprobe 5.1.x is not generally available to download except for Netprobe 5.1.0 Linux-64 package certified for deployment on Solace devices. Please download version 5.2.x or newer for all other deployments.

Released: 16 April 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Collection Agent
  • Gateway 2
  • Netprobe
  • Web Server

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
VI-5002 Active Console, GSE State Tree no longer collapses when a new Gateway is added.
VI-8730 Active Console, GSE Look and feel of the chart scroll bar in the Active Console was improved.
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5601 Gateway

Gateways now only import commands from remote Gateways if SSO is enabled and the importing connection is authenticated using SSL. Additionally, the CPU resources required by the Gateway when importing commands have been significantly reduced.
AA-5607 Schema Netprobe

Geneos now rejects metrics with Dynamic Entity mappings, including static mappings, that produce entities, samplers, or dataviews with names that contain special characters. A Bad Mapping error will be reported in the Dynamic Entity Health plug-in.

Geneos component names must only use the following characters [a-zA-Z0-9_\\% -].
AA-5623 Gateway

Gateway now always sends down the Dynamic Entities Health plug-in to the Netprobe if it is configured to do so.

Previously, it failed to send the plug-in if the only sampler was a Dynamic Entities Health sampler and there was no dynamic mapping that was configured for the Netprobe.
COL-8293 Gateway, Netprobe Internal commands for the RMC Interface plug-in have been removed and are no longer supported.
COL-8318 Gateway Netprobe is now able to resume its connection with Collection Agent when a connection was previously made following a restart of the Netprobe.
VI-8282 Web Server NullPointerException is no longer encountered when keystore.db file exists in the Web Dashboard config folder.
VI-8888 Web Server Web Dashboard now hides the Communication Problem dialog box when it reconnects with the Web Server.
VI-8905 Active Console, GSE Active Console can now load workspace URLs with Basic authentication.
VI-8928 Web Server The Web Server's maximum threads can now be set through the MAX_THREADS parameter in the run and geneosws scripts.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.1.0

Note: Netprobe 5.1.x is not generally available to download except for Netprobe 5.1.0 Linux-64 package certified for deployment on Solace devices. Please download version 5.2.x or newer for all other deployments.

Released: 31 March 2020

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • Gateway 2
  • Netprobe
  • Collection Agent
  • StatsD plug-in
  • Kubernetes plug-in
  • StatsD client Java library
  • StatsD client Python library
  • FIX Analyser 2 Netprobe
  • Gateway Recorder
  • Licence Daemon
  • SSO Agent
  • Web Server
  • Webslinger

Highlights

These are the highlights of this release:

  • Monitoring dynamic and orchestrated environments require Geneos to be more dynamic. From on-demand and elastic server availability in cloud to containers or microservices, and orchestrators, such as Kubernetes and OpenShift, this release introduces a number of new features to make configurations easier and automate monitoring.
  • MiniGeneos delivers a full stack of Geneos capabilities in a self-contained, easy to use, and localised container environment that can be run locally in your own development machine.
  • New discovery framework for Self-Announcing Netprobes to make configurations easier.
  • Geneos now supports integration with CyberArk password vault so that you no longer need to store passwords in Gateway configuration.
  • Netprobe documentation has been restructured, and now includes information on deploying to dynamic environments with Collection Agent. For more information, see Netprobe Documentation Home.
  • Other improvements:
    • Support for Red Hat 8, SUSE Linux Enterprise 15, and Ubuntu 18.04.
    • Improvements to Active Console light-theme interface for better contrast and visibility.
    • Library updates to resolve known security vulnerabilities.

Geneos for monitoring dynamic environments

Monitoring dynamic and orchestrated environments require Geneos to be more dynamic. From on-demand and elastic server availability in cloud to containers or microservices, and orchestrators, such as Kubernetes and OpenShift, this release introduces a number of new features to make configurations easier and automate monitoring.

For Netprobe, Collection Agent, and plug-ins, the ability to dynamically collect and identify application metrics, events, and logs in a constantly changing environment is now available. Netprobe package now includes Collection Agent and plug-ins for easy deployment and management. Netprobe and Collection Agent can now be deployed natively within orchestrated environments, and scale up and down along with your application. Applications can push metrics, events, and logs to Collection Agent using a dimensional data model which retains more information about the data being sent. For more information, see Collection Agent.

Note: Collection Agent plugins require an additional licence to use. Please contact your ITRS Account Manager or ITRS Sales.

  • StatsD plug-in — provides a StatsD server that allows custom metrics to be received from any application instrumented with the industry-standard StatsD protocol. ITRS-provided StatsD client libraries are available for Java and Python, with more to come over the next few releases. For more information, see StatsD Client Java and StatsD Client Python.
  • Kubernetes plug-in — provides a suite of collectors and processors necessary for collecting logs, metrics, and events in a Kubernetes or OpenShift environment. For more information, see Kubernetes Collection Agent plug-in.

Dynamic Entities

The ability to dynamically create Geneos data structures like entities, attributes, samplers, and dataviews based on dimensional data received from Collection Agent is now available. The dynamic mapping configuration in Gateway provides great flexibility to create your preferred view into application metrics, events, and logs. For more information, see Dynamic Entities.

MiniGeneos

MiniGeneos delivers a full stack of Geneos capabilities in a self-contained, easy-to-use, and localised container environment that can be run locally in your own development machine. This enables developers, DevOps, or anyone to get up and running with full capabilities on Geneos in a sandbox environment to create, verify, and deploy monitoring alongside applications without needing to fully understand how to configure, or deploy Geneos. For more information, see MiniGeneos.

Netprobe Discovery

New discovery framework for Self-Announcing Netprobes to make configurations easier is now available. This includes the ability to define custom discovery scripts that can discover the application and platform environment. This discovered information can be used in the Netprobe configuration as macros to simplify and automate Self-Announcing Netprobe configurations. For more information, see Auto-discovery.

More secure password

Strict security and audit compliance requires passwords to be stored in central password volts for a more secure access. Geneos now supports integration with CyberArk password vault so that you no longer need to store passwords in Gateway configuration. When required, Gateway retrieves the passwords from CyberArk vault. For more information, see CyberArk.

Breaking changes

These are the breaking changes in this release:

Collection Agent

  • Workflow stores created by previous versions are incompatible with this version of the Collection Agent.
  • monitoring.metrics.reporting-interval config property has been moved to monitoring.reporting-interval. Any configuration that defined this optional property must now be updated.
  • stop-filter and pass-filter were replaced with drop-filter and forward-filter. Refer to the Collection Agent Configuration Reference for more details.
  • useTcp() and useUdp() methods in StatsdClientBuilder have been replaced with channelType() in StatsD client Java library.
  • No longer collecting jvm_runtime_class_path and jvm_runtime_library_path attributes with StatsD client Java library.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description

AA-5353

COL-7527

UTL-1106

VI-8538

 Gateway, Webslinger, Licence Daemon, Netprobe, SSO Agent, Web Dashboard

The following components below now support RHEL 8.x:

  • Gateway
  • Licence Daemon
  • Webslinger
  • Netprobe
  • FIX Analyser 2
  • File Agent
  • SSO Agent
  • Web Dashboard

AA-5365

AA-5366

 Gateway, Licence Daemon

Gateway and Licence Daemon now support the following:

  • SLES 15.x
  • Ubuntu
AA-5408 Gateway Gateway has been updated to use version 1.2.2 of librdkafka.
AA-5492 Gateway Gateway now publishes a snapshot of all severity, snooze, and user assignment states when publishing to Gateway Hub is first enabled.
AA-5510 Gateway Gateway now supports the use of external password management services, such as CyberArk. External passwords can be used for Gateway database logging connections and in plug-in configurations to connect to third-party applications.
AA-5516 Licence Daemon The Geneos Licence Daemon (LICD) no longer has a dependency on JQuery.
AA-5522 Gateway

Gateway now uses version 0.6.3 of yaml-cpp.

This update addresses CVE-2017-11692.
AA-5528 Gateway

Gateways can now dynamically generate entities from the data provided by the Collection Agent.

This greatly reduces the configuration burden when monitoring applications in highly dynamic and containerised environments.

AA-5530 Gateway You can now set the environment used by Dynamic Entities when creating mappings.
AA-5534 Netprobe Schema The new Dynamic Entities Health plug-in allows you to track the state of all dynamic entities and metrics data received by a probe.
AA-5542 Active Console, GSE Gateway Setup Editor now automatically resizes the external password fields to accommodate large passwords.
AA-5543 Gateway A new Gateway configuration section called Dynamic Entities is added for controlling how entities are dynamically created for data received from Collection Agent.
COL-7517 Netprobe Added DLL_PATH registry value in the Windows Netprobe registry key. If set, the Netprobe resolves DLL dependencies in the folders specified in the DLL_PATH.

COL-7670

 FIX Analyser 2 Netprobe, FIle Agent Netprobe, FIX Analyser 2, and File Agent now support SLES 15.x.
COL-8019 Netprobe Publisher plug-in now supports bearer authentication with grant type password.
COL-8071 Netprobe Netprobe now supports a new command line option (-discovery), which allows you to specify the file path for the discovery script. This is for the new auto-discovery feature.
COL-8073 Netprobe

The Netprobe setup file now supports a new format for macros, which are based on the output of a discovery script that the user may provide.

For example, [[$MACRO_NAME]] inserted within the setup file. The existing macro format is still supported.
COL-8075 Netprobe The new collection-agent and statsd-plugin are now included in the Netprobe package. The Collection Agent files reside in a subdirectory named collection-agent inside the Netprobe distribution.
COL-8076 Netprobe When configured, the Netprobe now starts the Collection Agent executable JAR file when started.
COL-8082 Netprobe The Netprobe Windows installer now has text fields to specify the path of the discovery script. This is for the new auto-discovery feature.
C2-64 Collection Agent Kubernetes The Kubernetes plug-in now provides metrics for the Kubernetes pod and container status. This allows Geneos to monitor the pod and container lifecycles.
C2-76 Collection Agent StatsD client Python library The Python Statsd client library now supports events and attributes.
C2-95 Collection Agent Kubernetes The Kubernetes plug-in now provides metrics for the resource requests and limits of containers.
C2-107 Collection Agent The Collection Agent now uses the new platform datamodel 2.0.0.
C2-115 Collection Agent You can now specify default values when performing environment variable substitution.
C2-117 Collection Agent Kubernetes The Kubernetes plug-in now uses Gson to parse JSON files. The Jackson library has been removed.
C2-119 Collection Agent The Collection Agent now uses the TCP Reporterto communicate with the Netprobe. The NetprobeRestReporter has been removed.
C2-123 Collection Agent StatsD client Java library The StatsD Java client library now uses the new platform datamodel 2.0.0.
C2-124 Collection Agent StatsD client Python library The Collection Agent has been upgraded to include additional units of measure.
C2-125 Collection Agent The Collection Agent now logs its configuration at startup.
C2-128 Collection Agent You can now create pipeline processors that filter datapoints by specified criteria.
C2-129 Collection Agent You can now record Collection Agent messages and replay them to stdout, and to the Netprobe.
C2-131 Collection Agent The Collection Agent now reports more accurate health information to the Netprobe.
C2-134 Collection Agent You can now add processors to any collector in order to perform edge processing and filtering.
C2-135 Collection Agent Kubernetes The Kubernetes plug-in now removes stale entries from the KubernetesEnricher pod cache. This prevents uncapped memory usage.
C2-138 Collection Agent Kubernetes The Kubernetes plug-in now creates additional dimensions to capture more Kubernetes event types.
C2-140 Collection Agent Kubernetes The Collection Agent now logs errors when connections or requests to the Kubernetes API fail.
C2-147 Collection Agent The Collection Agent persistent storage has been upgraded with improved error detection and recovery capabilities.
C2-151 Collection Agent You can now send metrics from the Collection Agent to a Netprobe directly by workflow or through StatsD. This allows you to ensure metrics from different sources are allocated to the same Geneos entity correctly.
UTL-1123 Gateway, Netprobe curl library has been updated to use OpenSSL version 1.1.1d.
UTL-1124 Netprobe Net-SNMP has been upgraded to version 5.8. This is used by both Mibmon and Trapmon plug-ins.
UTL-1126 Active Console, GSE, Netprobe, Licence Auditor, Licence Daemon, Web server, FIX Analyser 2, File Agent OpenSSL versions have been upgraded to 1.1.1d.
UTL-1128 SSO Agent

Nimbus JOSE+JWT library is now upgraded to 7.9.

This update addresses CVE-2019-17195.

UTL-1134 SSO Agent SSO Agent has been verified to work with LDAP channel binding and LDAP signing.
UTL-1140 Gateway Recorder Gateway Recorder now supports Windows 64-bit.
VI-8593 Active Console, GSE The text colour for the selected ungrouped item in the Metrics view is now set to white.
VI-8685 Active Console, GSE The context menus in the GSE > Navigation panel no longer have static icons.
VI-8720 Active Console, GSE, Web server

Active Console and Web Dashboard are now packaged with BouncyCastle 1.64 to address security vulnerabilities.

This update addresses the following:

  • BDSA-2018-1190
  • CVE-2018-1000613
  • CVE-2016-1000338
  • CVE-2016-1000342
  • CVE-2016-1000343
  • CVE-2016-1000340
  • CVE-2016-1000344
  • CVE-2016-1000352
VI-8738 Active Console, GSE OS's file dialog is now used in the Object Inspector dockable, Active Dashboard properties, Reporting, and Search dialog.

VI-8761

VI-8811

 Web Server, Active Console, GSE

These components now use Log4j2 for logging

  • Web Dashboard
  • Active Console
VI-8762 Web Server Jetty libraries have been upgraded to 8.1.7.v20120910.
VI-8763 Active Console, GSE, Web server

Nimbus JOSE library has been upgraded to 7.9.

This update addresses CVE-2019-17195.
VI-8764 Web Server

ActiveMQ library is now upgraded to 5.15.10.

This update addresses CVE-2019-0222.
VI-8765 Web Server

After upgrading activemq-all to 5.15.10, there is no longer a security vulnerability hit for Apache Camel.

This update addresses the following:

  • BDSA-2020-1132
  • BDSA-2018-2585
  • BDSA-2020-1131
  • CVE-2019-0188
VI-8766 Active Console, GSE

Quartz library has been upgraded to 1.6.1.

This update addresses BDSA-2019-3134.
VI-8768 Web Server

Spring Framework libraries have been updated to 4.3.24 that are packaged in the ActiveMQ 5.15.10 library.

This update addresses CVE-2018-15756.
VI-8769 Web Server

Spring LDAP library has been upgraded to 2.3.2.

This update addresses CVE-2017-8028.
VI-8770 Web Server

Spring Security libraries have been upgraded to 4.2.13.

This update addresses CVE-2019-11272.
VI-8800 Active Console, GSE The table row texts in the Active Console settings are now displayed correctly.
VI-8807 Active Console, GSE The Event Ticker Import dialog now displays the value of From and To dates.
VI-8844 Active Console, GSE The tabs in the Active Console and GSE now show an underline below the selected tab indicating that a tab is selected. Also, dockables now show the severity by changing the tab's background colour.
VI-8864 Active Console, GSE The Metrics view now shows more information after the font sizes and styles have been improved.
VI-8865 Active Console, GSE The entity names in the Managed Entities view now display correctly.
VI-8878 Web Server Jetty libraries are now upgraded to 8.1.8.v20121106.
VI-8883 Active Console, GSE The text colour in the Metrics view table and headline is now black.
VI-8897 Active Console, GSE

The jackson libraries have been updated to version 2.10.2 to address security vulnerabilities found in version 2.10.0.

This update addresses the following:

  • BDSA-2019-3135
  • BDSA-2019-3215
     

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5478 Gateway Gateway no longer enters a deadlock when a Self-Announcing Netprobe connects and there is a KBA item whose target XPath uses a // (descendant or self) element.

AA-5494

COL-7876

 Gateway, Netprobe Gateway and Netprobe now work with MySQL 8.0 client libraries.
AA-5495 Gateway Gateway has been verified to work with MariaDB 10.3 client when running on CentOS 8 and Open Suse 15.
AA-5497 Gateway Gateway no longer core dumps on CentOS 8 and Ubuntu when using MSSQL ODBC Driver 17.
AA-5507 Gateway Gateway now produces a warning when a Gateway Hub dataset includes an invalid alias. If a rule references a time series derived from an invalid dataset, this produces a warning.
AA-5525 Gateway Rules using historical data functions, such as rate() and average(), now update correctly when Gateway resumes processing rules after a startup delay.
AA-5537 Active Console, GSE, Gateway, Web Server Geneos components now correctly handle XPath predicates that include both quotation marks and apostrophes. This allows commands, such as Snooze or User Assignment, to be used on cells in rows whose names contain strings of this form
AA-5560 Gateway Gateway no longer exits with a core dump when the Express Reports setup contains an invalid reference to a password variable.
AA-5584 Gateway The Gateway Hub Data plug-in now displays N/A instead of inf msg/sec in the Message rate column if the SampleNow command is received more than once in the same second. This prevents a Gateway Hub ingestion error.
COL-2007 Netprobe MEM_UTIL debug correctly displays the Netprobe memory usage for Linux Netprobe.
COL-6701 Netprobe Processes plug-in can now handle processes with very long arguments without affecting other rows.
COL-7410 Netprobe Processes plug-in can now handle processes with very long arguments without crashing.
C2-142 Collection Agent The Collection Agent store's count metric can no longer take a negative value.
C2-144 Collection Agent The TCP Reporter no longer fails due to too many open files when a large number of connection attempts fail.
UTL-1136 Gateway Recorder Gateway Recorder now correctly announces its Geneosversion. This is required in order to connect to Geneos components beginning version 5.0.x.
VI-774 Active Console, GSE Dashboard objects with anchored lines can now be grouped.
VI-2265 Active Console, GSE Objects with anchored lines can now be copied and pasted.
VI-2670 Web Server The limit of Gateway connections in the Web Dashboard > Configurations > Connections page is now 1024.
VI-7165 Active Console, GSE Modifier paths no longer append additional row and cell elements when modified.
VI-7371 Active Console, GSE Active Console now allows you to open workspaces from URLs that contain spaces and special characters.
VI-7432 Active Console, GSE Dashboards with multiline text values can now be imported.
VI-7746 Active Console, GSE, Netprobe, Web Server Active Console and Gateway Setup Editor now display a warning before it exits due to fatal errors.
VI-8201 Active Console, GSE The Past Working Day in the Time Definitions Manager now reflects the correct value.
VI-8362 Web Server Keytool path in the ssl_utils.sh file of a no_jre Web Dashboard now points to the correct JRE path.
VI-8371 Web Server When the Web Console stops updating within a configured dashboard refresh rate, Web Dashboard now restarts the refresh timer for updating tiles.
VI-8386 Active Console, GSE Active Console now works properly when using the Find button, and populates the Search result with values.
VI-8506 Active Console, GSE Doing a search with an empty file no longer causes the Active Console to hang.
VI-8575 Active Console, GSE Time Definitions now displays the correct label for the Start and End buttons.
VI-8603 Active Console, GSE The Active Console icon now displays the severity of any path that is defined in the Use Paths for Severity option in the Settings > System Tray.
VI-8747 Active Console, GSE Workspace file extensions are now case-insensitive allowing the Active Console to open and load workspaces regardless of character case.
VI-8825 Web Server Web Server no longer has Image resource could not be loaded errors when loaded.
VI-8907 Active Console, GSE Active Console can now import Event Ticker data from a Gateway Hub source with an HTTP protocol.
     

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Geneos 5.0.0

Released: 12 December 2019

This release delivers the updated binaries in the ITRS Downloads page for:

  • Active Console
  • File Agent
  • FIX Analyser 2 Netprobe
  • Gateway
  • Gateway Recorder
  • Gateway Timezones
  • Licence Auditor
  • Licence Daemon (LICD)
  • Netprobe
  • Web Server
  • Webslinger

Highlights

These are the highlights of this release:

  • The Publisher plug-in is a new plug-in that enables you to publish data from an FKM outbound stream to an index on the Elasticsearch.
  • Centralised configuration now allows you to manage the Gateway configuration using REST API.
  • The Web Console monitoring UI brings a brand new look for real-time monitoring.
  • Active Console introduces a new light theme interface.
  • Geneos data source for Grafana (Technology Preview) lets you seamlessly integrate data from Gateway Hub into your Grafana dashboards.
  • Events such as severity, snooze, and user assignment data can now be queried using Gateway Hub REST API.
  • Gateway Hub check script is introduced to help validate your environment before installing Gateway Hub.
  • Other improvements:
    • Gateway now uses the time zones files store in /usr/share/zoneinfo of the base machine to translate times between time zones.
    • Gateway now uses standard date and time format for log files generated by Geneos components.
    • Support for POST and PUT requests in the REST Extractor plug-in.
    • Enhanced memory monitoring metrics for the Hardware plug-in.
    • Support for Windows 2019.
    • Postgresql support for the Gateway Database Logging.
    • Support for MySQL 8, Oracle Database 19c, and MS SQL Server 2017.

New features and enhancements

These are the new features and enhancements of this release:

Issue key Component Release description
AA-3823 Gateway

Gateway Database Logging now supports the InnoDB engine for MySQL and MariaDB. InnoDB provides support for row-level locking, transactions, foreign keys and relationship constraints.

The Gateway Database Logging schema for MySQL no longer explicitly specifies the MyISAM database engine. The default engine (usually InnoDB) will now be used when a new database is created. However, no automated conversion script is supplied, since any upgrade to the InnoDB engine should be carefully planned according to the characteristics of the specific installation.
AA-4169 .Gateway Database logging now supports PostgreSQL.
AA-4226 Gateway, Netprobe Loading of MySQL database client libraries no longer requires libmysqlclient_r.so. If it does not exist, MySQL loads the libmysqlclient.so
AA-4953 Gateway,Netprobe, Gateway Timezones

Gateway now uses the system timezone files /usr/share/zoneinfo/* to convert times between timezones, instead of relying on a list of timezones distributed with the Gateway.

The system timezone files are also used to supply timezone abbreviations when the %Z format is used in the printTime rule function to format time values.

The timezone file is still used to supply a default set of timezone abbreviations to support the %Z format when parsing time values.
AA-5036

Gateway, Netprobe, EUEM Netprobe, Webslinger, Licence Daemon ATS, FIX Analyser 2, File Agent

 Gateway, Netprobe, FIX Analyser 2 Netprobe, File Agent, Webslinger, LICD, and Auditor now support a choice of date and time formats for their log files.
AA-5343 Gateway When requesting a change, the Gateway now passes the source of a change up to centralised configuration.
AA-5367 Gateway

Gateway Database Logging feature now supports the following database:

  • MySQL 8.0
  • Oracle 18c and 19c
  • MSSQL Server 2017
  • PostgreSQL 10 and 11
  • MariaDB 10.2 and 10.3
AA-5374 Gateway When a database logging transaction fails, it is now correctly rolled back.
AA-5396 Gateway Timezones

The timezone file is now updated based on IANA 2019c release:

  • Fiji observes DST from 2019-11-10 to 2020-01-12.
  • Norfolk Island starts observing Australian-style DST. The first transition is on 2019-10-06.
AA-5402 Gateway Gateway now supports percentile and T-Digest percentile aggregations from Gateway Hub.
AA-5404 Gateway Tooltips in ShowRules response now shows the value of any time series used in the rule at the time the rule was run.
AA-5423 Gateway Gateway can now obtain its setup from the centralised configuration in Gateway Hub by specifying the Gateway name.
AA-5434 Gateway Gateway now only works with centralised configuration in Gateway Hub versions 1.6 and above.
AA-5441 Gateway When using centralised configuration, Gateways with version 5.x will require a GSE with version 5.x to edit the setup.
AA-5442 Gateway Gateway 5.0 requires Gateway Hub1.6+ for centralised configuration. Lower Gateway Hub versions will be rejected.
AA-5447 Gateway When a Gateway starts and requests the setup from Gateway Hub, but the named Gateway has not been added, then the Gateway adds a blank Gateway with the correct name to Gateway Hub and then starts.
AA-5448 Gateway A new helper script is available in the Gateway package which enables you to upload Gateway binaries into Gateway Hub.
AA-5466 Gateway The banner setting in managedEntities is deprecated.
AA-5472 Gateway Gateway no longer publishes to the legacy geneos-raw and geneos-enriched topics. This means that Gateway no longer supports publishing to Gateway Hub versions earlier than 1.4.
AA-5499 Gateway The start script start_gateway2.tmpl is updated to use Bash rather than csh.
COL-6729 Netprobe Combo, Components Versions and Informix plug-ins are now deprecated.
COL-6829 Netprobe, File Agent Added Windows Server 2019 support for Netprobe and File Agent.
COL-6902 Netprobe The Exegy adapter now uses XCAPI 4.1.12
COL-6917 Netprobe The Hardware plug-in now calculates memoryUse metrics based on Linux computations.
COL-7000 Netprobe The Hardware plug-in now uses new method of obtaining memoryAvailable and memoryAvailablePct for Linux platforms.
COL-7221 Netprobe The REST Extractor plug-in now supports PUT and POST HTTP methods.
COL-7599 Netprobe The libwombattcp.so third-party libraries have been removed from the Netprobe package.
COL-7676 Netprobe

The Netprobe now supports the following database:

  • MySQL 8.0
  • Oracle 18c and 19c
  • MSSQL Server 2017
  • IBM DB2 11.5
  • PostgreSQL 10 and 11
  • MariaDB 10.2 and 10.3
COL-7742 Netprobe File Keyword Monitor now supports configurable outbound streams for publishing data using the Publisher plug-in.
COL-7745 Netprobe A new Publisher plug-in is now available on the Netprobe . The Publisher plug-in enables you to publish data from an FKM outbound stream to an index on the Elasticsearch host.
COL-7746 Netprobe The Publisher plug-in supports basic authentication. You can specify a username and password when publishing messages to an Elasticsearch server that is protected by basic authentication.
COL-7828 Netprobe The Publisher plug-in includes an Admin View where users can view metrics regarding the state of messages being read and sent to the Elasticsearch server. You can disable this view in the plug-in configuration.
COL-7873 Netprobe

Jackson libraries have been updated from version 2.9.8 to 2.9.10 to address security vulnerabilities.

This update addresses the following CVEs:

  • CVE-2019-16335
  • CVE-2019-17267
  • CVE-2019-14379
  • CVE-2019-14540
  • CVE-2019-12086
  • CVE-2019-14439
UTL-1099 Gateway, Netprobe The Gateway and Netprobe now use cURL 7.66.0.
UTL-1100 Active Console, GSE, Gateway, Netprobe, Web server, FIX Analyser 2, File Agent Upgraded Snappy library to version 1.1.7. This is used in the communication protocol between Geneos components.
UTL-1101 Gateway The libxml2 library is updated to version 2.9.9.
UTL-1103 Gateway The libxslt library is updated to version 1.1.33. This library is used for XML-related processing.
UTL-1104 Active Console, GSE, Gateway, Netprobe, Webslinger, Web server The Xerces-C library is updated to 3.2.2 for windows_64, darwin, linux_64, and linux_64-ppcle components.
UTL-1105 Active Console, GSE, Gateway, Netprobe, Web server, FIX Analyser 2 The OpenSSL library is updated to 1.0.2g-1ubuntu4.15.
UTL-1114 Gateway, Netprobe, FIX Analyser 2 Netprobe The SQLAPI library used by Geneos components to access databases is now updated to version 4.2.5.3.
VI-7310 Active Console, GSE OS specific file dialog are now used in File menu items Open and Save actions.
VI-7428 Gateway Remove local help files from GSE package as we now use Web Help.
VI-8256 Active Console, GSE You can now cancel long running save or validation operations that are waiting on responses from Gateway Hub.
VI-8296 Active Console, GSE GSE improves SSO handling in conjunction with Centralised Configuration.
VI-8364 Active Console, GSE Locks menus in the GSE are now consistent.
VI-8453 Active Console, GSE Added visualisation of Gateway Hub generated validation messages in GSE.
VI-8464 Gateway GSE improves the Centralised Configuration error messages.
VI-8472 Gateway Icons are now removed from the Search Criteria's Search For drop-down items in the Tools > Reporting.
VI-8477 Active Console, GSE Active Console and Web Dashboard now support the Postgresql database for History Charts.
VI-8478 Active Console, GSE GSE removes metadata comments from the setup files sent to the Gateway Hub.
VI-8490 Active Console, GSE

GSE updates the Error Dockable that allows you to filter errors by:

  • Tree selection
  • Connected Gateway
  • Duplicate errors
VI-8607 Active Console, GSE Check box icons are now updated with a light theme design.
VI-8635 Active Console, GSE The new onboarding screen can be accessed any time from the Active Console Help menu.
VI-8666 Active Console, GSE The Active Chart, Bar Chart, Active Gauge, and Pie Chart now have updated colour schemes.
VI-8674 Active Console, GSE The onboarding screen now loads on the Active Console startup. To disable the onboarding screen, tick the Do not show at startup check box at the bottom of the screen.
VI-8675 Active Console, GSE The Open and Save actions in the Active Console > File menu now use platform-default file choosers.
VI-8677 Active Console, GSE The Dockable Manager dialog now uses the platform-default file chooser.
VI-8707 Active Console, GSE File choosers for Time Definition > Import, Output > Save As, and Picture Widget > Add/Update now use platform defaults.

VI-8732

VI-8733

VI-8734

VI-8735

 Active Console, GSE

The options in each menu in the Active Console is now rearranged:

  • Help
  • Tools
  • View
  • File
VI-8739 Active Console, GSE

The Active Console title is now consistently used within the workspace and to all other windows.

VI-8740 Active Console, GSE Gateway Setup Editor now uses the OS native file dialog.
VI-8741 Active Console, GSE In Active Console and Gateway Setup Editor, the Gateway dockable no longer have the operating system indicator in the Gateway icons.
VI-8742 Active Console, GSE

Active Console and hub-sdk are now packaged with jackson 2.10.0 to address security vulnerabilities.

This update addresses the following:

  • CVE-2019-17267
  • CVE-2019-14540
  • CVE-2019-14379
  • CVE-2019-16942
  • CVE-2019-16335
  • CVE-2019-14439
  • CVE-2019-12086
VI-8744 Active Console, GSE Active Console now has a new default workspace.
VI-8745 Active Console, GSE EventTickers dockable is now renamed to Event Tickers.
VI-8758 Active Console, GSE Active Console now has new Active Chart types: Area Chart, Scatter Plot, and Step Graph.
VI-8759 Active Console, GSE Tools in the Tool & Modifiers dialog now show the commonly used groups first and removes the tool groups that are not commonly used.
   

Issues fixed

These are the issues we have fixed in this release:

Issue key Component Release description
AA-5300 Gateway GSE no longer hides the Remove Comment menu item when using simplified comments.
AA-5334 Gateway A warning is now shown, instead of an error, when the Gateway Hub location set in both the command line and the Gateway setup file.
AA-5426 Gateway Gateway no longer warns about lack of database connection when no database configured, but timeseries are configured to be downloaded from Gateway Hub.
AA-5490 Gateway Fixes a bug where the Gateway can become unresponsive while processing Self-Announcing Netprobe connections, if multi-threaded rule evaluation is enabled.
VI-2460 Active Console, GSE, Web server Web server no longer displays an error on startup saying the image resource managedentityviewdefault.png could not be loaded.
VI-3094 Gateway Fixes an error reported when the user tries to open GSE for a Gateway without a license.
VI-7923 Active Console,GSE Active Console no longer freezes when the current workspace residing in a URL is unreachable.
VI-8202 Gateway Fixes a bug where the GSE attempts to use a token but it did not have when editing Centralised Configuration Gateways without configuring an SSO server.
VI-8279 Web server Run scripts now include the DASHBOARDS_DIR parameter.
VI-8365 Active Console, GSE Fixes a bug where the GSE throws an exception if a Centralise Gateway was opened in GSE without GSE acquiring an SSO token.
VI-8445 Web server The geneos-bcrypt-hasher.jar inside Geneos Web Server is now renamed to geneos-bcrypt-hasher-1.0.ja.
VI-8687 Active Console, GSE The ActiveConsole.exe and GatewaySetupEditor.exe no longer indicate an incorrect version number in the file properties.
VI-8814 Gateway The GSE re-enables the Save current document button if the saving process is cancelled.
VI-8815 Gateway The Includes folder now unlocks when you unload it.
VI-8816 Gateway The Includes folder now unlocks when the GSE unloads it due to a reload of either the main setup or the schema.
   

Known issues

To view the list of known issues for all Geneos 5.x releases, see Geneos 5.x Known Issues.

Other Geneos releases

Geneos 5.x Release Notes

Released: December 2019

Last updated: November 2020
Geneos 4.x Release Notes

Released: February 2017

Last updated: December 2019

Disclaimer: The information contained in this document is for general information and guidance on our products, services, and other matters. It is only for information purposes and is not intended as advice which should be relied upon. We try to ensure that the content of this document is accurate and up-to-date, but this cannot be guaranteed. Changes may be made to our products, services, and other matters which are not noted or recorded herein. All liability for loss and damage arising from reliance on this document is excluded (except where death or personal injury arises from our negligence or loss or damage arises from any fraud on our part).