Ubuntu 18.04 LTS ‘Bionic Beaver‘ reached the end of the standard, five-year maintenance window for Long-Term Support (LTS) releases on 31 May 2023. That said, we recommend moving your updating or moving License Server host to a modern, supported Operating System.

That said, if you choose to run Ubuntu 18.04, we are keeping Telos Alliance License Server v1.0.62 available.

• Ubuntu 18.04

• Ubuntu 20.04

Prerequisites

• Administrator privileges

• A machine running a Microsoft-supported version of Windows. Windows 10 is recommended.

• Network access to the products requiring licenses

• TCP Port 35797 open in the firewall

Installation

• Click here or copy/paste the URL from the code block below to download Telos Alliance License Server.

https://telos-public.s3.amazonaws.com/license-server/telos-alliance-license-service_win_1.0.71.zip

• Right-click to extract the contents of the telos-alliance-license-service_win_1.0.71.zip package.

• Right-click on telos-alliance-license-service.exe and select Run as administrator.

• Follow the on-screen prompts to read and accept the Telos Alliance EULA, and install Telos Alliance License Server.

• Telos Alliance License Server uses a third-party Wibu Systems technology called CodeMeter to facilitate licensing for certain products and product features. A side installer will open during the installation of Telos Alliance License Server.

  • Step through the menus to accept WIBU's license agreement and install CodeMeter.

    • We suggest leaving the default settings that the CodeMeter installer presents.

  • When prompted, click Finish to complete the CodeMeter installation step and return to the Telos Alliance License Service Setup Wizard.

• Click Finish to complete Telos Alliance License Server installation and close the Setup Wizard.

After Telos Alliance License Server has been successfully installed, and licenses can be added to the system. See individual product documentation for product-specific licensing steps and requirements.

Overview

Troubleshooting the License varies slightly depending on the operating system on which it is installed. To account for these variations, information is divided into 3 sections: General, Ubuntu, and Windows.

General

Can the Docker Container connect to the License server?

• Open Terminal in Linux.

• Type docker exec -it <container id> /bin/bash, then press Enter.

• Type ping <IPAddress of License Server Host>, then press Enter.

• If the message "The host is unreachable" is the response, the network is not set up correctly; please contact Customer Support for assistance.

Can the License server be reached using the browser?

• Open a web browser on a machine that can see the License Server network.

• Type <IPAddress>:35797/getLicenseList, then press Enter.

• The expected responses are either “[]”, or “[with license information here]”

• Any other results indicate that the License Server is not installed or your network or is not configured properly; please contact Customer Support for assistance.

Are there any licenses installed?

• Open a web browser on a machine that can see License Server network.

• Type <IPAddress>:35797/getLicenseList, then press Enter.

• The expected response is “[with license information here]”

• If you receive "[]" then no licenses have been installed.

• If you receive any other response, either the license server cannot be reached or may not be functional; please contact Customer Support for assistance.

What version of License Server is installed?

1. Open a web browser on a machine that can see the License Server network.

2. Type <IPAddress>:35797/getVersion

3. The License Server version will be reported on the web page.

Ubuntu

Can the license server host connect to the container?

• Open a Command Prompt

• Type ping <IPAddress of Docker Container>, then press Enter.

• If the message "The host is unreachable" is the response, the network is not set up correctly; please contact Customer Support for assistance.

Is License Server installed and running?

• Open Terminal in Linux.

• Type systemctl --type=service then press Enter.

• You should see the following services running:

  • codemeter.service

  • telos-license-server.service

• If you do not see these services running, either License Server is not installed or the services are not running.

• Type sudo systemctl start codemeter then press Enter.

• Type sudo systemctl start telos-license-server then press Enter.

• Type systemctl --type=service then press Enter.

• You should see codemeter.service and telos-license-server.service running.

• If not, License Server may not be installed; install or re-install License Server.

Is the network set up properly for License Server, or are there any licenses installed?

• Open Terminal.

• Type curl -X GET http://<IPAddress>:35797/getLicenseList then press Enter.

• Provided that License Server is installed and your network is set up properly, any activated licenses on your machine will be displayed in the web browser.

• If the License Server is set up correctly but no licenses are programmed on your machine, the web browser will return “[ ]”.

• Any other results indicate that License Server is not installed or your network is not configured properly; please contact Customer Support for assistance.

What version of License Server is installed?

• Launch Terminal

• Type curl -X GET http://<IPAddress>:35797/getVersion

• The License Server version will be reported in Terminal.

How to remove a CodeMeter license from Linux

• Run the command below to display the serial numbers of all installed license containers:

