License Server Help

Upgrading

To learn which FLS version you have and whether there is a new one, see Check version. Before upgrading your instance of FLS, check that your environment meets the requirements.

There are a lot of differences between old (before build #12431) and current versions of License Server (FLS). From build #16429 (released on March 19, 2018), FLS is supported only by the latest JetBrains products: later than version 2018.2.1 (later than 2018.3 for .NET tools). When the IDE connects to FLS version that it does not support, you will get the following notification: "Outdated license server detected". For more information, see Outdated license server. To learn new features of the latest versions, see Release notes.

If you have very old FLS version (before build #12431), we recommend installing one of the newest versions. In this case, you need to repeat the whole procedure of configuring this new instance of FLS and link it to your company profile. After registration, new FLS will take license information from JetBrains Account.

In-place upgrading is available from build #12431 and is similar to the new installation procedure. In short, you need to save configuration files with previous settings, replace old FLS's program files with the new build and then place configuration files back. You need to save the whole conf subdirectory which is located in FLS installation directory. If you configured user restrictions, save the access-config.json file.

We also recommend creating a backup of the previous version to have an ability to revert it in case of problems with the new one.

  1. Save all configuration files to any safe directory and make a backup of the current FLS installation directory, for example, a zip archive.

  2. Change to FLS installation directory using the command line.

  3. Stop FLS using the following command:

    ./bin/license-server.sh stop
  4. Download ZIP archive and unzip it to the FLS installation directory (replace old folders and files with the new ones).

  5. Place saved configuration files back.

  6. Start FLS using the following command:

    ./bin/license-server.sh start
  7. Make sure that server grants users with requested licenses as it was before the upgrading. It means that existing registration is in use.

If you have very old FLS version (before build #12431), we recommend installing one of the newest versions. In this case, you need to repeat the whole procedure of configuring this new instance of FLS and link it to your company profile. After registration, new FLS will take license information from JetBrains Account.

In-place upgrading is available from build #12431 and is similar to the new installation procedure. In short, you need to save configuration files with previous settings, replace old FLS's program files with the new build and then place configuration files back. You need to save the whole conf subdirectory which is located in FLS installation directory. If you configured user restrictions, save the access-config.json file.

We also recommend creating a backup of the previous version to have an ability to revert it in case of problems with the new one.

  1. Save all configuration files to any safe directory and make a backup of the current FLS installation directory, for example, a zip archive.

  2. Change to FLS installation directory using the command line.

  3. Stop FLS using the following command:

    ./bin/license-server.sh stop
  4. Download ZIP archive and unzip it to the FLS installation directory (replace old folders and files with the new ones).

  5. Place saved configuration files back.

  6. Start FLS using the following command:

    ./bin/license-server.sh start
  7. Make sure that server grants users with requested licenses as it was before the upgrading. It means that existing registration is in use.

The upgrading is similar to the new installation. You need to repeat the whole process of configuring your instance of FLS and link it to your company profile. After registration, new FLS will take license information from JetBrains Account.

  1. Stop FLS using the Services Microsoft Management Console (MMC) (Control Panel > Administrative Tools > Services > JetBrains License Service)

  2. Download MSI Installer.

  3. Run downloaded MSI installer and follow wizard steps.

  4. Start FLS using the Services Microsoft Management Console (MMC).

  5. Make sure that server grants users with requested licenses as it was before the upgrading. It means that existing registration is in use.

Last modified: 25 August 2023