General: Upgrading to Magento with integrated Engagement Cloud connector (for 2.2.2 or above)

Summary

This article outlines, in several scenarios, how to upgrade to Magento 2.2.2 or above now that Engagement Cloud's bundled in.

Scenario 1 - Fresh installation/upgrading of Magento to 2.2.2 or above with integrated Engagement Cloud connector (v2.3.8), with no prior connector installed

Requirement: Upgrade to latest connector version.

Steps:
1. Fresh install of 2.2.2 or above
2. Run command "composer require dotmailer/dotmailer-magento2-extension"
3. Run command "bin/magento setup:upgrade"

Result: Connector is upgraded to the latest connector version.

Scenario 2a - Upgrading Magento to 2.2.2 or above, with non-integrated Engagement Cloud connector (lower than v2.3.8) already installed with Composer

Requirement: Upgrade to Magento 2.2.2 or above and fetch latest connector version.

Steps:

1. Upgrade to 2.2.2 or above
2. Run "composer require dotmailer/dotmailer-magento2-extension"

Result:
Connector is upgraded to the latest version.

Scenario 2b - Upgrading Magento to 2.2.2 or above, with non-integrated Engagement Cloud connector (higher than v2.3.8) already installed with Composer

Requirement: Upgrade to Magento 2.2.2 or above and fetch latest connector version.

Steps:

1. Upgrade to 2.2.2 or above
2. Run "composer update dotmailer/dotmailer-magento2-extension"

Result:
Connector is upgraded to latest version.

Scenario 3 - Upgrading Magento to 2.2.2 or above, with non-integrated Engagement Cloud connector already installed with a package drop

Requirement: Upgrade to Magento 2.2.2 or above and fetch latest connector version.

Steps:
1. Uninstall the non-integrated connector using the following steps:
   i) Remove the folder app/code/Dotdigitalgroup/Email
   ii) Remove Dotdigitalgroup_Email from app/etc/config.php
2. Upgrade to 2.2.2 or above
3. Run command "composer require dotmailer/dotmailer-magento2-extension"
4. Run command "bin/magento setup:upgrade"

Result:
Connector is upgraded to latest version.

Note: Connector tables will be re-created and all the data will get re-imported in the above scenario.
Did you find this article helpful?

Can we help?

Thanks for using Engagement Cloud. If you need more help or support, then contact our support team.