cmu --list

• Note the serial number entry from the previous step for the license that requires deletion, then run the command below to delete the license container:

cmu --delete-cmact-license --serial <EnterSerialNumberHere>

Example:

cmu --delete-cmact-license --serial 32767-39361

• Finally, run the command below once more to ensure that the license was removed:

cmu --list

Windows

Can the license server host connect to the container?

• Open Command Prompt.

• Type ping <IPAddress of Docker Container> then press Enter.

• If the message "The host is unreachable" is the response, the network is not set up correctly; please contact Customer Support for assistance.

Are the Services Running?

• Type Services in the Windows Start menu.

• Locate the Codemeter Runtime Service and verify it is running.

• Locate the Telos Alliance License Service and verify it is running.

The Telos Alliance License Server is designed to centralize licenses, serving them up to other hosts, applications, or containers on a network. Please note that not all Telos products support License Server. Please see individual product documentation to verify License Server deployments are supported. Telos Alliance License Server is available for both Windows 10 and 11 and many Linux distros (e.g. Debian/Ubuntu, RedHat/Fedora and some OpenSuSE derivatives).

• Linux

• Windows

Prerequisites

• TCP Port 35797 open in the firewall (REST API) - Required

• TCP Port 8080 open in the firewall (WebGUI) - optional for access to the WebGUI

• A host running Linux 5.x kernel or higher

  • Tested on the following distros:

    • Ubuntu Server 20.04

    • Ubuntu Server 22.04

    • Ubuntu Server 24.04

    • Rocky 9

    • Amazon Linux 2 AMI (HVM) kernel 5.10

    • Amazon Linux 2023 AMI

• sudo privileges when performing the install

• fuse, wget, libx11-6, and libxcb1 packages installed on the host

  • The online install, or online option of the offline package, will pull in any of these missing dependencies, as long as the host has internet access.

    • Ubuntu Server 20.04, 22.04, and 24.04 include all packages by default except fuse.

• Network access to the products requiring licenses

Installation

There are two methods for installing Tellos Alliance License Server. The Online Install method is the fastest deployment, but an Offline Package Install is offered for air-gapped deployments, or for some Infrastructure as Code deployments (e.g. AWS EC2 user data).

Online Install

• The installation and use of the Telos Alliance License Server application is contingent on your acceptance of the Telos Alliance End-User-License-Agreement. Please review the EULA before you proceed.

• After reading the Telos Alliance End-User-License-Agreement, and agreeing to the terms, copy/paste and run the code block below to install Telos Alliance License Server.

curl -sSf https://telos-public.s3.amazonaws.com/license-server/install.sh | sudo bash

Offline Package Install

If you are in an air-gapped environment, or installing Telos Alliance License Server as part of an Infrastructure as Code deployment (e.g. AWS EC2 user data), the following Offline Package Install is available.

• Click to download the Telos Alliance License Server Installer, or use the URL below:

  Copy

  https://telos-public.s3.amazonaws.com/license-server/Telos_License_Server-1.2.7-offline_installer.tar.gz

• Move the bundle to the target machine and run the following commands:

  Copy

  tar -xf Telos_License_Server-1.2.7-offline_installer.tar.gz
  cd Telos_License_Server-1.2.7-offline_installer
  sudo ./install_offline.sh

• See the Prerequisites section of this document for the required packages.

• Read the Telos Alliance EULA and select one of the available 3 options:

  • [1] These dependencies are installed. Accept EULA and proceed with installation

  • [2] Accept EULA and attempt to connect to the internet and install dependencies automatically

  • [3] Exit this script and install dependencies manually

After accepting the Telos Alliance EULA, installation will proceed. Telos Alliance License Server will then be available for use in your production environment.

See individual product documentation for product-specific licensing steps and requirements.

Automated deployment or IaC of the Offline Package Install

• After reading and agreeing to the terms of the Telos Alliance EULA, you may automatically accept one of the Offline Package Install options by using the one of the commands below.

• From the extracted Telos_License_Server-1.2.7-offline_installer directory, do:

Automatically accept option 1 in offline script:

{ echo 1;echo; } | sudo ./install_offline.sh

Automatically accept option 2 in offline script:

sudo ./install_offline.sh --online

Prerequisites

• Provide your AWS Account ID to Telos to gain access to the CloudFormation template.

• Create or use an existing VPC.

  • A public subnet (route to IGW), or private subnet with a NAT Gateway attachment is required for initial deployment.

