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.

  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?

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.

PreviousAWS CloudFormation Template DeploymentNextLegacy License Server Versions

Last updated