Changes between Version 14 and Version 15 of InstallationGuidelines/VirtualMachine

Timestamp:

11/08/11 20:18:20 (13 years ago)

Author:

Pat Tressel

Comment:

--

InstallationGuidelines/VirtualMachine

@@ -4 +4 @@
 The 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.)
 
-The development kit is a Debian Linux system with several useful tools installed:
- * Bazaar (bzr) -- revision control system used on Launchpad, where Sahana eden sources are hosted.
- * Firefox with Firebug for examining what is sent to the browser, and viewing HTTP messages sent to and from the browser.
- * Eclipse with PyDev for editing and debugging Python code.
- * Scripts for updating the Eden code and other tools.
+
 
 == Get the Sahana Eden development kit image ==
@@ -63 +59 @@
 and use the GUI to log in as user ''dev''.
 
-Note: There is no practical reason to log in in as ''root''.
-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:
-{{{
-sudo command-to-execute-as-root
-}}}
-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.
-
-To change passwords after first boot, log in as ''dev'', start a terminal window, and enter the following commands:
-{{{
-sudo passwd root #change root password
-passwd #change dev password
-}}}
-
-Try starting Web2py from the command line:
-{{{
-python /home/web2py/web2py.py
-}}}
-That will bring up a window in which you can enter an administration password for Web2py.
-(When Web2py is started from Eclipse, it uses a command that is set when Eclipse is configured -- that will be covered later.)
-
-=== File locations ===
-Web2py is located in /home/web2py. Eden is located in /home/web2py/applications/eden. Eclipse and PyDev are preconfigured with this information.
 
 === Updating Web2py, Eden, and the operating system ===
@@ -131 +105 @@
 -----
 
-== Notes ==
+== What's in the image, and where did we hide the files? ==
 
-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.
+=== Which Linux is this? ===
 
-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.
+The 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.
 
-Procedure for making a new virtual machine image:
+The development environment is configured to launch [http://lxde.org LXDE], a lightweight desktop environment after the first boot.
+
+=== Tools ===
+
+Several useful tools installed:
+ * Bazaar (bzr) -- revision control system used on Launchpad, where Sahana eden sources are hosted.
+ * Firefox with Firebug for examining what is sent to the browser, and viewing HTTP messages sent to and from the browser.
+ * Eclipse with PyDev for editing and debugging Python code.
+ * Scripts for updating the Eden code and other tools.
+ * iPython -- a fancier Python command line than the standard.
+ * irssi
+
+== Notes on using Linux (mainly for non-Linux users) ==
+
+
+=== File locations ===
+Web2py is located in /home/web2py. Eden is located in /home/web2py/applications/eden. Eclipse and PyDev are preconfigured with this information.
+
+=== The root account ===
+
+The ''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
+use {{{sudo}}}.
+In a terminal window, to execute a command with root privileges:
+{{{
+sudo command-to-execute-as-root
+}}}
+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.
+
+To change passwords after first boot, log in as ''dev'', start a terminal window, and enter the following commands:
+{{{
+sudo passwd root #change root password
+passwd #change dev password
+}}}
+
+
+
+-----
+
+== Procedure for making a new virtual machine image ==
+
 InstallationGuidelinesVirtualMachineMaintenance