Migrate Akeneo 4.x to 5.x

This blog is all about migration process from Akeneo 4.x to 5.x.

Nowadays, almost every customer wants to see the relevant product information for making the decision of purchasing the goods. They wouldn’t consider a purchase in most cases if the retailer is not providing the correct information.

Now, in modern commerce, you can invest in new technologies like PIM to provide compelling product information to the end-user.

Akeneo is one of best PIM solution provider in the World also, it is famous due to powerful, flexible, and adaptable Product Information Management solution.

Recently, Akeneo released the Akeneo version 5.x with almost 70 new features in Community as well as Enterprise Edition.

Akeneo is the most used open-source PIM solution in the World. There are 75k companies over the Globe managing the Product Information using Akeneo. They have also the enterprise edition of the Akeneo solution. It is famous among all the PIM because of its organizability functionalities.

Webkul is one of the best Akeneo solution providers in the World. It has the largest number of Akeneo connectors available for various eCommerce frameworks. Webkul developed more than 50+ extensions for Akeneo and, it is expanding day by day.

Also, Akeneo 5.x is released with some outstanding features. You can check here features:

• Automation
• Data governance
• Improved Quality
• Connectivity

Here you will find the furthermore steps that will help you to migrate the Akeneo 4.x to 5.x.

Note: Please make sure that you have taken the database backup before the migration. Further, you have to check that the daemon is not running in the background.

Step 1: Firstly, you have to stop running Daemon.

Step 2: Take the MySQL Dump of your Production Database using the terminal or our Backup Connector.

Upgradation Requirement

Step 3: You need to upgrade the server component for the new version 5.x.

• PHP 7.4
• MySQL 8.0
• Elasticsearch 7.10

You can check here furthermore information of server requirement here:

• Ubuntu 18.04
• Debian 10

You can check here moreover details of the the “Periodic tasks & Crontab configuration“.

Step 4: In addition, you have to upgrade the “Virtual Host Configuration“.

<VirtualHost *:80>
    ServerName akeneo-pim.local

    DocumentRoot /path/to/installation/pim-community-standard/public
    <Directory /path/to/installation/pim-community-standard/public>
        AllowOverride None
        Require all granted

        Options -MultiViews
        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteRule ^(.*)$ index.php [QSA,L]
    </Directory>

    <Directory /path/to/installation/pim-community-standard/public/bundles>
        RewriteEngine Off
    </Directory>

    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php7.4-fpm.sock|fcgi://localhost/"
    </FilesMatch>

    SetEnvIf Authorization .+ HTTP_AUTHORIZATION=$0

    ErrorLog ${APACHE_LOG_DIR}/akeneo-pim_error.log
    LogLevel warn
    CustomLog ${APACHE_LOG_DIR}/akeneo-pim_access.log combined
</VirtualHost>

Prepare the Setup

Step 5: The root of the current installation directory will be $INSTALLATION_DIR. Further, you need to run these commands.

$ export APP_ENV=prod
$ export INSTALLATION_DIR=/srv/pim
$ cd $INSTALLATION_DIR
$ cp -R ./vendor/akeneo/pim-community-dev/upgrades/* ./upgrades/
$ php bin/console doctrine:migrations:version --add --all -q
$ rm -rf var/cache/

Akeneo PIM COMPOSER.JSON can be downloaded from the Github repository.

$  curl https://raw.githubusercontent.com/akeneo/pim-community-standard/5.0/composer.json > $INSTALLATION_DIR/composer.json

Migration Process

Step 6: Moreover, for the preparation of the migration process run these commands:

$ export APP_ENV=prod
$ vendor/akeneo/pim-community-dev/std-build/migration/prepare_40_to_50.sh

Step 7: Please ensure that the migration requirement is ready.

$ rm -Rf var/cache
$ bin/console pim:installer:check-requirements

After running this command if you will face any issues then you need to check the server required to process the next step.

Step 8: After that you need to prepare the Front-end dependencies.

$ make upgrade-front

Step 9: Then run the final command to migrate your data.

$ bin/console doctrine:migrations:migrate

Above all steps will help you to migrate the data from Akeneo 4.x to 5.x.

Further, to know more about the Akeneo 5.x changes, then you need to check this blog. Everything you need to know about Akeneo 5.x

To know moreover details of the migration process, please check here:

Support

That is all about the Akeneo 4.x to 5.x Migration Process. Moreover, if you have any doubts or queries regarding the extension get back to us at support@webkul.com or create a ticket at our HelpDesk system.