9) Building a Quickstart Virtual Machine

Note: This is unnecessary if you want to *use* quickstart. Just follow the installation instructions.

If you for some reason need to rebuild a virtual machine "from scratch", these are the steps. Not all of the configuration is scripted. Much of the GUI configuration (inc setting up Firefox Add-ons) is manual.

Updating for version 1.0 and Ubuntu 11.04

1. Download some things to start:
   • Download and install Virtualbox
   • Download the latest Ubuntu Desktop CD image for your computer. The most compatible is the i386 version.
2. Create a new virtual machine in Virtualbox:
   • Start Virtualbox
   • Click New -> Next -> Name: Quickstart, OS: Linux, Version: Ubuntu
   • Set RAM to 50% of your system ram. (min 1024mb)
   • Accept defaults -> Finish
3. Configure a "shared" folder to move files between host and guest. This lets you move files between your pc, and the development environment.
   • Find the new virtual machine in the list
   • Right-Click -> Settings -> Shared Folders -> Click the +Folder icon on the right
   • Find a folder in your computer you want to share. Probably on your desktop.
   • In "Folder name", type "shared" -> Ok -> Ok
4. Start the new virtual machine from the list:
   • The "First Run Wizard" starts.
   • Next -> Under "Media Source", click the Icon next to the dropdown.
   • Click Add, and select the Ubuntu CD image you downloaded.
   • Select the defaults, and wait for the install to start.
   • If this doesn't happen, manually mount the cd with Devices->CD->More... and add the CD to VBox
5. Install Ubuntu:
   • Accept all the defaults
   • Use "quickstart" for the username and password. Use qs10 as a computer name
   • On the username/password page select "Log in automatically"
   • After install finishes, at reboot screen, remove the Ubuntu install CD. Quickstart VM window -> Devices -> CD/DVD Devices -> Unmount CD/DVD Device
   • Reboot the Quickstart vm
   • System->Administration->Update Manager->Check (password is quickstart) -> Install Updates
   • Restart (this brings kernel up to date for next step)
6. (Guest additions are installed in the script)
7. Install Quickstart development tools:
   • Start a command line "terminal": Applications -> Accessories -> Terminal
   • Run these commands to: install git, checkout quickstart, start the install script (remember the password is "quickstart"):
     

     sudo apt-get -y install git-core
     git clone --branch master http://git.drupal.org/project/quickstart.git 
     bash ~/quickstart/install-quickstart.sh

   • During the scripted process, use "quickstart" for all passwords
   • At the end of the scripted process, a text file will open with some instructions for manual configuration
   • See the handbook documentation for some quick tips on using Quickstart.