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.

Important

The Geneos 5.11.3 release includes updates to the following Geneos components and integrations to address the Apache Log4j vulnerabilities (CVE-2021-44228, CVE-2021-45046, and CVE-2021-45105):

Active Console 5.11.3
Web Dashboard 5.11.3
Terracotta Messaging integration 2.0.235
VMware integration 1.4.20

We recommend upgrading to the latest version Geneos 5.11.3 or newer. We can also confirm that no other Geneos components are affected by this vulnerability.

If you are unable to upgrade, please see the mitigation and workaround information in Vulnerability in Apache Log4j.

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.

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 to use. The Gateway can also be run in `-demo` mode for limited 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 the currently deprecated Mappings configuration in the Gateway Dynamic Entities	Gateway and Netprobe 5.11.0 and newer	30 November 2021	The currently deprecated Mappings configuration in the Gateway Dynamic Entities will be removed from Geneos 5.11.0. You must update the configurations to use the simplified Mapping configuration. For more information, see Dynamic Entities.
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.11.3

Released: 21 December 2021

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

Active Console
Web Dashboard
Terracotta Messaging integration
VMware Monitor integration

Highlights

These are the highlights of this release:

The Apache Log4j library in the Active Console, Web Dashboard, Terracotta Messaging integration, and VMware Monitor integration, has been upgraded to 2.17.0 to fix the security vulnerability in Apache Log4j (CVE-2021-45105). We recommend upgrading to the latest version Geneos 5.11.3 or newer.

To know more about the impact of this issue to the ITRS products and components, see Vulnerability in Apache Log4j.

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
VI-9394	Active Console, GSE, Web Server	The Apache Log4j library in the Active Console and Web Server has been upgraded to 2.17.0 to address the security vulnerability: CVE-2021-45105.
COL-10788	Integrations	The Apache Log4j library in the Terracotta Messaging and VMware Monitor integration has been upgraded to 2.17.0 to address the security vulnerability: CVE-2021-45105.

Known issues

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

Geneos 5.11.2

Released: 17 December 2021

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

Active Console
Web Dashboard
Terracotta Messaging integration
VMware Monitor integration

Highlights

These are the highlights of this release:

The Apache Log4j library in the Active Console, Web Dashboard, Terracotta Messaging integration, and VMware Monitor integration, has been upgraded to 2.16.0 to fix the security vulnerability in Apache Log4j (CVE-2021-45046). We recommend upgrading to the latest version Geneos 5.11.2 or newer.

To know more about the impact of this issue to the ITRS products and components, see Vulnerability in Apache Log4j.

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
VI-9389	Active Console, GSE, Web Server	The Apache Log4j library in the Active Console and Web Server has been upgraded to 2.16.0 to address the security vulnerability: CVE-2021-45046.
COL-10782	Integrations	The Apache Log4j library in the Terracotta Messaging and VMware Monitor integration has been upgraded to 2.16.0 to address the security vulnerability: CVE-2021-45046.

Known issues

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

Geneos 5.11.1

Released: 14 December 2021

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

Active Console
Web Dashboard
Terracotta Messaging integration
VMware Monitor integration

Highlights

These are the highlights of this release:

The Apache Log4j library in the Active Console, Web Dashboard, Terracotta Messaging integration, and VMware Monitor integration, has been upgraded to 2.15.0 to fix the security vulnerability in Apache Log4j (CVE-2021-44228). We recommend upgrading to the latest version Geneos 5.11.1 or newer.

To know more about the impact of this issue to the ITRS products and components, see Vulnerability in Apache Log4j.

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
VI-9387	Active Console, GSE, Web Server	The Apache Log4j library in the Active Console and Web Server has been upgraded to 2.15.0 to address the following security vulnerabilities: CVE-2021-44228 CVE-2020-9488
COL-10780	Integrations	The Apache Log4j library in the Terracotta Messaging and VMware Monitor integration has been upgraded to 2.15.0 to address the security vulnerability: CVE-2021-44228.

Issue key

Component

Release description

VI-9387

Active Console, GSE, Web Server

The Apache Log4j library in the Active Console and Web Server has been upgraded to 2.15.0 to address the following security vulnerabilities:

CVE-2021-44228
CVE-2020-9488

COL-10780

Integrations

The Apache Log4j library in the Terracotta Messaging and VMware Monitor integration has been upgraded to 2.15.0 to address the security vulnerability: CVE-2021-44228.

Known issues

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

Geneos 5.11.0

Released: 9 December 2021

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

Active Console
Azure plugin
Azure Marketplace
AWS plugin
Collection Agent plugin
File Agent
FIX Analyser 2Netprobe
Gateway
Netprobe
Prometheus plugin
SSO Agent
Web Dashboard

