Install Channel Manager

Review the requirements and gather required information before you install Channel Manager.

Install the extension

The Channel Manager installation instructions depend on whether Adobe Commerce or Magento Open Source is deployed on-premises or on cloud infrastructure.

• Install on an On-premises instance.

• Install on an Adobe Commerce on cloud infrastructure instance

Both methods require you to use the Command Line Interface (CLI).

Install on an on-premises instance

Use these instructions to install Channel Manager on Adobe Commerce and Magento Open Source to an on-premises instance.

1. Log in to the Commerce server as a user with permissions to write to the Commerce file system.

2. Put your website into maintenance mode.

   $ bin/magento maintenance:enable
   

3. From the Commerce project root directory, add Channel Manager to composer.json.

    composer require magento/channel-manager --no-update
   

4. If prompted, enter the access keys from your Commerce account.

   Your public key is your username; your private key is your password.

5. Update the dependencies and install the extension.

   composer update magento/channel-manager
   

   The composer update command updates only the dependencies required for Channel Manager. To update all dependencies, use this command instead: composer update.

6. Wait for Composer to finish updating project dependencies and resolve any errors.

7. Verify the module installation:

   • Check the module status.

     bin/magento module:status Magento_SalesChannels
     

     Sample response:

     Module is enabled
     

   • If the module is not enabled, enable it.

   bin/magento module:enable Magento_SalesChannels
   

8. Register the extension.

   bin/magento setup:upgrade
   

9. If prompted, recompile your Commerce project.

   bin/magento setup:di:compile
   

10. Clean the cache.

    bin/magento cache:clean
    

11. Disable maintenance mode.

    bin/magento maintenance:disable
    

Install on an Adobe Commerce on Cloud Infrastructure Instance

Work in a development branch when adding an extension to your cloud instance.

For help with using branches, see Get started creating branches in the Commerce on Cloud Infrastructure Guide.

During installation, the extension name (magento\channel-manager) is automatically inserted in the app/etc/config.php file. You do not need to edit the file directly.

1. On your local workstation, change to the Cloud project root directory.

2. Create or check out a development branch.

3. Using the Composer name, add the extension to the require section of the composer.json file.

   composer require magento/module-sales-channels-extension --no-update
   

4. Update the dependencies and install the extension.

   composer update magento/module-sales-channels-extension
   

   The composer update command updates only the dependencies required for Channel Manager. To update all dependencies, use this command instead: composer update.

5. Add, commit, and push code changes–include changes to both the composer.lock and composer.json file.

   $ git add -A
   

   $ git commit -m "Install channel manager extension"
   

   $ git push origin <branch-name>
   

6. After the build and deploy process completes, use SSH to log in to the remote environment and verify that the extension installed correctly.

   bin/magento module:status Magento_SalesChannels

Sample response:

Module is enabled

If the module is disabled, enable it in your local environment and deploy your changes.

1. After you install the extension successfully, log in to the Admin to configure the Commerce Services Connector.

   NOTE

   For instructions to update Channel Manager to a new release, see Upgrade modules and extensions.

Troubleshooting

Use the following information to resolve errors that occur during the Channel Manager installation process.

Incorrect Composer keys

If the access keys used to authenticate to the Composer repository are invalid, or not linked to the MAGE ID used to sign up for the Channel Manager service, the following error displays.

Could not find a matching version of package magento/channel-manager. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).

Check the key configuration:

1. Find the location of the auth.json file:

   $ composer config –global home
   

2. View the auth.json file.

   $ cat /path/to/auth.json
   

3. Verify that the credentials in the auth.json match the keys associated with the MAGE ID used to register for the Channel Manager service.

Insufficient memory for PHP

The following error displays if the system does not have enough memory allocated for PHP.

Fatal error: Allowed memory size of 2146435072 bytes exhausted (tried to allocate 4096 bytes) in phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchGraph.php on line 52

Use either of the following methods to resolve the memory issue:

• Increase the memory limit for PHP in the environment php.ini file. Also, verify that the Commerce instance has the recommended values for other PHP settings.

• Specify the memory limit from the command line.

  $ php -d memory_limit=-1 \[path to composer]/composer require magento/payment-services.
  

  For example:

  $ php-d memory_limit=-1 vendor/bin/composer require magento/channel-manager
  

Missing view

If you get an error about a missing process_catalog_exporter_view during the Channel Manager installation, try refreshing the indexers.

php bin/magento indexer:refresh

Cloud deployment errors

For problems deploying the extension to the cloud, see extension deployment failure.