Skip to content

Commit

Permalink
Merge 6.0 into 7.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Doodoune committed Mar 23, 2023
2 parents 172994b + 3049e9d commit 78f7101
Show file tree
Hide file tree
Showing 4 changed files with 103 additions and 76 deletions.
11 changes: 0 additions & 11 deletions cloud_edition/flexibility_mode/docs/job_consumers_and_workers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -97,17 +97,6 @@ Examples
# Disable the consumer not to be started automatically at instance boot up
partners_systemctl pim_webhook_consumer disable
- Manage all daemons at once:
.. code-block:: bash
:linenos:
# Check the status of all daemons
partners_systemctl pim_job_consumer@* status
# Restart all daemons
partners_systemctl pim_job_consumer@* restart
Onboarder
---------

Expand Down
2 changes: 1 addition & 1 deletion maintain_pim/first_aid_kit/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Sometimes, it's quite clear that the behaviour you experience is a bug. But it i

If you have doubts, please have a look at the following resources. If not, go to the next step.

* `The PIM Help Center <https://help.akeneo.com/en_US/v3/index.html>`_
* `The PIM Help Center <https://help.akeneo.com/en_US/v6/index.html>`_
* `The PIM online API documentation <https://api.akeneo.com/>`_

.. tip::
Expand Down
20 changes: 16 additions & 4 deletions migrate_pim/apply_patch/apply_patch_ce.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Run the composer update command:
Be aware that your composer.json won't be updated and some dependencies might be missing or coming from an outdated version.

You have to check whether the latest composer.json is different from yours. In this case you should backup your current composer.json and download the newest one beforehand.
You have to make sure you have the latest version composer.json. In this case you should backup your current composer.json and download the newest one beforehand.

Double check in the output of this command that the latest version has been fetched, you can also check it by using the following command:

Expand All @@ -22,7 +22,7 @@ Then clean the cache, re-install assets and warmup the cache:

.. note::

Before launching the following commands, remember to stop the daemon to avoid generating outdated cache.
Before launching the following commands, remember to stop the daemons to avoid generating outdated cache.


.. code-block:: bash
Expand All @@ -43,7 +43,19 @@ Please **clear your browser's cache** before testing.
We set any other dependencies to their exact patch versions to avoid compatibility issues.


.. note::
Troubleshooting
-----------------------


**Cache issues**

If you get a 500 error after upgrading and clear cache isn't working, try clearing the apc cache with a PHP script or restart the Apache/Web server.


**Composer issues**

You have to make sure you have the latest version of composer.json. If this isn't the case, you should backup your current composer.json and download the newest one before updating.

If you get a 500 error after upgrading, and clear cache isn't working, try to clear the apc cache with a php script or restart Apache/Web server.
You need to get an archive containing Akeneo PIM and its PHP dependencies: https://download.akeneo.com/pim-community-standard-v6.0-latest-icecat.tar.gz

You can then copy the composer.json file to your pim installation.
146 changes: 86 additions & 60 deletions migrate_pim/upgrade/upgrade_from_50_to_60.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,29 @@ Use this documentation to upgrade projects based on Akeneo PIM Community Edition
Disclaimer
**********

Make sure your production database is backed-up before performing the data migration.
The queue daemon(s) must be stopped as well.
.. warning::
Make sure your production database is backed-up and the queue daemon(s) have been stopped before performing any data migration.

Prepare your project for the new technical stack
************************************************

Your current v5.0 application must have up to date migrations before migrating on the new technical stack.
.. note::
Your 5.0 application must be on the latest patch and migrations must be up-to-date before migrating to the new technical stack.

*If you do not apply the most recent patch and migrations, you may experience problems upgrading.*

Check the most recent patch version here:
- `Enterprise Edition <https://updates.akeneo.com/EE-5.0.json>`_
- `Community Edition <https://updates.akeneo.com/CE-5.0.json>`_

You can check your current patch version with the following command: ``composer licenses | grep akeneo/pim``

To install the most recent patch, use the instructions in :doc:`/migrate_pim/apply_patch/index`

The root of your current installation dir is referred as $INSTALLATION_DIR.
The directory at the root of your current installation is referred to as ``$INSTALLATION_DIR``.

.. warning::
Please note that this part of the migration needs to be executed on your PIM 5.0 **before** upgrading your technical stack.

