Upgrade Akeneo PIM projects

#How to apply a patch - Enterprise Edition - Flexibility Cloud offer

In the following example, Akeneo PIM version 5.0.2 has just been released and we are using an Akeneo PIM version 5.0.1.

We always tag both Community and Enterprise versions with aligned version numbers, be sure to use the exact same version for CE and EE, for instance, a EE 5.0.2 fix may depend on CE 5.0.2.

Using the exact patch version will avoid any local composer cache issue.

In your enterprise standard project, the composer.json will reference both community and enterprise bundles repositories.

To upgrade, please change the composer.json to:

{
    ...
    "akeneo/pim-enterprise-dev": "5.0.2",
    ...
}

Run the composer update command:

composer --prefer-dist update

Be aware that your composer.json won’t be updated and some dependencies might be missing or from an outdated version.

You have to check whether the latest composer.json is different from your own. In this case you should backup your current composer.json and download the newest one beforehand.

Double check in the output of this command that the 5.0.2 version has been fetched, you can also check it by using the following command:

composer licenses

Then clean the cache, re-install assets and warmup the cache:

partners_clear_cache
rm yarn.lock
bin/console --env=prod pim:installer:assets
yarn install
yarn run less
yarn run webpack

If the patch is a javascript fix, please clear your browser cache before testing.

We set any other dependencies to their exact patch versions to avoid compatibility issues.

If you get a 500 error after upgrading and clear cache isn’t working try to clear the apc cache with a php script or restart Apache/Web server.

After that you can relaunch fpm to avoid generating outdated cache:

partners_php7.4-fpm restart

The partners_clear_cache and the partners_php7.4-fpm commands are only available in Akeneo Cloud Offer. You can find more commands in our System Administration & Services Management page.

If you have an error during the yarn run webpack command, please execute this process to upgrade your package.json, reinstall the correct version of yarn modules and clean your cache.

cp vendor/akeneo/pim-enterprise-dev/std-build/package.json package.json
cp vendor/akeneo/pim-enterprise-dev/yarn.lock yarn.lock
rm -rf node_modules
yarn install
partners_php7.4-fpm restart
rm -rf var/cache/* ./public/bundles/* ./public/css/* ./public/js/*
bin/console pim:installer:assets
bin/console cache:warmup
yarn run less
make javascript-prod
make javascript-extensions

Found a typo or a hole in the documentation and feel like contributing?
Join us on Github!