gistfile1.txt

Portable Portal dev environment with Vagrant

Potential future improvements:
	change to nginx if/when portal moves to it
	change to git for bitleap repo 
	auto-install IE 6-9 VMs as well: http://osxdaily.com/2011/09/04/internet-explorer-for-mac-ie7-ie8-ie-9-free/, https://github.com/xdissent/ievms
	windows 8/IE 10 VM? (IE 10 will also run on windows 7)
  windows host support?

This is a portable development environment for BCC (Portal). All dependencies are installed for you; you need only provide your credentials as explained below and a development box will be automatically built for you. Compatible accross all platforms where Virtualbox/Vagrant/SSH/Python run (everywhere!). 

Tested platforms (feel free to use later OS/dependency releases (Python 3.x excluded) and update this guide if you have problems or with examples of other working version combinations):
	Mac OS X 10.8.2 "Mountain Lion" – VirtualBox 4.2.6 – Vagrant 1.0.6 – Python 2.6.7
	Ubuntu 12.04 LTS "Precise Pangolin" - 

Setup instructions:

	1. The user installs dependencies:
		VirtualBox: https://www.virtualbox.org/wiki/Downloads
		Vagrant: http://downloads.vagrantup.com/
		SSH client (built-in on OSX & Linux [Windows details: http://docs.vagrantup.com/v1/docs/getting-started/ssh.html])
		Python >= 2.6.x (used for install script – built-in on OSX & Linux [Windows details:...])

	2. Run the install script
		Prompt user for the directory where they would like to keep their repos (default: ~/barracuda_repos)
		Prompt user for their Barracuda LDAP credentials (for configuring SCM access)
		Prompt user to go through Vagrant tutorial while waiting on install: http://docs.vagrantup.com/v1/docs/getting-started/index.html
			Tell user what changes in tutorial (e.g. use http://files.vagrantup.com/precise32.box or ideally load from local, faster server - local copy share or same place dev image comes from)
		At end of install, provide instructions to configure local system hosts file so site runs at http://login.barracuda.dev
			Specific directions for OS X, Ubuntu

	3. Get to work: http://login.barracuda.dev


Dev VM requirements:
	
	Notes:
		Uses a cuda-standard tool, puppet, to configure the Vagrant VM! :D

	Overview of things needing to be done by puppet/box creation script:
		SCM checkouts
			bitleap
			cui
			translations stuff
			anything else?
		special configuration files for the site (the special bitleap ones, etc)
		install/configuration of dependencies/requirements

	Software:
		LAMP
			base Linux VM: Ubuntu 12.04 LTS "Precise Pangolin"
			apache 2.x (?)
				SSL support enabled and configured with a self-signed certificate
			php 5.3.x
				w/ intl, gmp, mysql support
			mysql
		memcached and its php connectors
			needs to load automatically on boot
		other random important pieces (PEAR modules, etc)