.. code:: bash
Expand All @@ -25,46 +39,50 @@ The root of your current installation dir is referred as $INSTALLATION_DIR.
$ php bin/console doctrine:migrations:migrate
$ rm -rf var/cache/
.. note::
If you are updating an Enterprise Edition instance and are working with Akeneo Support, please run the following command (after executing ``doctrine:migrations:migrate``)
and provide us with the output so that we can quickly check for any database issues:

WARNING: please note that this part of the migration needs to be executed on your PIM v5.0 ``before`` upgrading your technical stack.
.. code:: bash
$ php bin/console doctrine:migration:status
Requirements
************

Updated System components
-------------------------

You have to make sure your system components are updated to the version required for Akeneo PIM:
- PHP 8.0
- MySQL 8.0
- Elasticsearch 7.16
.. note::
If you are using Enterprise Edition on the Akeneo Cloud Flexibility offering,
Akeneo will handle the component upgrades if you open a ticket with our Support team.

Your system components must be updated to the versions required for Akeneo PIM:
- ``PHP 8.0``
- ``MySQL 8.0``
- ``Elasticsearch 7.16``

.. note::
Elasticsearch supports in-place update: Elasticsearch 7.16 will be able to use indexes created
by previous Elasticsearch 7.x.
Elasticsearch supports in-place update.

So there's no need to export and reimport data for this system.
Elasticsearch 7.16 will be able to use indexes created by previous versions of Elasticsearch 7.x.

This means there's no need to export and reimport data for this update.

Updated System dependencies
---------------------------
Check your system dependencies are in sync with :doc:`/install_pim/manual/system_requirements/system_requirements`

Check your system dependencies are in sync with the :doc:`/install_pim/manual/system_requirements/system_requirements`

Updated crontab definition
--------------------------

Check your crontab is in sync with :doc:`/cloud_edition/flexibility_mode/docs/crontasks`

Check that your crontab is in sync with :doc:`/cloud_edition/flexibility_mode/docs/crontasks`

Upgraded Virtual Host configuration
-----------------------------------

*OnPremise only*
OnPremise only
^^^^^^^^^^^^^^

Since Akeneo PIM, instead of using one fpm pool, we are using one for the API, and one for UI.
Akeneo PIM uses one fpm pool each for the API and the UI.

You can check the VirtualHost configuration for 6.0 on your system: :doc:`/install_pim/manual/index`

Expand All @@ -73,24 +91,24 @@ Prepare your project

Akeneo PIM composer.json
----------------------------
The root of your current installation dir is referred as $INSTALLATION_DIR.

Community Edition
^^^^^^^^^^^^^^^^^

You can download the composer.json file directly from the Github repository:
You can download the ``composer.json`` file directly from the Github repository:

.. code:: bash
$ curl https://raw.githubusercontent.com/akeneo/pim-community-standard/6.0/composer.json > $INSTALLATION_DIR/composer.json
Enterprise Edition
^^^^^^^^^^^^^^^^^^
Please visit your `Akeneo Portal <https://help.akeneo.com/portal/articles/get-akeneo-pim-enterprise-archive.html>`_ to download the archive.
Please visit your `Akeneo Portal <https://help.akeneo.com/portal/articles/get-akeneo-pim-enterprise-archive.html>`_
to download the archive, then expand it to the installation directory on your host:

.. code:: bash
$ tar xvzf pim-enterprise-standard-<archive-suffix>.tar.gz -C $INSTALLATION_DIR --strip-components 1 pim-enterprise-standard/composer.json
$ tar xvzf pim-enterprise-standard-<ARCHIVE-SUFFIX>.tar.gz -C $INSTALLATION_DIR --strip-components 1 pim-enterprise-standard/composer.json
Load your PIM Enterprise dependencies
*****************************************
Expand All @@ -100,16 +118,25 @@ Load your PIM Enterprise dependencies
$ composer update
.. note::
You may need to temporarily increase the memory provided to ``composer``, as this step can be very memory consuming:

You may need to increase the memory provided to `composer`, as this step can be very memory consuming:

.. code:: bash
$ php -d memory_limit=4G /path/to/composer update
$ php -d memory_limit=4G <COMPOSER PATH>/composer update
Let Akeneo PIM continue the preparation for you
***************************************************

.. warning::
**Do not skip this step**

This script overwrites several configuration files, but it is necessary for the upgrade to succeed.

If you have customized your PIM (for example, by adding custom bundles),
we suggest saving a backup copy of your configuration files,
and you will need to resolve any conflicts.

Community Edition
-----------------

