License Server Troubleshooting

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?

Note - This feature is supported only in License Server v1.0.59 or higher.

Open a web browser on a machine that can see the License Server network.
Type <IPAddress>:35797/getVersion
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?

Note - This feature is supported in License Server v1.0.59 or higher.

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.