Geneos 4.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 4.x releases.

For the latest highlights, see What’s New in Geneos. If you are upgrading from an earlier version of, please read Upgrade Notes for compatibility changes you should be aware of before upgrading.

Note

End of life for 4.x.x is 31 May 2023. If you are using 4.x.x, we advise you to upgrade to 5.x.x or newer.

Geneos compatibility and lifecycle

The notice of change in the Geneos compatibility identifies the components, plug-ins, 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 4.x Compatibility Matrix.

End of support

The end of support means that the affected component, plug-in, or feature is no longer supported and this ends the release of binaries. The table below lists the affected component, plug-in, or feature:

End of releasing binaries

The end of releasing binaries means that the affected component, plug-in, or feature is no longer getting binaries for certain platforms, but the support continues. The table below lists the affected components, plug-ins, or features:

Geneos 4.13.3

Released: 18 February 2020

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

• Active Console
• Gateway Recorder

Highlights

These are the highlights of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.13.2

Released: 12 December 2019

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

• Gateway

Highlights

These are the highlights of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.13.1

Released: 23 October 2019

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

• Gateway 2
• Netprobe
• Web Dashboard

Highlights

These are the highlights of this release:

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.13.0

Released: 8 October 2019

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

• Active Console
• FIX Analyser 2 Netprobe
• Gateway 2
• Netprobe
• Integration template for Amazon Web Services
• Webslinger

Highlights

These are the highlights of this release:

• Anomaly Detection feature now uses data sets from the Gateway Hub with daily and weekly seasonality.
• Netprobe no longer restarts when you configure certain Java-based plugins.
• Improved support for type trades in FIX Analyser 2.
• AWS integration now supports configurable aggregation intervals, and user-defined column orders.
• New debug option in the REST Extractor plug-in now shows HTTP requests and responses.
• Issues that caused memory leaks on Windows Netprobe were fixed.
• Updated Netprobe REST API page.
• Gateway Hub 1.5.0 introduces the following new features:
  • Anomaly detection rules.
  • Kafka publishing filter.
  • Role-based security.

Gateway

• You can now define Anomaly Detection rules that use data sets provided by the Gateway Hub. See Data Sets (Time Series) for more details.
• Gateway Hub now uses the new SSO Agent default (Hub URL instead of port 9999). See Centralised teway Setp User Guide for more details.

Plug-ins

• The following plug-ins are enhanced and no longer cause the Netprobe to restart when you update their configuration:
  • REST API plug-in.
  • REST Extractor plug-in.
  • JMX plug-in, with exceptions.
  • JMX ThreadInfo plug-in, with exceptions.
• The FIX Analyser 2 plug-in has an updated schema. For more information on the new v1.3 schema, see the FIX Analyser 2 Netprobe User Guide.
• The Exegy client API is updated to 4.1.12 for the Market Data Monitor plug-in.

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.12.1

Last updated: 29 August 2019

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

• Active Console
• Gateway 2
• Netprobe
• Integration templates:
  • Docker Integration template
  • Apica integration template

Highlights

These are the highlights of this release:

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.12.0

Released: 31 July 2019

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

• Active Console
• FIX Analyser 2 Netprobe
• Gateway
• GatewayTime zones
• Licence Auditor
• Licence Daemon
• Netprobe
• Web Dashboard
• Webslinger

Highlights

These are the highlights of this release:

• Orchestrated Netprobe solution is now available.
• Active Console is now available on macOS and Ubuntu platforms.
• Improved Centralised Configuration of Gateways.
• Improved publishing to Gateway Hub.
• New Filter in FIX Analyser 2 Message Detector View to filter on Order State.
• New REST API plug-in is now available for general access.
• Java plug-in user experience improvements.
• New Netprobe configuration options for REST API connections.
• New Netprobe installer option for SSL certificate key.

Orchestrated Netprobe

The Orchestrated Netprobe facilitates the collection of application metrics, logs, and events in an orchestrated environment.

Docker containers and Kubernetes orchestration were developed to help users manage dynamic applications. These can be:

• Large pieces of software that were split into smaller microservices.
• Applications that were coded to benefit from resiliency and scaling.

Applications support teams who are faced with the challenges of monitoring these highly dynamic applications will benefit from two key features of the Orchestrated Netprobe solution:

• The ability of the application support teams to engage with DevOps and engineering teams to instrument their containerized applications through instrumentation libraries provided as part of this solution.
• The monitoring guidelines and instructions outlined in this documentation that will help you set up Geneos to be able to receive information from these dynamic applications with minimal configuration.

For more information, see Orchestrated Netprobe documentation.

Active Console

• Active Console now supports macOS version 10.14x (Mojave) and Ubuntu version 18.04 LTS (Bionic Beaver). Both are packaged and built with OpenJDK 8. For more information, see System Requirements in Active Console.

  Note

  Active Console on Ubuntu is only available as a technology preview with limited support. It will become fully supported in a future release.

• Active Console has a new index page in the Geneos online documentation, similar to Gateway Hub, so you can easily view the list of all topics. The new Active Console Documentation is available starting 4.11.x.

Gateway and Gateway Hub

• The improvement in publishing to Gateway Hub reduces the data required to publish from Gateway to Gateway Hub. As a result, this also improves the bandwidth, storage, and processing. You need to update both Gateway and Gateway Hub to get this update. See Connect a Gateway in Gateway Hub.
• Gateway Setup Editor can now lock and unlock centrally managed configurations in the Gateway Hub. The non-blocking interaction with Gateway Hub reduces the impact on Gateway.
• The Gateway Hub API documentation has improved. See API Documentation.
• For detailed release notes in Gateway Hub, see Gateway Hub Release Notes 1.4.

Netprobe

