BMO/DeveloperBox

Creating a BMO Development System using VirtualBox and Vagrant

Getting your system setup

• Install Virtualbox on your workstation (http://www.virtualbox.org)
• Install Vagrant on your workstation (http://www.vagrantup.com/)

Installing and running the BMO Vagrant box

• Create following file called 'Vagrantfile' in a directory by itself.

 Vagrant.configure("2") do |config|
   config.vm.box = "bugzilla"
   config.vm.box_url = "https://people.mozilla.com/~dkl/bugzilla.box"
   config.vm.network :forwarded_port, guest: 80, host: 8080
 end

• Execute the following in the directory where the 'Vagrantfile' is located. This will download the box and then start the VM.

 $ vagrant up

• The following will log you into the VM over SSH and drop you into the 'vagrant' user's home directory.

$ vagrant ssh

Working with the latest BMO code in the VM

• For starters you will need change your login password to a known value and also make yourself a Bugzilla admin (substitute your bmo address below).

 $ vagrant ssh
 $ cd ~/htdocs/bmo
 $ ./checksetup.pl --make-admin=<email> --reset-password=<email>

• You should now be able to access the web UI at http://localhost:8080/bmo using your browser on the same system.
  • You may need to update the values for urlbase and sslbase in /home/vagrant/htdocs/bmo/data/params to match the port number you chose for redirection earlier. If the port is different than 8080.

• Updating the BZR code to the latest revision. Note: http://doc.bazaar.canonical.com/migration/en/survival/bzr-for-git-users.html

 $ cd ~/htdocs/bmo
 $ bzr merge  (This will merge upstream changes into your local branch. There may be conflicts if you have made changes as well)
 $ bzr commit (commit the merged files to your branch)

• Run the built in test suite located in the /home/vagrant/htdocs/bmo/t directory.

 $ perl runtests.pl

• You can run just one of the tests in /t, for example to run the template compilation tests:

 perl t/004template.t

• Making a patch for review of your latest changes
  • (see https://wiki.mozilla.org/Bugzilla:Patches)
  • This will place the patch file in your home directory of the laptop and not on the VM so you can easily upload, etc.

 $ cd ~/htdocs/bmo
 $ bzr diff > /vagrant/<some_patch_name>_1.patch

• File any bugs or feature requests here