Magento Commerce only

Install the B2B extension

The Magento Commerce for B2B extension is only available for Magento Commerce v2.2.0. You must install it after installing Magento Commerce.

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
    

After completing the installation, you must follow the post-installation steps.

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
    

Append & to the command to run it in the background, return to a prompt, and continue running commands (e.g., 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.

If you enable the Shared Catalog module, you must also enable the Company module. The Quick Order and Requisition Lists modules can be enabled/disabled independently.

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

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

    Enable B2B features

  3. Click Save Config.

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