Troubleshooting
What each license state and error code means, and what to do about it.
Digicom products show the license state on their license screen, and show an error code when activation, check-in or deactivation fails. The exact wording depends on the product; the codes below are the same everywhere.
When you contact Digicom support, include the product name and version, the server's hostname, the state or error code, and the time it happened.
License states
| State | What it means | What to do |
|---|---|---|
valid | Licensed and working normally. | Nothing. |
valid_grace | The license file or the license itself has passed its end date, but the product is in its grace period and still works. A banner shows the days left. | Online: check that the server can reach the Portcullis API host (Network requirements); the next successful check-in usually clears this. If the contract has ended, contact Digicom to renew. Offline: ask Digicom for a new license file and import it. |
expired | The grace period is over. The product is in restricted (read-only) mode. Your data is kept. | Contact Digicom to renew. Online installations pick up the renewal at the next check-in; offline installations need a new license file. |
suspended | Digicom has suspended the license. Restricted mode. | Contact your Digicom account manager. Once reinstated, online installations recover at the next check-in. |
revoked | Digicom has permanently ended the license. Restricted mode. | Contact your Digicom account manager. |
not_activated | The product has no license file. | Activate it: online or offline. If it was activated before, check that the data directory is on persistent storage and was not lost or replaced. |
invalid | The license file failed verification: it was edited or damaged, is for another product or installation, or was signed with a key this product version doesn't trust. Restricted mode. | Don't edit the license file. Check whether the data directory or PORTCULLIS_INSTALLATION_ID changed (the file is bound to this installation). Re-activate online, or ask Digicom for a new file. If it started right after a product upgrade or downgrade, contact Digicom support. |
clock_tampered | The server's clock appears to have been set back. Restricted mode. | Correct the system clock (use NTP). Online installations recover at the next successful check-in. Offline installations: contact Digicom support if the state persists after fixing the clock. |
| Maintenance not covered | Your license's maintenance period doesn't cover this product build, so the product refuses to upgrade to it. The previous version keeps running. | Stay on the current version, or contact Digicom to extend maintenance. |
| Expiry warning (less than 7 days) | The license file expires soon, usually because check-ins have been failing. | Online: fix outbound HTTPS to the Portcullis API host. Offline: ask Digicom for a new license file. |
Error codes
| HTTP | Code | What it means | What to do |
|---|---|---|---|
| 400 | VALIDATION_FAILED | The product sent a malformed request. | Upgrade the product if an update is available, and contact Digicom support. |
| 404 | LICENSE_NOT_FOUND | The license key is unknown or for a different product, or this installation is not (or no longer) activated. For security, these cases look the same. | Check the key for typos and that it belongs to this product. If the installation was working before, it may have been deactivated: activate it again, or contact Digicom. |
| 409 | MACHINE_LIMIT_REACHED | All installation slots on the license are in use. The message includes the current count and the maximum. | Deactivate an installation you no longer use (Moving to a new server), or contact Digicom for more slots. |
| 403 | LICENSE_NOT_USABLE | The license is suspended, revoked, expired, or its start date has not been reached yet. | Contact your Digicom account manager. If the start date is in the future, wait until then. |
| 429 | RATE_LIMITED | Too many requests, or too many failed requests, from your IP address. | Wait and try again. The product retries automatically. If you entered wrong keys repeatedly, wait 15 minutes. |
| 503 | SIGNING_UNAVAILABLE | A problem on Digicom's side. | Try again later. If it persists, contact Digicom support. Running installations are not affected. |
| — | Network error / timeout / other 5xx | The product cannot reach Portcullis, or the server had a temporary problem. | Check DNS, firewall and proxy for outbound HTTPS to the Portcullis API host. Running installations keep working and retry automatically. |
Common situations
"Activation worked, but after a restart the product asks to be activated again."
The data directory is not persistent. Put it on a persistent volume, or set
PORTCULLIS_INSTALLATION_ID. You may need to ask Digicom to release the extra installation
that was created.
"We restored the server from a backup."
If the data directory was restored too, the installation keeps its identity. If check-ins then
fail with LICENSE_NOT_FOUND, activate again with the license key.
"The product says LICENSE_NOT_FOUND but the key is correct."
Check the product: a key for one Digicom product doesn't work for another. Also check whether
Digicom has issued you a new key.