Install the license server

The Semarchy xDI License Server is an optional component you can install to manage internally the Designer instances' licenses when they do not have access to the internet.

This document details how to install the Semarchy xDI license server.

Before the installation, make sure to understand the xDI architecture and review carefully the System requirements.

What is the license server?

The Designer refreshes its license token periodically, by synchronizing with a License Server.

This License Server is usually the central license server managed by Semarchy, where all licensed Designer are registered.

You can optionally install a license server in your organization’s network for your Designer instances to synchronize their license when your organization’s network configuration does not allow internet connections.

The License Server is a Java service, usually installed on a production or development server.

Download the license server

The License Server is shipped as an archive file. It runs on any platform with a supported Java Virtual Machine.

The latest version of the License Server can handle all older supported versions of Designer. We recommend you download and install the newest available License Server.

Install the license server

To install the license server:

  1. Uncompress the License Server archive to a temporary directory. Move the archive content to the target installation directory.

  2. Check and set, if needed, execution permission on all the .bat (Windows) and .sh (Linux or macOS) scripts located in the bin/ sub-folder of the installation directory.

  3. Configure the License Server.

  4. Install the license file

The configuration of the license server is mandatory. The License Server will not start if there is no configuration file or if the security properties are undefined.

Install the license file

Semarchy can provide a license file to deploy in your license server. Copy this file to the License Server installation directory.

Start the license server

To start the license server:

  1. In the bin/ subdirectory of the License Server installation directory, run the start.bat (Windows) or start.sh (Linux or macOS) file.
    The license server starts.

When started, the standard output should contain a message as below:

2022-03-30 10:18:21.242:INFO::jetty-7.3.1.v20110307
2022-03-30 10:18:21.275:INFO::started o.e.j.s.ServletContextHandler{/,null}
2022-03-30 10:18:21.487:INFO::Started SslSocketConnector@0.0.0.0:443

The com.semarchy.xdi.license.server.log file indicates possible errors and should contain the following when the license server is started:

2022-03-30 10:18:20,989 [INFO ] Loading server properties
2022-03-30 10:18:21,106 [INFO ] Server properties are loaded

Use the stop.bat (Windows) or stop.sh (Linux or macOS) scripts to stop the license server.

Monitor the license server

To monitor the license server and check its status, you can watch its log files or its process.

Watch the log files

The license server writes its log to the log subdirectory. Use that log to watch for license server output and messages.

Watch the process

To look at the process status, use your operating system tools to search for a Java process with com.indy.license.server.jar in its name. This process is the license server.