Here is our first aid kit if you encounter a bug on your PIM project.
Sometimes, it's quite clear that the behaviour you experience is a bug. But it is not always the case. Some behaviours can occur because you missed something (for instance a permissions misconfiguration), and the PIM just works as designed.
If you have doubts, please have a look at the following resources. If not, go to the next step.
Tip
User guides can be accessed at any moment from the (?) icon on the top right corner of the PIM.
There are some client side requirements to use the PIM. Please check that everything is OK by looking at /reference/technical_information/client_side_compatibilities
.
Maybe something has been changed in your server. You can check that by running the following command:
cd /path/to/your/pim/
php app/console pim:installer:check-requirements
Note
All our system requirements can also be found in this documentation: /developer_guide/installation/system_requirements/system_requirements
.
In addition, check that:
- The Xdebug PHP extension is well deactivated.
- The PIM commands are well run in prod mode instead of dev mode (See: Symfony documentation: Selecting the Environment for Console Commands).
- Your crontab scheduled PIM commands are not launched too frequently.
Depending on your infrastructure, you may need to check some points:
- Make sure you are not experiencing latency issues on your local network.
- Make sure you don't have an issue with one of your network equipments. For instance with a proxy server.
Make sure that you applied the latest patches available for your PIM version. You can check your current PIM version at the bottom of the PIM login or dashboard pages.
Tip
The /developer_guide/migration/index
documentation explains how to update your PIM to the most recent minor version.
As for the PIM it's important to check that the additional bundles you use (for instance: EnhancedConnectorBundle, CustomEntityBundle, InnerVariationBundle...) are up-to-date.
If you need assistance, please refer to each bundle's documentation.
Tip
This step is recommended if you encounter user interface issues like javascript errors or display problems.
From a technical point of view, assets are all the javascript, css and media files used by the PIM itself, by its dependencies, and eventually by your custom developments.
To make sure everything is OK, you can run the following commands:
One last thing, clear your browser's cache:
Clear the PIM cache (also known as "Symfony cache") by running the following commands:
cd /path/to/your/pim/
php app/console cache:clear --env=prod
Tip
This step is recommended if you encounter performances issues.
Each catalog is unique. How many channels, locales, attributes, families, categories, products and users do you have? These values may had increased drastically since you began using your PIM.
Most of this information can be found on the PIM system information screen (under System > System information).
Once the calculations made, please have a look at our /reference/scalability_guide/index
and /reference/performances_guide/index
.
Warning
If the previous steps failed to solve the bug, try this one.
Disable all custom developments by commenting them in the "AppKernel.php" file /path/to/your/pim/app/AppKernel.php
.
// your app bundles should be registered here
// new YourCompagny\Bundle\AppBundle\YourCompagnyCustomBundle(),
And then, re-apply Step 7: are your assets properly deployed? and Step 8: did you clear the cache?
Alternatively, you can check if the issue is reproducible on http://demo.akeneo.com (only for the latest PIM version).
Sorry to hear that. It seems it's /troubleshooting/bug_qualification/index
time.