Validation and Troubleshooting

Use this page to verify output integrity and quickly diagnose common workflow problems.

--cemdb-root can be omitted in many cases:

  • If the current directory contains ./cemdb, kub-dataset and kub-simulate use the default cemdb/locations.

  • kub-dashboard auto-detects ./cemdb.

CEMDB_ROOT environment variable:

  • kub-dashboard uses CEMDB_ROOT as its default CEMDB path.

  • For kub-dataset and kub-simulate, use --cemdb-root when your data is not under ./cemdb/locations.

1. 1. Validate Run Manifest

# Pick one generated run manifest
kub-dataset manifest-validate cemdb/locations/arz/v0.1.0/simulations/single/run_YYYY-MM-DD_HH-MM-SS/manifest.json

# Strict mode
kub-dataset manifest-validate --strict cemdb/locations/arz/v0.1.0/simulations/single/run_YYYY-MM-DD_HH-MM-SS/manifest.json

2. 2. Verify Dataset and Version Resolution

kub-dataset summary arz --version 0.1.0 --cemdb-root cemdb/locations

3. 3. Common Issues

Symptom Likely cause Check/fix

kub-simulate fails before submit

Apptainer executable or image path missing

Check apptainer_exec and apptainer_image in your selected profile (kub-simulate config show), then verify test -x /opt/apptainer/latest/bin/apptainer and test -f ./kub-master.sif

Run submitted but status shows no manifests

Job failed early

Inspect launcher log in run directory (slurm-<jobid>.out for Slurm or local-run.out for local mode) and run kub-simulate status --run-id …​

Dashboard shows zero runs

Index stale or wrong CEMDB root

Run kub-dashboard index --refresh --cemdb-root <root> and verify simulations/single/run_*/manifest.json

Manifest validation fails on missing artifacts

Partial or failed postprocessing

Re-run simulation, then validate again; inspect database/ files referenced by manifest

4. 4. Minimal Post-Run Health Check

# 1) Summary
kub-dataset summary arz --version 0.1.0 --cemdb-root cemdb/locations

# 2) Recent run status
kub-simulate status arz --version 0.1.0 --cemdb-root cemdb/locations --last 5

# 3) Dashboard index
kub-dashboard print-index --cemdb-root cemdb

5. Next Step

Proceed to Command Cheatsheet.