Configure the license controller for a reserved license

To configure the license controller to use a reserved license, edit the license controller configuration file.

It is assumed you have reserved a license for users as described in Reserve licenses for a group of users, and that your product is configured to use the FLM server. For details of how to configure the license controller to use the FLM, see Configure a Genero license controller.

In this task you will configure your product to use the licenses reserved for the QA users.

Locate your product's license controller configuration file.
Table 1. Genero products and license configuration files
Genero product Default license controller configuration file
Genero Business Development Language (BDL) $FGLDIR/etc/fgllicense
Genero Report Engine (GRE) $GREDIR/etc/grelicense
Tip:

Default locations of the license controller configuration files are shown. You can set the location of these files by using the FGLLICENSE or GRELICENSE environment variables.

  1. Open your license controller configuration file for editing.
  2. Change the configuration to use the "qa" reservation:
    1. Comment the line with the license number number=TAB#XXXXXXXX if it exists.
      An error is thrown if you configure both the license number and license reservation.
      (FLM-124): Warning, license.number and license.reservation are both configured.
      The license reservation is used and the license number is ignored.
      Check your license configuration.
    2. Add the line, reservation=qa

      The license controller configuration file should look like this:
      [server]
      host=localhost
      port=6800
      
      [license]
      reservation=qa
      
  3. Check that your license configuration is taken into account at runtime.
    1. 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.
    2. At the command line type the command flmprg -a info users to check the active users while the demo application is running.
      License      : TAB#XXXXXXX
      License key  : BBBBBBBBBBB
      Product      : Four Js Universal Compiler
      Type         : Development version
      Users        : 0/75
      
      Reservation  : svc
      License      : TAB#XXXXXXXX
      Users        : 0/10
      
      Reservation  : qa
      License      : TAB#XXXXXXXX
      Users        : 1/15
      Host         : amon
          FrontEndId2 {7206b94c-9225-4dcd-acdd-4751d5d43f9d}
              GUI Server amon:0 - Process Id 587639
                  creation-date: 2021/10/28 07:58:07
                  ping-date: 2021/10/28 07:58:07
                  cx-mode: direct
                  app-id: {c4bfb184-3b56-5e0f-d0a1-92909024d06f}
                  user-name: jdoe
                  host-addr: 127.0.1.1
                  host-name: amon
      The application should show one active reserved user (qa) over the max reserved users allowed for the license; Users : 1/15 in the sample output above.