Installing & Upgrading
Downloading and installing the Commerce Kickstart project is now easier than ever. If you have ever downloaded and installed a distribution for Drupal, then this should seem very familiar to you.
If you are having trouble installing, please check out our "Troubleshooting the Installation Guide."
Chances are you have customized Commerce Kickstart, and you should capture those overrides in a module before upgrading! If you do not, you may not be able to receive updates to distribution components, or possibly lose changes.
Check if any of Commerce Kickstart's Features are overridden:
- Open the admin menu, and click "Structure" -> "Features"
- Click on "Commerce Kickstart" in the vertical tabs
- Watch the "State" column and wait for the values to change from "Checking..." to either "Default" or "Overridden". This can take a few seconds to a few minutes, depending on how many Features you're using on your site.
- If any of the Commerce Kickstart Features have a state of "Overridden" it means your changes would be lost if all Features were reverted -which may be necessary to fully complete the upgrade!
To prevent your changes getting lost when Features are reverted, you have to capture them in an override module. The easiest way to do this is with Features Override, which is bundled with Commerce Kickstart (but not enabled) since version 2.27
See these great articles on the Phase2 blog about using Features Override:
- A new paradigm for overriding Drupal Features
- Features and Overrides – Part Deux
- Features and Overrides – Part III
Features Override upgrade documentation borrowed from Updating Panopoly documentation
Updating your files
If you are upgrading your site from a previous release of Commerce Kickstart (since 2.x RC1 forward), we support an upgrade path.
IMPORTANT - Drush 8.x-6.x supports an upgrade for Kickstart 2, but it is not the common "drush up" command. Use the following code snippets (and make sure to backup everything):
$ drush dl commerce_kickstart
$ drush updatedb -y
Or you can follow the step by step instructions below.
- Log in to your site as admin (user 1)
- Create a complete backup of your files and database. (This can be accomplished with Backup & Migrate or Drush)
- Download the latest release of Kickstart 2 by scrolling down to the bottom of the page and choosing between a tar.gz and a .zip file.
NOTE You absolutely want to download the full package with core, as Kickstart 2 does ship with core patches
- Extract to an empty folder
- Delete all files and folders on your site except the sites folder (remember you should have a backup before doing this)
- Copy or Move all files and folders except the sites/ folder from the new release to your current site.
- Go to /update.php and run any and all updates.
- Be happy because you are now on the latest release of all that is fantastic with Kickstart 2
NOTE A bug in MAMP causes seg faults in the php interpreter.
NOTE A bug in Windows extractor causes filename path issues, to avoid please use 7zip or similar third-party extractor program.
- New Site or Existing? This is a distribution and will not work with existing sites. A lot of the new modules developed can be installed separately (inline entity form, for example), but you will break your site if you try to install this distribution on your current site. See http://drupal.org/node/1680332 and http://drupal.org/node/1705356
- Server or local? You need to decide if you are going to install the Commerce Kickstart locally or on a server somewhere. Local setup is typically free and pretty easy. Server installation can be pretty simple too, but requires that you know the command line or are willing to wait for FTP to get it on your server so you can do something.
- Database? You will need an empty database for your new kickstart installation to use. If you are using a host, you will likely find a control panel that lets you create a database. Creating a database can be complicated if you’ve never done it before.
- RAM and load time? Unfortunately, most server installations keep a very minimal default setting for your website to use per instance. This includes the local installations as well. For more information on how to increase your RAM on apache, see the Increase PHP memory limit Drupal.org article.
Installing Drupal Commerce Kickstart 2
Did you skip the pre-installation checklist? Shame on you. Make sure you have everything ready for the actual installation, then proceed: