I've Received My License, Now What?

If you are looking to load more records than the built-in evaluation license or you are looking to use the Senzing API for productive purposes just reach out to Senzing to get a larger license.

Info

If you receive a zip archive, uncompress it to retrieve the g2.lic file documented here. The included g2lic_base64.txt file is used for the SENZING_ENGINE_CONFIGURATION_JSON environment variable, or for use on the Senzing AWS CloudFormation assets. 

 

SENZING_ENGINE_CONFIGURATION_JSON environment variable

Construct the SENZING_ENGINE_CONFIGURATION_JSON environment variable, and use the contents of the g2lic_base64.txt file as the value for LICENSESTRINGBASE64:

Example:

# replace /home/user/your_project with the path to your Senzing project.

export SENZING_ENGINE_CONFIGURATION_JSON='
{
  "PIPELINE": {
    "CONFIGPATH": "/home/user/your_project/etc",
    "LICENSESTRINGBASE64": "",
    "RESOURCEPATH": "/home/user/your_project/resources",
    "SUPPORTPATH": "/home/user/your_project/data"
  },
  "SQL": {
    "CONNECTION": "sqlite3://na:na@/home/user/your_project/var/sqlite/G2C.db/"
  }
}
'

 

G2Module.ini

Once you've obtained the license file package, make it available on the machine you intend to use it on. Decompress the package if required to make the g2.lic file available. Make the g2.lic file available, for example, at the root of your Senzing project folder, subsequently referred to as <project_root>.

• Modify the <project_root>/etc/G2Module.ini file
  • Under the [PIPELINE] stanza add a new key value pair of LICENSEFILE=<project_root>/g2.lic
  • Save the modification

The next time you run any Senzing utilities or initialize Senzing from your own applications using this project and G2Module.ini the new license file will be effective. You can confirm the license file use in numerous ways:

• Example using G2Command

~/senzprojs/2_3_1/python 
-> ./G2Command.py

Initializing Senzing engine...

Welcome to G2Command. Type help or ? to list commands.

(g2cmd) license

{"customer":"Senzing Internal","contract":"Senzing Internal - 10M","issueDate":"2020-09-15","licenseType":"EVAL","licenseLevel":"STANDARD","billing":"MONTHLY","expireDate":"2021-03-15","recordLimit":10000000}

(g2cmd) quit
~/senzprojs/2_3_1/python 
-> 

• Example using G2Loader

~/senzprojs/2_3_1/python 
-> ./G2Loader.py -T

No source file or project file was specified, loading sample data

Arguments: -T

...
...

Version & Config Details
------------------------

Senzing Version: 2.3.1 (2021-01-26)
Configuration Parameters: /home/ant/senzprojs/2_3_1/etc/G2Module.ini
Instance Config ID: 1412143730
Instance Config Comments: Configuration added from G2SetupConfig.
Instance Config Created: 2021-02-03 16:16:20.973


License Details
---------------

Customer: Senzing Internal
Type: EVAL
Records: 10000000
Expiration: 2021-03-15
Contract: Senzing Internal - 10M

...
...

• Example using the Senzing REST API Server with curl
  • This will only be available if you have previously installed it and is not installed by default during a base deployment of the Senzing APIs 
  • The curl command output in this example is piped to jq for formatting. The jq command  may not be installed on your system by default

~/senzprojs/2_3_1/python
-> curl -X GET "http://localhost:8250/license?withRaw=false" -H "accept: application/json; charset=UTF-8" | jq .
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 558 100 558 0 0 181k 0 --:--:-- --:--:-- --:--:-- 181k
{
  "meta": {
  "httpMethod": "GET",
  "httpStatusCode": 200,
  "timings": {
    "overall": 1,
    "enqueued": 0,
    "nativeAPI": 0,
    "nativeAPI:product.license": 0,
    "processRawData": 1
  },
  "timestamp": "2021-02-03T16:55:22.406Z",
  "version": "2.3.1",
  "restApiVersion": "2.3.0"
  },
  "links": {
    "self": "http://localhost:8250/license?withRaw=false"
  },
  "data": {
    "license": {
      "customer": "Senzing Internal",
      "contract": "Senzing Internal - 10M",
      "licenseType": "EVAL",
      "licenseLevel": "STANDARD",
      "billing": "MONTHLY",
      "issuanceDate": "2020-09-15T00:00:00.000Z",
      "expirationDate": "2021-03-15T23:59:59.000Z",
      "recordLimit": 10000000
    }
  }
}
~/senzprojs/2_3_1/python 
->

Warn

This article pertains to deploying Senzing natively on a host system and not within containerized demos such as on Senzing GitHub. Deploying a Senzing license within the GitHub assets is documented therein.