How to install HERE Anonymizer Self-Hosted

You can download HERE Anonymizer Self-Hosted from the HERE platform. The product is delivered in a ZIP archive that contains a fat JAR package with all of the code you need to run the application compiled.

📘
Note
Using the product requires a valid license. To learn more, see How to get and manage HERE Anonymizer Self-Hosted licenses. The best way to download HERE Anonymizer Self-Hosted and the product license is by using the OLP CLI.

Prerequisites

Before you start:

Get a HERE platform account created by your organization's admin and get the authentication and authorization credentials. To learn more about credentials, see the Identity and Access Management Developer Guide.
Install the OLP CLI. To learn more, see the HERE OLP CLI User Guide.
Set up your HERE platform credentials in the OLP CLI. To learn more, read this topic.

Environment requirements

HERE Anonymizer Self-Hosted uses Java 17 at runtime. The cluster nodes that run HERE Anonymizer Self-Hosted must have Java 17 installed.
HERE Anonymizer Self-Hosted requires Flink 1.19.3. Additionally, Flink classes must be provided by the runtime environment as they are not included in the here-anonymizer.jar archive.
The best way to run HERE Anonymizer Self-Hosted in production as a high-performance, scalable application, is on a cluster of Linux-based nodes.

Download HERE Anonymizer Self-Hosted

Check if you have access to the HERE platform. The list should contain the hrn:here:data::olp-here:here-anonymizer catalog.
```
olp catalog list
```
List the content of the releases layer of the catalog. The catalog contains all downloadable, released versions of HERE Anonymizer Self-Hosted.
```
olp catalog layer object list hrn:here:data::olp-here:here-anonymizer releases
```
Download a specific version of the product. Replace the {SELECTED_VERSION} placeholder value with the identifier of the version you want to download.
```
olp catalog layer object get hrn:here:data::olp-here:here-anonymizer releases --key HERE_Anonymizer_v{SELECTED_VERSION}.zip
```

Download the license

The license file is available in a catalog accessible only to authenticated members of your organization.

Check if you have access to the HERE platform. The list should contain the hrn:here:data::olp-here:here-anonymizer-license-{ORGANIZATION_REALM_NAME} catalog. Run this command:
```
olp catalog list
```
If this catalog is not on the list, create a "default" project. This creates a project with a HRN of the hrn:here:authorization::{ORGANIZATION_REALM_NAME}:project/default format. This is a one-time process.
```
olp project create default default
```

Link the catalog to the project. After this operation, the catalog shows on the list when you run olp catalog list.

olp project resource link hrn:here:authorization::{ORGANIZATION_REALM_NAME}:project/default hrn:here:data::olp-here:here-anonymizer-license-{ORGANIZATION_REALM_NAME}

List the content of the license layer of this catalog to see all available licenses.

olp catalog layer object list hrn:here:data::{ORGANIZATION_REALM_NAME}:here-anonymizer-license license

Download the license with the newest timestamp.

olp catalog layer object get hrn:here:data::olp-here:here-anonymizer-license license --key {LICENSE_YYYY_MM_DD}

Install the license

HERE Anonymizer Self-Hosted reads the license from one of the following locations in this order of precedence:

Environment variable: the license is stored directly in an environment variable named HERE_ANONYMIZER_LICENSE.
Custom file: the license is stored in a file at a user-defined path. The file path must be defined in the HERE_ANONYMIZER_LICENSE_FILE variable.
Default file: the license is stored at the default {USER_HOME}/.here/HERE_ANONYMIZER_LICENSE path.