und is the command-line interface to Understand — script project creation, analysis, CodeCheck, metrics, and reports, locally or in CI.
Run Understand from the command line · Headless workflow: create, analyze, check, report
Licensing
configure and query the Understand license from the command line
Understand licensing can be configured and queried from the command line. The current license can be inspected at any time with the license command (und help license).
Setting your license
und -setlicenseserver licensing.scitools.com
und -setlicensecode XXXXXXXXXXXXXXXX
| Option | Description |
|---|---|
-setlicensecode code | Save and activate the given license code with the license server. |
-setlicenseserver server | Set the license server to use (host or URL). |
-deregisterlicensecode | Release this machine's license seat on the server, freeing a concurrent seat. |
-refreshlicense | Force a fresh validation of the license against the server. |
Checking your license
| Option | Description |
|---|---|
-isundlicensed | Print 1 if Understand is licensed, 0 if not (useful in scripts). |
-licensehowmanydays | Print how many days remain on the current license. |
Environment variables
The license can also be configured entirely through the environment, which takes precedence over the saved configuration. This is useful for CI, containers, and shared machines.
| Option | Description |
|---|---|
UNDERSTAND_LICENSE_CODE | Use this license code instead of the saved one. |
UNDERSTAND_LICENSE_SERVER | Use this license server instead of the saved one. |
Offline activation
Machines without network access to the license server can be activated offline. Generate a request code, send it to SciTools, and install the reply code you receive back.
| Option | Description |
|---|---|
-enterofflinemode | Switch this install into offline licensing mode. |
-enteronlinemode | Switch this install back into online licensing mode. |
-createofflinerequestcode | Generate and display the offline activation request code to send to SciTools (-showofflinerequestcode displays it again, -newofflinerequestcode generates a fresh one). |
-setofflinereplycode code | Install the offline reply code received from SciTools. Provide its expiration with -expiration <yyyyMMdd> (and -maintenance <yyyyMMdd> for perpetual licenses). |
-showofflinereturncode | Display the offline return code so the seat can be returned to SciTools. |
Node-locked licenses
| Option | Description |
|---|---|
-createnodelockrequestcode | Generate this machine's node-locked-license request code (-shownodelockrequestcode displays it without regenerating). |
-setnodelockreplycode code | Install the node-lock reply code from SciTools. Provide its expiration with -expiration <yyyyMMdd> (and -maintenance <yyyyMMdd> for perpetual licenses). |
-shownodelockreturncode | Display the node-lock return code so the license can be returned. |