Geneos 4.x Release Notes

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Web Dashboard is not compatible with SSO Agent in the Gateway Hub.

Please use standalone SSO Agent available to download from ITRS Downloads.

Planned fix version: Geneos 5.1 (Q1 2020)

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Web Dashboard is not compatible with SSO Agent in the Gateway Hub.

Planned fix version: Geneos 5.1 (Q1 2020)

SSO-enabled Web Dashboard and Webslinger do not currently work with SSO Agent in the Gateway Hub. It works when connecting to a standalone SSO Agent or when SSO is disabled.

This involves a fix for SSO Agent in the Gateway Hub.

Known issue since: Geneos 4.13.0

Fixed in version Geneos 5.0.0 (December 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

If a Kerberos principal is not supplied, then Gateways can obtain data from Gateway Hub instances that are configured for anonymous access. This affects the following features:

• Centralised configuration provided by Gateway Hub.
• Obtaining Time series from Gateway Hub.

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Web Dashboard is not compatible with SSO Agent in the Gateway Hub.

Planned fix version: Geneos 5.1 (Q1 2020)

SSO-enabled Web Dashboard and Webslinger do not currently work with SSO Agent in the Gateway Hub. It works when connecting to a standalone SSO Agent or when SSO is disabled.

This involves a fix for SSO Agent in the Gateway Hub.

Known issue since: Geneos 4.13.0

Fixed in version Geneos 5.0.0 (December 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

Netprobe no longer restarts when:

• The REST API or REST Extractor sampler is inserted or updated.
• The JMX Server or JMX Thread Info sampler is inserted or updated, except if the new configuration results in a new iproperties option.
• The Rest api http port and Rest api https port in the probe setting is updated. 

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Web Dashboard is not compatible with SSO Agent in the Gateway Hub.

Planned fix version: Geneos 5.1 (Q1 2020)

SSO-enabled Web Dashboard and Webslinger do not currently work with SSO Agent in the Gateway Hub. It works when connecting to a standalone SSO Agent or when SSO is disabled.

This involves a fix for SSO Agent in the Gateway Hub.

Known issue since: Geneos 4.13.0

Fixed in version Geneos 5.0.0 (December 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

In this release, the REST Extractor plug-in introduces these features:

• Can recover from an unreachable URL on the first sample.
• Now supports non-JSON responses in its bearer authentication methods. This means that you can accommodate a token in the response, instead of specifying a field to contain the token.

In this release, the REST API plug-in introduces these features:

• HTTP and HTTPS port configuration for the REST API plug-in is now available for floating and Self-announcing Netprobes.

• The REST API plug-in now has a health check endpoint to check the availability of the sampler.

These options are now updating in the Active Console on macOS and Ubuntu:

• Pause Updates in the Event Tickers dockable. 
• Auto clear in the Commands dockable.
• Running in the Debug > Active Path Model menu.

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Any Gateway items (Scheduled Commands, Active Times, and Snooze periods) scheduled for more than 68 years into the future are known to cause issues with Gateway's ability to process any commands of type Task, to exit from a configured startup delay in applying rules or to process Scheduled Commands or Active Times. This is particularly noticeable in 64 bit Gateways.

Known issue since: GA3.x.x

Fix in version: GA4.13.1 (by end of Oct 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

A sslCertificateDaysRemaining column was added to the probeData Gateway plug-in.

The column displays the number of days remaining before the certificate expires.

• 0.0 is displayed if the certificate is not yet valid (start date is in the future) or if there was an issue obtaining the expiry date from the certificate.
• No value is displayed for virtual or insecure probes.
• Negative value is displayed if the certificate has already expired.

Gateway keeps processing while it waits for validation responses to be returned from Gateway Hub.

Gateway queues setup validation/change requests so that it can keep processing other data while waiting for Gateway Hub without having the setup changes clash.

When the Gateway is connected to Gateway Hub version 1.4.0, then the messages previously published to the geneos-enriched topic are now published to a new geneos-metrics-v1 topic and the messages previously published to the geneos-raw topic are no longer published.

This greatly improves the efficiency of sending Geneos metrics data to Gateway Hub.

When the Gateway is connected to Gateway Hub version 1.3.x or earlier, then there is no change to the way messages are published to the geneos-raw and geneos-enriched topics.

Gateway Hub locations set on the command line can now be used to:

• Get setup from Gateway Hub. 
• Get data in the Active Console for charting published data.

The timezone file was updated based on IANA 2019b release:

• Brazil no longer observes DST.
• Palestine's spring-forward transition has changed to the last Friday of March at 00:00.

The REST API plug-in enables a sampler to listen to inbound messages on an HTTP or HTTPS connection.

In addition, the following are the other features that the REST API plug-in is capable of in this release:

• Supports an update row endpoint.
• Supports a file stream endpoint.
• Outputs messages as streams, which can be monitored by the FKM plug-in.
• Supports HTTPS on its listening port. This is configured on the probe.
• Returns informative HTTP response codes.
• You can specify the capacity of a stream on the REST API plug-in.
• REST API plug-in endpoints require you to specify the managed entity and sampler. This allows multiple samplers to utilise the same listening ports.
• Supports a delete dataview endpoint.
• Supports a delete row endpoint.
• REST API plug-in group name defaults to the sampler name.
• REST API has been added to the licence daemon.

The Netprobe can now locate JAR files in a new /jars directory within the Netprobe directory, without the need to set GENEOS_JARS.

The Netprobe can now locate the launchpad library file without the need to set GENEOS_LIBS.

The Netprobe can now locate the JVM library without the need to set PATH, LD_LIBRARY_PATH or LIB_PATH, provided the usual Java installation directory structure.

The following components in Geneos is now packaged and built with OpenJDK 8:

• Active Console for Windows
• Web Dashboard
• Active Console for macOS 10.14 Mojave
• Active Console for Ubuntu

Active Console now displays the Gateway Hub visual indicator on the Gateway icon in the following circumstances:

• Gateway is configured to publish to Gateway Hub.
• Gateway obtains its configuration from Gateway Hub.

Context-Sensitive Help updates:

• Active Times to link to the correct sections in the online Geneos documentation.
• Links to the correct section of the online help for table elements that have no XML.

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Any Gateway items (Scheduled Commands, Active Times, and Snooze periods) scheduled for more than 68 years into the future are known to cause issues with Gateway's ability to process any commands of type Task, to exit from a configured startup delay in applying rules or to process Scheduled Commands or Active Times. This is particularly noticeable in 64 bit Gateways.

Known issue since: GA3.x.x

Fix in version: GA4.13.1 (by end of Oct 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Gateway is unable to decrypt encoded passwords in the configuration when using the AES-256 key to start the Gateway. The Gateway log reports this error:

ERROR: encryption decryption error: 0 - error:06065064:digital envelope routines:EVP_DecryptFinal_ex:bad decrypt

As a workaround, execute a kill -USR1 command in the Gateway start script after the Gateway has started, so the Gateway can reread the setup with the correct AES key.

Known issue since: Geneos 4.9.3

Planned fix version: Geneos 4.12.0 (end of July 2019)

Any Gateway items (Scheduled Commands, Active Times, and Snooze periods) scheduled for more than 68 years into the future are known to cause issues with Gateway's ability to process any commands of type Task, to exit from a configured startup delay in applying rules or to process Scheduled Commands or Active Times. This is particularly noticeable in 64 bit Gateways.

Known issue since: GA3.x.x

Planned fix version: GA4.13.1 (by end of Oct 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

The following security headers have been added to the License Daemon web responses:

• X-Frame-Options
• X-XSS-Protection
• X-Content-Type-Options

The following plug-ins are now deprecated: FIX, EUEM, Citrix Apps, Citrix Processes, Citrix Summary, and Citrix Sessions.

You can now use the RabbitMQ monitoring integration template to monitor RabbitMQ. RabbitMQ is an open source message broker that supports multiple messaging protocols.

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Gateway is unable to decrypt encoded passwords in the configuration when using the AES-256 key to start the Gateway. The Gateway log reports this error:

ERROR: encryption decryption error: 0 - error:06065064:digital envelope routines:EVP_DecryptFinal_ex:bad decrypt

As a workaround, execute a kill -USR1 command in the Gateway start script after the Gateway has started, so the Gateway can reread the setup with the correct AES key.

Known issue since: Geneos 4.9.3

Planned fix version: Geneos 4.12.0 (end of July 2019)

Any Gateway items (Scheduled Commands, Active Times, and Snooze periods) scheduled for more than 68 years into the future are known to cause issues with Gateway's ability to process any commands of type Task, to exit from a configured startup delay in applying rules or to process Scheduled Commands or Active Times. This is particularly noticeable in 64 bit Gateways.

Known issue since: GA3.x.x

Planned fix version: GA4.13.1 (by end of Oct 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

Updated the schemas for the following plug-ins:

• SET-SLC
• WTS-PROCESSES
• WTS-SESSIONS

Imported commands of certain types (internal detail) are only published if a dataview exists to which the command could be applied. Commands may appear and disappear with dynamic dataviews.

If an imported command is removed it is now also unpublished on the importing Gateway.

A Gateway does not support lock requests if its setup is stored in the Gateway Hub.

Gateway Hub is responsible for the locking of any resources it manages.

Gateway can now read command line arguments from a file. The default file is gateway2.gci in the working directory of the Gateway. The location can be overridden using the -config-file command line option.

Command line options in the file are processed before any on the command line, except for -config-file which is always processed first.

Self-announcing Netprobes now support multiple managed entities. The managed entities can be defined in the Netprobe configuration. Newer Gateways support this feature and will accept a Netprobe with multiple managed entities.

Older Gateways, however, do not support this and will be rejected by the Netprobe.

The following Netprobe commands now return fewer XPaths:

• /PLUGIN:FKM:triggerDetails

• /PLUGIN:FKM:viewTriggerWithSize

The REST Extractor plug-in is now available for reading data from REST interfaces:

• The plug-in communicates via HTTP or HTTPS GET request and expects a JSON response. It also supports jq queries to transform the JSON response into a desired dataview format.
• The plug-in supports basic authentication, as well as bearer authentication using an HTTP GET request.

Synthetic Monitoring integration template now has two default samplers:

• Apica-AllChecks
• Apica-Severity

Single sign-on is now available for the stand-alone Gateway Setup Editor:

• When launched stand-alone, the SSO button will be available if -SSOAgentURL is specified on the command line or via GCI file.
• When launched from the Active Console as an external process, the -connect parameter has been extended to include the SSO agent URL. This will connect automatically and enable the SSO button.
• When launched in process from the Active Console, no SSO button is required.

The Object Inspector was a pilot feature released for Geneos 4.10.0 which displays some modifiers and links properties of dashboard objects. In Geneos 4.11.0, the Object Inspector now displays the Object Inspector name in the workspace and contains the remaining properties that you can modify in the object properties dialog:

• Selects multiple objects.
• Loads the properties of the selected grouped objects.
• Supports the style and properties of Active Chart, Picture, Line Arrow, and Active Volume Bar objects.
• Selects the dataset type for Active Chart, Bar Chart, Spark Chart, and Historical Chart.
• Pie Charts can now be displayed in the Object Inspector. The style and properties settings of a Pie Chart can be modified, the dataset settings are read-only.
• Supports the style, properties, and dataset of Active Gauge object.
• Supports the dataset of Active Gauge, pie chart's datasets and its slice properties.

E4JMS — Non-durables plug-in is not displaying data starting Tibco EMS version 8.0 and newer.

Known issue since: Tibco EMS version 8.0 +

Planned fix version: Geneos 5.2 (Q2 2020)

Gateway is unable to decrypt encoded passwords in the configuration when using the AES-256 key to start the Gateway. The Gateway log reports this error:

ERROR: encryption decryption error: 0 - error:06065064:digital envelope routines:EVP_DecryptFinal_ex:bad decrypt

As a workaround, execute a kill -USR1 command in the Gateway start script after the Gateway has started, so the Gateway can reread the setup with the correct AES key.

Known issue since: Geneos 4.9.3

Planned fix version: Geneos 4.12.0 (end of July 2019)

Any Gateway items (Scheduled Commands, Active Times, and Snooze periods) scheduled for more than 68 years into the future are known to cause issues with Gateway's ability to process any commands of type Task, to exit from a configured startup delay in applying rules or to process Scheduled Commands or Active Times. This is particularly noticeable in 64 bit Gateways.

Known issue since: GA3.x.x

Planned fix version: GA4.13.1 (by end of Oct 2019)

Gateway may become unresponsive when processing Self-Announcing Netprobe connections if multi-threaded rule evaluation (operatingEnvironment > numRuleEvaluationThreads is more than 0) is enabled.

A temporary workaround is to turn off multi-threaded rule evaluation in the XML before starting the Gateway.

Known issue since: GA4.11.1

Fixed in Geneos 4.13.2 and Geneos 5.0 (December 2019)

Tooltip is not displayed when hovering over Managed Entity in the Managed Entities dockable. Managed Entities in State Tree dockable are able to display tooltips.

Known issue since: Geneos 4.10.0

Fixed in version: Geneos 4.10.1

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Known issue since: N/A

Fixed in version: Geneos 4.10.0

When a Command is given the same label as a containing Command Group, the Gateway may crash while saving the configuration.

Fixed in version: Geneos 4.10.0

Running Geneos 4.9.x Netprobe with command line argument -listenip none leads to excessive CPU usage.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.10.0

Referencing stringList variables in Actions may cause Gateway to crash.

Known issue since: Geneos 4.6.0

The status remains Pending even if there are heartbeat messages after login and logoff.

Known issue since: Geneos 4.1.0 (possibly earlier versions too)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the netsnmp library that is not compatible with MIB-MONs usage of the same libraries.

Known Issue Since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error in Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Fixed in version: Geneos 4.10.0

The 64-bit Windows Netprobe does not correctly install and run in Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Fixed in version: Geneos 4.10.0

Receives multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON. As this is intermittent, the exact solution is yet to be identified and this requires further analysis. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then consider remaining on a 32-bit release for the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Fixed in version: Geneos 4.10.0

Addresses two memory leaks in Gateway.

The main one occurs when rules queried Attributes from data items. While, the second one occurs when action output is processed.

Tooltip is not displayed when hovering over Managed Entity in the Managed Entities dockable. Managed Entities in State Tree dockable are able to display tooltips.

Known issue since: Geneos 4.10.0

Fixed in version: Geneos 4.10.1

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Known issue since: N/A

Fixed in version: Geneos 4.10.0

When a Command is given the same label as a containing Command Group, the Gateway may crash while saving the configuration.

Fixed in version: Geneos 4.10.0

Running Geneos 4.9.x Netprobe with command line argument -listenip none leads to excessive CPU usage.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.10.0

Referencing stringList variables in Actions may cause Gateway to crash.

Known issue since: Geneos 4.6.0

The status remains Pending even if there are heartbeat messages after login and logoff.

Known issue since: Geneos 4.1.0 (possibly earlier versions too)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the netsnmp library that is not compatible with MIB-MONs usage of the same libraries.

Known Issue Since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error in Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Fixed in version: Geneos 4.10.0

The 64-bit Windows Netprobe does not correctly install and run in Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Fixed in version: Geneos 4.10.0

Receives multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON. As this is intermittent, the exact solution is yet to be identified and this requires further analysis. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then consider remaining on a 32-bit release for the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Fixed in version: Geneos 4.10.0

Active times on specific days of the month.

Allows you to schedule active times on days in the form:

first | second | third | fourth | last day of named months | every month or a one off for a given year.

Gateway-Severity Data plug-in allows filtering on severity.

Adds a new filter option to filter on severity. Options are filtered:

• With no filter enabled, every severity above and including warning level is listed in the severity dataview.
• When a severity filter is applied, warning or critical severities can be selected to be included in the dataview.

The filterIn headline variable reflects the setting of this filter. For example, warning=true,critical=false tells you that only warning messages are listed in the view.

Also, the warning and critical counts only reflect what is in the view and not the state of the system as a whole.

SAN snooze and user assignment stored with the probe and transferred to Gateway on startup.

When a SAN probe connects to and receives setup, it sends messages to the connecting Gateway with the snooze and user assignment records that belong to the probe. These records are the definitive source of what is snoozed on the probe and the connecting Gateway removes all snooze and user assignment records it has belonging to that probe.

Then, it also add the snooze and user assignment records it receives. Where the item is snoozed on another Gateway, the XPath for the item changes as the new Gateway takes ownership. Newly user assigned and snoozed items get their records sync to the probe which store them on its working directory.

When items are copied within the Gateway Setup Editor navigation tree, any passwords (for example, within Sampler or Type definitions) are stripped out of the copied item. Usually, this results in validation errors until each password is re-entered, or the password setting is removed from the copied item.

Passwords are not stripped when an item is moved by dragging and dropping or cutting and pasting.

A new section is added to the ShowRules command where path aliases are used within the rule. This section shows the name, first matching value returned by the path alias, and the number matches returned by the path.

Hovering over the name reveals the path as a hint, as it does currently within the rule.

Allows you to require input on the following command arguments:

• Single line strings
• Multi line strings
• Options

Enables Kerberos authentication for remote include files on Linux through two new Gateway command line options:

-kerberos-principal <principal> — a unique identity to which Kerberos can assign tickets. For example, user@REALM or user/admin@REAL. 

-kerberos-keytab <path> — path to the keytab file. This is compulsory if the principal is specified.

For remote include files, both Kerberos GSS Negotiation and Basic authentication are supported. However, each can be turned off to speed up the other.

Updates the timezone settings for the following:

• Antarctica/Casey — changes the offset from UTC.
• Asia/Gaza — new DST rules.
• Asia/Hebron — new DST rules.
• Asia/Jerusalem — new DST rules.
• Asia/Pyongyang — changes the offset from UTC.

GW-Severity Data Plug-in: Filter by severity

Introduces the new includeSeverityLevel setting. This setting works with the existing includeXXX settings to configure a state filter. This can be one of the following:

• warning
• critical
• warningAndCritical

warningAndCritical is the default value.

These settings are reflected in a new headline variable stateFilter that starts with the severity levels configured with optional states. For example:

• stateFilter : Warning AND Critical WITH User Assigned — tells you that the cells in the dataview contain warning or critical severity and include user assigned items.

The following environment variables are added to the validation hook. All of which will exist but be blank if validation is not initiated by a user.

Environment variable content:

• _USER — validates and save the setup.
• _HOST — host machine name or IP address of the user.
• _ROLES — Groups and roles that the user belongs to.
• _USER_AUTHENTICATION_TYPE — type of authentication used to log into Geneos.

User authentication type:

• GeneosAuthenticated — requires a username and password during Geneos authentication.
• SSO — you are logged in through single sign on.
• Generic — you are logged into Geneos using the generic user definition and permissions.

Simplifies the use of comments within Gateway Setup Editor:

• Simplified comments can be enabled/disabled by setting the simplifiedComments GCI flag to enabled or disabled. 
• Comments can be added, edited, removed only on components present on the navigation panel.
• XML comments can be added to any node by switching to XML mode.
• Comments added on components in the navigation panel are displayed at the top of the corresponding settings panel.
• If comments exist in XML and are not visible, a message displays below the comment dialog to indicate their presence (for example, "37 additional comment(s) in XML."). You can switch to XML mode to view them.
• Removes all icons that indicate comments.
• Comments in rule blocks are not affected by this change. 
• By default, it disables simplified comments.

Adds ability to list the users presented in Active Console User Assignment drop-down using roleProperties.

This applies to users defined in the Gateway setup files and users obtained through SSO.

Adds a new command /GATEWAY:rebalanceSANs that is available on Gateway.

This removes zero or more Self-announcing Netprobes from the Gateway until the number of probes or the total Gateway score drops at or as close to the specified target value. It can be used to rebalance Self-announcing Netprobes across a group of configured Gateways.

The Propose Schema command is shown/hidden when enabled/disabled through a setup change without the need to restart Gateway Setup Editor.

Boolean entries in drop-down lists are correctly displayed with their intended default values.

New Control-M plug-in based on Control-M REST API available from version 9.0.18.

This supports filters for jobs and columns, as well as configurable set of columns for each dataview.

On the Gateway Setup EditorFile menu, the Save All As and Save a Copy As options are replaced with a single Export item. This exports a copy of all loaded and editable setup files to a new location on disk while maintaining the editing connection to the Gateway.

When you do not have a permission to save any of the files concerned, the Save and Export options are disabled on Gateway Setup Editor.

Removes SSO from the logon method drop-down when Gateway Setup Editor is running as a standalone process.

When Gateway Setup Editor opens as a separate process from Active Console with logon method set to SSO, then an error message displays and the Gateway Setup Editor fails to start.

Improves the messages that the Geneos components log when errors occur on connections to other processes:

• Internal Geneos error numbers (in the range -800 to -891) are no longer included in log messages.
• If available, it displays the peer host and port instead of the text "None" or "pConnector is Non NULL".
• Correctly format the messages that are written directly to the processes standard output as Geneos log messages.

Affects how the GSE displays regex flag settings.

Currently, these are a collection of booleans that the GSE displays as a drop-down list with OK and Cancel buttons. This does not work well within tables. The schema change tweaks the type, while keeping the boolean properties, such that the GSE opens a dialog for the settings within a table.

When the Gateway Setup Editor is launched from the Active Console as a standalone process, it can connect to secure and insecure Gatewaysthrough the following logon methods:

• Always ask
• Ask once
• Use system

SSO logon is not supported when the Gateway Setup Editor opens as a standalone process.

Right-click to copy XML and press Ctrl + Shift + C copy the XML to the clipboard in exactly the same format.

Copying XML by pressing Ctrl + Shift + C also sanitises any passwords present in the XML.

Tooltip is not displayed when hovering over Managed Entity in the Managed Entities dockable. Managed Entities in State Tree dockable are able to display tooltips.

Known issue since: Geneos 4.10.0

Fixed in version: Geneos 4.10.1

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Known issue since: N/A

Fixed in version: Geneos 4.10.0

When a Command is given the same label as a containing Command Group, the Gateway may crash while saving the configuration.

Fixed in version: Geneos 4.10.0

Running 4.9.x Netprobe with command line argument -listenip none leads to excessive CPU usage.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.10.0

Referencing stringList variables in Actions may cause Gateway to crash.

Known issue since: Geneos 4.6.0

The status remains Pending even if there are heartbeat messages after login and logoff.

Known issue since: Geneos 4.1.0 (possibly earlier versions too)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the netsnmp library that is not compatible with MIB-MONs usage of the same libraries.

Known Issue Since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error in Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Fixed in version: Geneos 4.10.0

The 64-bit Windows Netprobe does not correctly install and run in Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Fixed in version: Geneos 4.10.0

Receives multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON. As this is intermittent, the exact solution is yet to be identified and this requires further analysis. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then consider remaining on a 32-bit release for the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Fixed in version: Geneos 4.10.0

SSO Agent is enhanced to include a group filter setting that reduces the number of groups returned by AD.

This is a useful feature to have where users belong to many groups, but only a known subset are needed for Geneos authorisation. For example:

"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]"
},

Allows CORS from defined origins for specific URL methods.

This feature can be enabled by setting server.cors.* values in the SSO Agent configuration file.

Adds optional endpoint /groups/users to SSO Agent.

This is used by SSO enabled Gateways to obtain the list of users that the Active Console/Active Dashboard presents as assignable users when running the User Assignment commands.

Adds the ldap.query_filter to work in conjunction with ldap.user_class.

The ldap.query_filter allows the user to make their ldap search more specific using fields like objectcategory.

See the example below searches only for people in the user category. If set, this overrides the user_class settings which is used to set "objectclass" in the search query. If both are not in the setup, then user_class defaults to "user".

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

Adds a new public endpoint to SSO Agent (/public_key) that provides the agent's public key in PEM format.

It is disabled by default and can be enabled through the enable_public_key_endpoint configuration option.

Unable to save Active Console workspace after upgrading from 4.x to 4.9.0.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.9.1

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error on Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

We have received multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON.

The issue is likely caused by net-snmp third-party library. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then please consider remaining on a 32-bit release at the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the net-snmp library that is not compatible with MIB-MONs usage of the same libraries.

Known issue since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The status remains Pending even if there are heartbeat messages after login and logoff.

Fixed in version: Geneos 4.9.2

The 64-bit Windows Netprobe does not correctly install and run on Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Planned fix version: Geneos 4.10.0 (end of January 2019)

When a Command is given the same label as a containing Command Group, then Gateway may (very likely) crash on saving the configuration.

Planned fix version: Geneos 4.10.0 (end of January 2019)

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Planned fix version: Geneos 4.10.0 (end of January 2019)

Unable to save Active Console workspace after upgrading from 4.x to 4.9.0.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.9.1

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error on Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

We have received multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON.

The issue is likely caused by net-snmp third-party library. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then please consider remaining on a 32-bit release at the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the net-snmp library that is not compatible with MIB-MONs usage of the same libraries.

Known issue since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The status remains Pending even if there are heartbeat messages after login and logoff.

Fixed in version: Geneos 4.9.2

The 64-bit Windows Netprobe does not correctly install and run on Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Planned fix version: Geneos 4.10.0 (end of January 2019)

When a Command is given the same label as a containing Command Group, then Gateway may (very likely) crash on saving the configuration.

Planned fix version: Geneos 4.10.0 (end of January 2019)

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Planned fix version: Geneos 4.10.0 (end of January 2019)

Unable to save Active Console workspace after upgrading from 4.x to 4.9.0.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.9.1

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobeoverrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error on Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

We have received multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON.

The issue is likely caused by net-snmp third-party library. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then please consider remaining on a 32-bit release at the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the net-snmp library that is not compatible with MIB-MONs usage of the same libraries.

Known issue since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The status remains Pending even if there are heartbeat messages after login and logoff.

Fixed in version: Geneos 4.9.2

The 64-bit Windows Netprobe does not correctly install and run on Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Planned fix version: Geneos 4.10.0 (end of January 2019)

When a Command is given the same label as a containing Command Group, then Gateway may (very likely) crash on saving the configuration.

Planned fix version: Geneos 4.10.0 (end of January 2019)

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Planned fix version: Geneos 4.10.0 (end of January 2019)

Reverses DNS Timeout.

When reverse DNS lookups take too long, these are suspended for a configurable length of time.

When Gateway starts and when it applies setup changes, it rereads the snooze and user assignment files.

When an expiry time specified for snoozed or assigned items has been reached or an "until changed" value has changed, the item is unsnoozed or unassigned.

This type of event is now recorded (if database logging is enabled) or published (if publishing is enabled or the Gateway Hub connection is configured.)

Allows connection to Kafka using SASL Plaintext authentication.

This can be done over plain sockets or over SSL .

The error "Sampler '*XXX*' contains no schema definition. This must only be output when a sampler is reachable.

A sampler is considered reachable if:

• It is directly referenced by an enabled managed entity and that managed entity references a valid probe.
• It is indirectly referenced by an enabled managed entity through a type and that managed entity references a valid probe.
• The sampler is referenced by a type and self announcing probes are enabled. This means that the sampler is potentially reachable.

Sets minimum component versions that are allowed to connect to Gateway.

Restricts components that can connect to a Gateway by age. It possible to configure components and a minimum allowable version. Connections from a matching component of earlier version are rejected.

Gateway Setup Editor now provides the Paste Schema option to create sampler schemas as static variables.

If the clipboard contains schema definitions for one or more dataviews (for example, the output of the Propose Schema command), the Paste Schema option is available on the context menu for Static Variables > Sampler-schemas and for any groups contained within it.

TLS connections supported up to TLS 1.2. A minimum supported TLS version can be specified on the command line using -minTLSvsion number. Where, this number can be one of 1, 1.0, 1.1 and 1.2.

Netprobe, Gateway, Webslinger, licd have the new command line argument.

Gateway Recorder can set a minimum version through the MIN_TLS_VERSION environment variable.

Active Console negotiates the best possible version on connection. However, if you use an older active console and specify -minTLSversion 1.2 for example, it fails to connect.

Failed attempts to connect securely result in the error message, as the unsupported protocols are effectively removed:

ERROR: SSLConnector:accept SSL Error:[140760fc] SSL23_GET_CLIENT_HELLO:unknown protocol

Adds support for exceptions to standardised formatting.

If the exception text is found as the value of a published cell, then no formatting is applied and no error is logged:

• For the existing publishing format, the data is published unchanged.
• For publishing to Gateway Hub, the exception is published as "N/A" to enable Gateway Hub to recognise and process.

The /USERASSIGNMENT::assignUntilDateTime command now accepts an optional timezone as part of its Time argument.

If no timezone is specified, the Gateway time zone is used.

Adds the Show Current Schema command.

This can be run from either a sampler or a dataview and returns a list of all schemas configured for this sampler.

Allows ProposeSchema to process dataviews with & in column and headline names.

Allows ProposeSchema to process dataviews with & in row names when pivot dataview is in effect.

The Gateway Hub publishing schema for the WTS Sessions plug-in has been amended to include all the optional columns based on performance counters.

Two columns which are displayed only for Citrix servers have also been included.

The Propose Schema command is now able to handle the rowname column of the CPU sampler on Windows.

Improves error messages returned by the Propose Schema command when the rowname column of the dataview and its schema are inconsistent.

If a plug-in publishes a dataview with a varying number of rows and the dataview is pivoted, Gateway now logs an error message and stops attempting to publish the view.

Previously, Gateway was repeatedly logging an information message to indicate that it was ignoring an update.

User input has been made more convenient for commands with a "time in seconds" input argument.

When an argument of this type is configured, if the initial value is specified as "0" (that is, the Unix epoch, or 1970-01-01 00:00 UTC), then the default shown to the user is the current time when the command is invoked.

A calendar control can be used, as previously, to adjust this if required. This saves the user having to click to view the calendar control, then press the Now button and then click again to adjust the time.

When the Gateway Setup Editor is used to set the initial value for a "time in seconds" argument, it defaults to 1970-01-01 00:00 UTC and can be reset to this value by clicking the None button that appears in the calendar control.

Gateway Setup Editor now processes changes as you type for most text settings that appear within tables.

Improves the behaviour of the Save icon and the coloured dots that indicate if a setting is valid in its context.

When the pie has only once slice, it sets its degree coverage to 360.

Sometimes, when slices are removed, the computation for the remaining slice is off by a fraction and does not cover the full 360 degrees.

The user can convert a line chart into a target marker line chart.

The chart updates upon converting the data set into a target marker .

CVE-2016-1000031.

Upgraded the following libraries:

• ActiveMQ library from 5.14.1 to 5.15.6
• Commons-fileupload library from 1.3.2 to 1.3.3
• Xalan library from 2.7.1 to 2.7.2,
• xercesImpl.jar to xercesImpl-2.11.0.SP1.jar
• Included xml-apis.jar in geneos-web-server build.xml

Unable to save Active Console workspace after upgrading from 4.x to 4.9.0.

Known issue since: Geneos 4.9.0

Fixed in version: Geneos 4.9.1

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text.

For exampple, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _. This appears to have been introduced as part of the fixes around case insensitive matching.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

The new file matching code introduced to FKM in Geneos 4.3.0 returns a permission error on Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_ function needs to traverse the file path starting from the top or parent directory and continues to traverse through succeeding directories until it reaches the last/target directory level. Any permission issue that is encountered while traversing these directories breaks the traversal.

Known issue since: Geneos 4.3.0

Planned fix version: Geneos 4.10.0 (end of January 2019)

We have received multiple reports of the 64-bit Windows Netprobe that crashes intermittently with MIB-MON.

The issue is likely caused by net-snmp third-party library. If you require MIB-MON on Windows (and you cannot, for example, deploy a Linux Netprobe), then please consider remaining on a 32-bit release at the moment.

Known issue since: Geneos 4.0.0 (initial release of 64-bit Windows Netprobe)

Fixed in version: Geneos 4.9.2

MIB-MON does not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the net-snmp library that is not compatible with MIB-MONs usage of the same libraries.

Known issue since: Geneos 4.1.0

Fixed in version: Geneos 4.9.2

The status remains Pending even if there are heartbeat messages after login and logoff.

Fixed in version: Geneos 4.9.2

The 64-bit Windows Netprobe does not correctly install and run on Windows Server 2008 (Build 6001). The _K32GetModuleFileNameExA_ error message appears. As the investigations continue, the only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

Planned fix version: Geneos 4.10.0 (end of January 2019)

When a Command is given the same label as a containing Command Group, then Gateway may (very likely) crash on saving the configuration.

Planned fix version: Geneos 4.10.0 (end of January 2019)

SampleNow command (executed from ME or Sampler) fails to update the sample time displayed in Metric View.

Planned fix version: Geneos 4.10.0 (end of January 2019)

When either the /SNOOZE:unsnoozeAbsentItems or the /USERASSIGNMENT:unassignAbsentItems command is used, Gateway will now log and publish unsnooze or unassign events for the items which are unsnoozed or unassigned, as long as database logging or Gateway publishing is enabled.

Note that the target object of the messages published for these events will not include the filter sub-object: this is because the information required to populate this is not available for items which are no longer present.

Gateway

Updates the log archive script logging in the Gateway. Only one of the following INFO messages is now logged on Gateway startup or after a setup change based on the following conditions:

• Environment variable LOG_ARCHIVE_SCRIPT is not set, and log archive script is not set in the setup/XML. "Log archive script is not set."
• Environment variable LOG_ARCHIVE_SCRIPT is not set, and log archive script set in the setup/XML. "Log archive script set to: '<Log_Archive_Script>'."
• Environment variable is LOG_ARCHIVE_SCRIPT set and log archive script set in the setup/XML. "Log archive script set to: '<Log_Archive_Script>'. Overrides environment variable LOG_ARCHIVE_SCRIPT."
• Environment variable LOG_ARCHIVE_SCRIPT is set, and log archive script is not set in the setup/XML. "Log archive script set to: '<Log_Archive_Script>'. Set in environment variable LOG_ARCHIVE_SCRIPT."

A message is always logged on startup.

A message is logged after a setup change only if the value of the log archive script has changed.

Netprobe

Adds the log archive script logging in the Netprobe. Only one of the following messages is logged once on Netprobe startup:

• Environment variable LOG_ARCHIVE_SCRIPT is not set. "INFO: Log archive script is not set."
• Environment variable LOG_ARCHIVE_SCRIPT is set. "INFO: Log archive script set to: '<Log_Archive_Script>'. Set in environment variable LOG_ARCHIVE_SCRIPT."

A message is always logged on startup.

Detects Kafka queue is full and throttle sending of messages.

When it is detected that the Kafka publishing queue is full. Sending will be throttled. On resuming publishing the number of discarded messages will be reported.

The following attributes are now available in metadata.severity messages:

• 'snoozed': Indicates whether or not the target data item is snoozed.
• 'snoozedParents': Indicates the number of snoozed parent data items.
• 'userAssigned': Indicated whether or not the target data item is assigned to a user.

The Kafka adapter used by the Gateway now reads from all partitions of the "requests" topic. Previously it would assume that the topic would be created with only one partition and only read from partition 0.

If the script supplied with the Gateway (resources/kafka/make-topics.sh) is used to create the Kafka topics used for Gateway Publishing, the topic from which it reads snapshot and similar requests will be created with only one partition. However, if the topics are created dynamically, the number of partitions will depend the configuration of the Kafka broker cluster.

Propose schema for sampler and its dataviews.

Command : /GATEWAYHUB:ProposeSchema

Paths:

• geneos/gateway/directory/probe/managedEntity/sampler/dataview//cell");
• /geneos/gateway/directory/probe/managedEntity/sampler/dataview");
• /geneos/gateway/directory/probe/managedEntity/sampler");

Label: Propose schema

Description: Generate XML to paste into dataview schema definition

For each dataview in the given sampler, generates XML schema definition for headlines and columns not already described in an associated schema. Two column tables will be pivoted with a comment explaining that this is suggested way to do this.

The command will attempt to deduce the types of columns and headlines from the contained in the dataview. Units of measure will have to be supplied by the user post generation

Gateway Publishing supports the snapshot requests for snooze, user assignment and severity data, using a similar syntax to the existing metrics snapshot request. As with metrics snapshots, a snapshot request specifies a number of dataviews for which current data will be published. Data is also be published for the parent items (samplers, managed entities, probes and Gateway) of the specified dataviews.

Note: This comment applies to the parent epic. This story allows Gateway to accept the requests, but does not implement the responses.

New columns for Gateway-ManagedEntityData:

• dataviewCount — number of dataviews on managed entity.

• cellCount — total number of cells in busiest dataview.

New Command "/GATEWAY:MANAGEDENTITYDATA:VIEWBUSIEST" on dataviewCount cell to list dataviews from busiest to least busy.

Adds a new MBean — DashboardMonitor.

This MBean has these attributes:

• DashboardInformation
• DashboardsCount

Shows some Gateway attributes as part of MBeans:

• name
• versionString
• statusInfo
• connectionState
• isConnected
• isConnectedToSecondary
• hostNameAndPort
• primaryHostAndPort
• secondaryHostAndPort

Spring-framework upgraded from 4.3.10 to 4.3.19, spring-security from 4.2.3 to 4.2.8.

The following CVEs are addressed: CVE-2018-1270, CVE-2018-1275, CVE-2018-1199, CVE-2018-1271, CVE-2018-1272.

The use of a wildcard ("*") in a filename in FKM running on a Windows Netprobe overrides other text. For example, _C:\TEMP\*.log_ will also match _C:\TEMP\Reporting.log _ _ This appears to have been introduced as part of the fixes around case insensitive matching.

Know issue since: Geneos 4.3.0

The 64-bit Windows Netprobe will not correctly install and run on Windows Server 2008 (Build 6001). You will see a _K32GetModuleFileNameExA_ error. Investigations continue. The only workaround for this OS version is to continue using the 32-bit Netprobe build.

Known issue since: Geneos 4.0.0 (first 64-bit Windows build)

The new file matching code introduced to FKM in Geneos 4.3.0 will return a permission error on Windows platforms ("NOT_FOUND") if an intermediate directory does not have appropriately open permissions.

This is because the _findMatchingFiles()_Â function needs to traverse the file path starting from the top or parent directory and will continue to traverse through succeeding directories, until it reaches the last/target directory level. Any permission issue that will be encountered while traversing these directories will break the traversal.

Known issue since: Geneos 4.3.0

MIB-MON will not work in the same Netprobe instance as Trapmon. When Trapmon is configured, it sets a flag to the _netsnmp_ library that is not compatible with MIB-MONs usage of the same libraries.

Known Issue Since: Geneos 4.1.0

If WEB_SERVICE_URL contains a port, Webslinger will not append its LISTEN_PORT when constructing the redirect URI to communicate with the SSO Agent.

If WEB_SERVICE_URL does not contain a port, Webslinger will append its LISTEN_PORT when constructing the redirect URI to communicate with the SSO Agent.

Adds the SSL Certificate authentication to Webslinger when connecting to a secure Gateway:

• The following option can be added at the end of the secure Gateway line AUTHENTICATION_METHOD = SSL
• The authentication credentials may only contain a username (example, AUTHENTICATION = itrsUser1).

Spelling mistakes, misplaced punctuation, and capitalization now fixed in the Welcome to Geneos and Active Dashboards dockables. Listed below are the updated sections:

• Welcome to Geneos > Help and Getting Started tab
• Welcome to Geneos > Connecting to a Gateway Tab
• Welcome to Geneos > Setting up the State Tree
• Welcome to Geneos > Running Commands
• Welcome to Geneos > Designing Custom Views
• Welcome to Geneos > Dockable Framework
• Active Dashboard and Palette

Active Console only subscribes to the dataviews that contain snoozed cells when a path like the following is used in an Active Dashboard modifier or a List View:

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

Same with other boolean type data item properties, When set to true its value is equivalent to 1 ( state("snoozed")="1" ) and when set to false its value is equivalent to 0 ( state("snoozed")="0" )

Sets the following boolean defaults in the Gateway schema:

• Command - Args - Concatenate: Set to 'false'
• Active Time - Scheduled period - Override: Set to 'false'
• Active Time - Scheduled period - Invert: Set to 'false'

Command arguments for User Commands are passed verbatim to the target executable on both Gateway and Netprobe. No escaping or any manipulation of the arguments takes place. As a result, command arguments are treated in the same way regardless of the run location (Netprobe or Gateway):

• The first argument needs to be an executable or the path to an executable. It can be constructed via concatenation.
• Redirection, pipes etc will no longer work. To maintain such behaviour, they need to be executed as part of a shell script.
• Any workarounds that were needed to escape characters, add quotes or pass empty arguments or spaces are no longer required. Existing commands that make use of those workarounds would need to be re-examined.

Windows Netprobe is unaffected by this change.

When a command is configured to provide a list of options for user input, if one of the options has a label without a value, this option will be omitted and a validation warning will be provided. (Previously, there would be no warning and the entire command would be omitted.)

The same set of user input options is now available for tasks as for commands, including "XPath options", which provide a dynamic set of options based on values taken from a dataview.

Fixed by:

• AA-4239 — adds New Snooze parameters to XPath.
• AA-4242 — makes Snooze efficient.

SSO Agentcan read passwords from environment variables.

To avoid the need to store passwords as plain text in the SSO Agent configuration file, these can be read from environment variables:

• If the server.key_store.password setting is absent, it will be read from the ITRS_SSO_KEYSTORE_PW environment variable.
• If the server.trust_store.password setting is absent, it will be read from the ITRS_SSO_TRUSTSTORE_PW environment variable.
• If the ldap.password setting is absent, it will be read from the ITRS_SSO_LDAP_PW environment variable.

Any setting present in the configuration file will override the corresponding environment variable.

An external hyper link in the dashboard is corrected, allowing clients to invoke links of the form http.

In addition, these links now work with a single click rather than a double click (Dashboard Properties > 'Allow Objects to be selected' option.

Gateway Setup Editor - Unlock Dialog Timeout

This change makes it possible for informational dialog boxes to timeout and disappear. There are circumstances where waiting for user input can bring the setup editor to halt. This can have consequences where time critical code is depending on a response.

For example, when the setup is locked to a user it's possible for another user with sufficient permission to force an unlock or lock the setup for themselves. When this happens, a dialog box appears to inform the user that they have lost exclusive access. This dialog will stay in place and halt processing until the user clicks "OK".

As of this change, timely response to this dialog is deemed critical and if not responded to in 60 seconds the dialog will disappear.

The timeout defaults to 60 seconds but is configurable via a startup switch which can be reused for other dialogs causing a similar issue. The timeout value must be at least 30 seconds.

AA-4181 Stop storing TreeNodes in Environments

TreeNodes representing the XML of a variable definition were stored directly in environments for convenience. This had the advantage that you never had to worry about the structure of a variable until it was used in some way such as sent to a Netprobe as setup.

This change stores types that represent the structure of the variable data. This also includes a catchall for as yet unknown types in which case we wrap a TreeNode. The internal structure is used in many places and a convenience getAsTreeNode() function is provided for legacy code or where a rewrite would be too extensive.

Notification of snooze and user assignment events will only take place when the item is initially put into that state or an update takes place.

Previously, a snoozed or user assigned item that reappeared to due a Gateway or Netprobe restart would result in a notification for the newly recreated item.

The Gateway time zone file is updated to the 2018 release of the the time zone database maintained by IANA.

• Brazil's DST starts on the first Sunday in November.
• São Tomé and PrÃncipe switched from UTC to UTC +01 (as of 2018-01-01).
• Fiji ended DST on 2018-01-14.

Adds support for the following state predicates in Active Console/Gateway Setup Editor:

• snoozedCount (Snoozed Children): Number of snoozed children. Available on all data item except cells.
• snoozedParentCount (Snoozed Parents): Number of snoozed parents. Available on all data items.
• The new predicates are visible in the Path Editor's properties window for each data item type. 
• The new predicates can be used in Rule blocks as an argument to the 'state' function.

You can select one or more dashboard objects and right-click and select Temporarily Hide Selected. This hides the objects, such that these will not be drawn or rendered, allowing you to get to and modify the objects underneath. Objects can be re-displayed by selecting the 'Unhide all' right click menu option.

The hide status is not persisted, so on a save or reload of the work space the hide status will have been removed.

Open the workspace from url option when loading a workspace is supported for:

• HTTP
• HTTPS
• HTTPS with authentication that requires a username and password.

You can configure the EMF2 port via the activeconsole.gci file: EMF2ListenPort xxxx

When you right-click on a chart if you now navigate down to the Active Chart sub menus the duplicate properties menu has been removed. This was a duplicate wherein there was also a properties menu on the main right click menu.

The exception is when the chart has been detached, where the properties menu will still be available on the sub menu.