Skip to main content

LMS Certificate Troubleshooting

Symptoms​

Issue, document generation, or download fails, or expiry/revocation behavior is expected but absent.

Scope​

Certificate state, admin actions, and Document dependency.

Cause​

Likely causes​

Missing certificate/course; already issued conflict; generation attempted before issue; missing document reference; downstream unavailable/file missing; or unimplemented expiry/revocation/renewal behavior.

Safe diagnostic steps​

  1. Record certificate status category and requested action.\n2. Separate issue from document generation and download.\n3. Record dependency/error category and sanitized correlation reference.\n4. Do not collect certificate or document identifiers.

Resolution​

Safe resolution​

Use the supported order: issue, then approved generation, then download. Retry only through approved UI policy. Do not regenerate, compensate, or alter references manually.

Validation​

Confirm status category, presence category of document reference, and successful supported read/download using synthetic data.

Evidence to collect​

Collect only environment category, time window, capability/route, status or error category, sanitized correlation reference, lifecycle state category, and recent approved change context.

Escalation​

State issues go to Training; storage/download issues jointly to Training and Document; lifecycle gaps to product.

Source References​

  • microservices/src/training-service/Api/TrainingEndpoints.cs
  • microservices/src/training-service/Domain/TrainingEntities.cs
  • UI/salary-ui/apps/client-hrms-portal/src/pages/hr/TalentAdminPages.tsx
  • microservices/src/training-service/Application/DocumentServiceClient.cs
  • microservices/src/training-service/Api/TrainingEndpoints.cs

Summary​

This Draft page provides non-destructive, source-backed diagnosis and stops where recovery authority is not confirmed.

Audience​

LMS users, support, operations, engineering, QA, architecture, security, and implementation teams.

Overview​

Use supported reads and sanitized evidence. Never expose personal learning data, credentials, configuration values, infrastructure details, or operational commands.

See Also​

Keywords​

  • LMS troubleshooting
  • Safe diagnostics

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-17
  • Review cycle: Quarterly