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."
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: