Lifecycle and grace
License statuses, leases, grace periods and the states a product evaluates.
License status
| Status | Meaning |
|---|---|
active | Normal. |
suspended | Temporarily disabled by Digicom (for example non-compliance). Can be reinstated to active. |
expired | Past expires_at plus the grace period. Renewal makes it active again. |
revoked | Permanently ended. Cannot be undone. |
Changes made by Digicom (renewal, more machines, new entitlements, suspension) reach online installations at their next check-in, as a new signed file. A suspended, revoked or expired license still returns a signed file at check-in, carrying that status, so the product learns the decision from a trustworthy source.
Lease and grace
- Lease: an online-issued file is valid for
lease_days(default 30), never beyond the license end. Check-ins renew it long before it runs out. - Grace: after the file's
expor the license'sexpiresAtpasses, the product keeps working forgrace_days(default 14) and shows administrators a warning with the days left.
With the defaults, an online installation survives up to 30 + 14 = 44 days without reaching Portcullis. Each license can use different values.
Maintenance coverage
maintenanceExpiresAt limits which builds the license covers. A build is covered when its
build date is on or before that date, or when the field is empty. An uncovered build should
refuse to upgrade into the new version, while the old version keeps running.
Product states
The product evaluates its stored license file to one of these states on startup, every hour, and whenever it receives a new file.
| State | Meaning | Recommended behaviour |
|---|---|---|
valid | Signature, product and fingerprint OK, within validity, status active | Normal |
valid_grace | The file's exp or the license's expiresAt has passed, but within grace | Normal, plus a persistent admin banner with days left |
expired | Beyond grace | Restricted mode: read-only, admin login only; never delete data |
suspended / revoked | The signed status says so | Restricted mode; message to contact Digicom |
not_activated | No license file | Setup screen |
invalid | Bad signature, unknown or revoked signing key, wrong product, fingerprint mismatch, malformed | Restricted mode, and log the reason |
clock_tampered | The system clock appears to have been set back | Restricted mode until the clock is fixed or an online check-in succeeds |
See Enforcement guidelines and, for operators, Troubleshooting.