Import license from another installation

Licenses can be moved from one Genero installation to another.

When you move a license, you take a license from one Genero installation and make it available to another. The license is no longer available in the installation it was moved from.
Tip:

Moving a license is an alternative to uninstalling and reinstalling a license. An additional advantage is that you do not need to reactivate the license by registering it with Four Js.

For example, if you need to install a new product version, install it in a directory separate to your existing product installation. Move the license from your existing product installation using the fglWrt/greWrt import-license command. In the worst case scenario that the move fails, you can move the license back into your old installation.
  • A Genero BDL license can be moved to another Genero BDL installation or to a License Manager.
  • A license can be moved from one License Manager to another License Manager.
  • A license installed in a License Manager can be moved to a Genero product installation.
Licenses can be moved from any Genero product version to a different product version provided:
  • The source and target installations are on the same system.
  • The licensing tool in the target installation is 6.00.13 or greater or can be upgraded to run in compatibility mode with a license tool 6.00.13 or greater.
For details, refer to Table 1. The actions you can take depends on the version of the licensing tools in the target installation.
Table 1. Moving a license to a Genero installation
Target Description Actions

Genero product using licensing tools 6.00.13 or greater

The licensing tools in the target installation have the import-license feature.
  • Run the import license command: fglWrt/greWrt import-license

Genero product running in compatibility mode using licensing tools 6.00.13 or greater

The licensing tools in the target installation have the import-license feature.
  • Run the import license command: fglWrt/greWrt import-license

Genero product using licensing tools 5.20

The licensing tools in the target installation need to be brought up to version 6.00.13 or greater to use import-license.
  • Patch the license controller to 6.00.13 or greater.
  • Run the import license command: fglWrt/greWrt import-license
  • Set compatibility mode:

    set flm.server="compatv6" in the product installation /etc/fglprofile file.

Scenarios when you may need to move licenses

  1. You licensed a Genero 3.21 installation (license controller version 6.00.13 or greater) and you want to move the license to another Genero 3.21 installation (license controller version 6.00.13 or greater). In this example, the Genero BDL license in the specified directory is imported into the current installation:
    fglWrt import-license --from /opt/fourjs/fglgws
  2. You licensed a Genero 3.20 installation (license controller version 5.20) and you want to move the license to a Genero 3.21 installation (license controller version 6.00.13 or greater). In this example, the Genero BDL license in the specified directory is imported into the current installation:
    fglWrt import-license --from /opt/fourjs/fglgws320
  3. You licensed a Genero 3.21 product installation (license controller v6.00.13 or greater) and you want to move the license to a Genero 3.20 installation (license controller version 5.20). In this example:
    1. Patch the license controller in the Genero 3.20 installation to bring it up to version 6.00.13 or greater.
    2. Import the Genero license in the specified directory to the 3.20 installation:
      fglWrt import-license --from /opt/fourjs/fglgws321
    3. Configure the Genero 3.20 installation for compatibility. Set flm.server="compatv6" in the product installation /etc/fglprofile file.
  4. You have a License Manager 5.20 installation and you want to move a license to a Genero 3.21 product installation (license controller version 6.00.13 or greater). In this example, the specified license from the License Manager 5 installation is moved into the current Genero installation:
    fglWrt import-license --from /opt/fourjs/flm5  --license XXX#XXXXXXX
  5. You want to upgrade a license version 5.20 to version 6.00 in a Genero installation. In this example, fglWrt import-license upgrades the license in the current product installation directory if it is a license version 5.20:
    fglWrt import-license

Log files and debugging

The output from a command to move a license is recorded in a log file. Log files are found in the Genero installation /etc/license directory where the command is run.

Log filenames are in the format move-license.log. If more than one log file is present, the most recent log will have the highest number in the sequence: move-license.1.log, move-license.2.log, and so on.

The log file records the event of moving a license. It contains the result of the analysis of the source and destination installations. If the move is successful, the details of where the license was moved from and moved to is given. If the move fails for some reason, such as the license.dat file not found, the cause is explained in detail in the file. This file is useful if you need to troubleshoot issues moving a license.