• You can now include the Order State as an additional column in FIX Analyser 2 Message Detector Template. You can also filter Message Detector Template’s dataview using the said column. For more information, see Order state filter in FIX Analyser 2 Netprobe User Guide.
• You can configure connection options for the new REST API plug-in from the probe:
  • For normal Netprobes, see probes > probe >restApiHttpPort and restApiHttpsPort in Probes.
  • For floating Netprobes, see probes > floatingProbe >restApiHttpPort and restApiHttpsPort in Probes.
  • For Self-announcing Netprobes, see selfAnnounce >restApiHttpPort and restApiHttpsPort in the Netprobe User Guide.
• You can now set an SSL certificate key from the Netprobe installer. This includes installer command-line options. For more information, see Installer command line options in the Netprobe User Guide.

Plug-ins

• The REST API plug-in is a new RESTful inbound API in the Netprobe. This plug-in enables a sampler to listen to inbound messages on an HTTP or HTTPS connection. The REST API endpoints support creating, updating, and deleting of dataviews and rows. Also, this plug-in includes a stream endpoint for streaming log/event data directly to FKM. For more information, see REST API Plug-in User Guide.
• The Java plug-in configuration was streamlined improving logic for locating JARs, and libraries without the need to set the environment variables. For more information, see Configure the Java environment.

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.11.2

Released: 13 June 2019

Note

Issues that have been identified with Webslinger 4.11.0 for Linux and Solaris platforms, and Netprobe 4.11.1 for Windows are now fixed. We recommend that you download and use 4.11.2 version of these components.

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

• Active Console
• Gateway
• Netprobe

Highlights

These are the highlights of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.11.1

Released: 3 June 2019

Note

Issues that have been identified with Webslinger 4.11.0 for Linux and Solaris platforms, and Netprobe 4.11.1 for Windows are now fixed. We recommend that you download and use 4.11.2 version of these components.

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

• Gateway
• Netprobe
• Active Console
• Web Dashboard
• Licence Daemon (LICD)
• RabbitMQ monitoring integration template

Highlights

These are the highlights of this release:

RabbitMQ Monitoring

RabbitMQ integration enables you to retrieve all metrics available in your RabbitMQ environment and display them as dataviews in Geneos. You can see your RabbitMQ exchanges, nodes, queues or virtual hosts.

For more information, see RabbitMQ Monitoring User Guide.

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.11.0

Released: 2 May 2019

Highlights

Note

Issues that have been identified with Webslinger 4.11.0 for Linux and Solaris platforms, and Netprobe 4.11.1 for Windows are now fixed. We recommend that you download and use 4.11.2 version of these components.

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

• Active Console
• Gateway
• Licence Daemon (LICD)
• Netprobe (includes the RPM package)
• SSO Agent 1.4
• VMWare Third Party Plug-in
• Webslinger
• Integration templates:
  • Apica Monitoring integration template
  • AWS Monitoring integration template
  • Kubernetes Monitoring integration template -OpenShift Monitoring integration template

These are the highlights of this release:

• Centralised Gateways allow Gateway to store its setup in the Gateway Hub.
• Improved the Context-sentive help (CSH) in Gateway Setup Editor (Gateway Setup Editor).
• Improved responsive design for viewing documentation on mobile.
• Multiple managed entities are now supported on Self-Announcing Netprobes.
• Netprobe is now available as an RPM package.
• The Object Inspector dockable that supports the style, properties, and datasets of objects is now available in the Active Dashboard.
• The REST Extractor plug-in is a new plug-in for reading data from REST API.
• Set command line arguments from a file.
• Single sign-on works for Gateway Setup Editor (GSE).
• New Integrations:
  • Kubernetes Monitoring
  • Openshift Monitoring
  • RabbitMQ Monitoring

Centralised Gateways

You can now store Gateway configurations in Gateway Hub. Gateway Hub can function as a centrally accessible repository for Gateway setup and include files.

For more information, see Centralised Gateways User Guide.

Context-sensitive help

Right-clicking on an element in the Gateway Setup Editor and selecting Help now directs you to the online documentation by default. The element you selected is highlighted in the documentation.

If you have restricted internet access, you can download an offline package of the documentation and configure your GSE to point to this documentation instead.

To learn how to do this, and for more information, see Host the documentation locally to use Gateway Setup Editor context-sensitive help.

Object Inspector dockable

The Object Inspector dockable displays the style and properties of the selected shapes, and dataset of the charts when an object from the Active Dashboard is selected.

For more information, see Object Inspector dockable

REST Extractor plug-in

The REST Extractor plug-in is a new plug-in for reading data from REST APIs.

For more information, see REST Extractor Plug-in User Guide.

Set command line arguments from a file

The Gateway can now read command line arguments from a file on startup.

For more information, see Command line options

Kubernetes Monitoring

Kubernetes monitoring integration has been enhanced. You can now query the services of your Kubernetes running environment, see the number of pods, you have the ability to describe builds and tail logs from a pod or from a container.

For more information, see Kubernetes Monitoring User Guide.

OpenShift Monitoring

OpenShift integration enables you to retrieve all metrics and metadata available in your OpenShift environment and display them as dataviews in Geneos. You can query services of your OpenShift running environment, see the number of pods, list the available images you can deploy, check the ability to deploy builds, and tail logs from a pod or from a container.

For more information, see OpenShift Monitoring User Guide.

Breaking changes

These are the breaking changes in this release:

• In the Gateway, the behaviour of the _COMMENT environment variable has changed for actions fired by the unassignment of a data item. Previously, the comment provided when the item was assigned was placed in the _COMMENT environment variable for both assignment and unassignment events. It is now possible to configure Gateways to require comments for both assignment and unassignment events. This means for actions fired by unassignment events, the comment provided when the item is unassigned is placed in the _COMMENT environment variable. The comment that was provided when the item was originally assigned is now moved to a new environment variable called _PREVIOUS_COMMENT.
• Improved the Context Sensitive Help (CSH) for Gateway Setup Editor (Gateway Setup Editor) that is based on the specific content available online. Context sensitive help will launch your default browser to access the content online. To know more about this, see Host the documentation locally to use GSE context-sensitive help in Gateway Setup Editor.

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.10.2

