Run from a bootable USB stick (ISO)


System ISO Image, 2.7GB
Home data folder, 4.7GB


ComponentVersion
Frontend2.0.2
hbp_nrp_cleserver2.0.2
hbp_nrp_cle2.0.2
hbp_nrp_commons2.0.2
hbp_nrp_excontrol2.0.2
hbp_nrp_music_interface2.0.2
hbp_nrp_backend2.0.2
hbp_nrp_music_xml2.0.2


Targeted audience

This distribution of the Neurorobotics Platform is targeted to users who know how to create a bootable device under Linux. This enables users to create live usb sticks e.g. for a demo or a workshop. Booting on the live stick is safe and easy. It is possible to boot using the image or it can be installed. Installing should be done carefully as it can erase all data on the hard disk.

Creating a bootable NRP USB stick (on Linux)

Creating it from Windows or Mac is not described here, but should be doable.
The NRP-Live-USB image is separated into two components
which you can download from the above buttons

Formatting the USB stick

The requirement on the USB stick is at least 32 GiB. You need at least two partitions (you can use sudo gparted graphical tool):

Applying the image to the USB stick

Since your USB stick has now at least two partitions (a FAT32 and EXT4) you need to remember which device represents which one (or use sudo blkid for more info). in this document, we will assume that it is /dev/sdb, but this may be different on your system.
You need to mount both partitions, e.g. like this:
sudo mkdir /mnt/image_partition && sudo mount /dev/sdb1 /mnt/image_partition
(where sdb1 stands for the FAT32 partition on your stick) and
sudo mkdir /mnt/home_partition && sudo mount /dev/sdb2 /mnt/home_partition
(where sdb2 stands for the EXT4 partition on your stick)
To copy the system image (.iso file) to the USB stick we recommend the program 'unetbootin' (sudo apt-get install unetbootin). In unetbootin things are straight forward, you have to choose the downloaded .iso file and let it install on /dev/sdb1 (or whatever device is the first stick partition). The whole process takes up to a few minutes.
To copy the provided nrpuser home folder simply download it to your home and unpack it in the mounted home_partition:
cd /mnt/home_partition
tar -xzf $HOME/nrpuser.tgz
Important: make sure that the first subfolder of /mnt/home_partition is 'nrpuser'. Otherwise you wont be able to login later on the live system. The copy operation might take forever, depending on your USB stick's writing speed. Get a coffee.
Done! Please unmount all USB stick partitions and reboot on the USB stick.

Running the Platform

CAREFUL: when booting, be sure to choose the first option "Try Lubuntu". You might erase your whole system if you choose another option from the list.
You will be prompted for a login when Lubuntu has finished loading: It happens that you have to login 3 times until it works, for some unknown reason.
Open a LX Terminal from the System tools menu and issue the following commands:
cle-nginx
cle-start
Open a Firefox window on http://localhost:9000/#/esv-private (there should also be a bookmark in Firefox).
You will be prompted again for credentials. Give: Clone whatever experiment and launch.

Troubleshoot

If cle-start complains about some network (dns) issues and the browser shows a greyed out "Launch" button, just connect to your local wifi network or try disabling completely the network interface.
If you need to restart the Platform for any reason, use the
cle-kill
command in a LX Terminal, and the start as described above with cle-nginx and cle-start. This might also fix some issues.

Installing permanently on your PC from the USB stick

If you wish to install the full Lubuntu+NRP on your PC, this is doable easily by selecting "Install" from the boot list instead of "Try Lubuntu". Then follow the instructions.
Warning: you are responsible for your data if you install on your system. If you are not confident with Linux installations, this is not recommended if you want to keep your existing system working.

When finished installing, you will have to copy the home/nrpuser folder from the stick to your system's /home and update nrpuser's home path in /etc/password accordingly.