Skip to Content
PortcullisDocs
Concepts

Lifecycle and grace

License statuses, leases, grace periods and the states a product evaluates.

License status

StatusMeaning
activeNormal.
suspendedTemporarily disabled by Digicom (for example non-compliance). Can be reinstated to active.
expiredPast expires_at plus the grace period. Renewal makes it active again.
revokedPermanently 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 exp or the license's expiresAt passes, the product keeps working for grace_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.

StateMeaningRecommended behaviour
validSignature, product and fingerprint OK, within validity, status activeNormal
valid_graceThe file's exp or the license's expiresAt has passed, but within graceNormal, plus a persistent admin banner with days left
expiredBeyond graceRestricted mode: read-only, admin login only; never delete data
suspended / revokedThe signed status says soRestricted mode; message to contact Digicom
not_activatedNo license fileSetup screen
invalidBad signature, unknown or revoked signing key, wrong product, fingerprint mismatch, malformedRestricted mode, and log the reason
clock_tamperedThe system clock appears to have been set backRestricted mode until the clock is fixed or an online check-in succeeds

See Enforcement guidelines and, for operators, Troubleshooting.

On this page