Released: 28 March 2019

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

• Active Console
• Netprobe
• Gateway
• Licence Daemon (LICD)

Issues fixed

These are the issues we have fixed in this release:

Geneos 4.10.1

Released: 28 February 2019

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

• Active Console
• Netprobe
• Gateway
• Web Dashboard
• Citrix integration template

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.10.0

Released: 31 January 2019

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

Highlights

These are the highlights of this release:

• The Show tooltip on hover option was added to dashboard properties.
• More flexible Active Time configuration to support day of month options.
• Control-M plug-in based on Control-M’s REST API now supports Control-M versions 9.0.18 and above.
• Gateway command now requires user input for commands that can improve workflow and auditing.
• Improved integration and self-monitoring of Gateway to Gateway Hub connectivity.
• Kerberos support for accessing remote configuration files.
• The Object Inspector was a pilot feature released for which displays some modifiers and links properties of dashboard objects.
• Password sanitisation in Gateway Setup Editor.
• User Assignment is now populated from Active Directory users.
• SampleNow command (executed from Managed entity or Sampler) now updates the currently displayed Metrics dataview.
• Self-Announcing Netprobes was improved to easily manage large scale dynamic environments.
• Setup configuration can now be specified from a remote source in the Netprobe.
• Simplified version of the comments can be enabled in the Gateway Setup Editor.

Active Dashboard tooltip

When you have multiple dashboards in your environment with a large number of modifiers, you continually get the tooltips appearing. While this is useful during the initial setup of the dashboards, this might cause inconvenience if the tooltip keeps appearing but there is no option to disable the dashboard tooltips.

To resolve this, the Show tooltip on hover option is added to Dashboard properties that enables the modifier information as a tooltip for dashboard objects. By default, this option is enabled.

For more information, see Dashboard properties in Active Console.

Active times

You can now specify the time period for an active time as a repeating day. For example, as the last Friday in every month of every year, or the first Monday in June every year.

For more information, see activeTimes > activeTime > schedulePeriod > day.

Control-M plug-in (REST API)

The new Control-M plug-in is powered by REST API and supports Control-M versions 9.0.18 and above. It requires Java 8+ to run.

For more information, see Control-M Plug-in User Guide.

Gateway command

You can now specify that user input arguments requires a value to be entered to execute the command.

For more information, see commands > command > userCommand > args > arg > userinput > requireArgument.

Gateway Hub Data Plug-in

The Gateway Hub Data plug-in monitors the current configuration and state of publishing to Gateway Hub from a connected Gateway. This allow for self-monitoring of a Gateway Hub instance from Geneos.

For more information, see Gateway Hub Data plug-in.

Kerberos authentication

Active Console supports remote connection files that require Kerberos authentication or files that are hosted in a Kerberized web server.

For more information, see Connections settings in Active Console.

Object Inspector

Previously, the only way to edit the modifiers in Active Dashboard was when you right-click the object’s properties.

Now, when an object is selected, the Object Inspector dockable appears that allows you to add, edit, and delete modifiers. For more information, see Object inspector.

To view the changes for Object Inspector that have been introduced in Geneos 4.11.0 , see Object Inspector dockable in Active Console.

Password sanitisation

When you copy named items in the GSE, any passwords (for example, within Sampler or Type definitions) are removed from the copy.

For more information, see Password removal on copying.

Sampling information label

Previously, the Sample Time did not report the correct values in the dataview. In Geneos 4.10.0 release, this is fixed and the SampleNow command (executed from Managed entity or Sampler) updates the currently displayed Metric dataview. For more information, see The Metric table viewer in Active Console.

Self-announcing Netprobe commands

The Self-announcing Netprobe commands now allow the Self-announcing Netprobes to:

• Rebalance across available Gateways.
• Retrieve their configuration from a remote, secure, and URL-based source.
• Retain Snooze and User Assignment information when moving between Gateways.

There are two new commands available to help you configure Self-announcing Netprobe (SAN) on your Geneos estate:

• Rebalance SANs —  rebalances SAN connected to the Gateway based on either the number of SAN or the Gateway score.
• Disassociate Probe — forcibly disassociates a SAN from a Gateway.

See Netprobe commands and Rebalance Self-Announcing Netprobes command.

Set up configuration from remote source

You can now specify the netprobe.setup.xml configuration for a self-announcing or floating Netprobe from a remote URL. This option supports HTTPS. In addition, the Netprobe can be configured to periodically retrieve the configuration from the remote source.

This feature is unavailable for AIX platforms. For more information, see the following commands in the NetprobeCommand line options:

• /setup=<full path or URL to file>
• /setup-interval=<minutes>
• /setup-server-verify
• -setup <url>
• -setup-interval <minutes>
• -setup-server-verify <file>

Simplified comments

You can now enable a simplified version of the comments in the Gateway Setup Editor.

To learn how to do this, and for more information, see Simplified comments.

Breaking changes

Active Dashboard Tooltip

Geneos 4.10.0 release introduces the Show Tooltip on hover dashboard level setting to enable or disable the tooltip on dashboards. By default, Active Dashboard tooltips are disabled in Geneos 4.10.0 release. Based on the feedback from users, we have reversed this behaviour so that from Geneos 4.10.1, the Active Dashboard tooltips are enabled by default. This maintains behaviour prior to changes made in Geneos 4.10.0.

For more information, see Dashboard Properties.

New features and enhancements

These are the new features and enhancements of this release:

Issues fixed

These are the issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.9.3

Released: 13 December 2018

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

Highlights

These are the highlights of this release:

