Changes between Version 14 and Version 15 of InstallationGuidelines/VirtualMachine


Ignore:
Timestamp:
11/08/11 20:18:20 (10 years ago)
Author:
Pat Tressel
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallationGuidelines/VirtualMachine

    v14 v15  
    44The most convenient way to get up and running is to use a pre-configured development kit -- a complete operating system that's been set up to include all the required code and tools, and saved as an image of the system's disk -- and run this "virtual appliance" in a "virtual machine". The virtual machine runs as an application on your machine -- the "host" machine -- and emulates a separate computer -- the "guest" machine. You won't have to install anything but the virtual machine directly on your system. (We're including the official virtual machine jargon in case you need to read virtual machine documentation.)
    55
    6 The development kit is a Debian Linux system with several useful tools installed:
    7  * Bazaar (bzr) -- revision control system used on Launchpad, where Sahana eden sources are hosted.
    8  * Firefox with Firebug for examining what is sent to the browser, and viewing HTTP messages sent to and from the browser.
    9  * Eclipse with PyDev for editing and debugging Python code.
    10  * Scripts for updating the Eden code and other tools.
     6
    117
    128== Get the Sahana Eden development kit image ==
     
    6359and use the GUI to log in as user ''dev''.
    6460
    65 Note: There is no practical reason to log in in as ''root''.
    66 If one needs root privileges, ''dev'' has sudo privileges. In a terminal window, to execute one command or a pipeline of commands with root privileges:
    67 {{{
    68 sudo command-to-execute-as-root
    69 }}}
    70 This will prompt for a password if sudo hasn't been run recently -- it is asking for the current user's password -- here, that's the ''dev'' password.
    71 
    72 To change passwords after first boot, log in as ''dev'', start a terminal window, and enter the following commands:
    73 {{{
    74 sudo passwd root #change root password
    75 passwd #change dev password
    76 }}}
    77 
    78 Try starting Web2py from the command line:
    79 {{{
    80 python /home/web2py/web2py.py
    81 }}}
    82 That will bring up a window in which you can enter an administration password for Web2py.
    83 (When Web2py is started from Eclipse, it uses a command that is set when Eclipse is configured -- that will be covered later.)
    84 
    85 === File locations ===
    86 Web2py is located in /home/web2py. Eden is located in /home/web2py/applications/eden. Eclipse and PyDev are preconfigured with this information.
    8761
    8862=== Updating Web2py, Eden, and the operating system ===
     
    131105-----
    132106
    133 == Notes ==
     107== What's in the image, and where did we hide the files? ==
    134108
    135 The virtual machine image is based on a [BluePrintlivecdinstaller blueprint] and are configured to use about 512MB of RAM. The virtual disk is configured to expand to 20GB. The 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). The machine runs [http://code.google.com/p/shellinabox/ Shellinabox], [http://www.webmin.com/ Webmin], and SSH/sftp as services from startup.
     109=== Which Linux is this? ===
    136110
    137 The development environment is configured to launch [http://lxde.org LXDE], a lightweight desktop environment after the first boot. From LXDE, Eclipse with Pydev, Firefox with Firebug, iPython and irssi are accessible.
     111The virtual machine image is based on a [BluePrintlivecdinstaller blueprint] and is configured to use about 512MB of RAM. The virtual disk is configured to expand to 20GB. The 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). The machine runs [http://code.google.com/p/shellinabox/ Shellinabox], [http://www.webmin.com/ Webmin], and SSH/sftp as services from startup.
    138112
    139 Procedure for making a new virtual machine image:
     113The development environment is configured to launch [http://lxde.org LXDE], a lightweight desktop environment after the first boot.
     114
     115=== Tools ===
     116
     117Several useful tools installed:
     118 * Bazaar (bzr) -- revision control system used on Launchpad, where Sahana eden sources are hosted.
     119 * Firefox with Firebug for examining what is sent to the browser, and viewing HTTP messages sent to and from the browser.
     120 * Eclipse with PyDev for editing and debugging Python code.
     121 * Scripts for updating the Eden code and other tools.
     122 * iPython -- a fancier Python command line than the standard.
     123 * irssi
     124
     125== Notes on using Linux (mainly for non-Linux users) ==
     126
     127
     128=== File locations ===
     129Web2py is located in /home/web2py. Eden is located in /home/web2py/applications/eden. Eclipse and PyDev are preconfigured with this information.
     130
     131=== The root account ===
     132
     133The ''root'' account is the privileged user on Linux, but you don't need to log in as root to perform privileged tasks like installing software.  You can act as root without knowing the root password with the {{{sudo}}} command -- the ''dev'' account has the privilege to
     134use {{{sudo}}}.
     135In a terminal window, to execute a command with root privileges:
     136{{{
     137sudo command-to-execute-as-root
     138}}}
     139This will prompt for a password if {{{sudo}}} hasn't been run recently -- it is asking for the current user's password -- here, that's the ''dev'' password.
     140
     141To change passwords after first boot, log in as ''dev'', start a terminal window, and enter the following commands:
     142{{{
     143sudo passwd root #change root password
     144passwd #change dev password
     145}}}
     146
     147
     148
     149-----
     150
     151== Procedure for making a new virtual machine image ==
     152
    140153InstallationGuidelinesVirtualMachineMaintenance