Font size

Team License Server: Troubleshooting

This article covers the most common issues occurring during work with Team License Server.

Issues can occur during the installation of Team License Server or upon its restart. In case of an issue, try identifying the reason by consulting the Team License Server logs.

To view logs of Team License Server, go to the following directory:

In Linux: /var/log/anylogic-tls
In Windows: C:\ProgramData\AnylogicTLS

There, in the logs directory, you can find logs for all components of Team License Server, preserved in separate files.

Errors and error messages

Activation errors

These issues may occur during the product activation.

Error Description
Activation failed: This key is for the different product. This error appears when you select a specific product (for example, AnyLogic), but the key you entered is for a different product (for example, anyLogistix). Close the menu and start anew, while selecting the appropriate product.
This key is for desktop software. Enter the Team License Server key. This error appears when you enter the key for the desktop installation. You need an appropriate team license key for Team License Server to work.
This key is for the different product edition. Remove this edition and activate the correct one. This error appears when you select a specific product edition (for example, AnyLogic University Researcher), but the key you entered is for a different edition (for example, AnyLogic Professional). Close the menu and start anew, while selecting the appropriate edition.
This key was generated for a different machine or user account. This error appears when you try to activate the product on the different machine instead of the one you used to request the key, or under the different user account. The server machine and account which you use to request the key and activate it via the Team License Server UI must be the same.
This key has expired. This error appears when you try to enter the key whose validity has expired. Request the new key, if your license is still active.
Invalid key This error appears when you try to enter the incorrectly formed key.

Product removal errors

These issues may occur during the removal of a product.

Error Description
Some licenses are still in use. Before removing the product, make sure all active users have dropped their licenses. This error appears when you try to remove the product from Team License Server, while some users are still leasing their key from it. In this case, contact the users in question and ask them to drop their keys.
You can also consider revoking their licenses.

Other errors

Error Description
Team License Server failed to generate the request. Make sure you have installed Team License Server properly. This error usually appears when you try to request a key on a machine that does not have some libraries necessary for Team License Server to work properly. Consult Team License Server logs to learn more, or contact our support team.
No access to the activation servers. This error usually appears when you try to request a key on a machine that is unable to connect to AnyLogic activation servers. In this case, check your internet connection and try again.
If the issue persists, copy the automatically generated request text and mail it to our support team.

Issues and workarounds

This section outlines potential Team License Server issues that may require your manual intervention.

Restarting Team License Server

In Linux: To restart Team License Server, execute the following command in the Linux terminal:

sudo systemctl restart anylogic-tls.

In Windows: Open Services, right-click the AnyLogicTeamLicenseServer service and select Restart.

Enabling HTTPS for Team License Server

To begin using the HTTPS protocol to access your Team License Server instance:

  1. On Team License Server host machine, go to the following directory:
    /etc/anylogic-tls/
  2. Open the config file.
  3. Modify the file as follows:
    ssl.certificate-path=/etc/key/mykey.p12 // The path to the SSL certificate file
    ssl.certificate-alias=keystore
    ssl.certificate-password=*** // The SSL certificate password 
    ssl.certificate-type=PKCS12
    server.https-port=8444 // The port to use for the HTTPS connection
  4. Save the changes to the file and restart Team License Server.

Upgrading and removing old Team License Server

Before installing Team License Server 3+, make sure the legacy version (2.5) has been uninstalled from the host machine.

To remove Team License Server from a Linux machine:

All the commands listed in this section should be executed in Linux terminal on the Team License Server host machine.
  1. Stop the running Team License Server service:
    sudo /usr/sbin/service anylogic-tls stop
  2. Remove the service from the system:
    sudo rm /etc/init.d/anylogic-tls
  3. Remove the application files:
    sudo rm -rf <the path to Team License Server installation>

After that, you can proceed with the standard Team License Server installation procedure.

To remove Team License Server from a Windows machine:

Uninstall Team License Server just like you would any regular Windows application.

Forceful license revocation

If a user loses access to their device with a license leased from Team License Server and can’t return it, a system admin can use Team License Server forcefully reclaim the license.

To return the license using Team License Server:

  1. Navigate to <host machine name>:8080 in your preferred web browser.
  2. Log in as the administrator. The default password is admin.
  3. Go to the product’s page.
  4. In the Users table at the bottom of the page, move the mouse pointer over the row with the user whose license you want to return.
  5. Click the Delete icon that appears on the right.
  6. The dialog with the request text will appear:

    Team License Server: Revoking the user’s license

    Copy the text shown (manually or by clicking the Copy button in the bottom right corner of the form).
  7. Email the request text to the AnyLogic support team at support team. In the email, describe the reason for the compulsory revoke of the license.
  8. If your request has been approved, then after some time, you will receive an email containing the revoke code, to the server administrator’s email account. If the email is missing, check your spam folder.
    Repeat steps 1-5 to open the revoke form again.
  9. Switch to the Revoke the license tab.
  10. Enter the revoke code in the edit box.
  11. Click Apply.

After that, the user’s license seat will be revoked from their product installation.

How can we improve this article?