Troubleshooting¶

Out of Sync Error¶

If Step 1 fails in projark, run:

parkit syncapi

Then rerun your projark command.

Host Check Failure¶

projark requires Helix host identity (helix.nih.gov).

Session Check Failure¶

If prompted to use a session wrapper, start tmux/screen (or use an Open OnDemand graphical session) and rerun. Disclaimer: Open OnDemand is currently available only on Biowulf compute nodes, not directly on Helix. Since projark is Helix-only today, use tmux/screen on Helix; Open OnDemand support is future-facing until Helix access is available.

Token/Auth Failures¶

If token generation fails during syncapi, verify credentials and inspect:

HPC_DME_APIs/utils/temp/log

Missing Collection/Object on Retrieve¶

• Validate project number and datatype.
• Use --filenames only for exact object names.
• Omit --filenames for full collection retrieval.

Split Merge Expectations¶

--unsplit merges only files matching *.tar_0001, *.tar_0002, etc. If none are present, merge is skipped.