License file corruption

Under heavy load or due to limited disk space, some I/O operations might fail and Sandbox might not be able to complete scan tasks. In these situations, it might be impossible for Sandbox to write log files or temporary files to disk.

Unfortunately, this can also lead to the corruption of the license.dat file in the /home/sandbox/sandbox/transform/license folder.

When the sandbox service is restarted, the corrupted license data cannot be loaded and no scan operations can be completed until the license is restored.

When this issue occurs, the transform.log file (in /home/sandbox/sandbox/logs) typically contains entries like the following:

Remediation

If this issue occurs once, it might be sufficient to restore the license manually following the License Activation guide.

If the issue occurs repeatedly, then a permanent solution is adding the license.yml file in the /home/sandbox/sandbox/transform/license folder.

The license be re-activated automatically when a valid license.yml is detected.

Remediation steps in an online environment:

• Create a file named license.yml in your Sandbox installation directory: /home/sandbox/sandbox/transform/license/license.yml (the path might be different if you installed Sandbox to a different target directory)
• Copy your activation key to the newly created license.yml file

You can also use these commands to accomplish this:

Remediation steps in an offline environment:

• Use the offline license file that you have previously downloaded from your My OPSWAT portal.
• Copy your offline license file to the Sandbox installation directory: /home/sandbox/sandbox/transform/license/license.yml (the path might be different if you installed Sandbox to a different target directory)