MRC/Tutorials/Installation from OVA file

A. Import the VM on the Windows Machine

1. Download the .OVA file from this link: https://tuenl-my.sharepoint.com/:u:/g/personal/e_torta_tue_nl/EVGPgpPHIJlPhDbORKEaD2wB7hMJB3gHlaGSiUYT6wwppA?e=OcxAzv
2. Install [VirtualBox] on the your machine, if it's not already installed.
3. Open VirtualBox on your machine.
4. Click on "File" in the top menu and select "Import Appliance...".
5. Browse to the location where you transferred the .ova file and select it.
6. Follow the import wizard, accepting the default settings.
7. After importing, you should see the VM "mrc-ros1-template" listed in VirtualBox on your Windows machine

B. Configure some settings of the VM

1. In the VirtualBox menu, right click the "mrc-ros1-template" and click the option "settings" (orange cogwheel)
2. Go to "Display" and adjust the "Video Memory" to 64 MB.
3. Go to "Network" and select "Bridged Adapter" from the dropdown menu at "Attached to". Confirm that your wireless adapter is correctly configured at "Name", e.g., "Intel(R) Wi-Fi 6 AX200 160MHz"
4. Click "Ok" to confirm your changes

C. Final configurations within the VM

We need to configure the virtual machine to support clipboard sharing (copy-paste) with the host system and to automatically scale the display to fit your screen.

1. Select the newly imported VM "mrc-ros1-template" from the list and click "Start" (green right-pointing arrow) to boot it up.
2. The password for the virtual machine is "mrc"
3. After starting up, the system will automatically install some security updates in the background. Quickly performing the next steps may result in an error similar to the following: "E: Could not get lock /var/lib/dpkg/lock-frontend. It is held by process 2460 (unattended-upgr)". One solution is to wait it out, but most likely it will get stuck. So just run the command: "sudo systemctl stop unattended-upgrades.service". If that doesn't work, jsut quit the virtualbox and just re-open it.
4. Open a terminal (ctrl+alt+t), and enter the following command: "sudo apt-get install virtualbox-guest-additions-iso". If you can't find it, then run "sudo apt-get update" first.
5. (Clipboard sharing) At the top toolbar of the VM set a) "Devices"->"Shared Clipboard"->"Bidirectional" and b) "Devices"->"Drag and Drop"->"Bidirectional"
6. (Automatic scaling) At the top toolbar of the VM Press "Devices"->"Insert Guest Additions CD Image..". A window will pop up related to "VBox_GAs_7.1.6" and just press "Run". After finishing the installing just press "enter" and the window will close automatically.
7. Reboot the VM: just press the "X" to close the VM interface and press "Send the shutdown signal". Afterwards just start it up again.

D. Final preparations for tutorials further

1. In the home directory, create a folder "mrc". We do so by opening the terminal (ctrl+alt+t) and entering the command "mkdir mrc".

Troubleshooting Tips:

• If you have problems visualizing the screen of the virtual machine, try re-installing the guest additions

---

Next section: Starting the simulator