Four Js License Manager (FLM) Quick Start

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

You must install a Four Js License Manager for this quick start. For more information, go to Install Four Js License Manager.

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

Configure the Four Js License Manager
Configure the Genero product license controller
Install a license

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.

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.
Configure the License Manager.
Navigate to the $FLMDIR and open 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, go to Configure the License Manager.
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.
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 the FLM server and entering the license number you want to use with this installation.

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

Within the License Manager Workplace Window, navigate to your FGL directory and run the envcomp script to set the FGL environment; $FGLDIR/envcomp or %FGLDIR%/envcomp.bat.
Specify server and license details in the product license controller configuration file.
For example, to configure licenses for your FGLGWS installation, edit the $FGLDIR/etc/fgllicense file.
1. Update the host entry under the server element with the name of your host:
```
[server]
host=hostname 
port=port     # Default is 6800
```
2. 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, go to Configure a Genero license controller.
Test your license configuration locally.
Use the license controller command fglwrt -a info 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, go to Encode a license string.

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

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.
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.
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.
(Optional) To stop the FLM at the command line, type flmprg -s.