19 Troubleshooting and Debugging PEcAn

This chapter provides guidance for diagnosing and resolving common issues encountered when installing, configuring, and running PEcAn workflows. Problems may arise from web interface configuration, file system paths, model integration, or internal workflow execution. The sections below document frequently encountered errors as well as general debugging techniques that can help identify the source of a problem.

General troubleshooting approach

When troubleshooting PEcAn issues:

  • Identify the error message and where it occurs (web, R, or model).
  • Check logs and console output for details.
  • Verify file paths, permissions, and dependencies.
  • Reproduce the issue with a minimal workflow.
  • Use R debugging tools such as debug(), traceback(), and browser().