Install License Key in Invantive Data Hub

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.

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

Initial Key Configuration

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 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 single line of text between ‘-----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%.

Running the Data Hub batch file the following error occurred:

09:10:17.439 Error itgenuty727: The license was not accepted before running in headless mode.
Please restart the application in interactive mode to correct the problem.
itgenlic252: The application ‘Invantive Data Hub’ will be closed. A valid license key is missing or the license agreement has not been accepted.

How do I fix this?

The license agreement must be accepted manually (in interactive mode) before Invantive Data Hub can be used in non-interactive code.

Probably Invantive Data Hub is started from a batch file which specifies

/interactive:false

Either run Invantive Data Hub from the Start menu without options and accept the license agreement has shown above. Or temporarily change false to true and re-run the batch file from an interactive Windows command prompt.

Een bericht is gesplitst naar een nieuw topic: Itgenobr024 on connecting to Teamleader from Linux