Changes between Version 58 and Version 59 of InstallationGuidelinesVirtualMachine


Ignore:
Timestamp:
01/04/11 07:57:28 (14 years ago)
Author:
Fran Boon
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallationGuidelinesVirtualMachine

    v58 v59  
    88
    99It is currently running the Ubuntu 10.04 OS with Web2Py-r2717, Eden-r1560 & Eclipse 3.6
     10
    1011== Usage Notes ==
     12
    1113=== Introduction ===
    12 The dev env virtual machines for Virtualbox and VMware are based on a [http://eden.sahanafoundation.org/wiki/BluePrintlivecdinstaller blueprint] and are configured to use have about 512MB of RAM. The virtual disk is configured to expand to 20GB.
     14The dev env virtual machines for Virtualbox and VMware are based on a [http://eden.sahanafoundation.org/wiki/BluePrintlivecdinstaller blueprint] and are configured to use about 512MB of RAM. The virtual disk is configured to expand to 20GB.
    1315
    1416The virtual machine is built on [http://www.turnkeylinux.org/core TurnKey Linux's Core], which in turn is based on Ubuntu 10.04 (Lucid -- the most recent long-term support release).
     
    1921
    2022=== Getting Started ===
    21    1. Import VM with Virtualbox. Start the VM. Alternatively, start the VM in VMware player or compatible platform.
    22    2. The VM will appear in the left window pane, and the settings will appear in the right. Scroll down on the right side until you see "Network." Click network to ensure the VM has appropriate network address and IP address. (Specify the NIC and choose between bridged and NAT mode.
    23    3. After first boot, the machine arrives at the graphical user interface login page. Login with the provided credentials.
     23 1. Download the Image
     24 2. Uncompress the image
     25To run the image, you need to install either !VirtualBox or VMWare:
     26
     27==== !VirtualBox Installation ====
     28 3. Download [http://download.virtualbox.org/virtualbox/vboxdownload.html VirtualBox]
     29 4. Install !VirtualBox
     30 5. Import the Virtual Appliance:
     31 * File menu | Import Appliance
     32 * Choose the uncompressed image (the .ovf file)
     33 * Next
     34 * Accept the default appliance options unless you have a reason to make a specific change
     35 6. The VM will appear in the left window pane, and the settings will appear in the right. Scroll down on the right side until you see "Network." Click network to specify the NIC (e.g. switch to wireless) and choose between bridged and NAT mode.
     36 7. Start the Virtual Appliance by double-clicking the icon on the left.
     37
     38==== VMWare Installation ====
     39To import the download VM into VMware (e.g. Fusion), use the following steps.
     40 3. File > New
     41 4. Click Continue without disc
     42 5. Select Use an existing virtual disk
     43 6. Select NewDev.vmdk
     44 7. Select Make a separate copy of the virtual disk
     45 8. Click Choose
     46 9. Click Continue
     47 10. OS=Linux and Version=Ubuntu should be selected, click Continue, Click Finish
     48 11 Enter name for new VMware image e.g. Eden in the Virtual Machines directory
     49 12. Click Save
     50Remember to install the Linux VMware Tools after starting up the Eden machine using Virtual Machine > Install VMware Tools
     51{{{
     52sudo su -
     53./vmware-install.pl
     54}}}
     55And accept all the default options
     56
    2457=== Credentials ===
     58After first boot, the machine arrives at the graphical user interface login page. Login with the provided credentials.
     59
    2560Web2py administration password is set during the debugging process with either of the following commands and arguments, both of which would set the admin password to "admin":
    2661{{{
     
    6196
    6297
    63 == Legacy Usage Guidelines ==
    64 New usage notes are available [http://eden.sahanafoundation.org/wiki/DevEnvUsageNotes here] and are in the process of being migrated to this page.
    65 
    66  1. The ubuntu user and the admin account of web2py have the password set to: eden
    67  2. The web2py directory on the desktop contains the web2py release and a bzr branch of Eden Trunk located in
    68 {{{
    69 ~/Desktop/web2py/applications/eden
    70 }}}
    71  3. [DeveloperGuidelinesEclipse Eclipse] is preconfigured with the above directory.
    72  * The normal way to launch Web2Py in this environment is to launch Eclipse & start up the Debugger.
    73  * You can view the filesystem by clicking on the '!PyDev' button in the top-right.
    74  4. Firefox is pre-populated with Eden bookmarks.
    75  5. Run code and OS updates
    76 
    77 
     98== Troubleshooting older Releases ==
    7899Note: If you get a ticket when running the application for the 1st time with a message like "!OperationalError: Cannot add a UNIQUE column" then you need to stop the debugger, delete the contents of the databases folder & then start debugging again (there was an old database accidentally left on the system which cannot be auto-migrated - a new image without this issue has been uploaded):
    79100{{{
     
    90111
    91112A new image without this issue has now been uploaded.
    92 == Installation ==
    93  1. Download the Image
    94  2. Uncompress the image
    95 To run the image, you need to install either !VirtualBox or VMWare:
    96 === !VirtualBox Installation ===
    97  3. Download [http://download.virtualbox.org/virtualbox/vboxdownload.html VirtualBox]
    98  4. Install !VirtualBox
    99  5. Import the Virtual Appliance:
    100  * File menu | Import Appliance
    101  * Choose the uncompressed image (the .ovf file)
    102  * Next
    103  * Accept the default appliance options unless you have a reason to make a specific change
    104  * Start the Virtual Appliance by double-clicking the icon on the left.
    105113
    106 '''Login to Ubuntu as''':  '''UID:''' Sahana-Eden '''PW:''' eden
    107114
    108 === VMWare Installation ===
    109 To import the download VM into VMware (e.g. Fusion), use the following steps.
    110  3. File > New
    111  4. Click Continue without disc
    112  5. Select Use an existing virtual disk
    113  6. Select Eden-VM.vmdk
    114  7. Select Make a separate copy of the virtual disk
    115  8. Click Choose
    116  9. Click Continue
    117  10. OS=Linux and Version=Ubuntu should be selected, click Continue, Click Finish
    118  11 Enter name for new VMware image e.g. Eden in the Virtual Machines directory
    119  12. Click Save
    120 Remember to install the Linux VMware Tools after starting up the Eden machine using Virtual Machine > Install VMware Tools
    121 {{{
    122 sudo su -
    123 ./vmware-install.pl
    124 }}}
    125 And accept all the default options
    126115
    127116----