| 2 | | = Virtual Machine = |
| 3 | | |
| 4 | | == Summary == |
| 5 | | This virtual machine has been built to allow Developers to get operational quickly: |
| 6 | | |
| 7 | | It is in the Open Virtual Machine format for use in either [http://virtualbox.org VirtualBox] or [http://vmware.com VMWare]. |
| 8 | | |
| 9 | | It is currently running the Ubuntu 10.04 OS with Web2Py-r2717, Eden-r1560 & Eclipse 3.5. (Note that both Web2Py & Eden are very old & should be updated before development starts!) |
| | 2 | = Installation Guidelines: Virtual Machine = |
| | 3 | |
| | 4 | == Get the Sahana Eden development kit image == |
| | 5 | |
| | 6 | * Download the current virtual machine image here: |
| | 7 | [http://eden.sahanafoundation.org/downloads/eden_dev_env_-_l_vb.tar.gz 409Mb OVF format for !VirtualBox] |
| | 8 | |
| | 9 | * The image is compressed -- uncompress it. The extracted file will have an .ovf extension. |
| | 10 | * On Windows, a good tool for (un)compressing is [http://www.7-zip.org/download.html 7-Zip]. |
| | 11 | * On Linux / Unix, use tar xzf to uncompress the file, e.g. if the name of the downloaded image file is |
| | 12 | filename.tar.gz then do: [[br]] |
| | 13 | {{{tar xzf filename.tar.gz}}} |
| | 14 | |
| | 15 | == Install !VirtualBox == |
| | 16 | |
| | 17 | * [https://www.virtualbox.org/wiki/Downloads Download the appropriate !VirtualBox binary] for your system. (You won't need the "extension pack" or the SDK.) |
| | 18 | |
| | 19 | * Run the installer (by whatever means is appropriate for your system). |
| | 20 | * Let it install all features. |
| | 21 | * The installation will temporarily disconnect your machine from the network -- take appropriate action if you are running something that can't tolerate that. |
| | 22 | |
| | 23 | == Import the image into the virtual machine == |
| | 24 | |
| | 25 | * Start !VirtualBox (or let the installer start it). |
| | 26 | |
| | 27 | * Give !VirtualBox the image to run: |
| | 28 | * Select File -> Import Appliance. |
| | 29 | * Click on the Choose button and navigate to and select the uncompressed image (the .ovf file). |
| | 30 | * Click Next. |
| | 31 | * Accept the default appliance options unless you have a reason to make a specific change. |
| | 32 | |
| | 33 | == Connect to the network == |
| | 34 | |
| | 35 | The VM will appear in the left window pane, and the settings will appear in the right. Next tell the VM about your machine's network interface, so the guest can get to the network. There are two options for having the host and guest share the physical interface, NAT or bridged. NAT is less obtrusive and simpler to set up, but bridged provides more capability to the guest. A discussion of the differences is [http://www.virtualbox.org/manual/ch06.html here]. This shows NAT setup: |
| | 36 | |
| | 37 | * Scroll down on the right side until you see Network -- click that. |
| | 38 | * Select the appropriate network interface (NIC), e.g. switch to wireless if that's what you're using. (Keep this setting in mind -- you may need to change it if you sometimes use a wired network, and sometimes wireless.) |
| | 39 | * Select NAT mode. |
| | 40 | |
| | 41 | ----- |
| | 42 | |
