]> git.donarmstrong.com Git - neurodebian.git/blobdiff - sphinx/vm.rst
testimonial from Dr. Walter
[neurodebian.git] / sphinx / vm.rst
index 39e99bd577beb9b0980e15625a0239d106016c50..cc202c4b25b6f8f8bfccc46094e176ebad6b4cec 100644 (file)
@@ -15,29 +15,55 @@ once installed, be equipped with a large variety of neuroscience software with
 just a few mouse clicks (e.g. AFNI_, Caret_, FSL_, PyMVPA_).
 
 .. _virtual machine: http://en.wikipedia.org/wiki/Virtual_machine
-.. _AFNI: http://afni.nimh.nih.gov/afni/
-.. _Caret: http://brainvis.wustl.edu/wiki/index.php/Caret:About
-.. _FSL: http://www.fmrib.ox.ac.uk/fsl/
-.. _PyMVPA: http://www.pymvpa.org
 
 
 Downloads
 ---------
 
-* `NeuroDebian 6.0.4 image (32bit)
-  <http://neuro.debian.net/debian/vm/NeuroDebian_6.0.4_i386.ova>`_ [~558MB]
+Stable (6.x series)
+~~~~~~~~~~~~~~~~~~~
+
+Based on current stable `Debian 6.0 (squeeze)`_ release.  This VM
+provides a stable, well tested environment with the most of the recent
+releases available from NeuroDebian.
+
+* `NeuroDebian 6.0.6 image (32bit)
+  <http://neuro.debian.net/debian/vm/NeuroDebian_6.0.6_i386.ova>`_ [~559MB]
 
   *This image should work on virtually all systems that are supported by*
   VirtualBox_ *and can be used whenever the, otherwise preferable, 64bit image
   is not compatible with a host machine.*
 
-* `NeuroDebian 6.0.4 image (64bit)
-  <http://neuro.debian.net/debian/vm/NeuroDebian_6.0.4_amd64.ova>`_ [~573MB]
+* `NeuroDebian 6.0.6 image (64bit)
+  <http://neuro.debian.net/debian/vm/NeuroDebian_6.0.6_amd64.ova>`_ [~576MB]
 
   *This image only works on 64bit host machines with active hardware
   virtualization support. The should include all recent Apple hardware and most
   64bit Windows systems.*
 
+Development (to be 7.x series)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Based on upcoming `Debian 7.0 (wheezy)`_ release.  Although already
+quite stable, there might be outstanding issues.  This VM also
+switches from GNOME_ (v.2) desktop environment to XFCE4_.  We
+recommend this VM over a stable one for anyone needing recent releases
+of tools not available for the stable VM (e.g. recent pandas) --
+**getting a complete "Scientific Python" stack with 100s of other
+Python modules was never easier**.  Moreover your feedback might also
+be valuable to polish upcoming Debian wheezy release and NeuroDebian
+VM 7.0.
+
+* `NeuroDebian 6.999.b4.20121231 image (32bit)
+  <http://neuro.debian.net/debian/vm/NeuroDebian_6.999.b4.20121231_i386.ova>`_ [~656MB]
+
+* `NeuroDebian 6.999.b4.20121231 image (64bit)
+  <http://neuro.debian.net/debian/vm/NeuroDebian_6.999.b4.20121231_amd64.ova>`_ [~660MB]
+
+
+Historical
+~~~~~~~~~~
+
 Virtual appliances above carry guest additions for 4.x series of the
 VirtualBox. If you still have VirtualBox 3.x, use previous 6.0.2
 virtual appliances:
@@ -48,6 +74,12 @@ virtual appliances:
 * `NeuroDebian 6.0.2 image (64bit)
   <http://neuro.debian.net/debian/vm/neurodebian_6.0.2_amd64.zip>`_ [~560MB]
 
+.. note::
+
+  This older virtual appliances are distributed as a `zip` file. Please
+  extract all files from the `.zip` file, using appropriate software
+  for your operating system.
+
 .. note::
 
   You can verify that you have downloaded archives correctly using
@@ -68,13 +100,36 @@ virtual appliances:
 Changes
 -------
 
