This is an old revision of the document!
You can download and install VirtualBox *before* the tutorial or use the installation files that are on the USB drives that will be distributed at the beginning of the tutorial. You can download the software from VirtualBox downloads.
Use these directions to install VirtualBox.
If your host machine is any linux system, both
virtualbox-dkms packages must be installed. Also check to make sure you have exFAT filesystem drivers. Windows and Mac systems should have it by default. On Ubuntu, the packages required are
We recommended that your computer has at least 20 to 30 GB of free disk space and preferably 8 GB of RAM. If your computer has less RAM check the
Troubleshooting section for how to reduce the memory allocation of the virtual machine.
During the first tutorial session, you will receive a 16 GB USB drive with an OVA file called “CIDER2018.ova” and the installation files for VirtualBox. This image contains the software for all CIDER tutorials. Copy it onto the laptop you are going to use for the tutorial.
Alternatively, you can also download the virtual machine frome here: CIDER2018 Virtual Machine. Note that this file is over 5GB in size and will take a long time to download (it is not recommended to do this during the tutorial as the Wifi will be unable to provide sufficient speed for multiple simultaneous downloads).
We use VirtualBox to run a separate ('guest') operating system inside your normal (or 'host') operating system. For this tutorial we use a Lubuntu 16.04 linux inside the virtual machine, because it provides a reasonably intuitive interface, and importantly is relatively lightweight, keeping the size small, and the machine relatively fast.
The virtual machine contains the following users for the individual tutorials:
As a first step select any of the above users and login to the system. Note that all of the users listed above do not require a password. Lubuntu separates the common 'Start' menu in the bottom left corner of the screen from the 'Shutdown/Reboot/Switch user' menu in the bottom right corner of the screen, but otherwise the layout of file explorer and menus should be vaguely familiar to all users of 'Windows'/'MacOS'/'generic Linux' users.
The majority of the work in the tutorials will happen in the linux terminal, and if you are not used to working in the terminal, now is a good time to familiarize yourself with some basic commands:
t, or double-clicking on the
LXTerminalshortcut on the desktop
exitand pressing enter
cdfollowed by the directory name (or
cd ..to move up one directory). Just typing
cdand pressing enter brings you back to your home directory. Most tutorials will happen in the directory 'Desktop' and some subdirectory of it.
Tabonce or twice and the terminal will try to auto-complete the command you were typing (very useful for long or unknown filenames!)
leafpadfor a simple text editor)
The virtual machine has all required software installed, but if you are familiar with linux and you want to install additional packages (e.g. your favorite text editor), do it as
cideradmin, using the password
sudo apt-get install <package name> to install ubuntu packages.
Now simply start the CIDER2018 virtual machine and log into the user required for your current tutorial.
Some of the tutorials need to transfer data between the virtual machine and your host operating system. In order to allow this you will need to create a new folder on your laptop. Give it a name (e.g. 'share') and open the settings of the CIDER2018 virtual machine. Go to the 'Shared Folders tab' and add the newly created folder as a shared folder by clicking on the green plus and selecting your newly created folder (do *not* select the read-only option in the dialog that opens).
Take note of the folder name that VirtualBox assigns to this shared folder (most likely 'share'). If everything worked your settings tab should look like this:
Now click 'Ok' to save the settings and start your virtual machine. To mount the shared folder inside the virtual machine as any user open a terminal as explained above and use the following commands:
(only necessary a single time per user account)
(when asked for the password type
sudo mount -t vboxsf -o rw share shared_folder/
(when asked for the password type
Now you should have a new directory in your home directory called
shared_folder and every file you copy into this folder will appear on your host operating system in the folder
share that you created at the beginning of this subsection. You will need to repeat this process (except for the first step) every time you restart the virtual machine, thus test it now once, but only repeat it when necessary for your tutorial.
Systemstab. The amount of RAM can be set in the
Motherboardpanel, and the number of CPU cores can be set in the
processorpanel. You will have to shutdown the virtual machine in order to change these settings.