Install the installation key

Enter the installation key with either the license controller -k command or the Genero Licensing Application tool.

About this task:

After installing the license number and license key, you need to install an installation key. The procedure in this topic describes the installation of the installation key for Genero Report Writer for Java, C# and PHP installations using the grxWrt license controller and Genero Report Engine (GRE) using greWrt. Alternatively, you can use Genero Licensing Application tool, see Use the Genero Report Engine for Java Licenser to Install the Installation key..

Note: This procedure is valid for a local license only. If you are using the Four Js License Manager, see the "Add a License to Four Js License Manager" topic in the Four Js License Manager User Guide.

Important: You can run the command to install an installation key whilst users are on the system. They will not be affected by this procedure.

Before you begin:

You must be the root user or the user who installed the software to run the grxWrt or greWrt commands.
You must have set your Genero environment, if you wish to run the grxWrt or greWrt commands from any directory

Before you begin a manual installation:

If you intend to manually install the installation key, you must have a valid installation key to hand, see Register a local Genero Report Writer license. If you do not have this, please contact your local Four Js support office.

Before you begin an automatic installation:

If you intend to use the auto option to automatically complete licensing over the internet:

You must have the Customer Code delivered by Four Js with your product. Typically, this is delivered by email with license number, license key, and maintenance key. If you do not have a Customer Code, please contact your local Four Js sales office.
You do not need the installation key as it will be retrieved automatically and installed for you.

Choose from one of the following command line options:

If you do not have internet access, run the required command:
- To install the installation key for Genero Report Writer for Java, C# and PHP, run the following command:
  grxWrt -k <installation-key>
- To install the installation key for Genero Report Engine, run the following command:
  greWrt -k <installation-key>
Where <installation-key> is the installation key. You should receive a message to say the license installation was successful.
If you have internet access from the machine you are installing, you can complete licensing automatically using the auto option.
1. At the command prompt type the required command:
  - To install the installation key for Genero Report Writer for Java, C# and PHP, run the following command:
    grxWrt -k auto
  - To install the installation key for Genero Report Engine, run the following command:
    greWrt -k auto
2. At the prompt:
  Enter your customer login >
  Type your:
  Customer Code
3. At the prompt for proxy configuration:
  Do you need to configure an HTTP proxy ? (y/n)
  enter:
  n
  
  Note: If you enter y, you will be prompted for the required proxy information.
  The maintenance key is also retrieved from the Four Js Activation server and is displayed.
```
Installing maintenance key 'S7MO51KGYR7Z'
License installation successful.
```
  License installation is now completed. To check your license status, see Get license information

At this point: If you need to install the maintenance key, see Install or update the maintenance key.

Use the Genero Report Engine for Java Licenser to Install the Installation key.

You also have the option of using the Genero Licenser Application tool, which provides you with a graphical user interface to the licence controller. This task shows you how to install an installation key using the Genero Report Engine for Java Licenser.

Launch the required Licensing Application tool.
- For Genero Report Writer for Java, C# and PHP licensing, launch the Genero Report Engine for Java Licenser from your Four Js program list.
- For Genero Report Engine licensing, launch the Genero Report Engine Licenser from your Four Js program list.
Figure 1. Genero Report Engine for Java Licenser
In the Installation Key field, enter the installation key and select Install key
Select Quit to exit the dialog.