License GRE from the command line (via internet)

You can license a Genero Report Engine (GRE) product using the command line tool, greWrt.

Internet is required

Before you begin: Internet access is required to activate the license; a temporary installation does not require internet.

Important:

If your installation directory is in the C:\Program Files path, you must run as administrator when you license the product. This avoids any permission issues.

Tip:

Run the envgre script before starting. This ensures that the installation environment for Genero Report Engine is set. For further information, see Installation conventions.

Which procedure should I follow?

To install your license, you must have either a license file, a license string, or your license number, license key, and customer login.

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.

You can install the license using one of these methods:

Install using a license file

For this task you need a license file.

  1. Start the command line interface.
    Open a command prompt.
    • On Linux®/UNIX®/macOS™, open a command prompt. "sudo" may be required.
    • On Windows®, open the Command Prompt from the Start menu .
  2. Install license for your Genero product .
    Type the command fglWrt -f license-file
    The license is installed in temporary mode.
    Important:

    The license number and an installation number is displayed in the output. The installation number is needed for activating the license.

  3. Go to the License your products page on the Four Js web site and follow the procedure described in Register your license.

    With your license registered, you have the required keys.

  4. Activate the license.
    1. Run the following command: 
      greWrt -k lnum
      Replace lnum with your license number.
    2. At the prompt, enter the installation key. 
      Enter the installation KEY (call your vendor to obtain it)

    A message is displayed in the output to say the license installation was successful.

    License installation is now completed.

Install using a license string

For this task you need a license string. This command activates the license with Four Js over the internet.

  1. Start the command line interface.
    Open a command prompt.
    • On Linux/UNIX/macOS, open a command prompt. "sudo" may be required.
    • On Windows, open the Command Prompt from the Start menu .
  2. Install license for your Genero product .
    Type the command greWrt --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.

    The installation of the license is complete.

Install using a license number and key

This process validates your license with Four Js over the internet using your license number, license key, and customer login.

  1. Start the command line interface.
    Open a command prompt.
    • On Linux/UNIX/macOS, open a command prompt. "sudo" may be required.
    • On Windows, open the Command Prompt from the Start menu .
  2. At the command line, enter: 
    greWrt -l
  3. When prompted, enter the license number.
  4. When prompted, enter the license key.
  5. At the prompt: 
    Do you want to continue using HTTP ? (y/n)
    Enter: y
  6. When prompted, enter your customer code: 
    Enter your customer code >
  7. At the following prompt: 
    Do you need to configure an HTTP proxy ? (y/n)
    Enter y if your access to the internet is through a proxy. Provide the required information for HTTP proxy, port, and authentication when prompted. Otherwise, enter n.
    Figure: Installing and registering a license via HTTP with greWrt

    Image shows installation of license using the greWrt command and taking the option for automatic registration of license over the internet
    License installation is now completed.