License environment variables

These environment variables are relevant for the licensing tools.

FGLLICENSE

The FGLLICENSE environment variable specifies the Four Js License Controller configuration file for BDL (fglWrt).

The default license configuration file is at $FGLDIR/etc/fgllicense. If the environment variable is not set, the default configuration file is used.

When the FGLLICENSE environment variable is set, it specifies the path to the configuration file. Multiple configuration files may be used. For examples, see Do I need multiple license controller configuration files?.

When defining multiple license configuration files, the filenames must be separated by the operating system specific path separator. The path separator is ":" on UNIX® platforms and ";" on Windows® platforms.

on UNIX:
export FGLLICENSE=/mydir/fgllicense.dev:/mydir/fgllicense.base

on Windows:
set FGLLICENSE=c:\mydir\fgllicense.dev;c:\mydir\fgllicense.base

GRELICENSE

The GRELICENSE environment variable specifies the Four Js License Controller configuration file for Genero Report Engine (greWrt).

The default license configuration file is at $GREDIR/etc/grelicense. If the environment variable is not set, the default configuration file is used.

When the GRELICENSE environment variable is set, it specifies the path to the configuration file. Multiple configuration files may be used. For examples, see Do I need multiple license controller configuration files?.

When defining multiple license configuration files, the filenames must be separated by the operating system specific path separator. The path separator is ":" on UNIX platforms and ";" on Windows platforms.

on UNIX:
export =/mydir/:/mydir/

on Windows:
set =c:\mydir\;c:\mydir\

FLM_BYPASS_UAC

The FLM_BYPASS_UAC environment variable disables the User Account Control (UAC) prompt in a Windows system.

In a Windows system, some fglWrt or greWrt commands will only work if run as administrator, and a Microsoft® User Account Control (UAC) prompt will be raised to open an elevated command terminal where you can complete the action.

When the FLM_BYPASS_UAC=1 is set, the UAC prompt is disabled.

Be aware that with the UAC prompt disabled, you will need to open a terminal with "Run as Administrator" to run commands that need administrator privileges.

FLM_UMASK

The FLM_UMASK environment variable can be defined to set file permissions for directories that are part of the license installation and configuration for your product.

Warning:

The FLM_UMASK feature is available on UNIX-like platforms only.

FLM_UMASK sets a umask value, which removes, or masks out, permissions. The default permissions for directories is 777, which is the maximum level of permissions for all three user classes – from left to right – the owner, group, and others. It is calculated from the 8-bits of data that assigns read (4), write (2), and execute (1) permissions and combinations of those.

By applying a umask value, you can reduce the default permissions down to more secure levels. For example, 755 would give the owner permissions to read, write, and execute, while everyone else can read and execute (4+1=5) but cannot make changes to files within the directory.

Umask values are represented as four Octal digits (for example, 0077), with the first digit always set to zero. It works as an inverse of the permission values; subtracting the umask value from the default permissions gives you the actual permissions. If a permission is set in the umask value, it will not be set in the permissions applied to the directory:

0: No permissions are removed.
1: The execute bit is unset in the permissions.
2: The write bit is unset in the permissions.
4: The read bit is unset in the permissions.

For example, if you are removing write permissions from group and others, to yield the eventual permissions of 755, you set FLM_UMASK to 0022. The umask value is subtracted from the default permissions, 777-022=755.

You can set the UMASk value in either the license controller configuration file or the FLM_UMASK environment variable.

If both the license controller configuration file and FLM_UMASK are defined, the FLM_UMASK value takes precedence. The environment variable, FLM_UMASK, can be used to override configured values.
If permissions are not defined, the default umask value is applied as shown in Table 1.

Table 1. Directory permissions environment
Package	Environment variable	Default umask value	Use	Directories
FLM	FLM_UMASK	0077	Set a file permission mask for directories that are part of license installation and configuration for FLM license manager.	$FLMDIR/lock $FLMDIR/etc Log directory as defined in the FLM configuration file, $FLMDIR/etc/flmprofile
FGLGWS	FLM_UMASK	0000	Set a file permission mask for directories that are part of license installation and configuration for the Four Js License Controller for BDL (fglWrt).	$FGLDIR/lock $FGLDIR/etc Log directory as defined in the license controller configuration file, $FGLDIR/etc/fgllicense
GRE	FLM_UMASK	0000	Set a file permission mask for directories that are part of license installation and configuration for the Four Js License Controller GRE (greWrt)	$GREDIR/lock $GREDIR/etc Log directory as defined in the license controller configuration file, $GREDIR/etc/grelicense

on UNIX:
export FLM_UMASK=0022