Shopware 6 Background Queue Worker (Managed Server)

This article refers to the administration and control of the Shopware 6 Background Queue Worker in the support level "Managed". If you have ordered your Shopware server in the support level "Unmanaged", please use the article: Shopware 6 Background Queue Worker setup (Unmanaged Server)

Shopware 6 uses so-called message queue workers for the processing of background tasks as well as for the processing of recurring tasks. In the standard configuration of Shopware 6, these are executed via the logged-in administrator in the browser. As soon as more than one administrator is logged in, these message queue workers are executed multiple times and this can lead to a very high CPU load and problems with the execution of PHP.

Foreword

For our Managed Shopware Server, a graphical administration of the Systemd services is available, so that configuration via SSH is completely unnecessary. Both the Message Queue Consumer Service and the Shopware Scheduled Tasks Service are automatically pre-installed as standard.

Customization of the Shopware Background Services

To make adjustments to the background services, open the creoline customer center at account.creoline.com and navigate to the menu item Server via the sidebar and select the appropriate server.

Select the Configuration files tab:

You can customize the desired service using the Edit button:

Setting options

Parameter	Value	Description
numprocs	`1 - 99`	number of parallel worker processes
command (Receivers)	`async failed low_priority`	Specification of the receivers to be processed
user	`<systemuser>`	SSH user name of the owner of the Shopware instance

Then make the desired adjustments to the corresponding service and save them using the Save changes button.

A new version of your configuration is automatically created in the background so that you can restore previous versions at any time.

The underlying Systemd service then restarts automatically to apply your changes immediately.

Frequently asked questions

How can I configure more than one Message Queue Consumer process if the parameter `numprocs` does not exist?

We will be happy to set up the latest message queue consumer process for you on the basis of supervisor. Simply contact our support team and coordinate the desired configuration with us.

Please always state the store domain or the corresponding Plesk subscription when making an inquiry.

How can I include another receiver in the execution of the message queue consumer?

To add another receiver, you can add the desired receiver after the pre-installed receivers async failed.

Example configuration:

[..] bin/console messenger:consume async failed new_receiver [..]

In my Shopware server the tab "Configuration files" is not displayed, what do I have to do?

If the tab is not displayed on your Shopware server, the Background Queue Systemd service has been implemented using an older technology. We will be happy to set up the module for you at a later date so that you can benefit from the graphical interface.