Troubleshoot cron
This article offers troubleshooting solutions for issues with cron in Adobe Commerce on-premises products.
Affected products and versions
- Adobe Commerce on-premises 2.2.x, 2.3.x
- Magento Open Source 2.2.x, 2.3.x
Issues
The following are symptoms of cron issues:
-
Your update or upgrade never runs; it stays in a
pendingstate. -
An error message about the PHP setting
$HTTP_RAW_POST_DATAdisplays even though it’s set properly. -
The cron readiness check fails. Possible errors include non-writable paths and cron not set up. An example follows:
-
The PHP readiness check doesn’t display the PHP version as the following figure shows.
-
The following error displays in the Commerce Admin:
To see the error, you might need to click System Messages at the top of the window as follows:
Investigate to find the cause check-your-existing-crontab
This section discusses how to see if cron is currently running and to verify whether it’s set up properly.
To verify whether or not your crontab is set up do the following steps:
-
Log in to your Magento server as, or switch to, the Magento file system owner.
-
See if the following file exists:
bash ls -al <magento_root>/var/.setup_cronjob_status. If the file exists, cron has run successfully in the past. If the file does not exist, either you haven’t yet installed Magento or cron isn’t running. In either case, continue with the next step. -
Get more detail about cron. As a user with
rootprivileges, enter the following command:bash crontab -u <Magento file system owner name> -l. For example, on CentOSbash crontab -u magento_user -l. If no crontab has been set up for the user, the following message displays:terminal no crontab for magento_user. Your crontab tells you the following:- What PHP binary you’re using (in some cases, you have more than one)
- What Magento cron scripts you’re running (in particular, the paths to those scripts)
- Where your cron logs are located
See one of the following sections for a solution to your issue.
Solutions
Solution for crontab not being set up solution-crontab-not-set-up
To verify your cron jobs are set up properly, see Set up cron jobs.
Solution for cron running from incorrect PHP binary solution-cron-running-from-incorrect-php-binary
If your cron job uses a PHP binary different from the web server plug-in, PHP settings errors might display. To resolve the issue, set identical PHP settings for both the PHP command line and the PHP web server plug-in.
For more information about PHP settings, see Required PHP settings in our developer documentation.
Solution for cron running with errors solution-cron-running-with-errors
Try running each command manually because the command might display helpful error messages. See Set up cron jobs.