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.ymlin your fsTransform installation directory:<installdir>/fsTransform/license/license.yml - Copy your activation key to the newly created license.yml file
xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxxOffline 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.
./fsDeploymentIDOPSWAT FilescanDeployment ID: FSCANxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'Copy the above deployment id to use it for Offline License Activation on https://my.opswat.com.'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)
wget -S --spider https://activation.dl.opswat.com 2>&1Double 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:
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: dummyKeyIn case of expired license status ask for support on your My OPSWAT portal.