Akeneo PIM Community Standard Edition
Welcome to Akeneo PIM Standard Edition.
This repository contains the minimal application needed to start a new project based on Akeneo PIM. Practically, it means Akeneo PIM is declared as a dependency and will reside in the vendor directory.
If you want to contribute to Akeneo PIM, please use the PIM Community Dev repository located at https://github.com/akeneo/pim-community-dev
Requirements
System
- PHP 5.4.* above 5.4.4
- PHP Modules:
- php5-curl
- php5-gd
- php5-intl
- php5-mysql
- php5-mcrypt
- php-apc for PHP 5.4 (opcode and data cache)
- php5-apcu for PHP 5.5 (for data cache, as opcode cache usually included)
- PHP memory_limit at least at 256 MB on Apache side and 728 MB on CLI side (needed for installation, can be lowered to 512MB after installation for PHP-CLI)
- MySQL 5.1 or above
- Apache mod rewrite enabled
Web browsers
- tested: Chrome & Firefox
- should work: IE 10, Safari
- will not work: IE < 10
Installation instructions
Recommended installation
To install Akeneo PIM for a PIM project or for evaluation, please follow: http://docs.akeneo.com/master/installation/installation_workstation.html
Create a Akeneo PIM project with Composer
Alternatively, you can install Akeneo PIM with Composer, but please make sure that all requirements are fulfilled.
If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:
$ curl -s https://getcomposer.org/installer | php
Due to some Oro Platform limitations, you MUST create your database before launching composer.
Please note that you will certainly need to provide your GitHub credentials with this method, A lot of our dependencies are coming from GitHub and this reaches the max limit of 50 API calls from anonymous users.
$ php composer.phar create-project --prefer-dist akeneo/pim-community-standard ./pim-project v1.2.0-RC3
After that, follow the instructions here: http://docs.akeneo.com/master/installation/installation_workstation.html#installing-akeneo
Write permissions
The following directories must be writable for both the CLI user and the Apache user:
- app/cache
- app/logs
- app/import
- app/export
- web/bundles
- app/uploads/product
- app/archive
See http://docs.akeneo.com/master/installation/installation_workstation.html#apache for an alternative solution.
Add translation packs (optional)
You can download translation packs from crowdin:
The Akeneo PIM archive contains the following directories tree: <locale>/<version>/<translation_directories>
You just have to paste the <translation_directories> in your app/Resources/ directory.
For Oro Platform, the archive contains the same directories tree except the version directory which is removed.
Connect to your PIM application
Go to http://akeneo-pim.local/ for production mode or http://akeneo-pim.local/ for production mode.
You can now connect as Akeneo administrator with the following credentials:
- username: "admin"
- password: "admin"
Generating a clean database
By default, when you install the PIM, the database is preconfigured with demo data.
If you want to get only the bare minimum of data to have a clean but functional PIM, just change the following config line in app/config/parameters.yml:
installer_data: PimInstallerBundle:minimal
Then relaunch the install with the db option:
$ php app/console pim:installer:db --env=prod
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 -
some segmentation fault and
zend_mm_heap corrupted
error can be caused as well by the circular references collector. You can disable it with the following setting in your php.ini files:zend.enable_gc = 0
-
When installing with
php composer.phar create-project...
command, error aboutUnable to parse file "<path>/Resources/config/web.xml".
. It seems an external issue related to libxml, you can downgrade tolibxml2.x86_64 0:2.6.26-2.1.21.el5_9.1
. Look at: http://www.akeneo.com/topic/erreur-with-php-composer-phar-beta4/ for more informations.