Management and License Configuration

Make sure to review the previous Environment Configuration page before proceeding with the steps below.

First login

Open a browser connection to http://127.0.0.1:8080 (or the address configured in config.json). You should see the following screen:

Review the EULA text found at https://telosalliance.com/eula. If you agree with the terms, select "Accept EULA" and click the "Continue" button.

Creating the Management User

The next page allows you to configure a management user that will have access to the license server's web UI:

Select a user name and password then click the "Save Credentials" button. Make a note of the password for future access to the license server.

After you save the credentials, you will be prompted to login.

NOTE: The server password and a password hash are stored in the config.json file too. If you forget the password, delete the AgreeToEULA, Username, and PasswordHash fields from config.json and restart the server. You will be prompted to create the management user again.

Main Application UI

The UI offers options to manage CodeMeter licenses and key9 licenses:

Select the section of interest by clicking the menu items on the left side of the screen.

CodeMeter License for Key9 Support

Before you can use key9 licenses, you need to add a CodeMeter license to enable the key9 protocol support. On the CodeMeter page, you should see the following entry:

The actual counter values may be different on your system. If the "Available" counter for the "Telos Key 9" license is zero, then you need to install the appropriate license by following the steps below. If the counter is greater than zero, you should skip to the next section.

Follow these steps to add the "Telos Key 9" CodeMeter license to the server:

1. Click the "Get Request..." button on the "Telos Key 9" line. This will download a license request file to a folder on your computer.

2. Email this file to activations@telosalliance.com and let them know that you need a license for "Telos Key9" product code 1140. (tbd if this info will be needed in the future or if this is already present in the license request file)

3. When you receive the license file from Telos, click the "Install License..." button to install it.

4. The "Available" column should now indicate a "1" or larger value.

NOTE: The CodeMeter license depends on various hardware IDs of your system. Certain changes to your system may invalidate your CodeMeter license. If this happens, the license server will cease to work. You will need to obtain and install a new CodeMeter license file to get it working again.

Add Key9 Licenses to the Server

Click on the "Key9" section in the menu on the left side. A page like the one below may be displayed. If this is the first time you're running the server, there will be no licenses displayed yet:

When you receive key9 license files -- these have the "*.key9" file extension -- click the "Install new license..." button to add the license file to the license server. You should then see the file and license information displayed on the page. Of course, the counters may be different for your licenses.

NOTE: The key9 license files are keyed to a specific server ID that has been assigned to you. The last number in the file name, before the .key9 extension, indicates the server ID of the key9 license file. Make sure this matches the server ID displayed at the top of your Key9 Licenses page.

Point Product to On-Prem License Server

You can point your product to the on-prem license server either through environment variables, a configuration file change or through the web UI (if your product supports it). Refer to the product documentation for specific guidance.