I've Received My License File, Now What?

There are a few distribution methods for obtaining a Senzing license:

• You purchased a Senzing license online yourself and downloaded the license file from your account
• Your procurement department purchased a license on your behalf and it was sent directly to them for distribution
• Senzing directly sent you a license file

Info

If you receive a zip archive, uncompress it to retrieve the g2.lic file documented here. You will not need the included g2lic_base64.txt file. This is currently intended for use on the Senzing AWS CloudFormation assets. 

 

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.