Katalyst: Experiment fails to open due to missing or corrupt attachments

Description

• When a user tries to open a specific Katalyst experiment, the UI fails with an internal error.
• Logs show references to missing or inconsistent “Attachments” records for that experiment.
• The experiment previously contained attached files (e.g., reports, images, additional data) that may have been moved, deleted, or altered on disk or in the database.

Solution

• Identify attachment‑related errors in the server Katalyst logs, saved to the Tomcat installation directory:
  • Look for stack traces referencing attachment entities for the specific experiment ID.
• Check the backing storage:
  • Verify that the physical attachment files still exist on the configured file share or storage path.
  • Confirm read permissions for the Katalyst service account.
• Inspect attachment metadata in the database (Spectrus DB / Katalyst metadata store in MongoDB):
  • Ensure each attachment record points to a valid file and has consistent IDs.
• Remediation options:
  • If only one or a few attachments are affected, remove or correct the corresponding attachment records (following internal procedures) and re‑attach the files if needed.
  • If many attachments are affected, consider restoring attachment metadata and/or files from backup for that experiment.
• After cleanup:
  • Re‑open the experiment and verify it loads successfully.
  • Optionally, re‑attach any lost files using the Katalyst UI.