Magento Commerce only

Upgrade Magento Commerce with sample data to RC1 or RC2

Upgrade Magento Commerce with sample data to RC1 or RC2

These instructions apply to you only if all of the following are true:

  • You’re using Magento Enterprise Edition (EE)
  • You have installed optional sample data
  • You’re upgrading to Magento Commerce RC1 or Magento Commerce RC2 from any earlier version using the Setup Wizard

To upgrade to Magento Commerce RC1 or RC2 with sample data using the Setup Wizard:

Click to expand/collapse content
  1. Log in to your Magento server as, or switch to, the Magento file system owner.
  2. Change to the Magento installation directory.
  3. Open composer.lock in a text editor.
  4. Change the following:

    From:

    "type": "magento2-module-customer-balance"
    

    To:

    "type": "magento2-module"
    
  5. Save your changes to composer.lock and exit the text editor.

Apply file system permissions and ownership

As part of the sample data upgrade process, you must apply current file system permission and ownership as discussed in the following sections. Failure to do so will cause your upgrade to fail.

For more information about file system ownership and permissions, see Overview of ownership and permissions.

One-user ownership and permissions

If you run the Magento application as one user (which is typical of shared hosting environments), change file system permissions and ownership as follows:

cd <your Magento install dir>
chmod -R g+w var vendor pub/static pub/media app/etc
chmod u+x bin/magento

To optionally enter all commands on one line, enter the following assuming Magento is installed in /var/www/html/magento2:

cd /var/www/html/magento2 && chmod -R g+w var vendor pub/static pub/media app/etc && chmod u+x bin/magento

After you set file system permissions, manually clear the var/cache, var/page_cache, and var/generation directories.

A sample command follows:

rm -rf var/cache/* var/page_cache/* var/generation/*

Two-user ownership and permissions

If you run the Magento application with two users, enter the following commands as a user with root privileges:

cd <your Magento install dir>
find var vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :<web server group> .
chmod u+x bin/magento

To optionally enter all commands on one line, enter the following assuming Magento is installed in /var/www/html/magento2 and the web server group name is apache:

cd /var/www/html/magento2 && find var vendor pub/static pub/media app/etc -type f -exec chmod g+w {} + && find var vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} + && chown -R :apache . && chmod u+x bin/magento

Finish the upgrade

After you set file system permissions, complete your upgrade as discussed in Start System Upgrade.