Home
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.
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.
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.