Highlights

These are the highlights of this release:

With the addition of the Geneos AWS Monitor plugin, you can now monitor your AWS resources in a single enterprise platform alongside your on-premise and hybrid environments. The plugin collects AWS CloudWatch metrics, logs, and events to provide unified information across your AWS resources. Data is collected with minimal configuration and Geneos entities are created dynamically as you deploy more AWS services. This is a fully supported integration to give you a single pane of glass view of your entire deployment stack. In addition, the AWS plugin can:
- Monitor AWS services such as EC2, ECS, EKS, RDS, EBS, EFS, firewall, billing, and more.
- Generate close to real-time alerts using Geneos powerful rule and alert capabilities.
- Minimise configuration with built-in dynamic entity mappings for more automated discovery.
- Minimise cost by using a single enterprise tool for monitoring.
- See your entire estate in one platform with monitoring that scales with you.
Gateway can now collect statistics to help determine the requirements for storing Gateways data in the Obcerv platform (formerly Hub 3).
The slash character (/, U+002F) is now allowed in the Geneos component names generated by dynamic mappings.
New <probeHostname> macro in the Self-Announcing Netprobe setup file which supports hostnames with dots in the names.
Various updates to fix known security vulnerabilities.

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-6246	Netprobe	Netprobe now tracks the last update time for each row generated from Collection Agent metrics. When a row has not been updated for the number of seconds specified as the stale data timeout (default value is 120 seconds), it is dropped from the dataview. When a dynamic dataview has no current rows, it is dropped; if its parent dynamic sampler has no dataviews, it is also dropped. If a dynamic sampler is dropped and its parent entity now has no dynamic samplers or streams, that dynamic entity is dropped.
AA-6263	Gateway	To help determine the potential size of Obcerv storage for an existing Gateway, Gateway collects sizing statistics for gRPC messages and a Gateway setup option exists to choose `Statistics only` instead of `Grpc` in the Hub 3 Connection > Adapter. This option directs Gateway to discard messages instead of opening a gRPC connection. Statistics are gathered as long as Hub 3 publishing is enabled, whether the selected Hub 3 adapter is `Statistics only` or `Grpc`. The Gateway-hubConnection plugin has a Detail view showing the message rate and byte rate for each type of gRPC message. The Gateway also writes log messages showing the same information every 10 minutes.
AA-6267	Gateway, Netprobe	The slash character (/, U+002F) is now allowed in the Geneos component names generated by dynamic mappings. Since this character is not allowed in the Gateway Hub (Gateway Hub 2) metric series names, Gateway replaces each slash character in probe, entity, sampler, or dataview names with a hyphen (-, U+002D) when formatting Kafka messages for Gateway Hub. No such replacement is done in the messages published through Kafka to external systems, or in data published through gRPC to Obcerv (Hub 3).
AA-6276	Gateway	Legacy Dynamic Mapping that was introduced in the Geneos 5.1.x has been removed. This configuration has already been deprecated and was replaced by more simplified Dynamic entities > Mapping configuration in Geneos 5.7.0.
AZUREMON-351	Azure, Collection Agent	The Netty libraries have been upgraded to 4.1.70 to address the following security vulnerabilities: BDSA-2021-2832 BDSA-2021-2831
COL-9641	Active Console, GSE, Netprobe, FIX Analyser 2 Netprobe, File Agent	Netprobe now encodes user supplied invalid URL before displaying the message to the client. This addresses the QID 150117 Path-Based Cross-Site Scripting (XSS) vulnerability.
COL-9643	Active Console, GSE, Netprobe, FIX Analyser 2 Netprobe, File Agent	Active Console, Netprobe FIX Analyser 2, and File Agent Orb page now returns `Invalid Page Name` when BDO index is appended with extension. This addresses the QID 150004 Path-Based vulnerability.
COL-9932	Netprobe, FIX Analyser 2 Netprobe	When a Self-Announcing Netprobe chooses a Gateway to connect to, as long as it is configured to allow only reverse connections, it no longer resets its initial connection to that Gateway.
COL-10445	Netprobe	Added new `<probeHostname>` macro in Self-Announcing Netprobe setup file which supports hostnames with dots in the names.
COL-10526	Netprobe	Publisher plugin has been updated so that Success, Failed, and Lost columns no longer just accumulate the number of events. Instead, the columns now show the number of occurrences of each event for each sample interval.
COL-10555	Netprobe, FIX Analyser 2 Netprobe	If a Self-Announcing Netprobe is configured to require reverse connections, it rejects an unsolicited forward connection from a Gateway.
COL-10632	Netprobe, Collection Agent	Collection Agent has been updated to 2.3.2.
HAAW-198	AWS, Collection Agent	This release introduced the AWS plugin 2.0.0. The AWS plugin is a Collection Agent plugin that gathers metrics through AWS CloudWatch. This plugin also provides an API Destination that can interact with AWS services, such as EventBridge and SNS.
COL-10645	Netprobe, AWS, Collection Agent	The AWS plugin 2.0.0 binaries are packaged with Netprobe 5.11.x, and are also available to download from the ITRS Downloads.
AA-6323	Gateway	Added the `aws_mapping.xml` include file that can be used with the AWS plugin. This includes custom mappings and sample FKM samplers for the API Destination collector.
COL-10649	Netprobe	Publisher plugin no longer publishes event logs to Hub 3 (Obcerv) with Gateway name as dimension.
COL-10651	Netprobe, Azure, Collection Agent	The Netprobe package has been updated with Azure plugin 2.1.1.
COL-10665	Netprobe, Prometheus, Collection Agent	The Netprobe package has been updated with Prometheus plugin 2.0.2.
VI-8939	Active Console, GSE	The OkHttp library in the Active Console has been upgraded to 3.12.12 to address the security vulnerability: CVE-2018-20200 (BDSA-2018-4848).
VI-9256	Active Console, GSE	Active Console no longer packages the old deprecated `ActiveConsole-1.0.jar`, which solves the JDIC license vulnerability.
VI-9303	Web Server	The Apache commons IO has been upgraded to 2.11 to address security vulnerability: CVE-2021-29425.
VI-9347	Web Server	Web Server now displays a new banner and browser tab icon.
VI-9374	Active Console, GSE	The json-smart has been upgraded from 2.3 to 2.4.7 to address the security vulnerability: CVE-2021-31684.
VI-9378	Active Console, GSE, Web Server	The `LICENCE` and `NOTICES` files now include information for Java Native Access, jh, jhall, jhbasic, and JIDE.

