Install and test Drupal Distribution

Needs revision -- Last peer review: 11 Sep 2014
Description: 
Install a custom Drupal Distribution/Install Profile
Overview: 

This lesson walks you through installing a Drupal distribution.

Steps: 

1. Find a Drupal distro here: http://drupal.org/project/distributions. (For example, Drupal Commons.)

2. Download and unzip the distro. (If you look inside, it should look like a standard Drupal download with one or two exceptions. Look inside the 'profiles' directory. You should see an installation profile with a name that corresponds to the distro you selected. This is where custom installation instructions for this distro live. You may also see contributed modules in side profiles/my-profile/modules or sites/all/modules. Unlike core Drupal, distros frequently come packaged with additional open source projects required to make the distro work.)

3. Create a new database and take note of the user name and password. If you're using a GUI tool, please see instructions for that tool. Here's how you do this from the command line (e.g. database name: example, user name: example, host: localhost, password: 12345):

$ mysql
$ mysql> create database example;
$ mysql> grant all on example.* to 'example'@'localhost' identified by '12345';

4. Most sites will default to something like http://localhost/example. You can set up the distro to live at http://example.dev like this (example uses MAMP):

Add this here /etc/hosts:

127.0.0.1 example.dev

Add this here /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf:

<VirtualHost *>
DocumentRoot "/path/to/example"
ServerName example.dev
</VirtualHost>

4. Go to /path/to/example/sites/default. Copy default.settings.php to settings.php. And create a files directory.

5. Now go to http://localhost/example or http://example.dev in your browser. Select the install profile when prompted. And follow Drupal's installation instructions.

Lesson tags:

Comments

Use the Control Panel -> Settings -> Sites, and the Import button. The site path should be where your new downloaded drupal distro unzipped to.