Magento Commerce 2.1.6 Release Notes
- Functional fixes and enhancements
- System requirements
- Install the Magento software
- Upgrade from an earlier version
- Migration toolkits
Release notes updated on April 28, 2017.
Upgrading to this release can cause problems with image resizing. Please see Image Resize Issue with Magento 2.1.6 for an overview of these post-upgrade issues and our suggested workaround.
We are pleased to present Magento Commerce (formerly Enterprise Edition) 2.1.6. This release includes important performance enhancements for your Magento installation, especially for operations that involve the category page as well as image resizing.
Looking for the Magento Commerce (Cloud) Release Notes?
Magento 2.1.6 contains over 15 significant performance enhancements when compared to 2.1.5. Look for the following highlights in this release:
Improved performance of the Category page
loading configurable products from the database is now up to 5x faster
price calculations are now up to 3-5% faster
stock validation is now up to 20% faster
Optimized image resizing
image resize operations performed from the command line interface now generate images of all sizes. See magento catalog:images:resize for more information.
image resize operations from the Admin have been fixed
significant decrease in the number of file system operations when processing images on frontend
caching of image metadata is up to 50% faster, depending on store size
Improved performance of layered navigation
- layered navigation is now up to 3% faster due to the caching of attribute options
Minimized indexing operations after product import
Functional fixes and enhancements
We address the following functional fixes and enhancements in this release.
- Magento no longer locks the
category_product_entitytable. Unlocking this table reduces the potential of lock-related timeouts that can occur when indexing and checkout operations run in parallel. Previously, Magento locked the
- The storefront now displays images that Magento resizes during product save operations, rather than resizing the product on the storefront. Previously, the image path contained
store_id, and during save operations, Magento resized images for images the default store only.
Users have encountered problems displaying images after upgrading their software to Magento 2.1.6. These problems range from incomplete loading to the total inability to load images. Consequently, if you saved a product and didn’t open it on the storefront before upgrading to 2.1.6, you’ll need to apply a workaround.
Workaround: To correct problems with image loading, choose one of these two workarounds:
php bin/magento catalog:images:resize
- Save (or resave) the product with the associated image in the Admin panel.
\Magento\CatalogInventory\Model\Stock\Status\getStockId()method now returns the correct values.
- The check that Magento runs to confirm a configurable product’s readiness for sale is now faster. (The
isSalablemethod checks that a configurable product can be sold (that is, is in a saleable state)).
- Query optimizations have improved the speed of configurable product price calculation.
- Magento no longer calculates configurable product special prices on the category page. Previously, Magento calculated special prices on the category page, but did not display them.
- Magento now runs a selective partial re-indexing operation after import if you enable Update on Schedule. Previously, Magento ran a full reindex no matter which index mode was set.
- Magento now displays imported product images in this order: first, the base image, then the additional images in the order in which they were listed in the CSV file. Previously, Magento displayed images in this unexpected order: first, an additional image, then the base image, and finally, all remaining additional images.
- Magento now caches attribute options for the layered navigation feature. This reduces the number of queries to the database, and consequently improves performance.
- Magento no longer performs unnecessary file check operations (for example,
is_file), which improves the performance of the category and product pages.
- Magento now caches image metadata, which avoids the time-consuming need to read images for metadata loading.
- Magento no longer performs unnecessary staging-related flag operations on the Category page. Previously, Magento performed staging-related flag operations even when the Staging module was not used.
- Magento now shows a significant decrease in Redis traffic after upgrading 2.1.2 to 2.1.4.
- Magento no longer creates redundant objects when initializing a configurable product on the Category page.
- You can now disable swatches for both the Catalog page and search results (quick or advanced). To disable swatches from these requests, disable Stores > Configuration > Catalog > Storefront > Show Swatches in Product List.
- The logic that Magento uses to validate swatch attributes has been optimized.
- Magento now caches swatch data in the block cache, which improves the responsiveness of the configurable product pages.
Our technology stack is built on PHP and MySQL. For more information, see System Requirements.
Install the Magento software
See one of the following sections:
- Get Magento Commerce using Composer
- Get Magento Commerce using a compressed archive
- Complete the installation
Get Magento Commerce using Composer
Magento Commerce (formerly Enterprise Edition) is available from
repo.magento.com. Before installing the Magento Commerce software using Composer, familiarize yourself with these prerequisites, then run:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=<version> <installation directory name>
2.1.1, and so on
For example, to install 2.1.1 in the
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.1.1 magento2
Get Magento Commerce using a compressed archive
The following table discusses where to get the Magento software. We provide the following downloads:
- Magento Commerce software only
- Magento Commerce software with sample data (designed to help you learn Magento faster)
These packages are easy to get and install. You don’t need to use Composer, all you need to do is to upload a package to your Magento server or hosted platform, unpack it, and run the web-based Setup Wizard.
Archives are available in the following formats:
To get the Magento Commerce archive:
- Go to your account on magento.com.
- Log in with your Magento user name and password.
- In the left navigation bar, click Downloads.
- In the right pane, click Magento Commerce 2.X > Full Release or Magento Commerce 2.X > Full Release + Sample Data for the software.
Follow the instructions on your screen to complete the Magento Commerce download:
Magento-EE-<version>.*(without sample data)
Magento-EE-<version>+Samples.*(with sample data)
- Transfer the installation package to your development system.
Complete the installation
After you get the Commerce software:
Upgrade from an earlier version
To upgrade to Magento Commerce 2.1 from an earlier version, see Upgrade to Magento version 2.1 (June 22, 2016).
The Data Migration Tool helps transfer existing Magento 1.x store data to Magento 2.x. This command-line interface includes verification, progress tracking, logging, and testing functions. For installation instructions, see Install the Data Migration Tool. Consider exploring or contributing to the Magento Data Migration repository.
The Code Migration Toolkit helps transfer existing Magento 1.x store extensions and customizations to Magento 2.0.x. The command-line interface includes scripts for converting Magento 1.x modules and layouts.
Dear community members, thank you for your suggestions and bug reports.