How to get and manage HERE Anonymizer Self-Hosted licenses

The usage of HERE Anonymizer Self-Hosted is subject to the availability of a valid license.

License type

HERE Anonymizer Self-Hosted works with an Enterprise license. The license is designed for organizations, allows for unlimited bandwidth, and can be issued for periods of 1 month or 1 year.

Buying a license

To get a license, subscribe to HERE Anonymizer Self-Hosted and purchase the selected HERE Anonymizer Self-Hosted plan. Contact your HERE sales representative to learn more.

Downloading the license

After you purchase a license, download it from the HERE platform. To learn more, see Installation.

Upgrading a license

HERE Anonymizer Self-Hosted stops working when the license expires. Depending on the way the license is installed in the application, upgrading the license can require restarting the application.

If the application reads the license from a file with the path defined in the HERE_ANONYMIZER_LICENSE_FILE variable or stored at the default {USER_HOME}/.here/HERE_ANONYMIZER_LICENSE path, replace the currently used license with a new file. The application reads the license in one-hour intervals. The new license is read in the interval that follows the upgrade which allows the application to work continuously without having to restart.

If the application reads the license from the HERE_ANONYMIZER_LICENSE environment variable, update the value of the variable with the new license and restart the HERE Anonymizer Self-Hosted application to finalize the upgrade.

License features

A license can be issued enabling or disabling specific features like stream processing or batch processing.

Please note, that HERE Anonymizer Self-Hosted fails to execute if it is configured to use a feature which is not licensed.

In such a case, please contact your HERE sales or support contact person.

License properties

There are several properties associated with an issued license.

Some important properties are listed below:

• Expiry-Date defines when the license expires.
• Not-Before-Date defines the activation date of the license. The license isn't valid before that date.
• Issue-Date defines the date when the license was issued.
• minimumSupportedVersion defines the minimum version of the product for which the license is valid.

License states

Depending on the properties listed above, a license can be in either of the following states:

Effects of license state

• VALID: The application runs without interruptions.
• EXPIRED or INVALID: The application is stopped immediately when such license status is detected. An appropriate error message is printed in the logs.

License validation exceptions

• When the HERE Anonymizer Self-Hosted application fails to locate the license, the following exception is thrown:

  java.lang.IllegalStateException: Unable to locate the HERE Anonymizer License.

  Solution: Follow these license installation steps to ensure that the license is installed correctly.

• Upon encountering an expired license, the following exception is thrown:

  java.lang.IllegalStateException: Your license has expired and hence, the anonymization process has been stopped.

  Solution: Upgrade the license to continue using HERE Anonymizer Self-Hosted.

• Upon encountering a license that is not active yet, the following exception is thrown:

  java.lang.IllegalStateException: Your license is not valid yet!

  Solution: The license is activated automatically upon reaching the Not-Before-Date and can't be used before that date.

  You must wait until the license becomes active to use the product.

• When the version of HERE Anonymizer Self-Hosted is not compliant with the license, the following exception is thrown:

  java.lang.IllegalStateException: Your license is only valid for the anonymization library version >= xxx.xxx.xxx

  Solution: Upgrade the version of HERE Anonymizer Self-Hosted to the version defined in minimumSupportedVersion or higher.

• Upon encountering a corrupted license, the following exception is thrown:

  java.lang.IllegalStateException: License signature not verified.

  Solution: Download and install the license again, ensuring it's not corrupted in the process.

• When the system clock on the host machine malfunctions, the following exception is thrown:

  java.lang.IllegalStateException: Integrity check of the system clock failed.

  Solution: Set the system clock to an appropriate timezone and ensure that it's not altered by any service running on the machine. After setting the system clock, restart the HERE Anonymizer Self-Hosted application.

• When the license doesn't contain license-type details, the following exception is thrown:

  java.lang.IllegalStateException: License type cannot be null or empty.

  Solution: Contact the HERE support to re-issue the license.

• When the license doesn't contain appropriate rate limiting details, the following exception is thrown:

  java.lang.IllegalStateException: License of type '<LICENSE_TYPE>' must define 'probes_per_minute'.

  Solution: Contact the HERE support to re-issue the license.