This article explains errors you may experience while using the Upgrade Compatibility Tool and provides solutions to fix those errors so that you can successfully execute the tool.
Affected products and versions
- Upgrade Compatibility Tool is compatible with Adobe Commerce versions from 2.3.0 onwards.
Segmentation fault error
When two modules have the same name, the Upgrade Compatibility Tool shows a segmentation fault error.
To avoid this error it is recommended to run the
bin command with the added option
bin/uct upgrade:check /<dir>/<instance-name> -m /vendor/<vendor-name>/<module-name>
<dir> value is the directory where your Adobe Commerce instance is located.
If after running this command:
bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
The only output is
Upgrade compatibility tool:
bin/uct upgrade:check /var/www/project/magento/ -c 2.4.1 Upgrade compatibility tool
The likely cause is a PHP memory limitation.
There are two possible solutions to avoid this PHP memory limitation.
Override the memory limitation by setting
php -d memory_limit=-1 /bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
M2_VERSION is the target Adobe Commerce version you want to compare to your Adobe Commerce instance.
-m option allows the Upgrade Compatibility Tool to analyze each specific module independently to avoid encountering two modules with the same name in your Adobe Commerce instance.
This command option also allows the Upgrade Compatibility Tool to analyze a folder containing several modules:
bin/uct upgrade:check /<dir>/<instance-name> -m /vendor/<vendor-name>/
See the Run the tool in a command-line interface page for more information on command-line interface options.