Invantive products require a license key to run. The license key is used as basis for the billing. The configuration of license keys depends on the type of product: webserver, Windows or command line.
A license key is part of a subscription. A subscription has a unique code beginning with L followed by digits. Each subscription can have multiple license keys. A license key is approximately 2,000 characters long and does not begin with an L.
This article explains how to install or replace a license key in Invantive Data Hub using the command line. The article also explains how to present a deviating key as a command line parameter.
For Windows products running outside of Microsoft Office, please consult Install License Key on Independent GUI Products on Windows.
For Invantive products running within Office please consult Install License Key on Office-based Products on Windows.
Instructions
On initial start and on message such as itgenlic248 it is necessary to load a license key.
Initial Key Configuration
Preparations:
- Download Invantive Data Hub from https://download.invantive.com for the recommended release or https://releasenotes.invantive.com for a BETA.
- Install Invantive Data Hub by running the MSI file (Windows) or unzipping the zip file (MacOS, Linux).
- Acquire a license key from Invantive Cloud in the License section as License Keys.
- When no license key is available yet, contact from Invantive Support.
- The license key will be sent by mail from Invantive Support. When using Microsoft Outlook, check that extra line ends have not been removed as signaled below the mail subject. If so, click on “Restore line breaks“.
Perform the following steps to install a license key:
- Start Invantive Data Hub and wait for the following message to appear:
*** Agreement ***
Your license has not been configured yet, nor accepted.
1. Enter license key
2. Acknowledge agreement
L. Load license key from file
T. Load trial license
P. Load Public Data license
4. Show agreement text
5. Save agreement to file
6. Show details
E. Exit menu.
C. Exit application.
Please enter your choice:
- Choose option 1.
- A license key is asked for.
- Copy the lines of text including ‘-----BEGIN LICENSE KEY-----’ and '-----END LICENSE KEY-----’ to the clipboard.
- The key is very long and starts typically with ‘lh’ and in 70% of cases ends on ‘=’.
- Paste the contents from the clipboard.
- Press Enter.
- Review and approve the agreement using option 2.
- Leave the menu by choosing the option E.
- Continue use of Invantive Data Hub.
Replace License Key
Preparations:
- Acquire a license key from Invantive Cloud in the License section as License Keys.
- When no license key is available yet, contact from Invantive Support.
- The license key will be sent by mail from Invantive Support. When using Microsoft Outlook, check that extra line ends have not been removed as signaled below the mail subject. If so, click on “Restore line breaks“.
Perform the following steps to replace a valid license key:
- Start Invantive Data Hub and wait for the question what database to use:
*** Invantive Data Hub (20.2.6-PROD+1803 Development) on 10-9-2021 14:33:49 (UTC) ***
(C) Copyright 2004-2021 Invantive Software BV, the Netherlands. All rights reserved.
...
*** Connect ***
Query itgenlom010: Use database name 'DEFAULT\ecbeolnl'? Question? [Y/n]
- Answer n.
- A message appears:
Query itgenlom005: Database name or number ('?' for list, append text to filter, '*' for discovery, 'L' for license)
- Answer L.
- A menu appears:
*** Agreement ***
Your license has not been configured yet, nor accepted.
1. Enter license key
2. Acknowledge agreement
L. Load license key from file
T. Load trial license
P. Load Public Data license
4. Show agreement text
5. Save agreement to file
6. Show details
E. Exit menu.
C. Exit application.
Please enter your choice:
- Choose option 1.
- A license key is asked for.
- Copy the text including ‘-----BEGIN LICENSE KEY-----’ and '-----END LICENSE KEY-----’ to the clipboard.
- The key is very long and starts typically with ‘lh’ and in 70% of cases ends on ‘=’.
- Paste the contents of the clipboard.
- Press Enter.
- Leave the menu by choosing the option E.
- Continue use of Invantive Data Hub.
Replace Invalid License Key
Preparations:
- Acquire a license key from Invantive.
- The license key will be sent by mail. When using Microsoft Outlook, check that extra line ends have not been removed as signaled below the mail subject. If so, click on “Restore line breaks“.
Perform the following steps to replace an invalid license key:
- An invalid license key is signaled during start up, for instance as:
itgenlic056: Your current agreement key with ID 131...218 for agreement code 'L1...' is incompatible with the latest version of this application.
Please contact your dealer to receive an updated agreement key in version 6 or switch to a trial agreement.
Query itgencun002: Show details? Question? [y/N]
- Answer y to replace the license key.
- A message appears:
Error itgenuty316: The current license key is incorrect. Do you want to correct it? Question? [Y/n]
- Answer y.
- A menu appears:
*** Agreement ***
T. Load trial license
O. Load Open Data license
1. Load license key from file
2. Enter license key
3. Show acknowledgments
4. Show details
5. Show status
E. Exit menu.
- Choose option 2.
- Copy the lines of text including ‘-----BEGIN LICENSE KEY-----’ and '-----END LICENSE KEY-----’ to the clipboard.
- The key is very long and starts typically with ‘lh’ and in 70% of cases ends on ‘=’.
- Paste the contents from the clipboard.
- Press Enter.
- Review and approve the agreement using option 2.
- Leave the menu by choosing the option E.
- Continue use of Invantive Data Hub.
Hard-code License Key using Command Line Parameter
An alternative is to explicitly include the license key in every batch job. This can be done via the licensekey command line option with Invantive Data Hub. An example of a batch job:
set INVANTIVE_TRACE_FOLDER=c:\trace\xxacme
set INVANTIVE_CONFIGURATION_DATABASES_FOLDER=c:\jobs\xxacme\cfg
set INVANTIVE_PRG=C:\Program Files (x86)\Invantive Software BV\Invantive Data Hub 20.0\Invantive.Producer.QueryEngine.exe
set INVANTIVE_CONN=groep\database
set INVANTIVE_SQL_FILE=c:\jobs\xxacme\sql\job.sql
set INVANTIVE_LOG_FILE=c:\jobs\xxacme\log\job-%%Y%%m.log
set INVANTIVE_LOG_FILE_OVERWRITE=False
set INVANTIVE_INTERACTIVE=False
set INVANTIVE_LICENSE_KEY=lhGCN...very...long...license...key...CBAcg==
"%INVANTIVE_PRG%" /verbose /database:"%INVANTIVE_CONN%" /file:"%INVANTIVE_SQL_FILE%" /logfile:"%INVANTIVE_LOG_FILE%" /logoverwrite:"%INVANTIVE_LOG_FILE_OVERWRITE%" /interactive:%INVANTIVE_INTERACTIVE% /licensekey:%INVANTIVE_LICENSE_KEY%
IF %ERRORLEVEL% NEQ 0 (
echo Failed Data Hub job with exit code %ERRORLEVEL%.
exit /b %ERRORLEVEL%
)
echo Completed Data Hub job with exit code %ERRORLEVEL%.