• New Azure Monitor and Google Stackdriver integrations.

Azure Monitor Integration

Azure Monitor allows you to collect data, logs and notifications from your Azure resources. The integration with Geneos enables you to retrieve all these metrics and logs available in your Azure Monitor setup and display them as dataviews in Geneos.

For more information on the Azure Monitor integration, see Azure Monitor Integration User Guide.

Google Stackdriver Integration

Google Stackdriver aggregates metrics and events from infrastructure. The integration with Geneos enables you to retrieve all these metrics and metadata available in your Google Stackdriver setup and display them as dataviews in Geneos.

For more information on the Stackdriver integration, see Google Stackdriver Integration User Guide.

New features and fixed issues

These are the new features and issues we have fixed in this release:

sso-agent.conf
"ldap" section:
 "query_filter" : "(objectCategory=person)(objectClass=user)",

"ldap":{
 "location": "ldap://192.168.10.2:389",
 "secure": false,
 "base": "OU=Global,DC=ldn,DC=itrs",
 "user": "XXX",
 "password": "YYY",
"fields": {
 "user": "sAMAccountName",
 "displayname": "displayname",
 "email": "mail"
 },
 "group_filter": "^[A-Z]"
},

Known issues

These are the known issues affecting this release:

Geneos 4.9.2

Released: 28 November 2018

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

New features and fixed issues

These are the new features and issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.9.1

Released: 12 November 2018

Note

We identified an issue where some users were unable to save workspaces after upgrading to 4.9.0 release of Active Console. This issue is fixed and an updated Active Console 4.9.1 release is available to download. If you have downloaded 4.9.0 release ofActive Console, we recommend you upgrade to 4.9.1.

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

Highlights

These are the highlights of this release:

• New Velocimetrics Health Monitoring and Azure Monitor (tcproject/docs/geneos/data-collection/azure-monitor/current/azure-monitor.html) integration.

Velocimetrics Health Monitoring

Velocimetrics provides a real-time flow, volume and latency performance analysis. It is hardware based, and it includes a flow monitoring correlation engine. Velocimetrics Health Monitoring (VMX) integration with Geneos enables you to retrieve health statistics from the VMX servers using the JMX API and display them as dataviews in Geneos.

For more information on Velocimetrics Health Monitoring, see Velocimetrics Health Monitoring User Guide.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.9.0

Released: 31 October 2018

Note

We identified an issue where some users were unable to save workspaces after upgrading to 4.9.0 release of Active Console. This issue is fixed and an updated Active Console 4.9.1 release is available to download. If you have downloaded 4.9.0 release ofActive Console, we recommend you upgrade to 4.9.1.

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

Highlights

These are the highlights of this release:

• In the Active Console > Active Pie Chart settings, you can now modify the starting angle by setting the value in the Orientation (degrees) field.
• It is now possible to create a Bar Chart in Active Dashboard.
• Encrypt settings now allow you to encrypt settings that cannot be set in cleartext.
• The Exegy adapter for MDM plugin was enhanced.
• kafkacat is now shipped with Linux 64-bit Gateway.
• File Keyword Monitor and File Transfer Monitor plug-ins introduce new extended date generation keywords.
• Operating Environment now instructs the Gateway to reject connections from every component with versions older than the specified version.
• Improved schema management for Gateway Hub Publishing.
• Target Marker now converts a dataset into a target marker in Active Charts.
• Gateway Setup Editor usability improvements.
• The Database Query Arguments window has been renamed to User Defined Parameters.
• You can now use Kerberos to connect to Kafka.
• You can now use SASL authentication for publishing.
• New Integrations:
  • Citrix XenApp Monitoring
  • Thomson Reuters
  • Velocimetrics Health Monitoring
  • Azure Monitor
  • Google Stackdriver

Active Pie Chart settings

In the Pie Chart’s properties, an option should be available so the user can change the starting angle of the pie chart.

You can now modify the starting angle by setting the value in the Orientation (degrees) field. It sets the starting angle position of the pie chart in a clockwise manner. This can accommodate values between 0-360 degrees.

To configure the general settings of an Active Pie Chart, go to View > Active Dashboards > Active Dashboard Palette > Active Pie Chart.

See Active Pie Charts in Active Console.

Bar Chart

A dashboard is now capable of creating a bar chart that can display a data set using the selected data item. Similar to other charts, such as Pie and Active charts, you can manually add multiple data items into existing bar charts.

See Bar chart in Active Console.

Encrypt settings

You can now encrypt settings that cannot be set in cleartext, such as passwords, in the Gateway setup file.

See publishing > secureSettings.

Exegy adapter

The Exegy adapter now supports the commodities instrument class. In addition, new supported fields for the existing equities instrument class are added.

For more information, see Exegy adapter.

kafkacat

kafkacat is now shipped with Linux 64-bit Gateways. It can be used to test connecting to your Kafka infrastructure.

See kafkacat in Publish to Kafka and Nanomsg.

File Monitoring Plug-in

Similar to updates introduced to the File Transfer Monitoring (FTM) plug-in for Geneos 4.8.0, the today + x, today - x, previous_monitored_day - x, and next_monitored_day + x date keywords are now available to the File Keyword Monitoring (FKM) plug-in as well. These date keywords give you more flexibility in naming the files generated by the plug-ins.

In addition, we added some validations around the date keyword expansions. For more information, see the following:

• files > file > path for the FKM plug-in.
• files > file > path for the FTM plug-in.

Operating Environment

You can configure the Gateway to reject incoming connections from Geneos components that do not reach a minimum specified version.

See operatingEnvironment > clientConnectionRequirements > minimumComponentVersion > minimumForAllComponents in Operating Environment.

Schema Commands

There are now two schema commands available in the GSE:

• Propose Schema — suggests a schema for your sampler.
• Show Current Schema — shows you the current schema configured for a sampler.

