thinkproject


Setup Guide for a
DESITE BIM on-premise license server

rev. 2021-02-03


thinkproject DESITE BIM applications use a Flexera licensing system (from version 2.6.0 onwards).
This guide describes how to setup an on-premise license server (or LLS, for local license server) in case that using the more comfortable cloud licensing system is prohibited by your company's policies and/or technical restrictions.

For customers who have had past experience with Flexera licensing technology, a short note and clarification on terminology:
The LLS product's official name is "FlexNet Publisher" (or FNP in short), but you may know it under its former name "FlexLM" - common spelling variations are "Flexlm", "FLEXlm", and possibly some others.
This guide will refer to it just as "the license server" in an attempt to avoid confusion.

The setup can be roughly divided into 3 phases:

  1. Get the licensing toolkit and identify the server machine.
  2. Generate the license file in the thinkproject Licensing Customer Portal.
  3. Install the license server with the license file on the server machine.


  1. Get the licensing toolkit and identify the server machine

    1. Go to the machine designated for running the license server and log in. You will probably need administrative privileges to make any changes.

    2. Download the thinkproject license server toolkit file and unzip the contents into a new directory. The files unzipped into the directory will be:

      lmgrd.exe - the license server
      lmhostid.exe - a host ID utility (command line)
      lmtools.exe - management utilities (GUI)
      thinkprj.exe - thinkproject's vendor daemon
      							

    3. Run lmhostid.exe to determine the MAC address of your server machine that the license will be bound to. You should see something like this:

      lmhostid

      Please copy out the host ID that the tool retrieved. You will need it in the license generation process.
      Note: The tool may return multiple IDs (separated by spaces) if your machine has more than one ethernet adapter. In such a case, please just pick one.



  2. Generate the license file in the thinkproject Licensing Customer Portal

    1. Go to the thinkproject Licensing Customer Portal and log in. You can either do so by using your email and password, or the Entitlement ID that you will find in your license notification email (upper right corner).

    2. Go to "Activation & Entitlements" -> "List Entitlements"

      list entitlements

    3. In the list that comes up, please tick the checkbox in front of the license that you wish to activate.
      Then, please choose "Action" -> "activate"

      activate

    4. You should now be seeing a screen similar to the one below. Please click "Next".

      activate licenses (1)

    5. On the upcoming screen, you must configure the license server host. Please click the green + sign to do so.

      configure hosts (1)

    6. From the "Server Hosts" drop-down, please select "ETHERNET".

      create license host (1)

    7. Enter the host ID determined in phase 1 (lmhostid).

      create license host (2)

    8. Click "OK", then "Next".

    9. On the next screen, you need to enter the fulfill count, which is the number of licenses that the specified host will manage and distribute.
      You can use a lower amount than the total quantity, e.g. when you want to split the available licenses over various license servers. In the example picture below, the fulfill count is 2 out of 6.
      The most common scenario, though, is putting all licenses on one server. In that case, set fulfill count to the full quanity, which you see in column qty.
      Accept the setting by clicking "Next".

      configure counts

    10. License generation is about to be completed. You should now be seeing a screen like shown below, where you can once again review all the settings you made:

      review

      If you want to change any of the settings, click "Back".
      To have the licensing system check your settings for completeness and consistency, you can (optionally) click "Verify". The result should look like this:
      verification

      Finally, click "Generate".

    11. You will be presented with a final summary, similar to the one below. Click "Complete".

      license summary

    12. The license has been generated, now what is left to do is downloading the actual license file to deploy to your server.
      Go to "License Support" -> "List Licenses".

      list licenses (1)

    13. Mark the checkbox in front of the license we just created.

      list licenses (2)

    14. Choose "View" -> "Save to file".

      save to file

      You can choose a location and a file name at will. For convenience, it makes sense to put the file into the same folder as the one containing the license server toolkit (See phase 1).
      For this tutorial, the file will be named "desiteLicenseFile.lic".



  3. Install the license server with the license file on the server machine

    Note: You must make sure that your server system's firewall does not block the license server's communication. The easiest way to do that is to configure firewall exceptions (both outgoing and incoming) for lmgrd.exe.
    There is also the possibility to configure the license server to use specific ports and then opening just those ports in the firewall. This approach is covered by a separate documentation, but it is recommended to finish the basic setup first.


    1. From the directory on the server machine that holds the licensing toolkit (from phase 1) as well as the license file (from phase 2), run the following command:

      lmgrd -z -c desiteLicenseFile.lic								
      							
      The result should look similar to this:

      lmgrd

    2. With the license server now up and running, try to check out a license in DESITE running on a client machine.
      In the license dialog, switch to the "Concurrent User" tab and make sure that the "Use a local (on-premise) license server" checkbox is ticked.
      As "Server Address", enter the network address of your license server machine.
      Click "Check Out".

      desite license settings (1)

    3. With everything working correctly, you should get a "License checked out" response.

      desite license settings (2)

    4. Having a look at the license server again, lmgrd should have printed additional lines such as the following:

      (thinkprj) OUT: "DESITE_md" yourUser@yourMachine
      (thinkprj) OUT: "DESITE_md_pro" yourUser@yourMachine
      							
      (Obviously, this will differ depending on the product being licensed. You will only see the first line if you have not purchased the pro features. Or you may see "DESITE_custom", "DESITE_share_pro", etc.)

    5. With the license server running, we could wrap it up here. However, what you probably want to do is to set up lmgrd as a Windows service to automatically start up each time the machine is rebooted.
      There are several ways how you can set this up; the following steps describe how to do it with the help of lmtools.exe, which comes with the thinkproject license server toolkit.

      Shut down the license server that you have started manually in 3.1, and open up lmtools.exe.
      Switch to the tab "Config Services".

      lmtools (1)

      1. Assign a name to the service: in this example we call it "DESITE BIM licensing service". You can choose any name you like. It is, however, advised to choose a name that will help you find the service in the list of all Windows services as well as distinguish between different Flexera services, in case you are running more than one.

      2. Type or use the browse button to define the location of the license server program, lmgrd.exe. In this example, we use a directory called C:\tpLicSrv.

      3. Type or use the browse button to define the location and name of the license file. In this example, it is C:\tpLicSrv\desiteLicenseFile.lic.

      4. Type or use the browse button to define the location and name of the log file. This file can be useful if problems arise. It does not have to be in the same location as the licensing toolkit, nonetheless, we are using it again here to keep things simple: C:\tpLicSrv\debug.log.
        Note that writing permissions to this directory are required.

      5. Check the box labeled "Use Services". This will install it as a Windows service.

      6. Check the box labeled "Start Server at Power Up". Windows will start the service automatically each time the computer is rebooted.

      7. Click on "Save Service".

      8. At his point you have configured the license server as a Windows service, however, it has not been started yet.
        Switch to tab "Start/Stop/Reread", select the service we just configured, and press "Start Server".

        lmtools (2)

        You should see the message "Server Start Successful."





thinkproject Deutschland GmbH
Zamdorfer Strasse 100, 81677 Munich, Germany. email: info@thinkproject.com