Expand All @@ -118,7 +145,6 @@ Community Edition
$ export APP_ENV=prod
$ vendor/akeneo/pim-community-dev/std-build/migration/prepare_50_to_60.sh
Enterprise Edition
------------------

Expand All @@ -127,11 +153,6 @@ Enterprise Edition
$ export APP_ENV=prod
$ vendor/akeneo/pim-enterprise-dev/std-build/upgrade/prepare_50_to_60.sh
.. warning::
This script overwrites several configuration files.

In case of customisation, you need to resolve conflicts.

Make sure your environment is ready to be migrated
**************************************************

Expand All @@ -140,11 +161,10 @@ Make sure your environment is ready to be migrated
$ rm -Rf var/cache
$ bin/console pim:installer:check-requirements
If this command detects something not working or not properly configured,
please fix the problem before continuing.
If this command detects something not working or not properly configured, please fix the problem before continuing.

Prepare the front
*****************
Prepare the front-end
*********************

.. code:: bash
Expand All @@ -160,49 +180,61 @@ Migrate your data
$ bin/console pim:data-quality-insights:recompute-product-scores
.. note::
You may receive the following warning:

You may receive the following warnings:
.. code:: text
WARNING! You have X previously executed migrations in the database that are not registered migrations.
WARNING! You have [a number of] previously executed migrations in the database that are not registered migrations.
This can be safely ignored. The message means that your database is up to date, but that Doctrine did not find the migration files corresponding to some prviously-run migrations.

This can be safely ignored as this only means that your database is up to date, but without finding the corresponding
migration files.

Another message could be `Migration _X_Y_ZZZZ was executed but did not result in any SQL statements`.
.. note::
You may also receive:

.. code:: text
This makes sense for some migration that only touches the Elasticsearch index or don't apply because no data linked
to this migration have been found.
Migration _X_Y_ZZZZ was executed but did not result in any SQL statements
If a migration only affects the Elasticsearch index or does not apply because no data associated with the migration were found, this can be safely ignored.

.. note::
The following message can also be safely ignored if it concerns the ``data-quality-insights`` migration:

.. code:: text
The migration has already been performed.
The message "The migration has already been performed." concerning the "data-quality-insights" migration could be ignored .
Migrate the job queue
*********************

In 6.0 we set up a new job queue. You may have jobs awaiting in the old queue, they must be migrated in the new queue:
In 6.0 we set up a new job queue (also known as job consumers). If you have jobs awaiting execution in the old queue, they must be migrated to the new queue.

.. code:: bash
$ bin/console akeneo:batch:migrate-job-messages-from-old-queue
If you want to skip the interactive question and want to migrate directly:
(Use the ``--no-interaction`` flag if you want to skip the interactive question and want to migrate directly.)

.. code:: bash
$ bin/console akeneo:batch:migrate-job-messages-from-old-queue --no-interaction

Migrating your custom code
**************************

.. note::
Each Akeneo PIM version brings brand new features, so please check if you still need each custom bundle, as we may have incorporated the same or similar functionality into the PIM.

You can check for new features and changes in the changelog: :doc:`/migrate_pim/changelog`


Applying automatic fixes
------------------------

Some changes we made in the code of Akeneo PIM can be automatically applied to your own code.

In order to make this process easier and more error proof, we decided to use PHP Rector (https://github.com/rectorphp/rector)
In order to make this process easier and more error proof, we decided to use `PHP Rector <https://github.com/rectorphp/rector>`_.
to apply these changes.


Installing Rector
^^^^^^^^^^^^^^^^^

Expand All @@ -217,26 +249,20 @@ Applying automatic fixes
vendor/bin/rector process src/
.. note::

This will use the `rector.yaml` file created by the `prepare.sh` above.
Feel free to add your own refactoring rules inside it. More information on https://getrector.org/
Feel free to add your own refactoring rules inside it. More information on `getrector.org <https://getrector.org/>`_.

Identifying broken code
^^^^^^^^^^^^^^^^^^^^^^^^

You can use PHPStan to help you identify broken code:


.. code:: bash
composer require --dev phpstan/phpstan
vendor/bin/phpstan analyse src/
More information, please check https://github.com/phpstan/phpstan

From that point, you will have to migrate your bundle one by one.
For more information, please check the `PhpStan documentation <https://github.com/phpstan/phpstan>`_.

Remember to check if they are still relevant, as each Akeneo version
brings new features.
You should migrate your bundles one by one to avoid problems and locate any bugs.

0 comments on commit 78f7101

Please sign in to comment.