| 8 | | * Everyone should copy: |
| 9 | | * The readme file {{{README_GHC.txt}}} |
| 10 | | * The virtual machine image {{{EdenDevEnvGHC.ova}}}. |
| 11 | | * The docs directory {{{Docs}}}. |
| 12 | | * Mac users copy the {{{Mac}}} directory. |
| 13 | | * Windows users copy the {{{Win32}}} directory. |
| 14 | | |
| 15 | | Now give the flash drive to the next person waiting for it. |
| 16 | | |
| 17 | | == Install !VirtualBox == |
| 18 | | |
| 19 | | === If you're installing on Mac or Windows === |
| 20 | | |
| 21 | | * Mac and Windows users have !VirtualBox installers from the flash drive, in directories {{{Mac}}} or {{{Win32}}}, respectively. |
| 22 | | * Run the installer (by whatever means is appropriate for your system). |
| 23 | | * Let it install all features. |
| 24 | | * The installation will temporarily disconnect your machine from the network -- take appropriate action before letting the installer proceed if you are running something that can't tolerate being disconnected. |
| 25 | | * (Windows users: You don't need those "extensions" unless you want to use the USB drive from your virtual machine. You can always install them later.) |
| 26 | | |
| 27 | | === If you're installing on Linux === |
| 28 | | |
| 29 | | * Linux users should download the appropriate '''[https://www.virtualbox.org/wiki/Linux_Downloads VirtualBox installation file]''' for your system, and follow instructions there. |
| 30 | | |
| 31 | | == Import the image into the virtual machine == |
| 32 | | |
| 33 | | * Start !VirtualBox Manager (or let the installer start it). |
| 34 | | |
| 35 | | * Give !VirtualBox Manager the image to run: |
| 36 | | * Select File -> Import Appliance. |
| 37 | | * Click the Choose button. Navigate to and select EdenDevEnvGHC.ova. |
| 38 | | * Click Next (or Open, for a Mac). |
| 39 | | * (Do not uncheck any options on the appliance options form.) |
| 40 | | * Click Import. |
| 41 | | |
| 42 | | == Connect to the network == |
| 43 | | |
| 44 | | Next tell the VM about your machine's network interface, so the guest can get to the network. |
| 45 | | |
| 46 | | * Scroll down on the right side of !VirtualBox Manager until you see Network -- click that. |
| 47 | | * If no adapters are enabled, enable adapter 1. |
| 48 | | * For "Attached to" select "Bridged Adapter". |
| 49 | | * Under that, for "Name", select the appropriate network interface, e.g. 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.) |
| 50 | | |
| 51 | | == Start the virtual machine == |
| 52 | | |
| 53 | | On the left side of the !VirtualBox Manager GUI, you should see your new "Eden Dev Env" virtual machine. |
| 54 | | |
| 55 | | * Double-click the virtual machine entry to start it. |
| 56 | | * As it starts up, it may show popups about "mouse / keyboard capture". Check "Don't show this again" and dismiss the popups. |
| 57 | | * The Login screen should appear. User is ''dev'' and password is ''eden''. |
| 58 | | * After you're logged in, the Eclipse IDE will start -- ignore it for the moment. |
| 59 | | |
| 60 | | == You may want to change the dev password. == |
| 61 | | |
| 62 | | * Start a terminal window by double-clicking the LXTerminal icon. |
| 63 | | * To change your password, type {{{passwd}}} and follow the instructions. |
| 64 | | |
| 65 | | == Fix these before starting Eden == |
| 66 | | * Install the dateutil library:[[br]] |
| 67 | | {{{ |
| 68 | | sudo apt-get install python-dateutil |
| 69 | | }}} |
| 70 | | * Get a fresh copy of the configuration file: |
| 71 | | * In Eclipse, find {{{web2py/applications/eden/models/000_config.py}}} and delete it (right-click (or Mac equivalent), delete). |
| 72 | | * Also in Eclipse, find {{{web2py/applications/eden/deployment-templates/models/000_config.py}}} and copy it to {{{web2py/applications/eden/models/000_config.py}}}. |
| 73 | | * Edit {{{web2py/applications/eden/models/000_config.py}}} and change the first "False" to "True" -- that's this line:[[br]] |
| 74 | | {{{ |
| 75 | | FINISHED_EDITING_CONFIG_FILE = True |
| 76 | | }}} |
| 77 | | |
| 78 | | == Update Eden if needed == |
| 79 | | |
| 80 | | If you arrived at the beginning of the Codeathon, you don't need to do this. If you started later, and people might have started updating the team Eden branch on Launchpad, then make sure you have all of their work by doing: |
| 81 | | |
| 82 | | * (If you don't have one open) start a terminal window by double-clicking the LXTerminal icon. |
| 83 | | {{{ |
| 84 | | cd /home/web2py/applications/eden |
| 85 | | git pull upstream |
| 86 | | }}} |
| 87 | | |
| 88 | | == Next steps == |
| 89 | | |
| 90 | | '''''Installation is complete here.''''' |
| 91 | | |
| 92 | | * Have a look at the rest of the [wiki:Develop developer's wiki]. |
| 93 | | * Try out this [http://en.flossmanuals.net/sahana-eden/building-a-new-application/ familiarization exercise]. |
| 94 | | |
| 95 | | '''''Go hack! Success! ''''' |
| | 8 | The files to copy are: |
| | 9 | * The VM image !EdenDevEnv.ova |
| | 10 | * If you are installing on Windows or Mac, copy the appropriate !VirtualBox installer for your system. |
| | 11 | * If you are installing on Linux, then you'll need to get the [https://www.virtualbox.org/wiki/Linux_Downloads VirtualBox kit appropriate for you Linux distribution] from the !VirtualBox site. |
