Demo Framework Distribution Installation
Here are some helpful ways that you can install and run the Demo Framework. You can download the packaged release and install as you normally would. However, there are some advanced techniques to quickly and easily install the distribution. The advantage in using Vagrant means you will be developing on the exact same environment as the DF maintainers. The idea is that we can much more easily collaborate and solve people's problems if we use a shared Vagrant.
Using Vagrant with Virtualbox
Download and Install Virtualbox
Virtualbox: https://www.virtualbox.org/wiki/Downloads
Download and Install Vagrant
Vagrant: http://downloads.vagrantup.com
Install Berkshelf for Vagrant$ vagrant plugin install vagrant-berkshelf
Build the distribution as you normally would using build-df.make or download the release package from Drupal.org.
Add the following Vagrantfile and Berksfile to your docroot
https://gist.github.com/brantwynn/5680085/raw/Vagrantfile
https://gist.github.com/brantwynn/5680070/raw/Berksfile
Set the following environmental variables (or edit the Vagrantfile and hardcode them).$ export DRUPAL_DISTRO=df$ export DRUPAL_PROJECT=localdemo
Use Vagrant to build the virtual machine or reload it$ vagrant up
Automating your Vagrant build process using vice.sh
$ wget https://gist.github.com/brantwynn/5680040/raw/vice.sh
Add this line to your .bash_profile or .zshrcsource /path/to/df/vice.sh
Now you can skip everything but installing Virtualbox/Vagrant/Berkshelf in the instructions above... Just use the vice.sh shell script.
Usage: vice [makefile] [destination] [distro] [sitename] [vagrant command]$ vice ~/downloads/df/build-df.make ~/Sites/vgrnt.demo df demoframework up
$ vice /path/to/df/build-df.make /path/to/your/demo/docroot df demo-test reload
Using build.sh (build distro - quick, easy, no frills)
$ sh build.sh [docroot]
You can rebuild the install profile directory inside your docroot. This is good for deploying the latest DF changes without completely tearing down your Vagrant box.
Additional Tools for Homebrew/MAMP/etc
Pre-Vagrant, we had been using some scripts to help automate DF builds. Consider these legacy techniques to fall back on if Vagrant is failing for you.
Using dice.sh (build and install distro - fully automated, handy)
$ wget https://gist.github.com/brantwynn/5110901/raw/dice.sh
Source the dice.sh file from your .bash_profilesource /path/to/df/dice.sh
Run the 'dice' command to install this distro (or others).
Usage: dice [makefile] [docroot] [dbuser] [dbpass] [database] [sitename] [distro]
$ dice build-df.make ~/Sites/demo root password demo.db demosite df