wiki:InstallationGuidelinesVirtualMachine

Version 58 (modified by rik goldman, 11 years ago) ( diff )

--

Virtual Machine

This virtual machine has been built to allow Developers to get operational quickly (1 Gb compressed):

It is in the Open Virtual Machine format for use in either VirtualBox or VMWare.

It is currently running the Ubuntu 10.04 OS with Web2Py-r2717, Eden-r1560 & Eclipse 3.6

Usage Notes

Introduction

The dev env virtual machines for Virtualbox and VMware are based on a blueprint and are configured to use have about 512MB of RAM. The virtual disk is configured to expand to 20GB.

The virtual machine is built on TurnKey Linux's Core, which in turn is based on Ubuntu 10.04 (Lucid -- the most recent long-term support release).

The machines run Shellinabox, Webmin, and SSH/sftp as services from startup.

The development environment is configured to launch LXDE, a lightweight desktop environment after the first boot.

Getting Started

  1. Import VM with Virtualbox. Start the VM. Alternatively, start the VM in VMware player or compatible platform.
  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.
  3. After first boot, the machine arrives at the graphical user interface login page. Login with the provided credentials.

Credentials

Web2py 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":

/home/dev/web2py.py -a admin -i 127.0.0.1 -p 80

/home/dev/web2py.py --password admin -i 127.0.0.1 -p 80

Root User

Username: root

Password: to be determined

Dev User

Username: dev

Password: to be determined

Filesystem

Web2py is located in /home/web2py. Eden is located in /home/web2py/applications/eden. Eclipse and PyDev are preconfigured with this information.

Scripts

/usr/local/bin contains three helpful scripts. To run them, start LXTerminal (in the accessories menu) and simply enter the commands as demonstrated below. They are in all users' paths, so may be executed from any working directory.

Update web2py

Enter the command with or without a revision number, as demonstrated below:

update_web2py 2717 #updates web2py to rev 2717
update_web2py #updates web2py to recent revision

Import Eden

update_eden 1560 #updates Eden to rev 1560
update_eden #updates Eden to recent revision

Update Eden

Imports Eden to Web2py

import #updates Eden to rev 1560

Legacy Usage Guidelines

New usage notes are available here and are in the process of being migrated to this page.

  1. The ubuntu user and the admin account of web2py have the password set to: eden
  2. The web2py directory on the desktop contains the web2py release and a bzr branch of Eden Trunk located in
    ~/Desktop/web2py/applications/eden
    
  3. Eclipse is preconfigured with the above directory.
  • The normal way to launch Web2Py in this environment is to launch Eclipse & start up the Debugger.
  • You can view the filesystem by clicking on the 'PyDev' button in the top-right.
  1. Firefox is pre-populated with Eden bookmarks.
  2. Run code and OS updates

Note: 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):

rm -rf ~/Desktop/web2py/applications/eden/databases/*

If you get an error like "AttributeError: SQLCustomType instance has no attribute 'startswith'" then:

cd ~/Desktop/web2py/gluon
rm sql.py
wget http://eden.sahanafoundation.org/sql.py

Then can proceed as above: Stop Eclipse, empty databases folder & restart Eclipse

A new image without this issue has now been uploaded.

Installation

  1. Download the Image
  2. Uncompress the image

To run the image, you need to install either VirtualBox or VMWare:

VirtualBox Installation

  1. Download VirtualBox
  2. Install VirtualBox
  3. Import the Virtual Appliance:
  • File menu | Import Appliance
  • Choose the uncompressed image (the .ovf file)
  • Next
  • Accept the default appliance options unless you have a reason to make a specific change
  • Start the Virtual Appliance by double-clicking the icon on the left.

Login to Ubuntu as: UID: Sahana-Eden PW: eden

VMWare Installation

To import the download VM into VMware (e.g. Fusion), use the following steps.

  1. File > New
  2. Click Continue without disc
  3. Select Use an existing virtual disk
  4. Select Eden-VM.vmdk
  5. Select Make a separate copy of the virtual disk
  6. Click Choose
  7. Click Continue
  8. OS=Linux and Version=Ubuntu should be selected, click Continue, Click Finish 11 Enter name for new VMware image e.g. Eden in the Virtual Machines directory
  9. Click Save

Remember to install the Linux VMware Tools after starting up the Eden machine using Virtual Machine > Install VMware Tools

sudo su -
./vmware-install.pl

And accept all the default options


InstallationGuidelinesVirtualMachineMaintenance

InstallationGuidelinesDeveloper

InstallationGuidelines

Note: See TracWiki for help on using the wiki.