Enterprise Licensing

With enterprise licensing the vovserver checks out license tokens from RLM and distributes the licenses to the vovtaskers, so that the traffic to RLM is substantially reduced. Tasker licensing is typically applicable to Accelerator and FlowTracer only. The distribution of tokens to vovtaskers follows the same rules used with license keys:
  • Direct taskers take the least of the number of cores and the number of slots
  • Indirect taskers need no license
  • If insufficient tokens are available, a tasker may receive a partial number of tokens.

The enterprise licensing is controlled by a variable that can have the following values:

Table 1. Enterprise Licensing Modes
Mode Description
Off The enterprise licensing is turned off. Licensing is therefore supported by either the license key or by the taskers connecting directly to RLM.
Auto The enterprise licensing is active and automatically adjusts up and down to match to the actual demand for license meaning that the more taskers or users are detected by the vovserver, the more tokens are checked out. It may take about one minute to adjust the license up and up to five minutes to adjust it down. On the way up, it is possible for some taskers to be in a transient license violation.
Full The enterprise licensing is active and checks out all available tokens. This is the preferred method for simple installations.
N N is a positive integer. The enterprise licensing is active and checks out precisely N tokens. This is the preferred mode for production farms, for this also enables the system to operate in steady state and to implement the 5-day grace period in case RLM becomes temporarily unavailable.
For a more permanent definition of the enterprise licensing for a product, use the policy.tcl file:
### Example of policy.tcl file
set config(enterpriselicense) "Auto"
# set config(enterpriselicense) "Full"
# set config(enterpriselicense) "Off"
# set config(enterpriselicense) 200; # Some positive integer.
The enterprise licensing mode can be changed at any time, although caution is recommended when doing so. To change the enterprise licensing mode on the fly, use one of the following (complex) command:
> source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
% vovsh -x 'vtk_server_config enterpriselicense Off' 
% vovsh -x 'vtk_server_config enterpriselicense Auto' 
% vovsh -x 'vtk_server_config enterpriselicense Full' 
% vovsh -x 'vtk_server_config enterpriselicense 2000' 
% vovsh -x 'vtk_server_config enterpriselicense 2500' 

The feature that is being checked out depends on the product, as explained in the following table.

Altair Product vovserver feature Enterprise Licensing Feature Recommended Licensing Mode
Monitor-basic server_lms n/a n/a
Monitor server_lm user_licmon n/a
Accelerator server_nc slots_nc N
Allocator server_la n/a n/a
FlowTracer server_ft slots_ft N

To check the current licensing status, visit /cgi/license.cgi.

VTK Interface to Licensing

To debug licensing:

# Activate debugging
> source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
% vovsh -x 'vtk_server_config set_debug_flag licenseKey'

The debugging output goes into the server log file:

### REMEMBER to turn off debugging!
> source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
% vovsh -x 'vtk_server_config reset_debug_flag licenseKey'

To check status of enterprise licensing:

> source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
% vovsh -x 'vtk_generic_get licensepool licenseInfo; parray licenseInfo'

To force a check or reacquisition of the licenses, use:

> source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
% vovsh -x 'vtk_license_check CHECK'
% vovsh -x 'vtk_license_check ACQUIRE'