How to setup a license server

There is detailed documentation on FlexNet licensing in the document entitled “FlexNet Publisher License Administration Guide” (LAG). This how-to will refer to sections in that document where appropriate.

Prerequisites

To set up a license server you first need to select a machine to use as a server. See the LAG Chapter 8 on page 65 “Selecting a License Server Machine”. Once you have chosen a platform, you then download the correct license server zip file for your server platform. We provide daemon tools for the following platforms:

  • Microsoft Windows 32-bit and 64-bit
  • Linux LSB 32-bit and 64-bit
  • Mac OS X
  • Solaris, 64 bit Intel/AMD platform

Step-by-step guide

  1. Install daemons
    Unzip the license server zip file which will create a folder with the same name as the zip, for example on OS X the folder will be called something like “deltaxml-license-server-macos-1_0”.
    The daemon executables may be found in the bin sub-folder.
    There are two ways of running and controlling license servers:
    • Command line tools lmgrd, lmstat, lmdown etc. (See LAG page 97 “lmgrd”)
    • A browser based GUI called lmadmin (See LAG page 69 “lmadmin”).
    Note that on the Windows platform there is also a Windows desktop GUI tool called lmtools.exe which provides a graphical equivalent of the command line tools.
  2. Choose your preferred option and install by placing either the command line executables or the contents of the lmadmin folder on to your server system.
  3. Startup and shutdown
    The automated startup and shutdown of both types of license servers is described for Windows and Unix-style platforms in the LAG. See Chapter 10 for lmgrd and Chapter 9 for lmadmin.
    On Windows lmgrd can be installed as a service using the command line tool "installs.exe" included in the zip for the Windows platform. 

    Example install as service: 

    installs.exe -c C:\licensing_redist\deltaxml.lic -e C:\licensing_redist\lmgrd.exe -n "DeltaXML License Manager" -l C:\licensing_redist\logs
     
  4. Configure an Options File
    An options file allows you to further control licensing within the constraints of the license model.  See LAG Chapter 13 “Managing the Options File”.
    For concurrent user licenses the options file should contain one line for each named user in the following form:
    INCLUDE <product-name> USER <user-login-name>
    You will need to modify the vendor line of the license file to point to the options file. For example if the options file is called "deltaxml.opts" you would add "OPTIONS=deltaxml.opts" to the end of the vendor line of the license.
  5. Monitor the Logs
    See LAG Chapter 21 “Report Log File” and Chapter 22 “Debug Log File” for details of all logging aspects.

#content .code