Floating License Server Help

Configuring host availability

If the floating license server(FLS) runs behind a reverse proxy or the host configured for the FLS software doesn't match the host machine where the software is running, you need to configure the virtual-hosts property for the FLS software, which validates the values of the “Host” header in the request.

When enabled, the license server will only process the requests with a “Host” header which matches the hosts listed in the license server’s configuration file.

For ZIP-based versions, the check is enabled by default and the parameter is: --jetty.virtualHosts.names

For MSI-based versions, the check is added since build 19488, disabled by default and parameters are:

--virtual-hosts --virtual-hosts-default
At least one of these parameters should be configured to enable verification on Windows.

Configuration

  1. Stop FLS
  2. Execute in the command line with Administrator permissions:
    <fls_home>/bin/license-server.sh configure --jetty.virtualHosts.names=proxy-server.mydomain.com

    where value of --jetty.virtualHosts.names is the host of proxy or the host configured for usage by FLS. If there are several hosts, specify them separated with a comma.

  3. Start FLS
  1. Stop FLS
  2. Execute in the command line with Administrator permissions:
    <fls_home>\bin\license-server.bat configure \ --virtual-hosts=proxy-server.mydomain.com,proxy-server2.mydomain.com,host3

    where value of --virtual-hosts is the host of proxy or the host configured for usage by FLS. If there are several hosts, specify them separated with a comma.

  3. <fls_home>\bin\license-server.bat configure \ --virtual-hosts-default=all-known **or** local **or** none
  4. Start FLS

Where virtual-hosts-default is MSI-based-only parameter, accepts one of these values:

none - by default, no virtual hosts are added. If the property “virtual-hosts” is also not set, then the virtual-hosts list is empty and there will be no restriction applied on the "Host" header.

local - by default, the list of virtual hosts contains all the local interfaces of the server including the configured "listen" address and server hostnames.

all-known - by default, the list of virtual hosts contains all the network interfaces of the server including the configured "listen" address and server hostnames.

Last modified: 5 August 2019