Usage issues

Issue

When trying to obtain a license, users get the following error message:

Solution

This error can occur with FLS versions before #17768 (5 Sep 2018) if a license is requested by an IDE starting from version 2023.2.

To solve this issue, upgrade your FLS to build #17768 or later.

Issue

Attempt to obtain license from server leads to the following error:

This happens because license server installation is not registered.

Solution

Follow the registration instructions to complete the registration of your FLS.

Issue

Error caused by unexpectedly formatted data received in response to license request sent to FLS. Attempt to obtain license from server leads to the error

Solution

Check connection to license server:

• Try running ping <server host>.

• If ping is successful, try to access FLS page from the web browser installed on the machine with JetBrains product, which fails to obtain a license, by visiting FLS address used in the product.

• If FLS page is successfully opened, set up network configuration, used by the web browser, for the product.

• If configuration is the same but connection still fails let product contact FLS through transparent proxy that allows product to receive response from the server and doesn't change passed data.

Issue

Attempt to obtain license from the server leads to the error License Server response has not passed data integrity check: Invalid signature format. The issue is caused by an outdated version of FLS used to obtain the ticket.

Reason

Starting with the 2018.2.1 release of JetBrains IDEs (released in Q3 2018), products no longer obtain license tickets from the old versions of FLS (versions prior to build #16429 which was released on March 19, 2018). To find the version number of FLS you are using, look in FLS log or in the web interface.

Solution

Update FLS to the latest version by following the upgrade procedure.

Issue

Attempt to obtain license from FLS gives Cannot obtain ticket error message.

Solution

Issue is caused by absence of FLS page by the path entered as FLS address. Open FLS address in web browser and check if there is license server page available. If FLS page is not available, use actual FLS address or re-configure FLS address to the address you are trying to use. If FLS page is successfully opened setup network configuration, used by the web browser, for the product.

Issue

The error is thrown when FLS is trying to contact JetBrains.

Solution

There are several possible reasons of the issue and suggested solutions:

• Proxy server between you and JetBrains Account that intercepts SSL traffic and substitutes our certificate with its own one, which is different and will not be accepted by the IDE. Proxy server may be completely transparent to you and may work without any explicit proxy configuration in your system. Contact your organization IT helpdesk or ISP support to get it resolved.

• If you are using Linux, your JDK may have incomplete keystore without Thawte CA, therefore, JDK can't verify SSL certs from our server. See this issue for details. You can install Oracle JDK 1.8 and configure license server to use this new JDK installation instead of the system JDK by running:

  <fls_home>/bin/license-server.sh java set <path to JRE home directory>

  <fls_home>/bin/license-server.sh java set <path to JRE home directory>

  <fls_home>\bin\license-server.bat java set <path to JRE home directory>

  Make sure to install JDK manually from OpenJDK or Amazon Corretto. JDK installed by the package manager will use the same cacerts file that may be incomplete or even empty/corrupted.

• IBM JDK will have issues connecting to account server, use Oracle JDK or OpenJDK.

Issue

An attempt to access FLS page fails with an error message "Passed host header is not allowed."

Solution

If FLS runs behind the reverse proxy or a host configured for FLS software doesn't match a host of machine where the software is running, configure virtual hosts property for FLS software. See Reverse proxy