Errors + Troubleshooting
MetriCal logs various error codes during operation or upon exiting. This page catalogs them, along with descriptions (🔍) and troubleshooting (🔧) steps.
Error Codes in Logs
During operation, error codes may be printed to the log (stderr) as informational warnings or as errors that caused MetriCal to fail and exit.
Licensing
Licensing-specific error codes and troubleshooting tips are listed below.
license-001
🔍 Verifying the license online failed. MetriCal couldn't verify the signature or decode the contents of the licensing server's response.
🔧 Ensure no network proxy is modifying HTTP content or headers.
license-002
🔍 Verifying the local license-cache file failed. MetriCal couldn't verify the signature or decode the contents of the local license-cache file.
🔧 Ensure a valid license-cache file exists and has not been edited or corrupted. See the licensing setup instructions to enable offline licensing.
license-003
🔍 License is in an invalid state. The provided license is either suspended/banned (e.g. subscription expired/lapsed) or was not found (e.g. was revoked or typoed).
🔧 Contact us at support@tangramvision.com for help.
license-004
🔍 The local license-cache file could not be read from disk.
🔧 Ensure a license-cache file exists and is readable. See the licensing setup instructions to enable offline licensing.
license-005
🔍 The local license-cache file could not be parsed.
🔧 Ensure a valid license-cache file exists and has not been edited or corrupted. See the licensing setup instructions to enable offline licensing.
license-006
🔍 No default application config path could be found in order to locate or write the license-cache file. This is likely an issue with Docker configuration causing the HOME environment variable to be unset inside the container.
🔧 Please review and follow the licensing setup instructions to enable offline licensing. If the issue persists, contact support@tangramvision.com.
license-007
🔍 The local license-cache file could not be written to disk. Offline operation is not possible without a license-cache file.
🔧 Ensure that the metrical-license-cache volume is being successfully mounted into the Docker container. Please review and follow the licensing setup instructions to enable offline licensing. If the issue persists, contact support@tangramvision.com.
license-008
🔍 The local license-cache file could not be serialized to disk. Offline operation is not possible without a license-cache file.
🔧 Please contact us at support@tangramvision.
license-009
🔍 The local license-cache file is expired.
🔧 Run MetriCal with internet access to refresh the license. You must run a mode/sub-command (other
than help
) in order to refresh the license.
license-010
🔍 Checking the license online failed. This error code encompasses a variety of possible errors including: DNS issues, no network connection, network request timeout, licensing server errors or downtime, or network proxies editing network packet contents or headers.
🔧 Please check your network connection — ensure that the internet is reachable, DNS resolves successfully, and no network proxies are active that modify traffic. Check the licensing service is up at https://status.keygen.sh/. To ensure future resilience to network-related issues, follow the licensing setup instructions to enable offline licensing. If the issue persists, contact support@tangramvision.com.
license-011
🔍 The provided license key does not match the key in the license-cache file.