Logs and Debugging

Upgrade logs

The upgrade commands output a summary of each step. For more detail, check the following log files:

  • logs/upgrade.log — logs generated by the SuiteCRM 8 upgrade process.

  • public/legacy/upgradeWizard.log — upgrade logs from the legacy part of the application. Generated during the legacy-post-upgrade step.

  • logs/<app-env-mode>/<app-env-mode>.log — the main application log. The file path reflects your APP_ENV value, e.g. logs/prod/prod.log. This log typically contains little upgrade-specific information.

  • public/legacy/suitecrm.log — the main legacy application log. May contain upgrade-related entries alongside general application logs.

APP_ENV mode

In a production environment, APP_ENV in .env or .env.local should be set to prod. This mode has a high log level, so not all debug information is logged.

To get more detail, temporarily change APP_ENV to qa. After changing it, clear the Symfony cache from your instance root:

bin/console cache:clear

Only use APP_ENV=qa temporarily. Switch back to prod after debugging.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.