Katalyst: Experiment Export Failed

Description

• Export operations may fail for several reasons, including incorrect or missing CONFIG.JSON settings, insufficient permissions on the KAT_Project record set, unexpected browser‑side errors, or server‑side failures on the Spectrus DB system.

Solution

• Confirm all components are connected from the web app (Show User Menu → About).
• Insufficient permissions on the KAT_Project record set:
  • Start ESMC (<ACD>\SPECTRUSDB.SRV\ESMC.EXE) and connect using the Spectrus DB administrator account.
  • On the Server Tree, select Record Sets.
  • Right‑click KAT_Project → All Records Permissions and ensure Browse and Create access rights are allowed for the KAT_USERS group.
  • Right‑click KAT_Project → Data Items and Tables Management Permissions and ensure Create access is allowed for the KAT_USERS group.
• Unexpected web browser error:
  • Open the browser console log (press F12) and review errors.
  • Proceed according to the messages shown.
• Server‑side error on the Spectrus DB system:
  • Check the Spectrus DB logs located at:
    <ACD>\SPECTRUSDB.SRV\cbookserver_errors.log
  • Contact Technical Support if needed.
• Invalid CONFIG.JSON KAT_Project record set:
  • From the Katalyst configuration folder, open the CONFIG.JSON file.
  • In the "spectrusdb-connection" array, ensure the Project value is written correctly as KAT_Project.
  • Edit the entry if necessary.
• Use the built‑in Katalyst experiment backup and restore capability to recover the experiment:
  • In Katalyst, click the User menu icon.
  • Select Experiment Backups to open the Export Manager window.
  • Locate the affected experiment ID in the backups list.
  • Select the desired backup and click Load Backup.
  • Allow the backup to import; once complete, try opening the experiment again.
    • If the backup loads successfully:
      • Validate the experiment content (materials, plate data, analytics).
      • Re‑attempt the export operation if needed.
    • If no suitable backup is available or restore fails:
      • Check database health and logs around the time of the original export failure.
      • After resolving DB performance issues, test with a smaller experiment to ensure export works normally.
• Contact Customer Support for assistance.