ÃÛ¶¹ÊÓƵ

Message broker

ÃÛ¶¹ÊÓƵ Commerce uses the RabbitMQ open-source message broker. It offers a reliable, highly available, scalable, and portable messaging system.

Message queues provide an asynchronous communications mechanism in which the sender and the receiver of a message do not contact each other. Nor do they need to communicate with the message queue at the same time. When a sender places a message in a queue, it is stored until the recipient receives them.

The message queue system must be established before you install ÃÛ¶¹ÊÓƵ Commerce. The basic sequence is:

Install RabbitMQ on Ubuntu

To install RabbitMQ on Ubuntu 16, enter the following command:

sudo apt install -y rabbitmq-server

This command also installs the required Erlang packages.

If you have an older version of Ubuntu, RabbitMQ recommends installing the package from their website.

Refer to for more information.

Install RabbitMQ on CentOS

Install Erlang

RabbitMQ was written using the Erlang programming language, which must be installed on the same system as RabbitMQ.

See for more information.

Refer to the to install the correct version.

Install RabbitMQ

The RabbitMQ server is included on CentOS, but the version is often old. RabbitMQ recommends installing the package from their website.

Refer to the RabbitMQ install page to get the latest supported version. ÃÛ¶¹ÊÓƵ Commerce 2.3 and 2.4 support RabbitMQ 3.8.x.

Refer to for more information.

Configure RabbitMQ

Review the official RabbitMQ documentation to configure and manage RabbitMQ. Pay attention to the following items:

Install with RabbitMQ and connect

If you install ÃÛ¶¹ÊÓƵ Commerce after you install RabbitMQ, add the following command-line parameters during installation:

--amqp-host="<hostname>" --amqp-port="5672" --amqp-user="<user_name>" --amqp-password="<password>" --amqp-virtualhost="/"

Where:

Connect RabbitMQ

If you already had ÃÛ¶¹ÊÓƵ Commerce installed and you want to connect it to RabbitMQ, add a queue section in the <install_directory>/app/etc/env.php file so that it is similar to the following:

'queue' =>
  array (
    'amqp' =>
    array (
      'host' => 'rabbitmq.example.com',
      'port' => '11213',
      'user' => 'magento',
      'password' => 'magento',
      'virtualhost' => '/'
     ),
  ),

You can also set RabbitMQ configuration values using the bin/magento setup:config:set command:

bin/magento setup:config:set --amqp-host="rabbitmq.example.com" --amqp-port="11213" --amqp-user="magento" --amqp-password="magento" --amqp-virtualhost="/"

After the running the command or updating the <install_directory>/app/etc/env.php file with AMQP configuration values, run bin/magento setup:upgrade to apply the changes and create the required queues and exchanges in RabbitMQ.

Configure SSL

To configure support for SSL, edit the ssl and ssl_options parameters in the <install_directory>/app/etc/env.php file so that they are similar to the following:

'queue' =>
  array (
    'amqp' =>
    array (
      'host' => 'rabbitmq.example.com',
      'port' => '11213',
      'user' => 'magento',
      'password' => 'magento',
      'virtualhost' => '/',
      'ssl' => 'true',
      'ssl_options' => [
            'cafile' =>  '/etc/pki/tls/certs/DigiCertCA.crt',
            'certfile' => '/path/to/magento/app/etc/ssl/test-rabbit.crt',
            'keyfile' => '/path/to/magento/app/etc/ssl/test-rabbit.key'
       ],
     ),
  ),

Start the message queue consumers

After you have connected ÃÛ¶¹ÊÓƵ Commerce and RabbitMQ, you must start the message queue consumers. See Configure message queues for details.