Troubleshooting: Licensing¶
Diagnostics while locked¶
License diagnostics remain available while the product is locked. They report the state; they never block.
php artisan pterocloud:license:diagnostics --json
php artisan pterocloud:license:status --json
State mapping¶
| State | Diagnostic | Meaning |
|---|---|---|
active |
PASS | Signed lease valid. |
expiring |
WARN (LICENSE_EXPIRING) |
Lease near expiry. |
server_unavailable with a valid lease |
WARN (LICENSE_SERVER_UNAVAILABLE) |
Server unreachable, lease still valid. |
| everything else | FAIL | Commercial operations are locked. |
Locked states¶
expired, lease_expired, suspended, revoked, invalid,
tamper_suspected, installation_limit, product_mismatch,
version_not_owned and unverified all lock the control layer. Existing
infrastructure keeps running.
Clock anomaly¶
Symptom: LICENSE_CLOCK_ANOMALY. Synchronise the system clock; a backwards jump
can affect lease validation.
Integrity failure¶
Symptom: LICENSE_INTEGRITY_FAILURE, LICENSE_CACHE_TAMPER. The signed release
manifest or the persisted lease failed an integrity check. Reinstall from the
official release and re-activate.
Common codes¶
| Code | Title |
|---|---|
PC-LIC-001 |
License required |
PC-LIC-002 |
License signature invalid |
PC-LIC-003 |
License cache tamper detected |
PC-LIC-004 |
License bound to another installation |
PC-LIC-005 |
License integrity check failed |
PC-LIC-006 |
License clock anomaly |
PC-LIC-007 |
License expiring soon |
PC-LIC-008 |
License expired |
The full list is in the error reference.
The license key is never shown in diagnostics or bundles
Diagnostics and support bundles contain no key material. Do not paste a key into a ticket.