ONELAB virtual machine
Contents
Introduction
ONELAB is a software tool allowing to make multi-code scientific simulations. In order to check on how ONELAB actually works with various open-source simulation software, you need to have them installed on your system. As a one-size-fits-all solution for all interfaced clients, a virtual machine has been designed so that ONELAB models and interfaced client software can be installed on it with minimal user interaction. You first have to install the generic ONELAB virtual machine on your system by proceeding as described below. Instruction to install client software and models are given when appropriate.
Install the virtual machine
- Step 1 - Install VirtualBox on your computer
- Install VirtualBox on your system from the Oracle VirtualBox website. Download the binary package suitable for your operating system and the latest VirtualBox Extension Pack (There are 2 files to download), and follow the installation instructions.
- Step 2 - Configure Network connection between host and virtual machine
- Launch VirtualBox. From the VirtualBox menu (under Windows: VirtualBox > File > Settings > Network ; under OSX VirtualBox > Preferences > Network), check that a "Host only Network" called "vboxnet0" is present. If not, add it by clicking on the "+" icon.
- Step 3 - Download the ONELAB virtual machine package
- by following the link: ONELAB virtual machine OVA package
- Step 4 - Import the OVA package in VirtualBox
- From the VirtualBox Menu "File", import the downloaded OVA package. A new virtual machine entry entry appears in the left panel.
- Step 5 - Start the ONELAB virtual machine
- Start the virtual machine by double-clicking its entry in the left panel. Enter "olvm" for login and "olvm" again for password (without quotes). You are ready to continue with ONELAB models.
The virtual machine is a second computer running on your system. They share screen, mouse and keyboard. It is also convenient to have them share a folder. This allows easy communication of files and data between the host to the virtual machine.
To share a folder, you first need, if need be, to shut down the virtual machine, and create the folder to be shared on the host. Then, enter the settings panel of the virtual machine and select the "Shared folders" tab. Click on the "+" icon and browse to the shared folder on the host system. As the "Folder name", write "OLVM" (without quote), and check the "auto mount" box. The shared folder is mounted on /media/sf_OLVM but, with the special name "OLVM", a link to the shared folder will be available directly as "SHARED" on the desktop of the virtual machine.
Troubleshooting
- On older versions of Windows, you might have to explicitly enable virtualization in the bios.
- There is a well-known conflict (generating an error message when saving a file) between gedit and folders shared with a Windows host. As a workaround, backup files should be enabled in gedit settings, disregard error message and always save twice (More information on that: https://bugs.launchpad.net/ubuntu/+source/gedit/+bug/34813?comments=all).
- VirtualBox does not yet fully support the MacBook Pro Retina screen. If you experience display problems, try launching VirtualBox in low resolution. Right click on the VirtualBox icon in the Application folder, select "Properties" and tick the "Open in low resolution" box.