Install the B2B extension

Installation

1. Change to your Magento installation directory and enter the following command to update your composer.json file and install the Magento Commerce for B2B extension:

   composer require magento/extension-b2b
   

2. When prompted, enter your authentication keys. Your public key is your username; your private key is your password.

3. Run the following commands after Composer finishes updating modules:

   bin/magento setup:upgrade
   
   bin/magento setup:di:compile
   
   bin/magento setup:static-content:deploy -f
   

Post-installation

After installing the Magento Commerce for B2B extension, follow these instructions to launch Magento Commerce for B2B.

Start message consumers

The Magento Commerce for B2B extension uses MySQL for message queue management. If you want to enable the B2B Shared Catalog feature, you must start the corresponding message consumers after installation.

1. List the available message consumers:

   bin/magento queue:consumers:list
   

   You should see the following consumers:

   sharedCatalogUpdatePrice
   sharedCatalogUpdateCategoryPermissions
   

2. Start each consumer separately:

   bin/magento queue:consumers:start <consumer_name>
   

   For example:

   bin/magento queue:consumers:start sharedCatalogUpdatePrice
   

Refer to Manage message queues for more information.

Add message consumers to cron

You may also add these two message consumers to the cron job (optional). For this, add these lines in your crontab.xml:

* * * * * ps ax | grep [s]haredCatalogUpdateCategoryPermissions >>/dev/null 2>&1 || nohup php /var/www/html/magento2/bin/magento queue:consumers:start sharedCatalogUpdateCategoryPermissions &
* * * * * ps ax | grep [s]haredCatalogUpdatePrice >>/dev/null 2>&1 || nohup php /var/www/html/magento2/bin/magento queue:consumers:start sharedCatalogUpdatePrice &

Specify parameters for message consumers

Depending on your system configuration, to prevent possible issues, you may also need to specify the following parameters when starting the services:

• --max-messages: manages the consumer’s lifetime and allows you to specify the maximum number of messages processed by the consumer. The best practice for a PHP application is to restart long-running processes to prevent possible memory leaks.

• --batch-size: allows you to limit the system resources consumed by the consumers (CPU, memory). Using smaller batches reduces resource usage and, thus, leads to slower processing.

Enable B2B features in Magento Admin

After installing the Magento Commerce for B2B extension and starting message consumers (if you want to enable the Shared Catalog module), you must also enable B2B modules in Magento Admin.

1. Access the Magento Admin and click Stores > Configuration > General > B2B Features.

2. Select Yes from the drop-down menus to enable B2B features:

   

3. Click Save Config.

Looking for more documentation? Checkout the B2B Developer Guide and User Guide.