Floating License Guide


Contents

1. Overview

A floating licensing model allows customers to use CAD Exchanger Lab on multiple PCs at the same time. A floating license is tied not to the end-user seats, but to the license server. Thus, CAD Exchanger Lab can be used on any PC connected to this license server. Simultaneously, this license can be used by a limited number of end-users. If one more user wants to use CAD Exchanger Lab, any other user should stop using this license.

License manager
License manager

Accordingly, a floating license model involves two components: license server and client. A license server should be deployed on the server by the system administrator. This server regulates the distribution of licenses to end-users of CAD Exchanger Lab (within the license count).
A client component is a regular CAD Exchanger Lab (3.9.2 or higher).
When CAD Exchanger Lab requests the license from the license server, the latter checks if there are free licenses in the pool. If so, the license server allows the end-user to use CAD Exchanger Lab, decreasing the count of available licenses. When the end-user stops using CAD Exchanger Lab, the license is returned to the license server.

2. Requirements

A floating licensing model has the following technical requirements:

  • Client and server communicate over TCP protocol, therefore, there should be the opportunity to establish such connection. By default, TCP port 6200 is used, however, it can be changed. It is also needed to check firewall settings and make sure that it does not block this TCP connection.
  • The license server should be deployed on a physical machine. The use of virtual machines is not allowed.
  • Floating license is tied to the MAC address of a computer running the license server. For uninterrupted operation it is required that the network device to which the license is tied remains in the computer.
  • Currently, a floating license model is supported only on Windows (64 bit) for both server and client.

3. Setup Floating License server

3.1. Installation

  • Download the .zip file from here.

  • In order to verify download correctness, the following MD5 checksum can be used for comparison: 42eb9de60bd7f2441820cb50b76051c9

  • Extract the contents of .zip file. It contains 2 files:

    • the installer (lmx-enduser-tools_win64_x64.msi)

    • the library (liblmxvendor.dll)

      DLL
      DLL

  • Run the installer and follow instructions. Make sure the following options are set:

    • Install LM-X License server

    • Path to "liblmxvendor.dll" file

    • Install the license server as a service (recommended)

      License Server
      License Server

3.2. Configuration

Once the server is installed, it should be configured by editing lmx-serv.cfg file located in the installation folder (by default, C:\Program Files\X-Formation\LM-X End-user Tools 5.0 x64):

  • Optionally, specify the IP address(es) and TCP port to listen, for example:
    TCP_BIND_ADDRESS = 192.168.0.1
    TCP_LISTEN_PORT = 6200
  • If the logging should be enabled, specify the path to the log file:
    LOG_FILE = C:\path\to\log\file.log
  • Set the path where the license will be located:
    LICENSE_FILE = C:\path\to\license\file.lic
    Or just place the license file in the installation folder.
  • It is highly recommended to change the password for remote access to the server:
    REMOTE_ACCESS_PASSWORD = MyNewPassword.

A detailed description of these settings can be found in lmx-serv.cfg file.
Note: Since the license server and CAD Exchanger Lab communicate over TCP protocol, the incoming connections over the specified port should be allowed. If the ability to search for the license server automatically will be used, the incoming connection over the UDP port 6200 also should be allowed. By default, an Inbound port rule should be created, however, the scenario can differ depending on the used firewall.
Once the license server is configured, it can be started by running lmx-serv.
If the server has already been configured earlier, the further configuration can be performed via Java GUI by running LicserverClient.jar when the server is running (Java required).

4. License activation

