Four Js License Manager (FLM) Quick Start

This quick start walks you through a basic configuration of the Four Js License Manager (FLM), to include installing a Genero license.

This quick start is divided into three sections, which must be completed in order.

Configure the Four Js License Manager

In the first part of this quick start, you will configure the license manager.

The Four Js License Manager (FLM) configuration file is $FLMDIR/etc/flmprofile.

  1. If running, stop the FLM at the command line.
    1. Open a command prompt.
      • On Windows®, right-click on the License Manager Workplace Window from the Start menu and select Run as administrator.
      • On Linux®/UNIX®/macOS™, open a command prompt. "sudo" may be required.
      Tip:

      When you use the License Manager Workplace Window, the environment is set for you. If you are using a different command line interface, run the $FLMDIR/envflm script before starting. This ensures that the environment is set for the Four Js License Manager.

    2. Type flmprg -s

      The FLM service is stopped.

  2. Configure the License Manager.
    Edit the FLM configuration file ($FLMDIR/etc/flmprofile). To set the value for the FLM server resource, update the host entry under the server element with the name of your host. The default is localhost.
    [Server]
    # FLM host 
    host=localhost 
    
    # Default service port
    port=6800

    For more information on FLM configuration, see Configure the License Manager.

  3. Start the license manager at the command line.
    1. Open a command prompt.
      • On Windows, right-click on the License Manager Workplace Window from the Start menu and select Run as administrator.
      • On Linux/UNIX/macOS, open a command prompt. "sudo" may be required.
    2. Type flmprg -r

      The FLM service is started.

  4. Test your license server configuration.
    Use the command flmprg -a env to output the configuration. Entries are written to stdout:
    FLM server: localhost
    FLM service: 6800
    # ...

In the next part of this quick start, you will configure the product's license controller configuration file.

Configure the Genero product license controller

In the second part of this quick start, you will configure the product's license configuration file, providing details about and for the FLM server.

Each Genero product has a license controller configuration file, as identified in Table 1.
Table 1. License controller configuration file
Package (version) Configuration file (no extension)
FGLGWS $FGLDIR/etc/fgllicense
GRE $GREDIR/etc/grelicense
  1. Specify server and license details in the product license controller configuration file.
    1. For example, to configure licenses for your FGLGWS installation, edit the $FGLDIR/etc/fgllicense file.
      Update the host entry under the server element with the name of your host:
      [server]
      host=hostname 
      port=port     # Default is 6800
    2. To set the value for the license number, add the line in the following format under the license element with the product's license number:
      [license]
      # License to use with FLM service
      number=license_number
      For more information on license configuration, see Configure a Genero license controller.
  2. Test your license configuration locally.
    Use the license controller command fglwrt -a env to output the configuration. Entries are written to stdout. You should see details of the license manager in the output.
    Hostname: DESKTOP-CC
    FLM server: localhost
    FLM service: 6800
    User check: 10
    #...

In the next part of this quick start, you will install your product license on the FLM.

Install a license

In the last part of this quick start, you will install your product's license with the FLM.

Note:

While this quick start uses the license string to install the product license with the FLM, you do not need to use a license string. You can also use your license number, license key, and customer login, by following the procedures listed under Steps to licensing with FLM.

If you are not provided with a license string, you can generate a license string from your license number, license key, maintenance/subscription key, and login. For instructions on how to generate a license string, see Encode a license string.

For this quickstart, you will install the product license on the FLM.

  1. Start the command line interface.
    Open a command prompt.
    • On Linux/UNIX/macOS, open a command prompt. "sudo" may be required.
    • On Windows, right-click on the License Manager Workplace Window from the Start menu and select Run as administrator.
  2. Install license on the FLM.
    Type the command flmprg --install-license-string license-string auto

    For this command you need a license string. This command validates the license with Four Js over the internet. For more information on installing licenses, see Steps to licensing with FLM.

  3. Test your license configuration.
    1. Use the command flmprg -a info license to output the license information. The FLM writes information about the license to stdout.
    2. To check that your license configuration is taken into account at runtime, run the gwc-demo application on the host where the product is installed.
      Start an instance of the Genero Desktop Client (GDC). In the FGL demo directory ($FGLDIR/demo) run the command fglrun demo.42m.
      The application should launch without error messages.
    3. At the command line type the command flmprg -a info users to check the active users while the demo application is running.
      License      : TAB#AAXXXXXX
      License key  : XYYYYYYYYYYY
      Product      : Four Js Universal Compiler
      Type         : Development version
      Users        : 1/10
      Host         : DESKTOP-CC
          FrontEndId2 {664c8963-6f9f-4b92-bc62-bab5961227ab}
              Process Id 11068
                  creation-date: 2021/07/09 09:51:44
                  ping-date: 2021/07/09 09:51:44
                  cx-mode: direct
                  app-id: {d2bb5dab-8651-f871-7b23-08e5dd255f5b}
                  user-name: jodo
                  host-addr: 127.0.0.1
                  hw-addr: 0A-00-27-00-00-09
                  host-name: DESKTOP-CC
      The application should show one active user over the max users allowed for the license; Users : 1/10 in the sample output above.