If you are currently using version 5.x.x, we advise you to upgrade to the latest version before the EOL date. You can find the latest documentation here.
Deprecated Settings
Introduction
This section describes the settings which have been deprecated from the Gateway schema.
Authentication
authentication > groups
The (optional) groups section contains any number of uniquely named user-group definitions.
authentication > users > user > email
Deprecated: Use authentication > users > user > information instead, which allows the inclusion of generic information. Use the value type "Email".
Database Suspend Command
The command Database > Suspend (available on Gateway in the Gateways view in Active Console) where you had to tick/untick the "Suspend database" checkbox to suspend /unsuspend logging of database item values has been deprecated.
You should now use the commands DatabaseLogging > Itemvalues > DiscardandDatabaseLogging > Itemvalues > Log. The old command can still be scheduled through scheduled commands / tasks for backward compatibility.
Database Suspend On Error Setting
This setting has been deprecated and you should now use discardItemValuesOnError setting.
In this setting, you can configure multiple error codes. When any of these error codes are returned from the database, it triggers discarding of database item values and these updates are not be logged to the database (or saved to disk if the database isn't available).
This setting takes a text input and a wildcard search (pattern) is used to match the error against the error string returned from the database.
For example, the database may throw back error like:
[2003] Can't connect to MySQL server on 'ITRSPC000.ldn.itrs' (110)
Any substring of this error message such as
"2003
" or "[2003]
" or "Can't connect to MySQL server on 'ITRSPC000.ldn.itrs'
" will match
this error message.
To start logging of database item values again, you need to issue command DatabaseLogging > Itemvalues > Log.
Please refer Database logging errors for a list of possible error codes returned from different database vendors.
Managed Entities and Managed Entity Groups
Banner variables
Depreciated as of Geneos version 5.0.0
Banner variables allow you to quickly see the value of the most important monitoring metric for a specific managed entity, for example the current CPU load.
Each managed entity can be optionally configured with a single banner variable. The value of this variable is displayed as part of the managed entity icon in Active Console 2, and is updated as the variable changes.
To configure a banner variable, enable the banner setting in the Advanced tab and supply the name of the data-item to display in the banner. This name can be either an absolute name or a relative name which starts from the managed entity being configured.
Scheduled Commands
scheduledCommands > scheduledCommand > recurrence > pattern > hourly
This setting has been deprecated. Please use hours recurrence pattern.
scheduledCommands > scheduledCommand > recurrence > pattern > daily
This setting has been deprecated. Please use days recurrence pattern.
scheduledCommands > scheduledCommand > recurrence > pattern > weekly
This setting has been deprecated. Please use weeks recurrence pattern.
scheduledCommands > scheduledCommand > recurrence > pattern > monthly
This setting has been deprecated. Please use months recurrence pattern.
Self-Announcing Netprobes
Filters
selfAnnouncingProbes > filters
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
Filters are used to control which Self-Announcing Netprobes can connect to the Gateway, based on the managed entity attributes specified in the Netprobe setup. There are three types of conditionals configurable for filters:
- selfAnnouncingProbes > filters > filter > and
- selfAnnouncingProbes > filters > filter > or
- selfAnnouncingProbes > filters > filter > entityAttributeComparison
Filters are checked in the order they are defined in the setup. The first filter that matches the probe determines whether to allow or deny the connection.
If a probe does not match any filters in the list, the catch-all filter action determines whether the probe is allowed to connect or denied.
Caution: The condition defined by a filter must be true for all managed entities defined on a Self-Announcing Netprobe or the probe will be rejected.
selfAnnouncingProbes > catch-allFilter
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
The value of this setting determines whether to allow or deny the connection from a Self-Announcing Netprobe that does not match any of the filters configured in filter .
Setting | Description |
---|---|
ALLOW | Allow the probe connection |
DENY | Deny the probe connection |
selfAnnouncingProbes > filters > filter > name
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
This setting specifies the name of the filter. Several filters can have the same name. There is no requirement at the time being for the name to be unique.
Filter Types
selfAnnouncingProbes > filters > filter > and
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
The and filter combines the results from all sub-filters to form the logical conjunction result.
That is, this filter will only match the probe if all sub-filters match the probe, or if there are no sub-filters.
selfAnnouncingProbes > filters > filter > or
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
The or filter combines the results from all sub-filters to form the logical disjunction result.
That is, this filter match the probe if at least one sub-filter matches the probe, or if there are no sub-filters.
selfAnnouncingProbes > filters > filter > entityAttributeComparison
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
The entity attribute comparison filter allows you to specify an attribute in the Managed Entity (of the self-announce probe) to perform a comparison against.
As a contrived example, you can use this to filter all probes in London by specifying the name setting as "City" and the value setting as "London".
Note: This assumes that there are managed entity attributes called "City" that have been configured correctly.
selfAnnouncingProbes > filters > filter > entityAttributeComparison > name
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
The name of the managed entity attribute which will be compared.
If the attribute does not exist on the entity, the filter will behave as if the attribute has an empty string value.
selfAnnouncingProbes > filters > filter > entityAttributeComparison > comparison
Deprecated. Gateway can accept Self-Announcing Netprobes with multiple managed entities.
Setting | Description |
---|---|
EQUALS | The comparison will pass the probe, if the attribute matches the specified value (case-sensitive comparison). |
NOT_EQUALS | The comparison will pass the probe, if the attribute does not match the specified value (case-sensitive). |