Configure License Server 4.x (Legacy)

The Protection! Licensing Server software requires the Java runtime environment:

1. Download the latest Java 8 version. You can do this on the following web site:

   http://www.java.com/en/download/manual.jsp

   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.

2. Install it on the computer where you will install Protection! License Server.

Install on headless machines

After you install Java on the server computer, you can install Protection! Licensing Server. Follow the steps below.

1. Make sure your computer meets the Licensing Server requirements.

2. Download Protection! Licensing Server:

   	Windows	Linux	macOS
   32-bit	Win	Linux	macOS
   64-bit	Win

   By downloading our software, you agree to our terms of use and privacy policy.

3. Run the downloaded installer and follow the installation wizard instructions.

You need to configure the license server settings before using it. See below.

Install on headless machines

In some cases, you may experience issues when connecting to the license server. It may happen when you, for example, access the server from a different domain. To fix this issue, you need to specify the host name explicitly:

Show steps

Show stepsHide steps

1. Open the <ProtectionLS Installation Directory>/bin/server.xml file in any text editor.

2. Specify the name of the server computer to the hostName attribute of the server element. For example:

   XML

   XML

   <server hostName="licenseserver" port="1099" exportPort="10991" mgmtPort="9999" mgmtExportPort="9998" allowRestart="false">
   ...
   

   Save the file.

3. Restart the license server.

By default, the license server uses the following ports:

Make sure that your firewalls and proxies allow connecting to the license server through these ports. Quite often, these ports are already open.

If you are not sure whether these ports are open, or if you need assistance with configuring your proxies, please ask your system administrators for help. You will need to restart the license server to apply the changes you have made. For information on how to specify other ports, please see Protection! License Server Administrator Guide (pdf).

1. Start the Protection! Management Console.

   You are asked to create a connection:

   

   Click the image to enlarge it.

2. Specify the collection parameters:

   • Enter the server Name and (optionally) Description.

   • Enter the Server Address.

     The Management Console can configure license servers working on most other computers, including those headless.

     Note:

     If the Management Console and the license server are on the same machine, leave localhost in this field.

   • Enter a Port number (the default is 9999).

   • Enter a Login and a Password.

     Note:

     Default credentials are – Login: admin Password: {empty}

   • Click OK.

You can change the credentials in the Management Console later.

1. In the server Management Console, switch to the Summary view:

   

   Click the image to enlarge it.

2. Click Connect to connect to the server.

   You will see summary statistics for the server:

   

   Click the image to enlarge it.

1. If you received the license file in a .zip archive, extract it from the archive to a directory on your computer.

2. In the server Management Console, switch to the Summary view:

   

   Click the image to enlarge it.

3. Click Connect to connect to the server.

   You will see summary statistics for the server:

   

   Click the image to enlarge it.

4. In the menu on the left, select License Storage. Then select File > Import Licenses from the main menu:

   

   Click the image to enlarge it.

5. In the subsequent Open File dialog, select the license file you received from SmartBear and click Open:

   Note:

   If you received a .zip file from SmartBear, then, in the dialog, you need to specify the extracted license file.

   

   Click the image to enlarge it.

   This will install the license on the server computer.

To provide users with access to the license, you need to assign the installed license to users. The easiest way to do that is to assign the license to the Everyone user group that is available by default. This will make the license available to all the users who connect to your license server.

If you need more control, you can assign the license to an individual user or user group that you create on the license server. You can also assign the license to users from an LDAP server (Lightweight Directory Access Protocol) that is available in your network. See Managing Users and Groups for complete information.

To assign the license to users:

1. Select the license file from the License Entries list, then click Add User on the Allocation tab toolbar on the right:

   

   Click the image to enlarge it.

2. The following dialog will appear:

   

   Click the image to enlarge it.

3. Select the desired group and click OK.

Note:

You can examine the configuration of the assigned user or group by double-clicking it. For example, the Everyone group has the following configuration: Click the image to enlarge it.

Now, the selected license will be available to the specified users in the network.

The license server is now installed and configured to control the licenses.