Applies to ReadyAPI 3.3, last modified on July 03, 2020

This topic describes how to install license server on the headless machine.

Note: To configure the installed license server, you use the License Management Console that does not have a command-line interface. See Configure License Server.
Installation process requires the user to have root permissions.


To install the license server, you must have Java 8 installed. To check if it is installed, run the following command:

java -version

We do not support other Java versions (Java 9 and later).
Note: By default, Protection! License Server looks for the installed Java 8 on the computer and uses it if possible. If the server cannot find Java 8, make sure you set the path to the Java 8 installation folder as the value of the JAVA_HOME environment variable.

If you don't have Java 8 installed:

  1. Refresh your package list:

    sudo apt-get update

  2. Install Java:

    sudo apt-get install openjdk-8-jre

Installing License Server

  1. Download the license server installation package to the current folder:

    wget ""

  2. Make the downloaded file executable:

    chmod +x ./

  3. Run the installation with the root permissions:

    sudo ./

  4. Follow the instructions on the screen to finish the installation.

Modifying the Server Configuration

After you install the license server, you need to configure it.

Before configuring it, make sure the server is not running. You can do this by using the ProtectionLS script (by default, it is located in the <ProtectionLS Installation Directory>/bin directory):

sudo ./ProtectionLS status

If the server is running, run ./ProtectionLS stop to shut it down.

  1. Specify server IP or host name in the <ProtectionLS Installation Directory>/bin/server.xml file by using any text editor:

    <server hostName="111.222.333.444" port="1099" exportPort="10991" mgmtPort="9999" mgmtExportPort="9998" allowrestart="false">

  2. Start the license server:

    ./ProtectionLS start

What to Do Next

Your license server is configured. Now, install a license by using the License Management Console on a not headless machine in your network. To learn how to do it, see Configure License Server.

See Also

Headless Machines

Highlight search results