Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

How to Install a Magento SUPEE-8788 Patch

DZone's Guide to

How to Install a Magento SUPEE-8788 Patch

This article walks through the SUPEE-8788 patch installation because, unlike most, it has an installation scenario that makes it unusual.

· Security Zone
Free Resource

Address your unique security needs at every stage of the software development life cycle. Brought to you in partnership with Synopsys.

Magento patches are files with .sh extension. Unlike usual patches, they have an installation scenario in them, which ensures atomicity of installation and deinstallation processes.

The scenario also logs installation and deinstallation actions into app/etc/applied.patches.list file.

To install any patch, first things first, you should upload the patch file into the root category of the chosen Magento shop and run this command (just replace the example patch name with the name of the patch you are installing right now).

sh PATCH_SUPEE-8788.sh

Checking if patch can be applied/reverted successfully…

Patch was applied/reverted successfully.

To get the list of installed/uninstalled patches, run this command:

sh PATCH_SUPEE-8788.sh –list

The list you will get looks like this:

2016-12-05 17:38:48 UTC | SUPEE-1533 | EE_1.13 | v1 | _ | n/a | SUPEE-1533_EE_1.13_v1.patch

2016-12-05 17:41:01 UTC | SUPEE-3941 | EE_1.14.0.1 | v1 | d35110621d80be22922611e2b0a502da054a95f0 | Tue Jul 15 17:57:57 2014 +0300 | v1.14.0.1..HEAD

2016-12-05 17:41:28 UTC | SUPEE-4291 | EE_1.14.0.1 | v1 | 1fdfe63a44cde9ad7f7b9a6afe228e55d579a499 | Tue Sep 2 17:58:21 2014 +0300 | v1.14.0.1..HEAD

2016-12-05 17:41:37 UTC | SUPEE-5344 | EE_1.14.1.0 | v1 | a5c9abcb6a387aabd6b33ebcb79f6b7a97bbde77 | Thu Feb 5 19:14:49 2015 +0200 | v1.14.1.0..HEAD

2016-12-05 17:41:42 UTC | SUPEE-5994 | CE_1.6.0.0 | v1 | _ | n/a | SUPEE-5994_CE_1.6.0.0_v1.patch

2016-12-05 17:41:49 UTC | SUPEE-6237 | EE_1.14.2.0 | v1 | 8b216c42e2e5d2cb5d8e500fcb6690abede9df52 | Fri Jun 12 13:39:59 2015 +0300 | v1.14.2.0..HEAD

2016-12-05 17:41:56 UTC | SUPEE-6285 | CE_1.9.1.1 | v1 | 7226d88b1eeb07a5fbc4e62be189a5219457cc14 | Mon Jun 22 16:32:26 2015 +0300 | 202596e441..7226d88b1e

2016-12-05 17:42:02 UTC | SUPEE-6482 | CE_1.9.2.0 | v1 | | Tue Jul 14 14:17:04 2015 +0300 |

2016-12-05 17:42:09 UTC | SUPEE-6788 | CE_1.9.0.1 | v1 | be76c3faa9d26b74a513463408211e9921b09341 | Fri Oct 23 14:59:13 2015 +0300 | ea98922

2016-12-05 17:42:19 UTC | SUPEE-7405-CE-1-9-0-1 | CE_1.9.0.1 | v1 | ea82b89fc68d641ccb88e2a5fc816c9eba68a4d9 | Tue Jan 19 15:57:35 2016 +0200 | be76c3faa9..ea82b89fc6

2016-12-05 17:42:29 UTC | SUPEE-7405 | CE_1.9.0.1 | v1.1 | dfd0cb980c437c549d16f5912a1480d50732144f | Fri Feb 5 13:27:40 2016 +0200 | ea82b89fc68d641ccb88e2a5fc816c9eba68a4d9..dfd0cb980c437c549d16f5912a1480d50732144f

2016-12-05 17:42:55 UTC | SUPEE-7616 | CE_1.9.2.2-CE_1.8.0.0 | v1 | 1609c0d0be86473d357346fa51f93c12b365d7a1 | Tue Dec 8 12:53:31 2015 +0200 | e1fc3c59c9587427b8a9c88655715f27afbfe970..1609c0d0be86473d357346fa51f93c12b365d7a1

Uninstall the patch with these lines:

sh PATCH_SUPEE-1533.sh -R

Checking if patch can be applied/reverted successfully…

Patch was applied/reverted successfully

Tips for Proper Installation of SUPEE-8788 Magento Patch

Different patches can cause bugs and issues, depending on the number of corrections the patch contains. For example, the first uncorrected version of SUPEE-8788 wasn’t working properly with SUPEE-1533.

Here’s what we recommend to do for installing the patch and avoiding any possible or known issues afterward:

  • Always install the patch on the dev environment first. Otherwise, your store may be affected with issues and bugs, and you can lose sales and money because of this.
  • Backup the site and the databases for dev and live environments, even if you’re sure everything will be fine.
  • In case you installed the first (broken) version of SUPEE-8788, uninstall it, uninstall SUPEE-1533 as well, install SUPEE-3941 (if it hasn’t been applied yet), and finally install SUPEE-8788 v2.
  • Disable compilation before installation and clear Magento cache before and after installation.
  • Store the patch files on your server. The thing is, you can’t uninstall the patches without their initial files.
  • Make sure to test your Magento shop with the patches installed to make sure all the features are working properly.

Find out how Synopsys can help you build security and quality into your SDLC and supply chain. We offer application testing and remediation expertise, guidance for structuring a software security initiative, training, and professional services for a proactive approach to application security.

Topics:
magento ,patch ,security

Opinions expressed by DZone contributors are their own.

THE DZONE NEWSLETTER

Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

X

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}