Install license keys

This topic guides you through the procedure of installing and accepting Guardium® license keys.

Before you begin

  • Download your license keys from Passport Advantage
  • Install or upgrade your Guardium system
  • Verify that the machine type is correctly set for your system

About this task

Installing a Guardium license key is a two-step process: you need to install the license key and then read and accept the terms of the license agreement. After installing a Guardium license key, the user interface will reload to reflect the functionality enabled by the new license.

Establishing a functional Guardium system requires installing both a base and at least one append licenses. The base license must be installed and accepted before installing and accepting any append licenses.

For more information about Guardium license keys, see License keys.

Attention:

When upgrading a Guardium system, you will not need to apply licenses. License keys will be automatically generated based on your preexisting installation, but you will need to review and accept the license agreements before you can begin using your Guardium system. To review and accept licenses on an upgraded system, navigate to Setup > Tools and Views > License and click the Read and accept license link.

Procedure

  1. Log in to your Guardium system as the admin user.
  2. Verify that the Machine Type displayed in the Guardium banner is correct for the system you are licensing.
    The machine type will be one of the following:
    • Standalone
    • Central Manager
    • Aggregator
    Attention: If you are setting up a central manager and the Machine Type indicates an aggregator, convert the system from an aggregator to a central manager using the following CLI command: store unit type manager.
  3. Install a base license.
    1. Navigate to Setup > Tools and Views > License.
    2. On the License page, enter the base key for your system in the License key field and click Apply to continue.
      Attention: Depending on the system you are setting up, you will need to apply either a base collector key or a base aggregator key. A base aggregator key is required when setting up a central manager system.
    3. From the License Agreement dialog, review the license agreement associated with the base key and click Accept when you are ready to accept the terms.
      The Guardium interface will automatically refresh after accepting the agreement, but there will be no change in available functionality after installing a base license key.
  4. Install one or more append licenses.
    Repeat the following steps for each append licence you have purchased and want to install.
    1. Navigate to Setup > Tools and Views > License.
    2. On the License page, enter an append key in the License key field and click Apply to continue.
    3. From the License Agreement dialog, review the license agreement associated with the append key and click Accept when you are ready to accept the terms.
      The Guardium interface will automatically refresh after accepting the agreement, and any new functionality associated with the append license will become available.
    4. Repeat the steps in this section for each append license you want to install.

What to do next

In an environment with a central manager, you can distribute the new licenses by navigating to the Manage > Central Management > Central Management page and clicking the refresh unit info icon to distribute licenses from the central manager to managed units.

In an environment with a central manager, the central manager and its managed units must use the same shared secret. Set the shared secret from the Setup > Tools and Views > System page or by using the CLI command store system shared secret.

License text is also available for download by starting the Guardium fileserver and navigating to opt-ibm-guardium-log/install/[LICR number], where [LICR number] identifies the license you want to download.