Skip to Content
PortcullisDocs
Operators (customer IT)

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

StateWhat it meansWhat to do
validLicensed and working normally.Nothing.
valid_graceThe 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.
expiredThe 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.
suspendedDigicom has suspended the license. Restricted mode.Contact your Digicom account manager. Once reinstated, online installations recover at the next check-in.
revokedDigicom has permanently ended the license. Restricted mode.Contact your Digicom account manager.
not_activatedThe 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.
invalidThe 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_tamperedThe 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 coveredYour 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

HTTPCodeWhat it meansWhat to do
400VALIDATION_FAILEDThe product sent a malformed request.Upgrade the product if an update is available, and contact Digicom support.
404LICENSE_NOT_FOUNDThe 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.
409MACHINE_LIMIT_REACHEDAll 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.
403LICENSE_NOT_USABLEThe 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.
429RATE_LIMITEDToo 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.
503SIGNING_UNAVAILABLEA problem on Digicom's side.Try again later. If it persists, contact Digicom support. Running installations are not affected.
—Network error / timeout / other 5xxThe 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.

On this page