• Create a Security Group with the following ports open.

  • TCP Port 35797 (REST API) - limit to VPC CIDR.

  • TCP Port 8080 (WebGUI) - limit to your public IP, CIDR block of your business network, or bastion host.

  • Optional - TCP for 22 (SSH Management) - limit to administrator public IP(s) or bastion host.

• Key pair created in the Region you plan to deploy the License Server EC2 instance.

Creating a CloudFormation Stack from a template

• Navigate to the CloudFormation service in the AWS Management Console. In the top-right corner of the AWS Management Console, select the AWS region in which you plan to deploy these resources.

• Click Stacks in the left pane

• Under the Create stack dropdown, select With new resources (standard).

• Tick the Amazon S3 URL option, and copy/paste the URL below into the Amazon S3 URL field.

• Click Next to proceed.

https://telos-devops.s3.us-east-1.amazonaws.com/cloudformation/infrastructure/Telos_CloudFormationTemplate_LicenseServer_v1.2.7.yaml

Configuring the CloudFormation Stack

Stack name

• Enter a Stack Name - this name will be used to name the stack and all resources, so name it something meaningful.

  • Example: telos-license-server

Deploy the Stack

• After filling in all the required fields in the CloudFormation template, scroll down to the bottom of the page.

• Click Next to proceed.

• Optionally specify additional TAGS, IAM Permissions, or other advanced AWS CloudFormation options.

These optional features are not directly supported by Telos Alliance. For guidance on your organization's needs regarding CloudFormation advanced feature, consult the AWS Documentation or the AWS Support team.

• Click Next to proceed.

• Scroll through the appearing stack review page, reviewing the data and settings you entered for accuracy.

• If you are happy with the settings, click Submit to deploy the CloudFormation Stack.

Prerequisites

• sudo privileges

• A machine running Ubuntu 18.04

• Up-to-date apt package list. Run the following command to confirm.

• wget installed

• unzip installed

• Network access to the products requiring licenses

• TCP Port “35797” must be open in order for the License Server to work.

Installation

• Download the License Server Installer:

• Unpackage the file:

• Change the path:

• Run the install script:

The license server has been successfully installed, and licenses can be added to the system.

v1.2.7

Linux

• Update CodeMeter runtimes to 8.20 to fix a bug that was causing licenses to be lost in AWS when EC2 instances were shutdown.

v1.2.5

Linux

• Update CodeMeter runtime to 7.60d

• Optimize CodeMeter log rotation.

• Implement log rotation for License Server log.

• Add support for scale deployments (tested up to 768 total licenses)

v1.1.0

Linux

• Update CodeMeter runtime to 7.60c

• Add instruction to systemd service to speed up stopping and restarting of the telos-license-server.service

• Update key9 On-Prem and WEBUI modules to v1.1.5 ( logging and backup features)

• Remove logic in install script to copy existing key9 server config files from old working directory

• Fix a race condition that caused the license server to hang when more than 40 licenses were called at the same time (only occured in scaled environments).

v1.0.72

Linux

• Integrate license server into AppImage to enable support for distros other than Ubuntu.

• Move working directory from /var/Telos/LicenseServer to /opt/telos/.license-server to support AppImage requirements.

• Add logic to copy old working directory files to new working directory.

• Rename License Server systemd service from license-server.service to telos-license-server.service

• Update key9 On-prem module to v1.1.4

v1.0.71

Linux / Windows

• Integrate key9 On-prem module v1.1.3

• Add logrotate job to rotate CodeMeter logs automatically

• Move from full CodeMeter runtime to cm-lite driver v7.60.5598.500 to remove dependencies in air-gapped systems

Prerequisites

• TCP Port 35797 open in the firewall

• A machine running Ubuntu 20.04

• sudo privileges

• Network access to the products requiring licenses

Installation

• Update apt package list:

  Copy

  sudo apt-get update

• Download the Telos Alliance License Server Installer:

  Copy

  wget https://telos-public.s3.amazonaws.com/license-server/telos_license-service_u20.04_1.0.71.tar.gz

• Unpackage the file:

  Copy

  tar -xf telos_license-service_u20.04_1.0.71.tar.gz

• Change the path:

  Copy

  cd install_linux_u20.04

• Run the install script:

  Copy

  sudo ./install_license_server.sh

• Follow the link presented in the CLI to read the Telos Alliance EULA.

• Press Enter on the keyboard to accept the EULA and install and use Telos Alliance License Server, or Ctrl-C to decline and abort installation.

After Accepting the Telos Alliance EULA, installation will proceed. Telos Alliance License Server will then be available for use in your production environment.

See individual product documentation for product-specific licensing steps and requirements.