Many features in the Gateway, including running the Gateway itself, require a licence to function. These are acquired from the Geneos Licence Daemon to which the Gateway connects.
See Geneos Licence Daemon - Technical Reference for more information about the Licence Daemon.
You can run Geneos in a demo mode, without a license daemon, to trial the software.
To run a Gateway in demo mode, start a Gateway named
Demo Gateway with the
-demo command line option.
Demo mode has the following limitations:
- You can connect a maximum of two Netprobes.
- You cannot change the name of the Gateway.
Note: You may encounter problems when changing the active Netprobes of a demo system. If you connect three Netprobes A, B and C sequentially, the Gateway will not connect to Netprobe C. If you subsequently disconnect Netprobe B, you may need to restart Netprobe C or the Gateway before Netprobe C can connect.
The gateway must initially request a 'gateway' licence to run any functionality. If this request is successful, the gateway starts up and requests licences for other configured components (for example Database Logging). If the initial Gateway licence is denied, the Gateway remains idle.
A licences are requested for Netprobe and Collection Agent plugins.
The connection to the Licence Daemon is dynamic. Therefore, components on the Gateway (including the gateway itself) can move from licenced to unlicenced if the licence is changed on the daemon, making certain features available or unavailable. The gateway retains only the minimum licences required for the current configuration.
Connect to the Licence Daemon
By default, the gateway attempts to connect to
a daemon running on
localhost:7041. The hostname and
port to connect to can be specified using the
-licd-port command line options when
starting the gateway.
If the Licence Daemon has been
configured to run securely, the gateway needs to
be passed the
The gateway can be configured to request licences from a particular group on the daemon using operatingEnvironment > licensingGroup.
A Gateway token is required to start a Gateway.
A server token is required for each machine where a Gateway is running a Netprobe.
A token will be requested for each plugin running on any configured Netprobes. Some plugins are licensed by server, meaning one token allows a Netprobe to run as many instances of that plugin as required. Others are licensed by sampler, meaning each token corresponds one to one with a plugin instance. For more information, contact ITRS.
Collection Agent plugins
A plugin token is required to run Collection Agent plugins. A licence is valid for a maximum count of entities utilising a plugin.
A token will be requested for each Collection Agent plugin of each unique Dynamic Entity.
If the creation of a new Dynamic Entity exceeds the allowed entity count of any plugin utilised by that entity, then no token is provided and the Dynamic Entity is rejected. You can monitor accepted and rejected Dynamic Entities using the Dynamic Entities health plugin. For more information, see Dynamic Entities Health.
Viewing information about licensing
There are two methods for viewing the licence on the daemon and how it is being used.
- Web Page Report.
- This is available by right-clicking on the Gateway icon and selecting Licensing Information.
- Licence usage.
The Gateway data also provides high level licensing information such as expiry date and current connection status to the daemon.
Licence Usage plugin
The Licence usage displays reports about the licence on the daemon and how it is currently in use.
By default, the views show the licences available and currently in use for all licensing groups configured on the gateway. In addition, an overall LicenceUsage view shows connection and licence expiry information.
The plugin can also be configured to request views for specific groups as well as the overall usage of the entire licence.
It is strongly suggested that a gateway is used to monitor licence usage as one would monitor any other application. For a set of useful rules please consult the Licence Daemon Technical Reference Guide.