Issues fixed

These are the issues we have fixed in this release:

Issue key	Component	Release description
AA-6211	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-6239	Gateway	Checks have been added in the Gateway to reject a probe if the connection details do not match those that are expected for that connection.
AA-6289	Gateway	Kubernetes mappings no longer generate entity clashes. When you upgrade to Netprobe 5.11.0, you must upgrade your Kubernetes mapping template to the latest version.
AA-6301	Netprobe	Fixed an error in the Publisher plugin when configured to publish to Hub 3 (Obcerv), and Hub 3 (Obcerv) is not configured with rootCA.
AA-6320	Gateway	The schema definition supplied for `Gateway-hubConnection` has been amended to avoid ingestion errors when this sampler is published to Gateway Hub 2.
COL-10180	Netprobe	Fixed issue where Netprobe exits when given an invalid X-plugin configuration.
C2-326	Prometheus, Collection Agent	Fixed missing Snappy dependency in the Prometheus plugin.

Known issues

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

Geneos 5.10.1

Released: 28 October 2021

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

Active Console
Collection Agent plugin
Docker Image
FIX Analyser 2Netprobe
Gateway
Gateway Helm Chart
Kubernetes plugin
Netprobe
Prometheus plugin
Web Dashboard

Highlights

These are the highlights of this release:

Uptrends is an end-user experience monitoring solution that can synthetically monitor your websites, APIs, and web applications. This release introduces the new Geneos Uptrends plugin that allows you to visualise the status of your Uptrends monitored websites and services alongside your application monitoring. Integration also allows you to click through from a Geneos dataview in the Active Console to the Uptrends UI for more detailed investigations.
X-plugins now support Npcap (replacement for WinPcap) without needing to run in compatibility mode.
Improved MariaDB support for Gateway database logging and SQL Toolkits.

New features and enhancements

These are the new features and enhancements of this release:

