The software for the Code Generation 2009 Tutorial is available through a virtual machine. To run this virtual machine you need a recent version of [[http://www.virtualbox.org/wiki/Downloads][VirtualBox]] (version 2.2 or higher).

The virtual machine contains an Ubuntu 9.04 install, including the necessary StrategoXT components:

	* StrategoXT, including the manual
	* JavaFront
	* WebDSL 
	* WebDSL source code
	* Tomcat

If you have any questions, please feel free to send an email to 
	* [[mailto:rob.vermaas@gmail.com][Rob Vermaas]] (rob.vermaas@gmail.com)
	* [[mailto:visser@acm.org][Eelco Visser]] (visser@acm.org)

or go to the #stratego IRC channel on irc.freenode.net.

---++ Installation

The virtual machine image can be downloaded:

	* ftp://ftp.strategoxt.org/pub/stratego/vm/CodeGen.zip

The zip file is approximately 1.5GB compressed, and you need about 4GB of space for the uncompressed image.

After downloading

	* unzip the downloaded file
	* start Virtual Box
	* Press _New_ button, which starts a wizard, press next
	* Enter a name for the virtual machine, and fill in:
		* Operating system: Linux
		* Version: Ubuntu
	* Press Next
	* Enter the amount of memory available in the virtual machine, we recommend at least 512MB
	* Press Next
	* Select _use existing harddisk_, and press on the button next to the dropdown box to go to the Virtual Media Manager
		* Press _Add_ button
		* Choose the downloaded and extracted disk image (!CodeGen.vdi) and select _Open_
		* Then press _Select_ button, which closes the Virtual Media Manager
	* Press _Next_, which will show a summary of what you have just done
	* Press _Finish_ to add the machine to your !VirtualBox

Now, the virtual machine is available in Virtualbox, and it is possible to start the machine. Username and password for the default login is *guest*. 

The sample application for the tutorial is available in _/home/guest/src/tutorial_.


---++ Testing image

To check if the image is correctly installed,

	* open terminal  (menu Applications/Accessoires/Terminal)
	* _cd src_
	* _./build-webdsl-svn_
	* _cd tutorial_
	* _webdsl build deploy_, to deploy the sample application
	* start Tomcat using the desktop item
	* start firefox and point browser to http://localhost:8080/tasks/



---++ Shared folders

To mount a shared folder (from !VirtualBox)

	* In !VirtualBox, go to menu _Devices_, then _Shared Folders_
	* Choose _Add_ and fill in
	  * Folder Path: / (to share the root filesystem of the host)
	  * Folder Name: share
	* Press OK
	* open terminal  (menu Applications/Accessoires/Terminal)
	* Execute: _mount-shared share /home/guest/Desktop/share_ to mount the shared folder with name 'share' to a folder on your desktop.


---++ Issues

	* in some cases networking does not work immediately. Open a terminal (e.g. alt-f2, then type gnome-terminal or menu _Applications/Accessoires/Terminal_) and execute: *sudo /etc/init.d/networking restart*. (Password _guest_.)