Changes between Version 6 and Version 7 of InstallationGuidelines/VirtualMachine

Timestamp:

11/06/11 14:49:52 (13 years ago)

Author:

Pat Tressel

Comment:

--

InstallationGuidelines/VirtualMachine

@@ -27 +27 @@
  * Run the installer (by whatever means is appropriate for your system).
   * Let it install all features.
-  * The installation will temporarily disconnect your machine from the network -- take appropriate action if you are running something that can't tolerate that.
+  * 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 that.
 
 == Import the image into the virtual machine ==
@@ -78 +78 @@
 That will set the administration password to "admin".  When Web2py is started from Eclipse, it uses a command that is set when Eclipse is configured -- that will be covered later.
 
-Although it's usually good to get security updates for the operating system and applications, updating may lead to incompatibilities with other software, and has been known to render the system unusable. So do the following only if you know there is a security issue, and not when you're in the middle of something critical.[[br]]
+=== 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 ===
+/usr/local/bin contains three helpful scripts. To run them, start a terminal window and enter the commands below. They are in the path, so may be executed from any working directory.
+
+==== Update web2py ====
+On occasion, the latest revision of Web2py is not stable. Check the topic in the #sahana-eden IRC channel on freenode for the latest known-safe revision.
+To update Web2py to the latest revision:
+{{{
+update_web2py
+}}}
+To update to a specific revision, do the following with nnnn replaced by the revision you want.
+{{{
+update_web2py nnnn
+}}}
+
+==== Update Eden ====
+You will almost certainly want the latest revision of Eden.
+{{{
+update_eden # updates Eden to current revision
+}}}
+If, for some reason, you need a specific revision, do the following with nnnn replaced by the revision you want:
+{{{
+update_eden nnnn # updates Eden to revision nnnn
+}}}
+
+==== Optionally update the operating system ====
+Although it's usually good advice to update the operating system and applications to pick up security fixes, updating may lead to incompatibilities with other software, and has been known to render the system unusable. So do the following only if you know there is a security issue, and not when you're in the middle of something critical.[[br]]
 Log in as ''dev'' and execute the following:
 {{{
@@ -85 +113 @@
 }}}
 
-=== File locations ===
-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 a terminal window and enter the commands 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 revision 2717
-update_web2py # updates web2py to current revision
-}}}
-==== Update Eden ====
-{{{
-update_eden 1560 # updates Eden to revision 1560
-update_eden # updates Eden to current revision
-}}}
-
-==== Web2Py shell ====
-Launch a Web2py shell in the Eden environment (apologies for the oddly named script).
+=== Web2Py shell ===
+One can get a Python command line with the Web2py and Eden environments loaded with this script (apologies for the odd name):
 {{{
 import_eden
 }}}
+This executes the {{{python web2py.py ...}}} command shown previously.
 
 === Eclipse ===
-Configure the included !Eclipse/PyDev:
+Some parts of the Eclipse and !PyDev configuration need to be done after startup:
  * DeveloperGuidelinesEclipse#Configuration
 
-
-
+-----
 
 == Notes ==
@@ -121 +132 @@
 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.
 
-
-----
 Procedure for making a new virtual machine image:
-
 InstallationGuidelinesVirtualMachineMaintenance