License Activation

License restrictions

An activated and valid license deployment is necessary to access the full functionality of the product. Without such license it is not possible to start scan requests.

License limitations

Scan limit: licenses contain a scan limit which defines the number of scans allowed daily. It is not possible to start new scan processes once the daily limit is depleted.

Deployment ID

Product deployments are represented by a unique system fingerprint called Deployment ID.

Licensing is based on the generated deployment ID and a limited number of activations are possible for each license. Therefore every time your product is deployed with a different deployment ID, it will be captured as a different activation record accumulated into your total activations allowed.

Once the number of active deployments reached the deployment limit, new product activations are not possible.

The Deployment ID is an automatically generated unique fingerprint identifying the computer the product is deployed on. It might change when you alter the system that the product is installed on.

License Actions

Online license activation

The product will connect directly to the OPSWAT licensing server online, and acquire its license based on your purchased Activation Key. License activation will happen automatically once a valid activation key is detected.

Steps to activate online:

Create a file named license.yml in your fsTransform installation directory: <installdir>/fsTransform/license/license.yml
Copy your activation key to the newly created license.yml file

Example license.yml containing a dummy activation key
    
 
xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx
Copy

Offline license activation

In air-gapped environments the product can be activated with the help of another computer that has a working internet connection. The Deployment ID of the target computer and the Activation Key will be required to download an offline license file (.yml) via your My OPSWAT portal. Follow the displayed instructions for details.

Steps to activate offline

Generate Deployment ID by executing the fsDeploymentID script, which can be found in the release package.
Use your Activation Key and Deployment ID to download an offline license file from your My OPSWAT portal.
Copy your offline license file to the fsTransform installation directory: <installdir>/fsTransform/license/ folder.

DeploymentId generation
    
​x
 
./fsDeploymentID​OPSWAT Filescan​Deployment ID:  FSCANxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx​'Copy the above deployment id to use it for Offline License Activation on https://my.opswat.com.'
Copy

Please note that only one *.yml file is allowed in the license directory.

Deactivation

If a new license file is detected, the product will try to deactivate the existing deployment automatically, releasing the used deployment slot. Offline activated licenses cannot be automatically deactivated.

Troubleshooting

Make sure that there is a working internet connection and the OPSWAT Activation Server is reachable (https://activation.dl.opswat.com)

Test if Activation Server is network reachable
    
 
wget -S --spider https://activation.dl.opswat.com 2>&1
Copy

Double check if the license file is placed in the correct folder and the content is correct.

Have a look on the <installdir>/fsTransform/fstransform.log file for more error details, example:

License error example log
    
 
2023-08-17 11:20:05,945 INFO 99 [fsLogger] - Trying to activate new license online2023-08-17 11:20:05,946 ERROR 70 [fsLogger] - License error occurredfsio.transform.license.LicenseException: Activation key invalid: dummyKey
Copy

In case of expired license status ask for support on your My OPSWAT portal.

Last updated on

Was this page helpful?