Magento Open Source 2.1.6 Release Notes
- Highlights
- Functional fixes and enhancements
- System requirements
- Install the Magento software
- Upgrade from an earlier version
- Migration toolkits
- Credits
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 Open Source (formerly Community 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 Enterprise Cloud Edition Release Notes?
Highlights
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.
Catalog
- Magento no longer locks the
category_product_entity
table. Unlocking this table reduces the potential of lock-related timeouts that can occur when indexing and checkout operations run in parallel. Previously, Magento locked thecategory_product_entity
table.
- 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:
- Run
php bin/magento catalog:images:resize
or
- Save (or resave) the product with the associated image in the Admin panel.
- The
\Magento\CatalogInventory\Model\Stock\Status\getStockId()
method now returns the correct values.
- The
\Magento\CatalogInventory\Model\Stock\Status\getStockId()
method now returns the correct values.
Configurable products
- The check that Magento runs to confirm a configurable product’s readiness for sale is now faster. (The
isSalable
method checks that a configurable product can be sold (that is, is in a saleable state)).
- 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.
Indexers
- Magento now runs a selective partial re-indexing operation after import if you enabled Update on Schedule. Previously, Magento ran a full reindex no matter which index mode was set.
Import
- 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.
Miscellaneous
- 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,
file_exists
,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 now shows a significant decrease in Redis traffic after upgrading 2.1.2 to 2.1.4.
Swatches
- 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.
System requirements
Our technology stack is built on PHP and MySQL. For more information, see System Requirements.
Install the Magento software
You can get Magento Open Source (formerly Community Edition) 2.1 from Github, Composer, or using a compressed archive.
See one of the following sections for more information:
- Get the Magento Open Source software using Composer
- Get a compressed archive
- Complete the installation
Get the Magento Open Source software using Composer
The Open Source software is available from repo.magento.com
. Before getting the Open Source software, familiarize yourself with the Composer metapackage prerequisites, then run
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=<version> <installation directory name>
where <version>
is 2.1.0
, 2.1.1
, and so on
For example, to install Magento Open Source 2.1.1 in the magento2
directory:
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.1.1 magento2
Get a compressed archive
The following table discusses where to get the Magento software. We provide the following downloads:
- Magento Open Source software only
- Magento Open Source 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: .zip
, .tar.bz2
, .tar.gz
To get the Magento Open Source software archive:
- Go to http://magento.com/download.
-
Choose either the software or the software and sample data:
Magento-CE-<version>.*
(without sample data)Magento-CE-<version>+Samples.*
(with sample data)
<version>
is the three-digit release number (for example,2.0.7
,2.1.0
, and so on).
Complete the installation
After you get the Open Source software:
- Set file system ownership and permissions.
-
Install the software:
Upgrade from an earlier version
See the following sections for more information.
Upgrade an existing installation from the GitHub repository
Developers who contribute to the Open Source codebase can upgrade manually from the Magento Open Source GitHub repository.
-
Go to the Contributing Developers page.
-
Follow the instructions to pull the updates from the repository and update using Composer.
Other upgrades
Other types of upgrades are discussed in Upgrade to Magento version 2.1 (June 22, 2016).
Migration toolkits
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.
Credits
Dear community members, thank you for your suggestions and bug reports.