Documentation

Troubleshooting the Kickstart 2 Installation

There are a few hiccups people have posted about and we've tried our best to give you next steps. Chances are, you won't have any problem installing Commerce Kickstart 2, but if you do, we have listed the bare minimum requirements and a few odd settings that sometimes cause problems.

 NOTE    A bug in MAMP causes seg faults in the php interpreter.

  • Disk Space: 45 MB
  • RAM: minimum 128M, more is recommended because your server can fail with this memory if it is at all strained (learn how to configure).
  • Web Server: Apache 1.3, Apache 2.x, or Microsoft IIS
  • Database: MySQL 5.0.15 or higher with PDO, PostgreSQL 8.3 or higher with PDO, SQLite 3.3.7 or higher

Details are offered on the Drupal Requirements Page.

Odd Settings

There are a few settings that default to good values, but can interfere with installation should you have changed defaults:

  • xdebug setup: If you are using xdebug, you'll want to make sure you have the nesting levels configured accurately. (http://drupal.org/node/1663314)
  • apache setup: max_allowed_packet needs to be 16M minimum
  • required php libraries: Commerce Kickstart 2 requires the Curl PHP Library to be installed.

Quick reminder about Memory

Since the Commerce Kickstart 2 distribution can install an entire setup and configured working demo, the installation process requires a bit more sustained power. In our early beta tests, installations can sometimes silently fail when it uses close to your memory limit. Migrate will stop importing content and you will end up with the settings of a new store and very little content. The solution to fix this situation is to reinstall with a higher memory limit, or to rerun the migrations using the Drush command "drush ms" or by enabling the module "Migrate UI" and going to admin/content/migrate.