Installation troubleshooting

In case any issues arise after installation please check the logs. The most important places where logs are shown are accessed with the the following commands (try to look for lines beginning with [ERROR]):

Webservice is unavailable / under maintenance

This may happen from time to time, if there is an issue with unhealthy docker containers. Please restart Sandbox using the helper scripts:

"Unfortunately, the application server "app*" is not reachable"

The issue is that the analyzer app (transform) is unable to start up or it is not accessible by the broker.

It is recommended to stop and restart the sandbox service. Then wait a minute or so until the connection is established between broker and transform. If the issue persists after several minutes, please check deeper into logs.

General issues related to file permissions

Please investigate whether the folder mentioned in the error message is owned by the sandbox user.

This can be done using the ls -la <path> command. In case it is not owned by that user, recursively own it with the following command:

Issues related to the APT package manager

When the installer fails to install a required package via APT, you might see a similar error message indicating that the package manager is locked by another process that is running in the background:

In this case, it is recommended to wait a few minutes while that other process finishes and releases the lock.

Feel free to check the status of that background process using top , htop or any similar utility.

If the process PID is also displayed in the error message (e.g. 18943 above), then the following command shows the status of the given process:

Please restart the Sandbox installation after the background process is completed.

If that does not help, please reboot the system and try again!