Skip over navigation
Documentation
You are currently viewing documentation for version 3.0 which is not a long-term support release. The latest long-term support release is version 2.6

How to Apply Patch

The patch file name supports the following naming convention: {package}-{version_to_apply}.patch. For example, platform-1.9.2.patch.

1. cd to the crm root folder and switch the application to the maintenance mode.

$ cd /path/to/application
$ sudo -uwww-data bin/console lexik:maintenance:lock --env=prod

2. Stop the cron tasks.

$ crontab -e -uwww-data

Note

www-data can be changed to user under which your web server runs

Comment this line.

1
 */1 * * * * /usr/bin/php /path/to/application/bin/console --env=prod oro:cron >> /dev/null

3. Stop all running consumers.

4. Create backups of your Database and Code.

5. Copy the patch file to the package directory

1
/path/to/application/vendor/oro/{package}

So, the “platform-1.9.2.patch” file should be copied to /path/to/crm_folder/vendor/oro/platform.

6. To apply the patch, cd to the package folder and execute patch command.

$ cd /path/to/application/vendor/oro/{package}
$ patch -p1 < platform-1.9.2.patch

7. cd to crm root folder and clear caches.

$ cd /path/to/application

Remove the caches.

$ sudo -u www-data bin/console cache:clear --env=prod

or, as an alternative:

$ sudo rm -rf var/cache/prod

8. Execute the oro:platform:update command and clear caches.

$ sudo -u www-data php bin/console oro:platform:update --env=prod --force

Remove the caches.

$ sudo -u www-data bin/console cache:clear --env=prod

or, as alternative:

$ sudo rm -rf var/cache/prod
$ sudo -u www-data bin/console cache:warmup --env=prod

9. Run the consumer(s).

$ sudo -u www-data bin/console oro:message-queue:consume --env=prod

10. Enable cron.

$ crontab -e -uwww-data

Uncomment this line.

1
*/1 * * * * /usr/bin/php /path/to/application/bin/console --env=prod oro:cron >> /dev/null

11. Switch your application back to normal mode from the maintenance mode.

$ sudo -uwww-data bin/console lexik:maintenance:unlock --env=prod

Note

If PHP bytecode cache tools (e.g. opcache) are used, PHP-FPM (or Apache web server) should be restarted after the uprgade to flush cached bytecode from the previous installation.

Browse maintained versions:3.01.122.02.32.6

You will be redirected to [title]. Would you like to continue?

Yes No
sso for www.magecore.comsso for oroinc.desso for oroinc.frsso for marketplace.orocommerce.comsso for marketplace.orocrm.com
Back to top