Akeneo PIM preferably requires a Hypernode Professional M hosting plan or larger. You can either choose to install it on a seperate Hypernode instance or on the same Hypernode as your Magento or Shopware installation. If you choose the latter you have to make sure that you have enough resources (disk space, memory and CPU) left. Furthermore you need to make sure that you are already using MySQL 5.7, PHP 7.2 and Elasticsearch 6.x, so it won’t affect your shop negativily. Installing Akeneo may take up to 10 minutes

Upgrade your PHP version

Before installing Akeneo, make sure your PHP version is changed to PHP 7.2.

Enable PHP-APCU

Upgrade to MySQL 5.7

Important: After an update to MySQL 5.7, it’s not possible to switch to MySQL 5.6.

Enable and configure Elasticsearch v6

Install Node.js v10.16

After Node.js has been installed you can check if it’s correctly set by running node -v. This should output v10.16.0.

Install Yarn latest version

Download and install Akeneo using the command line

Download and unzip the latest stable release to /data/web/akeneo.

Download Akeneo sample data

If you want to start with preconfigured demo data also known as ‘icecat’

Download Akeneo without sample data

If you want to start a fresh blank catalog also known as ‘minimal’

Unpack Akeneo

After you’ve downloaded Akeneo unpack it.

Setting up Akeneo

First change the MySQL username and password in ~/akeneo/pim-community-standard/app/config/parameters.yml to your own credentials.

Create an administrator user

Fill in the form with a Username, Password, First name, Last name, Email and local code.

Finish the installation

Akeneo Nginx configuration

If your Magento or Shopware installation already points to example.hypernode.io, your Akeneo installation will be available on a subdomain, for example akeneo.example.hypernode.io. Create a file called /data/web/nginx/http.akeneo.conf and insert the template below. Don’t forget to change example to the app name of your Hypernode.

Restart PHP-FPM

Tada! Your Akeneo-installation is now available on akeneo.example.hypernode.io!

Configure your Akeneo cron

After installing Akeneo, configure your cron by adding these scripts to your crontab file:

Troubleshooting

  • Error when installing Akeneo: No alive nodes found in your cluster
    Make sure ElasticSearch is enabled.

  • When creating a user in Akeneo: Property “user_default_locale” expects a valid locale code. The locale does not exist, “en_US” given.
    Akeneo wasn’t installed properly, probably because elasticsearch wasn’t enabled in the first place.

  • request.CRITICAL: Uncaught PHP Exception “index_not_found_exception”,”reason”:”no such index”
    There may be mismatches in the Elastic index. Reset the Elasticsearch indexes:

00