: Ensure your operating system and environment are compatible with the software. Sometimes, issues arise from conflicts with other software, system configurations, or from running in an unsupported environment.
| Cause Category | Specific Issue | |----------------|----------------| | | Firewall blocking TLS/SSL ports (default 7010, 7011) between key readers and supervisor server. | | Supervisor Service State | OptimaKeySupervisor service stopped or crashed. | | Database Corruption | Supervisor database containing key metadata is corrupted or locked. | | Clock Skew | System time difference > 5 minutes between key readers and supervisor (breaks time-based tokens). | | Certificate/Encryption | Expired or mismatched root certificate for key authentication. | | Firmware Mismatch | Key firmware version not supported by current supervisor version. | optima key supervisor error