Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at docs.hitachivantara.com

 

Hitachi Vantara Lumada and Pentaho Documentation

Manage Pentaho licenses

Parent article

You can manage the licenses from the Pentaho User Console (PUC), Pentaho Data Integration (PDI client), or the command line interface. Licenses for Pentaho software are provided in the form of .lic files.

License files are needed after installation of the software, when subscribing or renewing your subscription, or when these licenses change or expire. If you are a new customer, your Pentaho Welcome Kit will contain the necessary licenses. If you are an existing customer, the licenses will be emailed. If you did not receive your welcome kit, did not receive the licenses, or are having any other problems contact Pentaho Support.

NoteEvaluation Period: Thirty to sixty days after the software evaluation period, the temporary licenses included will expire.

The required licenses for various Pentaho Business Analytics components are listed in the table below. However, your subscription may not feature all of the components or licenses listed.

Required LicenseInstalled Component(s) *
Pentaho Analysis Enterprise EditionAnalysis Design Tools
Pentaho BI Platform Enterprise EditionPentaho Server, Analyzer, Reporting Design Tools, Analysis Design Tools, and Interactive Reporting
PentahoDashboard DesignerDashboard Designer
Pentaho Hadoop Enterprise EditionBig Data drivers
Pentaho PDI Enterprise EditionPentaho Server and Data Integration (ETL)
Pentaho Reporting Enterprise EditionReporting Design Tools
* Please note that drivers and plugins licensed for use with some components have not been included in this table.

Manage licenses using PUC

Follow the procedure below to install the licenses using PUC.

Procedure

  1. Copy your license files to a convenient location.

  2. Log in to the Pentaho User Console.

    If you do not have valid licenses and your user role has administration privileges, the first time you log on, the License page will appear. You must enter licenses.Missing or expired license warning in the PUC
  3. Click the Add button (+) and then browse to the license files that you want to install. Double-click the license to install it.

  4. Repeat the previous step until all needed licenses are installed.

    NoteTo remove unwanted license files, select the files you want to remove then click the Delete button (X). When prompted, click Yes to delete the license.
    The license manager user interface in the Administration window of the         PUC

Manage licenses using the PDI client

Follow the procedure below to install the licenses using the PDI client (also called Spoon).

Procedure

  1. Copy your license files to a convenient location.

  2. Start the PDI client. See Learn about the PDI client for more information on the PDI client

    If no valid license for the PDI client exists, the Pentaho License Manager dialog box appears. You must enter licenses to proceed.
  3. From within the Pentaho License Manager, click the Add button (+).

  4. Browse to the license file that you want to update, then select or multi-select the license file(s) (.lic) you want to install.

    A green check appears in the Status column to indicate that the license file (as displayed in the Product Name column) is correctly installed. The dialog box also provides the version, and installation and expiration dates of the license.
  5. Repeat the previous step until all needed licenses are installed.

  6. Click Close to close the dialog box.

    NoteTo remove unwanted license files, select the files you want to remove then click the Delete button (X). When prompted, click Yes to delete the license.
    The Pentaho License Manager dialog box in the PDI client

Manage licenses using the command line interface

You can set the license path environment variable, install the license files, update the license files, list the license files, or remove license files.

Setting the license path environment variable

To ensure that the Pentaho Server uses the same location to store and retrieve your Pentaho licenses, you must create a PENTAHO_INSTALLED_LICENSE_PATH system environment variable for your Pentaho user account if it does not exist. It does not matter what location you choose; however, the location needs to be available to the user account(s) that run the Pentaho Server.

Set the license path variable on Linux

Procedure

  1. Edit your /etc/environment file with a text editor.

  2. Add this line in a convenient place (changing the path as explained above, if necessary):

    export PENTAHO_INSTALLED_LICENSE_PATH=/home/pentaho/.installedLicenses.xml
  3. You must log out and log back into the operating system for the change to take effect.

  4. Verify that the variable is properly set.

    env | grep PENTAHO_INSTALLED_LICENSE_PATH

Results

The PENTAHO_INSTALLED_LICENSE_PATH variable is now set.

Set the license path environment variable on Windows

Procedure

  1. In Windows, right-click on Computer, then select Properties from context menu, then click Advanced System Settings.

    The System Properties window will appear.
  2. In the System Properties window, click the Advanced tab, then click Environment Variables.

  3. In the System Variable section, click New.

    A dialog box will ask for a variable name and value.
  4. Type PENTAHO_INSTALLED_LICENSE_PATH into the name field, and the directory you intend to install licenses to plus .installedLicenses.xml in the value field, then click OK.

    C:/pentaho/.installedLicenses.xml
  5. In the parent window, click Apply Changes.

  6. You must restart your computer for the change to take effect.

  7. Verify that the variable is properly set, using a command prompt:

    echo %PENTAHO_INSTALLED_LICENSE_PATH%

Results

The PENTAHO_INSTALLED_LICENSE_PATH variable is now set.

Next steps

If you run Tomcat automatically as a Windows service, you must also configure it to run on the Windows user account where the .installedLicenses.xml file is located.

Install or update license files from the command line

To install or update license files, follow the steps below.

Procedure

  1. Download the .lic file(s) you want to install.

  2. Navigate to the /license-installer/ directory where Pentaho PDI tool is installed (the license-installer subfolder).

  3. Copy your .lic files to the /license-installer/ directory.

  4. Run the license installation script:

    • Linux:

      Run install_license.sh with the install switch and the location and name of your .lic file as a parameter. You can specify multiple .lic files separated by spaces. Be sure to use backslashes (\) to escape any spaces in the path or file name.

       ./install_license.sh install Pentaho\ BI\ Platform\ Enterprise\ Edition.lic 
    • Windows:

      Run install_license.bat with the install switch and the location and name of your license file as a parameter. Be sure to use quotation marks (") to escape any spaces in the path or file name.

      install_license.bat install "C:\Users\username\Downloads\Pentaho BI Platform Enterprise Edition.lic"
  5. Repeat the previous step for all needed licenses.

List or remove license files from the command line

To list or remove license files, follow the steps below.

Procedure

  1. Navigate to the /pentaho/server/license-installer/ directory.

  2. Run the following scripts with the display switch:

    • Linux:
      ./install_license.sh display
    • Windows:
      install_license.bat dis
    If you have installed any Enterprise Edition license files, a list of them will appear, along with the products they cover and the duration of the license.
  3. To remove a license, run the same script with the uninstall switch.

    A list of installed licenses will appear, followed by a prompt for the license ID you would like to remove. If you press Enter at this prompt, it will exit without taking any action.
  4. Type in the license ID number that you want to remove, then press Enter.

Results

After removing a file, if you had more than one installed, the list will regenerate and the prompt will reappear. You can choose to remove another license file, or you can press Enter to exit the script.

Next steps

If you would prefer not to be prompted for confirmation, or if you intend to call this program as part of a script, use the -q switch to suppress prompting.