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.

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.