To activate license for the first time and start using CAD Exchanger Lab, the following steps should be done:

  1. Run CAD Exchanger Lab (3.9.2 or higher).

  2. Open the license panel:

    1. If you are using an evaluation license, click "Buy".

      Evaluation
      Evaluation

    2. If you have an active node-locked license, press "Esc", go to the information panel (in the bottom-left corner) and click "Renew".

      Renew
      Renew

    3. If the evaluation period has expired and there is no active node-locked license, then click "Buy".

      Buy
      Buy

  3. Click "Manual activation" at the bottom.

    Manual Activation
    Manual Activation

  4. Switch to the "Floating" tab.

    Floating
    Floating

  5. Choose one of 2 ways to look for the license server:

    1. The user can use an automatic server discovery. In this case, CAD Exchanger Lab will look for the server automatically without any additional actions.

      Automatic license server discovery
      Automatic license server discovery

      However, this approach has additional requirements:

      • Automatic server discovery is performed by broadcasting over UDP protocol (6200 port, cannot be changed). So, broadcasting over UDP 6200 port should be permitted;
      • This approach can be used only in local area networks (no VPN or Internet).
    2. The user can use an IP address or domain name to find the server (Automatic server discovery is disabled). The communication can also be performed over the VPN or the Internet. So in this case, the user has to set the host (IP address or domain name) and the port of the server.

      Disabled automatic license
      Disabled automatic license

  6. Click "Activate"
    If the activation is successful, the corresponding message will appear on the panel:

    Success activation
    Success activation

    In most cases, the activation proceeds instantly. However, if the network is heavily loaded or the connection is not stable, the process may take up to 30 seconds.
    If a problem has occurred during the activation process, please refer to the Troubleshooting section to resolve it.
    CAD Exchanger Lab remembers the last successful floating license activation and will try to obtain the license from the same server automatically when CAD Exchanger Lab will be started the next time.

5. License deactivation

The license is returned to the license server automatically when the application is closing. However, the user can do this manually by opening the Information panel (in the bottom-left corner) and clicking "Disable floating license".

Disable floating license
Disable floating license

6. Pre-purchase verification

To verify if a floating license model can be used before purchase, one should follow the deployment instructions except for placing the license key in the license server. If the setup is successful, CAD Exchanger Lab will display the following error message on activation: "No license on the license server".

7. Troubleshooting

7.1. Activation issues

When the floating license activation in CAD Exchanger Lab fails, one of the following error messages appears:

Message Description Solution
No connection to a network The computer does not have the network adapter or is not connected to the network. Make sure that your computer is connected to the network.
No connection to the license server The license server is not found. If you use automatic license server discovery, make sure that your computer belongs to the same local network as the license server. If you do not use automatic license server discovery, double check that you specified the host and port of the server correctly. Make sure that the license server is running. The server may be not allowed to listen to the required ports.
A TCP connection failed Your firewall may be blocking a TCP connection, or the connection to the server may be slow. Check your firewall settings whether it blocks TCP connection. Try to activate the floating license again.
No permissions to establish the connection The connection is rejected by the server. Make sure that the server is not configured explicitly to reject the connections from this client computer.
No license on the license server The license server does not serve the license. Make sure that the path to the license in the license server’s configuration file corresponds to an existing valid license. This error message also occurs during pre-purchase verification, signifying that the verification was successful.
No available licenses. Please wait until someone releases the license All of the licenses are in use at the moment. Wait until one of the other users will stop using CAD Exchanger Lab and return the license to a pool.

If you see one of the error messages above, please contact your system administrator first. If the problem will not be resolved, then contact support@cadexchanger.com.

7.2. Connection loss

Since a floating license is a network license, the connection to the license server should be kept at all times when client CAD Exchanger Lab is running. When the connection is lost, CAD Exchanger Lab notifies about that and continues working for the next 2 minutes. If during this time the connection is re-established, CAD Exchanger Lab will continue working. Otherwise, the license will be deactivated. License server will return this license to the pool automatically. If the connection is lost and the license is deactivated, CAD Exchanger Lab will try to find the local license used earlier. If such a license exists, it will be used and CAD Exchanger Lab will continue working. Otherwise, the floating license should be activated again, when the connection problem is resolved.

Floating license not acquired
Floating license not acquired