|
| 1 | +## Command-line upgrade to Magento {{ page.guide_version }} with sample data |
| 2 | + |
| 3 | +These instructions apply to {{site.data.var.ce}} and {{site.data.var.ee}} users *only* if all of the following are true: |
| 4 | + |
| 5 | +* You have installed optional sample data |
| 6 | +* You are upgrading to Magento {{ page.guide_version }} (including a Release Candidate) from any earlier version using the command line |
| 7 | + |
| 8 | +To upgrade to Magento {{ page.guide_version }} sample data using the command line: |
| 9 | + |
| 10 | +1. Log in to your Magento server as, or switch to, the [Magento file system owner]. |
| 11 | +1. Change to the Magento installation directory. |
| 12 | +1. Back up your current `composer.json` file: |
| 13 | + |
| 14 | + ```bash |
| 15 | + cp composer.json composer.json.bak |
| 16 | + ``` |
| 17 | + |
| 18 | +1. Upgrade the Magento software version using commands of the following format: |
| 19 | + |
| 20 | + ```bash |
| 21 | + composer require <product> <version> --no-update |
| 22 | + ``` |
| 23 | + |
| 24 | + ```bash |
| 25 | + composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update |
| 26 | + ``` |
| 27 | + |
| 28 | + * Example for {{site.data.var.ce}}: |
| 29 | + |
| 30 | + ```bash |
| 31 | + composer require magento/product-community-edition {{ page.guide_version }}.0 --no-update |
| 32 | + ``` |
| 33 | + |
| 34 | + ```bash |
| 35 | + composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.* magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* --no-update |
| 36 | + ``` |
| 37 | + |
| 38 | + * Example for {{site.data.var.ee}}: |
| 39 | + |
| 40 | + ```bash |
| 41 | + composer require magento/product-enterprise-edition {{ page.guide_version }}.0 --no-update |
| 42 | + ``` |
| 43 | + |
| 44 | + ```bash |
| 45 | + composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.* magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* magento/module-gift-card-sample-data:100.4.* magento/module-customer-balance-sample-data:100.4.* magento/module-target-rule-sample-data:100.4.* magento/module-gift-registry-sample-data:100.4.* magento/module-multiple-wishlist-sample-data:100.4.* --no-update |
| 46 | + ``` |
| 47 | + |
| 48 | + {% include note.html |
| 49 | + type="info" |
| 50 | + content="To upgrade to a Release Candidate, append `-rc<x>` to the version of each module. For example, `-rc3`." |
| 51 | + %} |
| 52 | + |
| 53 | +1. Update dependencies: |
| 54 | + |
| 55 | + ```bash |
| 56 | + composer update |
| 57 | + ``` |
| 58 | + |
| 59 | +1. If prompted, enter your [authentication keys]. |
| 60 | +1. Wait for dependencies to update. |
| 61 | + |
| 62 | +### Finish your upgrade |
| 63 | + |
| 64 | +After you have reset file system permissions: |
| 65 | + |
| 66 | +1. If you have not done so already, log in to your Magento server as, or switch to, the Magento file system owner. |
| 67 | +1. Change to your Magento installation directory. |
| 68 | +1. Manually clear the `var/cache`, `var/page_cache`, and `var/generation` directories. |
| 69 | + |
| 70 | + A sample command follows: |
| 71 | + |
| 72 | + ```bash |
| 73 | + rm -rf var/cache/* var/page_cache/* var/generation/* |
| 74 | + ``` |
| 75 | + |
| 76 | +1. Upgrade Magento: |
| 77 | + |
| 78 | + ```bash |
| 79 | + bin/magento setup:upgrade |
| 80 | + ``` |
| 81 | + |
| 82 | +{% include install/sampledata/file-sys-perms-digest.md %} |
| 83 | + |
| 84 | +<!-- Link definitions --> |
| 85 | +[Magento file system owner]: {{ page.baseurl }}/install-gde/prereq/file-sys-perms-over.html |
| 86 | +[authentication keys]: {{ page.baseurl }}/install-gde/prereq/connect-auth.html |
0 commit comments