technosophos edited this page Sep 1, 2010 · 4 revisions
Clone this wiki locally

Installing DDB

Check out the README.mdown file for details on installation. Here is the process in a nutshell:

  • Get and install Phing.
  • Download and unpack DDB.

The current best way to retrieve DDB is simply to download the source from the sourcecode repository.

Using DDB

Once you have installed Phing, you can begin working with Drupal Distro Builder.

This tool can be used to manage building, deploying, and maintaining Drupal distributions.

Common usages:

Build a custom distribution including all of the modules defined in the drupal.properties file:

$ phing

The above will create a date/time-stamped tarball of the latest version of Drupal along with all of the modules you have specified.

$ phing explain

The above will display information about what target directories are defined and what modules will be installed. However, it does not perform any modifications to files.

$ phing -Dinstalldir=./foo install

This does the same as the above, except that instead of building a tarball, it places the entire Drupal distribution in the directory passed as -Dinstalldir (in this case, ./foo). If the directory is visible to the webserver, you should be able to immediately run install.php from your web browser.

It is easier to set 'installdir' in drupal.properties, and then do this:

$ phing install

Then, installdir will be used to determine where to place files.

You can also install individual modules into 'installdir' with this command:

$ phing mod -Download=querypath

This will install the querypath module. You can install multiple modules using the same format as you would use in drupal.properties:

$ phing mod -Download=querypath,amplify,quiz

The above will install querypath, amplify, and quiz. Note that you must not leave whitespace between module names, as the shell will interpret those as separate arguments.

$ phing upgrade

This will perform all necessary module updates. It does this by inspecting the installation's sites/all/modules directory and then checking Drupal.org's servers to see what updates are available. Any necessary updates will be downloaded and installed.

Don't want a particular module to be updated? Add it to the pin list in drupal.properties.

By default, modules in sites/default/modules are not automatically updated because by convention only custom modules go there. To alter this behavior, you can modify the build.xml file for updateModules.

$ phing clean

Remove all downloaded files and build directories. (This does NOT delete the files in the installdir, so it is safe to run after phing install)

$ phing -l

List all available targets along with a short help message.