+6.999.b4.20121231 -- 31 Dec 2012
+
+      * Based on beta 4 release of debian-installer_ for wheezy
+      * Comes with XFCE4_ instead of GNOME_
+
+6.0.6 -- 01 Oct 2012
+
+      * Updated core system to Debian squeeze 6.0.6
+
+6.0.5 -- 10 Nov 2011
+
+      * Updated core system to Debian squeeze 6.0.3
+      * Updated shipped virtualbox-ose guest-utils and guest-x11 to 4.0.10
+
+        - ``~/host`` is now symlinked to correct path ``/media/sf_host``
+        - ``brain`` user is added to ``vboxsf`` group so mounted host
+          directories should become readily available
+
+      * Root partition size and swap space got doubled in size (40GB
+        and 2GB correspondingly).  Space is allocated dynamically so
+        the actual size of the virtual drive should not grow unless
+        you use it
+
 6.0.4 -- 13 Jun 2011
 
       * Updated shipped virtualbox-ose guest-utils and guest-x11 to 4.0.4
 
 6.0.3 -- 12 Jun 2011 [Superseded in the archive by 6.0.4]
 
-      * Updated to Squeeze 6.0.1
+      * Updated to Debian squeeze 6.0.1
       * Updated VirtualBox guest additions to 4.0.4 from backports.debian.org
       * Appliance is available as a single file (.ova) ready for the import
 
@@ -97,8 +152,6 @@ will benefit from security bug fixes provided by the Debian project for the
 whole operating system, as well as from software updates for
 neuroscience-related packages.
 
-.. _Debian 6.0 (squeeze): http://www.debian.org/releases/squeeze
-.. _GNOME: http://www.gnome.org/
 
 
 Installation
@@ -127,15 +180,14 @@ potential questions regarding installation and maintenance.
 .. _VirtualBox: http://www.virtualbox.org
 
 Next, download the most recent version of the NeuroDebian virtual machine from
-the Downloads_ section. The machine is distributed as a zip file. Please
-extract this file, using appropriate software for your operating system.
-Once extracted, start VirtualBox and select "Import Appliance" from the file
+the Downloads_ section.  Start VirtualBox and select "Import Appliance" from the file
 menu.
 
 .. image:: pics/vm_import_app.jpg
 
 The next dialog will ask you to choose a virtual machine. Please navigate to the
-extracted NeuroDebian download and select the `.ovf` file.
+extracted NeuroDebian download and select the `.ova` (or extracted
+`.ovf` for older appliances shipped as `.zip`) file.
 
 .. image:: pics/vm_import_wizard.jpg
 
@@ -149,9 +201,7 @@ but select NeuroDebian and hit the *Settings* button. In the following dialog
 you'll have a chance to configure the machine. You can assign the amount of RAM
 that should be made available to it (for serious fMRI data processing, please
 allow at least 2 GB). If you have a recent computer with multiple CPU cores,
-you can also decide how many cores should be used by the virtual machine. If
-you have a large screen you should increase the display memory to 32 MB in the
-*Display* settings.
+you can also decide how many cores should be used by the virtual machine.
 
 .. image:: pics/vm_add_host_folder.jpg
 
@@ -161,11 +211,17 @@ easy way to access data on the computer without duplicating it or using the
 network to access it. The virtual machine is preconfigured to access a shared
 folder named labeled "host".  Click on the *add* button to select a folder that
 shall be accessible by the machine (e.g. your home directory) and put "host" as
-the folder name. Note, the folder name is simply a label. Your directory will
+the folder name and mark it to be auto-mounted. Note, the folder name is simply a label. Your directory will
 not be renamed.
 
 .. image:: pics/vm_host_folder.jpg
 
+If you have a large screen you should increase the display memory to
+32 MB in the *Display* settings.  Also you might like to enable the
+support for 3D Acceleration
+
+.. image:: pics/vm_settings_display.jpg
+
 Finally, close the settings dialog. You have now completed the setup, and you
 can start the virtual machine by hitting the *Start* button. A new window will
 appear showing the boot process. After a short while the NeuroDebian desktop
@@ -254,7 +310,9 @@ mounted host directories.
   backports::
 
     sudo apt-get install -y linux-headers-2.6-amd64 # or -686 for 32bit
-    sudo apt-get install -y -t squeeze-backports virtualbox-ose-guest-kdms \
+    sudo apt-get install -y -t squeeze-backports virtualbox-ose-guest-dkms \
          virtualbox-ose-guest-utils  virtualbox-ose-guest-x11
 
   and reboot VM.
+
+.. include:: link_names.txt