Applies to ReadyAPI 3.0, last modified on November 19, 2019

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 installed. To check if it is installed, run the following command:

java -version

If you don't have Java installed:

  1. Add the Java package repository:

    sudo add-apt-repository ppa:webupd8team/java

  2. Refresh your package list:

    sudo apt update

  3. Install Java:

    sudo apt install oracle-java8-installer

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