[[PageOutline]] [[br]] = Prework = 1. Download and install [http://www.virtualbox.org/ VirtualBox] on your machine, we have tested versions 4.1.14 * For convenience we have included the the Virtual Box software for popular operating systems in the USB stick. * If your computer runs Ubuntu 10.04 which comes with !VirtualBox 3.1.6_OSE, please download the latest version of !VirtualBox. 2. Copy the VM image from the USB stick to your computer. 3. Run !VirtualBox and Import Appliance (File->Import Appliance), accept the default settings for the VM. * If you are using a FAT32 filesystem you will NOT be able to load the image. 4. Start the VM and log in 5. Change the default password, on the task bar on the top, click on the right on the user 'geni', and choose the Change Password button. 6. Verify that the VM has connectivity. Start Firefox (shortcut on the top bar) and try to load Google. If you can't reach any website, restore VM's Network connection. * On the far right on the top bar, there is the network icon (two opposite facing arrows). * Click that icon and choose 'Auto eth0'. * Try loading the webpage again. = Useful Tips = == Enable Copy-paste between your host and your guest VM == While running the VM, go to the `Devices` !VirtualBox menu. Choose `Install Guest Additions ..`, follow the steps. Once this is installed reboot the VM. === Copy and paste === * In the terminal within the VM, use '''Ctrl-Shift-C to copy''' and '''Ctrl-Shift-V to paste'''. * vim and emacs editors are installed on the VM, so feel free to use them for editing your files. == Vim and Emacs tips == * To replace a pattern within the file: * If you are using vim, while in command mode, type: {{{ %s/pattern/replace_text/gc }}} And press 'y' for the instances of the pattern you want replaced, 'n' otherwise. * If you are using emacs, press Alt-x and then type: {{{ query-replace }}} and press ENTER. Enter the pattern to be replaced, press ENTER, enter the text you want to replace it with and press ENTER. Press 'y' for the instances of the pattern you want replaced, 'n' otherwise. * If you want to have a shared folder between your machine and the VM so that it's easier to transfer files during the tutorial, you have to do this before starting the VM. Follow [http://ozz314.wordpress.com/2008/05/08/virtualbox-shared-folders-between-ubuntu-guest-and-mac-host/ these instructions] * If you get an error running Omni, look at the [http://trac.gpolab.bbn.com/gcf/wiki/OmniTroubleShoot troubleshoot page] for help.