Issue key	Component	Release description
AA-6101	Gateway, Netprobe, Docker Image	The base image of Docker components has been moved to UBI8.
AA-6176	Gateway Helm Chart	Helm chart for installing Geneos Gateway in the Kubernetes is now available. See Installation using helm.
C2-293	Kubernetes plugin	You can now configure specific namespaces for `KubernetesLogCollector`.
C2-301	Kubernetes plugin	Improved the interval execution time for the Kubernetes metrics.
C2-305	Kubernetes plugin	The Kubernetes labels are now published as attributes.
COL-7752	FIX Analyser 2 Netprobe	The database schema packaged with FIX Analyser 2 now uses the default database engine (usually InnoDB) when a new database is created, and it no longer explicitly specifies the MyISAM database engine.
COL-10303	Gateway, Netprobe	Netprobe now performs a forward DNS lookup for `TRUSTED_GATEWAY_HOSTS` when the reverse lookup fails.
COL-10427	Netprobe	Simplified Gateway Hub connection configuration. Also, the Collection Agent destination has been renamed to Hub3 in the Publisher plugin.
COL-10443	Gateway, Netprobe	Prometheus units are now available in the Gateway Hub `platform-datamodel`.
COL-10444	Netprobe	The Netty Project libraries in the Netprobe package have been upgraded to 4.1.69.Final to address the following security vulnerabilities: BDSA-2021-2831 BDSA-2021-2832
COL-10523	Netprobe, Prometheus	The Netty packaged in the Prometheus plugin has been updated to 4.1.69.Final to address the following security vulnerabilities: BDSA-2021-2831 BDSA-2021-2832
COL-10528	Netprobe	The Geneos Uptrends plugin is now available to use. This integration allows you to collect Uptrends Synthetics Monitoring metrics.
COL-10549	Netprobe, Collection Agent, Kubernetes, Prometheus	The versions of the following components that are packaged with Netprobe 5.10.x have been updated to: Collection Agent 2.3.0 Kubernetes plugin 2.2.1 Prometheus plugin 2.0.1
VI-8938	Active Console, GSE, Web Server	The Google Guava library used in both Active Console and Web Server has been updated to 31.0.1-jre to address the following security vulnerability: CVE-2018-10237 (BDSA-2018-1358).
VI-9208	Active Console, GSE	The HttpClient library used in both Active Console and Gateway Setup Editor has been upgraded to 4.5.13 to address the security vulnerability: BDSA-2020-2701.

Issues fixed

These are the issues we have fixed in this release:

Issue key	Component	Release description
AA-4360 COL-7983 COL-7984	Gateway, Netprobe	The load order of MySQL and MariaDB client libraries has been changed so that the supported ones are picked up first.
AA-5496	Gateway	Gateway now loads `libmysqlclient.so.20` if available.
AA-6226	Gateway	A Gateway with database logging activated no longer logs duplicate messages when activating. The message logged by a primary Gateway that starts while the secondary is active no longer refers incorrectly to manual failback.
C2-289	Kubernetes plugin	Fixed an issue where the Kubernetes log collector aborts on unhandled IO exception.
C2-300	Kubernetes plugin	The Apache Commons Compress library has been updated to 1.21 to address the following security vulnerabilities: CVE-2021-35515 (BDSA-2021-2076) CVE-2021-35516 (BDSA-2021-2075) CVE-2021-35517 (BDSA-2021-2078) CVE-2021-36090 (BDSA-2021-2073)
C2-314	Collection Agent	The Kafka dependency was removed in Collection Agent 2.3.0.
C2-319	Kubernetes plugin	Fixed an issue where the Kubernetes log reader stops reading log after `ClosedChannelException`.
COL-8249	Netprobe	X-plugins now support Npcap (replacement for WinPcap) without needing to run in compatibility mode.
COL-8491	Netprobe	Fixed `datetime` sorting algorithm in the FIX Analyser 2 web reports to include microsecond accuracy.
COL-9060	Netprobe	Fixed inconsistent behaviour when the FTM plugin is using the `monitoredDays` setting and date tags.
VI-9199	Active Console, GSE	The Active Console default workspace has been updated to remove the use of non-identifying X-path predicates (for example, `"value !OK"`) within the List Views. For your own custom workspace, we recommend that you modify the List Views to avoid using non-identifying X-path predicates, and instead use the List View filters in order to improve performance. For more information, see Refactor List Views containing XPaths with Non-identifying Predicates.

Known issues

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

Geneos 5.10.0

Released: 30 September 2021

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

Active Console
Azure 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 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 the Azure plugin allow Geneos to dynamically create entities and dataviews to keep configuration to minimum.
Azure Marketplace VM
- You can now deploy the Azure plugin through the Azure Marketplace. This deployment makes the configuration of the Azure 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` and `PUT` content-type options, such as application, JSON, and the newly added `Application/x-www-form-urlencoded`, for both bearer authentication and main request body.
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	The Azure 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	The Azure plugin and Azure Event Hub plugin now publish similar dimensions.
AZUREMON-350	Azure	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 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 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, Netprobe	The Azure 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 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 plugin
Collection Agent
Netprobe
Web Dashboard

Highlights

These are the highlights of this release:

With the addition of the Geneos Azure 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	Azure 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 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_CIPHER`environment 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

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.

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

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

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

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