sandbox/2012-02-08_comp_neurosci_ubuntu_live_usb.rst

   1 :date: 2012-02-08 19:02:00
   2 :tags: neuroscience, computational neuroscience, ubuntu, software, live cd, usb disk, linux distribution
   3
   4 .. _chap_comp_neurosci_ubuntu_live_usb:
   5
   6 A Live Ubuntu/NeuroDebian USB Stick for Computational Neuroscience
   7 ====================================================================
   8
   9  .. image:: screenshot-genesis-neuron-xpp.png
  10         :width: 150px
  11         :alt: View of the desktop running GENESIS, Neuron and XPPAUT
  12         :align: right
  13         :target: screenshot-genesis-neuron-xpp.png
  14
  15 I prepared an `Ubuntu 11.04`_/NeuroDebian_ live image with computational neuroscience tools for mainly use in USB sticks. This live image will let you run a full `Live Ubuntu Linux`_ system **without installing anything on your hard drives**, and it includes `persistent storage`_ that **maintains new files and packages across reboots**. The system is bundled with several computational neuroscience tools like GENESIS_, NEURON_ and XPPAUT_. It is made to fit in USB sticks of size >1GB. To use it, you will have to restart your PC with the USB stick inserted. After you turn on your computer, you will possibly also need to bring up your boot menu and choose to boot from the USB stick (most likely by pressing F10 or F12).
  16
  17 .. _`Ubuntu 11.04`: http://help.ubuntu.com/11.04/ubuntu-help/index.html
  18 .. _GENESIS: http://www.genesis-sim.org/GENESIS/
  19 .. _NEURON: http://neuron.duke.edu/
  20 .. _XPPAUT: http://www.math.pitt.edu/~bard/xpp/xpp.html
  21 .. _NeuroDebian: http://neuro.debian.net
  22 .. _`Live Ubuntu Linux`: http://help.ubuntu.com/community/LiveCd
  23 .. _`persistent storage`: http://help.ubuntu.com/community/LiveCD/Persistence
  24
  25 *Note: You do not have to reboot your computer if you have a virtual machine* (e.g., `VirtualBox <http://www.virtualbox.org>`_, `VMware <http://www.vmware.com/>`_, etc.) *and you can point it boot from the USB stick.*
  26
  27 .. warning::
  28  In general, a USB stick is not preferable media for a day-to-day use of Linux because flash memory has a short lifetime (on the order of about several months to a year, based on usage). In addition to the chance of hardware failure over a long time frame, the Ubuntu Live CD also has a tendency to slowly `get corrupted over time`_, but with special care taken, it can be used safely.
  29
  30 As a first precaution, the USB stick should be routinely backed up. You can also copy your files over to your hard drive. To improve performance, it is even possible to transfer the persistent storage to your hard drive. See below for details.
  31
  32 .. _`get corrupted over time`: http://bugs.launchpad.net/ubuntu/+source/upstart/+bug/125702
  33
  34 .. attention::
  35  RULES FOR KEEPING YOUR FILES SAFE:
  36
  37  1. NEVER YANK OUT THE USB STICK WHILE UBUNTU IS RUNNING. PERFORM PROPER "SHUTDOWN" FIRST.
  38
  39  2. REGULARLY BACKUP DATA FROM USB STICK ONTO HARD DRIVE
  40
  41 *Disclaimer: I take no responsibility over lost data whatsoever. By using this image, you assume all responsibility of your data.*
  42
  43 Installing the ISO image onto a USB flash drive:
  44 ------------------------------------------------
  45 Download the ISO image from the `NeuroDebian Derivatives page`_. Use a
  46 utility like UNetBootin_ to install the ISO image on your USB
  47 drive. Keep the persistent space setting at zero, as otherwise it
  48 will overwrite our image. *Simply extracting the ISO would not work as
  49 the media needs to be set to bootable.*
  50
  51 .. _UNetBootin: http://unetbootin.sourceforge.net/
  52 .. _`NeuroDebian Derivatives page`: http://neuro.debian.net/derivatives.html
  53
  54 Copying files to your hard drives:
  55 -----------------------------------
  56 Open the file browser by clicking on the home icon in the left sidebar on the Desktop. In the file browser window, you should be able to see your hard drives on the left sidebar. When you click on them, they will be "mounted" (i.e., become visible) and show up as directories under /media. Then, you can copy files back and forth.
  57
  58 Backing up the persistent storage that holds your files:
  59 --------------------------------------------------------
  60 Do this routinely to save your new files on the USB stick:
  61
  62 1. While running your favorite PC operating system, insert USB stick
  63
  64 2. Copy file "casper-rw" on your Desktop, preferably with a date
  65
  66 To restore it, copy it back on the USB and make sure it's named "casper-rw"
  67
  68 Transferring the persistent storage to your hard drive:
  69 ---------------------------------------------------------------
  70
  71 1. While running any host operating system, insert USB stick
  72
  73 2. Copy file "casper-rw" to the root of one of your hard disks (e.g. C:\\casper-rw). Ubuntu will find it and use it from there. Keep on making backups of it as it can still get corrupted over time.
  74
  75 3. Delete or rename "casper-rw" to something else on the USB stick so your hard disk copy is used.
  76
  77 4. At any time, you can copy your hard disk copy back onto the USB stick
  78
  79 What to do in case of corruption and boot failure:
  80 --------------------------------------------------------
  81 You can either:
  82
  83 1a. Copy your backed up "casper-rw" file onto the USB disk. You will lose your changed files since last backup.
  84
  85 1b. Boot the USB stick by choosing a non-persistent boot option from the Ubuntu boot disk and perform a filesystem check. Once you get a terminal. Issue:
  86
  87 ::
  88
  89  $ sudo su -
  90
  91 Which should give you root access. And then run the disk check:
  92
  93 ::
  94
  95  # e2fsck -p /cdrom/casper-rw
  96
  97 Press "y" and enter for the questions that it asks. Should not ask
  98 more than 10-20 of them. After this you should be able to reboot back
  99 into the Live Ubuntu.
 100
 101 Installing Ubuntu completely on your hard drive for dual booting
 102 ----------------------------------------------------------------
 103 Click on the "Install Ubuntu 11.04" link on the Desktop and follow the instructions.
 104
 105 Other troubleshooting:
 106 ----------------------
 107 This Live USB Stick is completely based on a Ubuntu 11.04 Live CD
 108 distribution. Please refer to their thorough documentation for further
 109 issues: https://help.ubuntu.com/community/LiveCD
 110
 111 .. admonition:: Revision History
 112
 113  *v2*, by CG on 2012-03-06
 114   Included the NeuroDebian repository, and installed
 115   XPPAUT and python-brian (with all python dependencies for
 116   computational modeling) packages.
 117
 118  *v1*, by CG on 2012-01-31
 119   Initial version with manual installations of GENESIS, NEURON and
 120   XPPAUT onto Ubuntu 11.04 Live CD.
 121
 122 .. admonition:: Created by...
 123
 124   | Created for use at the `Emory University <http://www.emory.edu>`_ BIO450/IBS534 Computational Neuroscience Course by Cengiz Gunay <cgunay AT emory.edu>, <cengique AT users.sf.net>
 125
 126  .. image:: CC_by_3.0_88x31.png
 127         :alt: Creative Commons License
 128         :align: left
 129         :target: http://creativecommons.org/licenses/by/3.0/
 130
 131  This Live Comp Neurosci Ubuntu/NeuroDebian USB Stick contains free and open-source software provided by Ubuntu GNU/Linux and NeuroDebian_ repositories, which are distributed with their own respective licenses. The distribution of this image with the added computational neuroscience tools is licensed by Cengiz Gunay under a `Creative Commons Attribution 3.0 Unported License <http://creativecommons.org/licenses/by/3.0/>`_. This means you can customize and redistribute this image as long as you say that you originally took it from here.
 132
 133
 134