Install or update the maintenance key

Information on methods for installing or updating the maintenance key for a Genero Report Writer for Java, C# and PHP and Genero Report Engine (GRE) installation.

A maintenance key is provided with your maintenance contract. The key indicates the day that the maintenance contract expires. If you are licensing the product, you will be prompted for the maintenance key during the licensing process.

If you have purchased a new maintenance contract, you only need to install the new maintenance key. You do not need to reinstall your license, or uninstall the old maintenance key.

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

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 maintenance key, you must have a valid maintenance 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 maintenance key as it will be retrieved automatically and installed for you.

To install the maintenance key, choose from one of the following command line options:

If you do not have internet access, run the required command:
- To install the maintenance key for Genero Report Writer for Java, C# and PHP, run the following command:
  grxWrt -m <maintenance-key>
- To install the maintenance key for Genero Report Engine, run the following command:
  greWrt -m <maintenance-key>
Where <maintenance-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 maintenance key for Genero Report Writer for Java, C# and PHP, run the following command:
    grxWrt -m auto
  - To install the maintenance key for Genero Report Engine, run the following command:
    greWrt -m 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 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

Use the Genero Licenser to Install or Update the Maintenance 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 or update the maintenance 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 Maintenance Key field, enter the maintenance key and select Update key. A window pops up displaying “Maintenance key successfully installed”.
- The Licensing status field is updated; “temporary information stored” has been replaced with “License installation successful”.
- In the field under Licensing status you will see the maintenance expiry date appears after the End of maintenance date: This means that your maintenance key is valid until the date displayed.
Your product is now fully licensed.
Select Quit to exit the dialog.