Review the requirements and gather required information before you install Channel Manager.
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).
For help with installing Commerce software using the CLI, see Install an extension.
Use these instructions to install Channel Manager on Adobe Commerce and Magento Open Source to an on-premises instance.
Log in to the Commerce server as a user with permissions to write to the Commerce file system.
Put your website into maintenance mode.
$ bin/magento maintenance:enable
From the Commerce project root directory, add Channel Manager to composer.json
.
composer require magento/channel-manager --no-update
If prompted, enter the access keys from your Commerce account.
Your public key is your username; your private key is your password.
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
.
Wait for Composer to finish updating project dependencies and resolve any errors.
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
Register the extension.
bin/magento setup:upgrade
If prompted, recompile your Commerce project.
bin/magento setup:di:compile
Clean the cache.
bin/magento cache:clean
Disable maintenance mode.
bin/magento maintenance:disable
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.
On your local workstation, change to the Cloud project root directory.
Create or check out a development branch.
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
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
.
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>
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.
After you install the extension successfully, log in to the Admin to configure the Commerce Services Connector.
For instructions to update Channel Manager to a new release, see Upgrade modules and extensions.
Use the following information to resolve errors that occur during the Channel Manager installation process.
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:
Find the location of the auth.json
file:
$ composer config –global home
View the auth.json
file.
$ cat /path/to/auth.json
Verify that the credentials in the auth.json match the keys associated with the MAGE ID used to register for the Channel Manager service.
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
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
For problems deploying the extension to the cloud, see extension deployment failure.