Getting Akeneo PIM¶

1
2

$ wget https://download.akeneo.com/pim-community-standard-v3.2-latest-icecat.tar.gz #for icecat version
$ wget https://download.akeneo.com/pim-community-standard-v3.2-latest.tar.gz #for minimal version

1
2

$ mkdir -p /path/to/installation
$ tar -xvzf pim-community-standard-v3.2-latest-icecat.tar.gz -C /path/to/installation/

Initializing Akeneo¶

1

$ cd /path/to/installation/pim-community-standard

Dependencies,

1
2

$ php -d memory_limit=3G ../composer.phar install --optimize-autoloader --prefer-dist
$ yarn install

Frontend,

1
2

$ php bin/console cache:clear --no-warmup --env=prod
$ php bin/console pim:installer:assets --symlink --clean --env=prod

Installation,

1
2

$ bin/console pim:install --force --symlink --clean --env=prod
$ yarn run webpack

You now have to create an administrator user via the command pim:user:create. There is no default admin account. For instance:

1

$ bin/console pim:user:create superadmin GENERATEDSUPERADMINPASSWORD support@example.com Super Admin en_US --admin -n --env=prod

Configuring tasks via crontab¶

The application needs the following tasks to be executed in background on a regular basis.

Edit your crontab with crontab -e and configure your tasks.

You have to add these 3 commands to your local installation:

1
2
3

php /path/to/installation/pim-community-standard/bin/console pim:completeness:calculate --env=prod    # recalculates the products completeness
php /path/to/installation/pim-community-standard/bin/console pim:versioning:refresh --env=prod        # processes pending versions
php /path/to/installation/pim-community-standard/bin/console pim:volume:aggregate --env=prod          # recalculates the number of product values

In the following example, these lines will run the completeness calculation at 11pm, the versioning calculation at 5am and the aggregate volume at 10pm every day:

1
2
3
4

# m  h  dom  mon  dow  command
0 23  *    *    *    php /path/to/installation/pim-community-standard/bin/console pim:completeness:calculate --env=prod > /path/to/installation/pim-community-standard/var/logs/calculate_completeness.log 2>&1
0 5  *    *    *    php /path/to/installation/pim-community-standard/bin/console pim:versioning:refresh --env=prod > /path/to/installation/pim-community-standard/var/logs/refresh_versioning.log 2>&1
0 22  *    *    *    php /path/to/installation/pim-community-standard/bin/console pim:volume:aggregate --env=prod > /path/to/installation/pim-community-standard/var/logs/volume_aggregate.log 2>&1

Launching the daemon for job execution¶

Launch a daemon in order to execute the jobs. Please follow this documentation: Setting up the job queue daemon.

Testing your installation¶

Access the web folder using your favorite web browser and log in with the user you just created with the pim:user:create command . If you see the dashboard, congratulations, you have successfully installed Akeneo PIM! You can also access the dev environment using app_dev.php as index.

If an error occurs, it means that something went wrong in one of the previous steps. Please check error outputs of all the steps.

Known issues¶

• with XDebug on, the default value of max_nesting_level (100) is too low and can make the ACL loading fail (which causes 403 HTTP response code on every application screen, even the login screen). A working value is 500: xdebug.max_nesting_level=500
• not enough memory can cause the JS routing bundle to fail with a segmentation fault. Please check with php -i | grep memory that you have enough memory according to the requirements
• If you do install the PIM twice, ensure all the PIM cron tasks are stopped before the installation of the database, to avoid Base table or view not found errors.

What’s next?¶

Now you have an Akeneo PIM up and running. But maybe you want more! What about these topics?

• You can switch to the minimal dataset or import your own data by following How to customize the Dataset.
• You can add additional translations by following How to Add Translation Packs.