Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

license_key_id

Parameter

license_key_id[N] N=0 or 1

TypeNumericText string
Value

A

number (decimal Sentinel key ID) that specifies regular (N=0) and backup (N=1) license

set of Sentinel Key IDs that specifies the license keys to be used by CHARON

-VAX

.

set session license_key_id[0]=1877752571
set session license_key_id[1]=354850588

It is also

possible to specify both regular and backup key in one line

possibly to use a keyword "any" to force CHARON to look for suilable license in all available keys if the license is not found in the specified keys.

Example:

set session license_key_id

[0]

=

1877752571 license_key_id[1]=354850588

"1877752571,354850588,any"

Based on the presence of

the regular and/or backup license key IDs

this parameter in the configuration file, CHARON

-VAX

behaves as follows:
 

  1. No keys are specified (the parameter is absent)
    CHARON

-VAX
  1. performs an unqualified search for any suitable key in unspecified order. If no key is found, CHARON

-VAX
  1. exits.

Both
  1. One or many keys are specified
    CHARON

-VAX
  1. performs a qualified search for a regular license key in the specified order. If it is not found, CHARON

-VAX performs a qualified search for backup license key. If it is not found, CHARON-VAX exits.
  • Only regular key is specified
    CHARON-VAX performs a qualified search for a regular license key. If it is not found, CHARON-VAX performs an unqualified search for any suitable key. If none are found, CHARON-VAX exits.

  • Only backup key is specified
    CHARON-VAX performs an unqualified search for any suitable key. If no key is found, CHARON-VAX exits.
    1. exits (if the keyword "any" is not set).

    If the keyword "any" is specified then if no valid license has been found in the keys with specified ID’s all other available keys are examined for valid license as well.

    Note

    The order in which keys are specified is very important. If a valid license was found in the key which ID was not the first one specified in configuration file, then available keys are periodically rescanned and if the key with the ID earlier in the list than the current one is found CHARON tries to find a valid license there and in case of success switches to that key.


    license_id

    Parameter

    license_id

    TypeText string
    Value

    A set of license indetifiers that specifies the licenses to be used by CHARON. This parameter is applicable only to new licenses.

    Example:

    set session license_id = "2718281828,314159265"

    If this parameter is set, Charon considers for validation only the available licenses with license ID parameter set and equal to one of
    the license ID's specified in the configuration

    license_key_lookup_retry

    Parameterlicense_key_lookup_retry
    TypeText String
    Value

    In case the CHARON-VAX license connection is not present at guest statup, this parameter specifies how many times CHARON-VAX will try to reestablish the connection and, optionally, a period of time between retries.

    Syntax:

    set session license_key_lookup_retry = "N [, T]"

    where:

    • N - Number of retries looking for license key (or keys)
    • T - Time between retries in seconds. If not specified 60 seconds is used

    Example 1

    set session license_key_lookup_retry = 1

    If license key is not found during initial scan, do only one more attempt after 60 seconds.

    Example 2

    set session license_key_lookup_retry = "1,30"

    Same as above but retry in 30 seconds.

    Example 3

    set session license_key_lookup_retry = "3,10"

    If license key not found during initial scan, do 3 more attempts waiting 10 seconds between them.

    Example 4

    set session license_key_lookup_retry = "5"

    If license key is not found during initial scan, do 5 more attempts waiting 60 seconds between them.

    ...