Sometimes, when performing a major upgrade from X-Cart 5.5.1.x to 5.6.0.x via Apps › Updates, you may see a warning that prevents the upgrade from starting:
 |
|
This check helps avoid issues caused by the new task queue structure in version 5.6.
Below, we explain why this happens and provide steps to resolve stuck background tasks.
Why X-Cart blocks the upgrade
Starting with X-Cart 5.6.0.x, your store uses a new shared queue system for background tasks.
Upgrading may stop important ongoing tasks in your 5.5.1.x store and will not carry them over to the new version. This can cause data loss for scheduled processes like importing products, updating the sitemap, or sending data to Google and Amazon feeds. To prevent data loss, X-Cart blocks the upgrade until all tasks are complete.
⚠️ The upgrade can start only after the background task queue is empty.
How to prepare your store for the upgrade?
To make sure the no background tasks interfere with an upgrade, follow these steps:
Below is a detailed explanation of each step 👇.
Step 1: Check auto catalog imports
Go to Catalog › Catalog import and ensure that no imports are running or queued.
Check both the Import Schedule and Import Status columns to confirm that all tasks are complete before proceeding. In the example below, the import for one of the products was scheduled for 11:00 and was still running at the time of recording:
Step 2: Close your storefront
Limit customer activity by temporarily closing your storefront, thus avoiding new orders, messages, or email notifications being created while you prepare to upgrade.
Step 3: Pause other scheduled tasks
Most scheduled cron jobs run on the server, and cannot be managed through the X-Cart Admin, so you’ll need server access 📟 to temporarily disable or comment out cron commands. This stops automated imports, feed updates, sitemap generation, and other scheduled tasks that could interfere with the upgrade.
It's best to contact our support or hosting teams to help clear outdated records from messenger_messages and resolve any remaining issues.
Step 4: Wait for background tasks to complete
Allow all running tasks to finish before starting the upgrade. You can monitor their progress on the specific integration pages:
eBay: Catalog › Feeds › Product Feeds
Google Catalog › Feeds › Google Product Feed
Amazon: Channels › Amazon › Feed Submission History
etc.
Make sure no tasks are left in progress or queued before proceeding.
🧑🏻💻 If the message about running tasks still appears in Apps › Updates after the queue is empty, some old or stuck tasks may remain.
Contact our support team to help clear them.
✅ Start an upgrade
Once all tasks are cleared and the queue is empty, you can safely upgrade to X-Cart 5.6.0.x.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!