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:
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:
Features Override upgrade documentation borrowed from Updating Panopoly documentation
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.
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.
Did you skip the pre-installation checklist? Shame on you. Make sure you have everything ready for the actual installation, then proceed:
Download Kickstart
Make sure you click on “Notes” so you can see all of the various download options. You absolutely want to download the full core version as Kickstart 2 ships with core patches.
Extract the Files
The files come compressed in either zip or tar.gz. Once you have them extracted, you will want to place the entire folder in your site's root folder (also called www root or docroot). Make sure you move the entire folder, because it is very easy to forget to copy the typically hidden .htaccess file, which is required for lots of important functions.
Welcome Screen
This is the first installation screen. If you see the welcome message, then you have successfully copied your files into the right folder. Congrats!
Requirements
If you happen to have a requirements problem, this page will help you resolve those issues.
Database Config
Connecting to your database is probably the most important step in the installation. It’s possible you will see this screen a couple of times as you hone your ability to choose the right combination of passwords and database name.
Install Profile
This screen requires no interaction on your part. It’s designed to handle as many actions as your server can handle per page load.
Site Configuration
This is where you can set the Store Name, Store Email Address and timezone information.
Store Content
You’re so close to having a complete Commerce Kickstart installation! All that is left is to determine whether you want to install the demo store. Be careful: once installed, the demo store is not removable without reinstalling the whole site!
Importing Products
This screen shouldn’t take too long to complete. It’s simply showing you the progress of importing the content to your site. If you’re interested in how we do it, we are simply using the commerce migrate module to handle the import and features to set it up.
Found errors? Think you can improve this documentation?
edit this page