These commands allow you to see and create new schemas for your dataviews.

Target Marker

In Active Charts, a dataset can be used to show a horizontal line in the chart. You can now use Target Marker to visualise threshold markers and values in Active Charts. The conversion of the selected dataset into a horizontal line or marker is based on its cell value from the metrics dataview.

See Convert a dataset into a target marker in Active Console.

User Defined Parameters in Active Dashboard

With the Gateway Hub added to Active Console, the Connection menu is obsolete as it only returns database logging connection entries. Since this is no longer just applicable for database logging queries, the Database Query Arguments window has been renamed.

You can now populate a historical chart data using User Defined Parameters that can be used for Gateway Hub data source. To get historical data in Active Chart for a specific period, go to View > Active Dashboards > Active Dashboard Palette > Active Chart.

See Get historical data within specified date range in Active Console.

Use Kerberos to connect to Kafka

You can now use Kerberos to connect to Kafka on Linux 64-bit Gateways.

See Use Kerberos to connect to Kafka on Linux 64-bit Gateways.

SASL authentication

You can now use SASL authentication for publishing.

See publishing > additionalSettings.

Citrix XenApp monitoring

We have developed a new integration for monitoring Citrix XenApp implementations. This new integration replaces our existing Citrix plug-ins, which are due to reach end of life in February 2019.

For more information on the new Citrix XenApp monitoring integration, see Citrix XenApp Monitoring User Guide.

CorvilNet monitoring

ITRS now owns and manages the CorvilNet integration resources, also known as the CorvilNet plug-in (CNPI). This integration enables Geneos to connect with the CorvilNet Engine and collect network monitoring statistics.

For more information on the CorvilNet monitoring integration, see CorvilNet Monitoring User Guide.

RefinitivTREP integration

Geneos configuration templates are available for monitoring the Refinitiv TREP platform. The integration provides a set of configuration files, dashboards, and tools which enable out-of-the-box monitoring of the TREP platform and related applications through preconfigured samplers and types.

See Refinitiv TREP Integration.

Ultra Messaging monitoring

ITRS now owns and manages the Ultra Messaging integration resources, also known as the Ultra Messaging plug-in (UMPI). This integration enables Geneos to monitor status and performance data coming from applications based on the Ultra Messaging high-performance message streaming (UMS) application.

For more information on the Ultra Messaging monitoring integration, see Ultra Messaging Monitoring User Guide.

Breaking changes

Commands, Actions and Effects

Geneos 4.7.0 release introduced changes to the way arguments are parsed to Commands, Actions and Effects.

These changes were required to provide consistent behaviour and understanding across both Netprobe and Gateway to simplify user experience.

We strongly recommend you check the configuration and behaviour of any Commands, Actions and Effects before deploying to production.

For more information, see Commands, Actions and Effects.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.8.0

Released: 31 July, 2018

Last updated: 12 October, 2018

Note

We discovered an issue in 4.8.0 release of Gateway when primary and secondary Gateways are started with Gateway publishing enabled, an error is encountered. This issue is fixed and an updated Gateway version 4.8.1 is available to download. If you have downloaded 4.8.0 version of Gateway, we recommend you upgrade to 4.8.1.

Geneos Web Dashboard version 4.8.2 is available which resolves security vulnerability in spring framework. The following CVEs are addressed: CVE-2018-1270, CVE-2018-1275, CVE-2018-1199, CVE-2018-1271, and CVE-2018-1272.

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

Highlights

These are the highlights of this release:

• Gateway Setup Editor continues to support current open format for publishing to Kafka.
• Easy access to metric and event history in Active Console.
• File Transfer Monitor plug-in now supports extended date generation keywords.
• Improved alerting in the Gateway alerts with respect to snoozing in order to reduce the number of alerts triggered.
• Gateway time zone and offset allows you to issue remote REST commands with “data and time” parameters without having to first calculate the time difference.
• Gateway Hub Publishing now stores and retrieves metric and event history. This includes event snapshot and snapshots payload schema.
• Includes Data plug-in in the Gateway was enhanced for you to see the last user who edited a setup file, the name of the workstation, and the Gateway these were authenticated with.
• Logging of Snoozed and User Assign events was improved to provide full audit trail of activity.
• JMX port for remote monitoring now monitors the performance of Web Dashboard using new metrics exposed through JMX.
• Managed Entities plug-in in the Gateway allows you to list the busiest dataviews on a managed entity using a command.
• Latency library for MDM plugin was optimised to improve memory usage.
• The Workspace settings in the Active Console now include the configuration for Gateway Hub.
• You can now use a wildcard * to allow global access in the properties.
• New Integrations:
  • Amazon Web Services Monitoring
  • ITRS Synthetic Monitoring (powered by Apica)

File Transfer Monitoring (FTM) Plug-in

The file related plug-ins generally support date generation keywords, such as <today> and <yesterday>, to generate file names to process. However, these keywords are not consistently supported by all plug-ins.

Now, these keywords have included a new set of data generation keywords. New file keywords for today + x, today - x, previous_monitored_day - x, and next_monitored_day + x date tags are added.

For more information, see File Transfer Monitor User Guide.

Gateway Alerts

The behaviour for when notifications for suspended alerts are triggered has changed to reduce the number of unhelpful messages when alerts come out of an inactive period.

See Suspended Alerts in Rules, Actions, and Alerts.

Gateway time zone and offset

You can now obtain the Gateway time zone and offset using a REST endpoint. This allows you to issue remote REST commands with “data and time” parameters without having to first calculate the time difference.

See Obtain the Gateway time zone and offset in Gateway Commands.

Events snapshot

You can now request a snapshot of severity, snooze and user assign events.

See Snapshot request for events in Publish to Kafka and Nanomsg.

Snapshots payload schema

User assigned and snoozed information has been added to the Payload Schema. This allows you to easily identify severity changes that are not snoozed or assigned to someone.

See Appendix: Payload schema in Publish to Kafka and Nanomsg.

Includes Data Plug-in in Gateway

You can now see the last user who edited a setup file, the name of the workstation, and the Gateway they were authenticated with, via three new columns added to the Includes Data plug-in.

See Includes data in Gateway Plug-Ins.

JMX port for remote monitoring

Most users are relying on Web Dashboards to provide the overall system health and transaction flows. To ensure that these Web Dashboards are functioning normally, MBeans or methods to determine the dashboard statistics for dashboard count and stale are required.

You can now use the JMX monitoring to remotely monitor the GatewayMonitor and DashboardMonitor MBeans. To do this, enable the JMX_PORT and JMX_FLAG debugging flags in the run script of your installation.

See Enable JMX port for remote monitoring in Web Dashboard.

Managed Entities Plug-in in Gateway

You can now list the busiest dataviews on a Managed entity using a command on the Managed Entities Plug-in. Two new columns have also been added showing the total number of dataviews on a managed entity and the number of cells on the dataview with the most cells. This allows for an easier troubleshooting exercise when investigating a busy Gateway.

See Managed entities data in Gateway Plug-Ins.

Workspace settings

You can now use the Gateway Hub connections in the Active Console settings. Also, the Workspace Settings dialog has been updated to include a new section for Gateway Hub.

The Gateway Hub icon appears at the dataview and Gateway levels to indicate if data is publishing to and can be retrieved from Gateway Hub.

See Gateway Hub settings in the Active Console.

SSO properties

You can now use a wildcard (*) to allow global access for config.user.groups and dashboard.user.groups.

This allows anyone from the group to access the Web dashboards. A pattern is used to check if the user group roles are authorised.

Amazon Web Services monitoring

Amazon Web Services (AWS) integration with Geneos enables you to retrieve live Amazon Elastic Compute Cloud (EC2) instance information, list CloudWatch metrics, monitor volumes and other interactions configured in Amazon Web Services, and display them as dataviews in Geneos.

For more information, see Amazon Web Services Monitoring User Guide.

ITRS Synthetic Monitoring

ITRS Synthetic Monitoring*(powered by Apica)* allows you to monitor websites, web applications, and web services. The integration with Geneos enables you to retrieve all the checks and alert statistics configured in the Apica dashboard and display them as dataviews in Geneos.

For more information, see ITRS Synthetic Monitoring User Guide.

Breaking changes

Commands, Actions and Effects

Geneos 4.7.0 release introduced changes to the way arguments are parsed to Commands, Actions and Effects.

These changes were required to provide consistent behaviour and understanding across both Netprobe and Gateway to simplify user experience.

We strongly recommend you check the configuration and behaviour of any Commands, Actions and Effects before deploying to production.

For more information, see Commands, Actions and Effects.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.7.0

Released: 31 May, 2018

Last updated: 7 June, 2018

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

Highlights

These are the highlights of this release:

• Consistent argument parsing for actions and commands to simplify configuration.
• Market Data Monitor plug-in introduces ICE Feed Adapter for ICE Market Data Services.
  • Real-time monitoring for consolidated feed provided by ICE Data Services.
• The scoring criteria in Paths scoring were improved to identify expensive XPath in the Active Console.
• The behaviour for action and command scripts run on Netprobe and Gateway is now consistent:
  • Gateway Actions and Effects argument parsing behaviour.
  • Gateway commands argument parsing behaviour.
• The cpuClockSpeed in the Hardware plug-in now displays the maximum speed frequency of the first CPU found by Netprobe.
• SSL certificate authentication was added for Webslinger.

ICE Feed Adapter

The new ICE Data Services or IDC consolidated feed adapter uses the IDC Consolidated Feed Token Format (CTF) Wire Protocol.

See ICE adapter in Feed Adapters.

Path scoring

In Paths dockable, you can use the Evaluate all button to check all the XPaths in one single click. The result displays “N/A” if the list is not an XPath. Also, an expensive XPath is highlighted in orange.

See Evaluate paths in Active Console Paths Dockable and Scoring.

Gateway Actions and Effects argument parsing behaviour

The behaviour for Actions and Effects have changed to ensure consistency when actions and effects are run on the Gateway or Netprobe and to reduce unexpected behaviour.

See Script effects in Rules, Actions, and Alerts.

Gateway commands argument parsing behaviour

The behaviour for Commands has changed to ensure consistency when commands are run on the Gateway or Netprobe and to reduce unexpected behaviour.

Hardware Plug-in

The cpuClockSpeed has changed to display the maximum speed frequency of first CPU found by Netprobe.

See Hardware Plug-in - Technical Reference.

SSL authentication for Webslinger

Webslinger now connects to Gateways using SSL certificates.

See SSL authentication on a Secure Gateway in Webslinger.

Breaking changes

Commands, Actions and Effects

Geneos 4.7.0 release introduces changes to the way arguments are parsed to Commands, Actions and Effects.

These changes were required to provide consistent behaviour and understanding across both Netprobe and Gateway to simplify user experience.

We strongly recommend you check the configuration and behaviour of any Commands, Actions and Effects before deploying to production.

For more information, see Commands, Actions and Effects.

New features and fixed issues

These are the new features and issues we have fixed in this release:

dataitem(/geneos/gateway/directory/probe/managedEntity/sampler/dataview/rows/row/cell
[(state("snoozed")="1")])

Known issues

These are the known issues affecting this release:

Geneos 4.6.0

Released: 3 April 2018

Last updated: 4 May 2018

Note

An issue was discovered in 4.6.0 release of Gateway where string variables containing special characters like < did not parse correctly. As a result, string variables containing special characters like <today... used by plug-ins for specifying date or time substitution did not work correctly. This issue is fixed and we recommend you upgrade to 4.6.1 to get the updated Gateway version.

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

Highlights

These are the highlights of this release:

• New monitoring integrations with data storage, messaging, and orchestration platform.

  • Self-contained downloadable packages that can be integrated with many applications and services to collect key performance metrics.
  • Built on core plug-ins and features, such as JMX and Toolkit.

• Active Console introduces a new path dockable that can display all XPaths and identify which XPaths are likely to be expensive. This enables you to optimise the use of XPaths and improve performance of Active Console.

• Search results in the Active Console can now be converted into List Views dockable, allowing you to save your favourite search results.

• New 64-bit Active Console is now available to improve compatibility with 64-bit libraries.

• Active Dashboard improvements that allow you to:

  • Temporarily hide dashboard objects, allowing you to easily access and edit dashboards.
  • Trigger follow selection events from within dashboards by simulating user selection. This enables more interactive user experience of the dashboards by allowing dashboards to be reconfigured by selecting other dashboard objects.
  • Open multiple links on a dashboard object at the same time.

• Gateway can now store environment configuration in a more efficient manner, reducing the memory footprint, especially in large setup.

• New integrations:

  • ActiveMQ Monitoring
  • Cassandra Monitoring
  • Docker Monitoring
  • Elasticsearch Monitoring
  • Hadoop Monitoring
  • Kafka Monitoring
  • Kubernetes Monitoring
  • MongoDB Monitoring
  • Postgresql Monitoring
  • Zookeeper Monitoring

New features and fixed issues

These are the new features and issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.5.0

Released: 31 January, 2018

Last updated: 9 February, 2018

Note

Geneos Netprobe version 4.5.1 is available with fix for COL-6052 that resolves an issue where FKM starts reading at the beginning of the file, even though the default is to start at the end. The fix for COL-6049 is also available that resolves an issue where Disk plug-in inode columns show zero while waiting for NFS partition data.

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

Highlights

These are the highlights of this release:

• Gateway sharing feature is used to export a subset of monitoring data from one Gateway and import it into another. Gateway sharing of commands allows you to apply their own rules on the same set of data, aggregate visualisation of data derived from multiple Gateways, and to easily share data across regions and teams. The ability to share commands along with data provides greater level of access and control over the shared data.
• Sharing of commands require both Gateways to be using Single Sign On. This ensures existing controls over permissions are maintained.
• These commands can be shared between Gateways:
  • Probes commands defined by a sampler that run in the Netprobe.
  • User commands defined in the exporting that run in the Netprobe.
  • Sample Now and View Netprobe log.
  • Snooze commands.
  • User Assignment commands.
  • Show Rules.
• Heartbeat function for API Stream plug-in now provides better status of the process generating the stream.
• Hardware plugin now includes more metrics and provides a consistent view across supported platforms:
  • New metrics include NTP service availability and local clock offset, hardware vendor, CPU model, and clock speed.
  • Replaced the timeDifference metric with ntpAvailability and ntpLocalClockOffset metrics. These two new metrics provide a more accurate measurement for time difference based on NTP service.
  • In case of multi-CPU or multi-cores Windows servers, the cpuUtilisation represents the average across cores/CPUs, instead of the heaviest loaded logical processor.
  • On Solaris, swapUsed is based on swap -l command, instead of swap -s. A new metric called swapUsed (virtual) is available that is based on swap -s command.
  • On Linux and Solaris, cpuUtilisation now takes CPU wait times into account.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Geneos 4.4.0

Released: 1 December, 2017

Updated: 17 January, 2018

Note

Active Console version 4.4.1 is available that resolves an issue where Active Console configuration is not loaded if workspace configuration do not have the SSOAgentUrl defined.

Last updated: 14 June, 2018

Note

Active Console version 4.4.2 fixes an issue where the SSO login failed for users who belong to lots of AD groups (reproduced using single user belonging to more than 300 AD groups).

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

Highlights

These are the highlights of this release:

• A new Single Sign-On and Active Directory integration:
• Integration with Active Directory that secures centrally managed access, improves audit control, and makes the maintenance easier.
• Supports passwordless login using and NTLM.
• Compatible with the existing Gateway Roles and Permissions.
• Gateway Annotations allow you to configure text to be passed into actions and alerts based upon data items on which these are triggered. For example, this makes it possible to place text specific to data items into an email, independent of rules, actions, and effect configuration.
• Extractor plugin now supports parsing JSON data for creating dataviews.
• Extended rule syntax for userdata to support more data types, such as dataview name, managed entity attributes, active, and snooze states. This makes it easier to define userdata directly in rule syntax without having to specify variables.
• You can now restrict access to Gateway sharing data sets to specific users.
• Gateway sharing connectivity between Gateways can now use SSL certificate for password less authentication.
• Active Console to support connecting to Sybase database with password encryption enabled.
• MQ plug-in supports encrypted password for security exit configuration.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Known issues

These are the known issues affecting this release:

Geneos 4.3.0

Released: 2 October, 2017

Geneos Single Sign On capability is currently in “Limited Availability”. We are working with a number of early adopters to further enhance the capability. We aim to make this “Generally Available” by end of November.

Note

Geneos 4.3.o version of Gateway, Active Console, Web Dashboard, and Webslinger have been enhanced to support Geneos Single Sign On capability. You may see changes within the product to support this, but you will require the new SSO Agent binary to enable integration with LDAP / Active Directory. Please contactITRS Support if you would like to request access to the new SSO Agent binary

Last updated: 8 November, 2017

Note

Active Console version 4.3.1 is available with fix for VI-7090 which resolves an issue where Active Console configuration is not loaded if workspace configuration don’t have SSOAgentUrl defined

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

Highlights

These are the highlights of this release:

• Improved load balancing of Self-Announcing Netprobes:
  • The algorithm used to allocate Self-Announcing Netprobes between Gateways has been enhanced so that Gateways can inform each Netprobe about the other Netprobes that are negotiating a connection.
  • This ensures that the load is evenly distributed if many Netprobes are started at once, or if the number of Netprobes have to choose between two or more remaining Gateways when one Gateway stops.
• Improved password security in the Gateway configuration.
• JRE and Spring security library updates.
• SSL client authentication for Webmon plugin.
• Improved X plugins connectivity.
• Improved file name matching for file related plugins.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Geneos 4.2.0

Released: 1 August, 2017

Updated: 17 August, 2017

Note: Geneos Web Server (Web Dashboard) version 4.2.0 is available with fix for WEB-474 that resolves an issue with delays in updating the Web Dashboard browser interface.

Updated: 24 August, 2017

Note: The new 64-bit Windows Netprobe binary is available to download from ITRS Downloads.

Last updated: 9 February, 2018

Note

Geneos version 4.2.1 is available with fix for COL-6049 that resolves an issue where Disk plug-in inode columns show zero while waiting for NFS partition data. The fix for COL-5714 is also available which resolves an issue where Disk plug-in significantly increase virtual memory usage in NFS partition.

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

Highlights

These are the highlights of this release:

• Gateway Setup Editor usability usability improvements include:
• Number of fixes to improve sizing of input fields.
• Improved linking to errors in include files so you can quickly identify the correct section of the setup file.
• GSE now supports copying and pasting named items from one setup file to another. Previously, this was only possible within a setup file.
• GSE now warns you if the changes that are about to be applied might remove the ability for them to make further changes to the setup.
• You can now use follow selection paths in the Active Dashboard.
• Gateway and Netprobe now support SSL verification to establish a secure communication between these Geneos components.
• Gateway can start up and continue to run when read/write problems are detected in the Gateway cache.
• Geneos stringList variables can now be used within Rules.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Geneos 4.1.0

Released: 31 May, 2017

Last updated: 16 June, 2017

Note

Active Console is upgraded to 4.1.1 that includes the fix for ACX-4412 to make tooltips appear correctly in the entities view.

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

Highlights

These are the highlights of this release:

• Gateway adds new REST endpoints to easily get the list of targets against which to execute commands. This makes it easier to query the Gateway and generate valid targets so that scripts and external applications can execute Gateway commands.
• Gateway load statistics help monitor Gateway performance include statistics that record time spent on running code related to REST service. This monitors the impact of external scripts and applications executing Gateway commands through the REST interface.
• Gateway setup validation now allows you to:
  • Validate running Gateways through REST service so that automated checks can be run to make sure best practices and standards are applied consistently.
  • Generate structured output to JSON format that makes it easier to consume by another processes or applications.
• Gateway supports configuration settings for Dynamic Gateway connections to improve hostname resolutions.
• Netprobe and Active Console are now supported on Windows Server 2016 operating system.
• Improved error messages for Perfmon plugin.

New features and fixed issues

These are the new features and issues we have fixed in this release:

Geneos 4.0.0

Released: 20 February, 2017

Last updated: 24 March, 2017

Geneos 4.0.0 succeeds 3.8.0 as the latest version of ITRS application performance monitoring tool. It is the next step in the Geneos evolution, introducing new capabilities that co-exist with existing Geneos deployments and giving ITRS customers the flexibility to adapt and evolve at their own pace.

The first release, 4.0.0, focuses on laying the technical foundations to support those new capabilities and features coming up over the next few releases.

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

Highlights

These are the highlights of this release:

• Provides an upgrade path to new components and capabilities without breaking existing Geneos 3.x.x deployments.

• Seamless upgrade from Geneos 3.x.x and all core Geneos components such as Active Console, Netprobe plugins, Gateway, Netprobe, and Web Dashboard.

  • All existing Gateway configurations, rules, API plug-in integrations, toolkits, dashboards, and any custom integrations will continue to work with Geneos 4.x.x release.

• Updated compatibility with operating systems, libraries and the underlying build infrastructure to support continued maintenance.

• Applications that consume Gateway Published data can now request Gateways to resend directory data information such as probe, managed entity, and attributes. This helps consuming applications to catch up on information about the Gateway directory hierarchy to process consumed messages.

• Applications that consume Gateway Published data can now request snapshots of a set of dataviews.

• Gateway Publishing stats utility to understand the amount of data that the Gateway publishes which helps to define resource requirements for the consuming applications.

• Gateway REST service for Commands now supports ability to get list of all available commands on a specific target for the user whose credentials are used to make the request.

• New Active Console default workspace with useful list views (Geneos health, assigned to me, snoozed) and a home dashboard to help you get started are now available.

• Unicode support for Active Dashboard objects.

• New modifiers for Active Dashboard to link cell value to colour, or to control image, and text transparency.

• User-defined application name for database connections so database access from Geneos can be easily identified.

• Support connection authentication for MQ plug-ins to establish a more secure connection to IBM MQ.

• Support for the following platforms:

  • 64-bit Web Dashboard on Solaris x86 and Sparc.
  • Digitally signed Windows binaries.
  • SAP/Sybase ASE 16.1 and 16.2.
  • MSSQL Server 2016.
  • Postgres 9.5 and 9.6.
  • Mozilla Firefox ESR 45.x and 49.x.
  • MS Edge 38.
  • Tibco EMS 8.3.
  • IBM MQ 8,0 and 9.0.
  • IBM i 7.2 and 7.3. The following changes are introduced to Geneos packages in 4.0.0:

• Name of the package file is geneos-<component>-<version>.<platform>.<tar.gz/zip>.

  • For example, geneos-netprobe-4.0.0.solaris-x64.tar.gz.

• Packages contains a root directory .

• Libraries are located within a sub-directory named lib or lib64:

New features and fixed issues

These are the new features and issues we have fixed in this release:

Other Geneos releases

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