In this course, we are using Ubuntu 24.04 LTS and ROS2 Jazzy as development tools. We will talk about what these tools mean later but for now you just need to know that these are not regular programs which you simply write the name in Microsoft Store (or App Store) and get. Therefore, we are using virtual machines.

Virtual machines are basically some software which run just like a regular PC but without any physical components. They use the host's hardware equipments as a guest. Since ROS works best on Linux based operating systems but we assume most of you have Windows PCs, we provide this ready-to-use solution for you to start ROS as smooth as possible.

There will be two components:

  1. The virtual appliance (the file you open in a virtual machine player)
  2. A software to run the virtual appliance (VMware)

The admin password inside the virtual appliance is: robotics

Virtual Appliance

A virtual appliance is a copy of a working operating system and its programs. We provide you ready-to-use virtual copy of what you need. To download it, use this link with your HVL credentials. After downloading, Windows users must extract the folder inside the .zip file.

Virtual appliances are usually big files, so we recommend you make space on your hard drive before downloading. The virtual appliance is about max 20 GB in size.

Virtual Appliance Player

A virtual appliance player is a piece of software on which you can run your virtual appliance (aka. a virtual copy of a system). We suggest you download VMware for this purpose.

VMware Install

Option 1

If you use Windows, try this link first. At the installation step, it will ask if you want to install Windows Hypervisior, do not install it. Afterwards, select “enable enhanced keyboard” option. Follow the regular installation gut feelings and you are done.

Option 2

If the link above didn’t work, or you are using Linux/Mac, to install VMware, you need to go to create an account at Broadcom.com

Please use only international characters to while you enter your name and adress

After the registration is completed, login to your account and click to the correct link below that is compatible to your PC.

Video tutorial for installation is here. Installation tutorial is for Windows. You can use “Virtual Disk.vmdk” file instead for Mac.

Running VMware

After installing it you should import the virtual appliance in the VMware Player/Workstation. Start VMWare > click File > Scan for Virtual Machines > Browse to where your virtual appliance folder is (Ubuntu_24_04_jazzy). The VMware workstation will find import the appliance automatically.

After you finished importing the virtual appliance, go to Edit virtual machine settings and in Display settings and make sure that Accelerate 3D graphics is enabled and choose recommended Graphics Memory from the dropdown box as shown in the pictures. Based on your version of VMware, the images might be slightly different.

image-center

Also make sure, that in the Network Adapter settings, under Network connection, NAT is selected, as shown in the pictures below.

image-center

When first opening the virtual machine, the following window will pop-up. Select I Copied It to continue.

image-center

Quick reminder, the admin password inside the virtual appliance is: robotics.

Troubleshooting

Copy-paste doesn’t work

Option-1

First try VM tools auto update:

  1. Start VMware.
  2. Select the virtual appliance Ubuntu24_04_jazzy BUT DON’T RUN YET.
  3. Edit virtual machine settings > Options > VMware tools.
  4. Select update automatically and click Synchronize guest time with host.

image-center

Option-2

Try this if option-1 does not work.

  1. Start your virtual machine.
  2. Open a terminal: Ctrl + Alt + T
  3. Run these commands:
sudo apt update
sudo apt upgrade
sudo apt autoremove
sudo apt-get install --reinstall open-vm-tools-desktop -y

and now restart the VMware.

You might still experience errors in copy-paste’ing folders. Then just click “Skip all”. It will successfully copy-paste, nonetheless.

Option-3

This won’t solve your issue if you can’t copy a simple text between your host and guest, but it may solve if you can’t copy FOLDERS. Try using shared folders. First create a folder on Windows (or whatever host you have). Easiest is to create a “VMtest” folder on Desktop. The rest of the steps are on the VM.

  1. Go to the top menu of VMware and click VM > Settings.
  2. Go to the Options tab and select Shared Folders.
  3. Select your share and click Properties. Select “Always enabled”.
  4. Set the Host Path to exactly to the folder you created on Desktop/VMtest and COPY THE PATH AFTERWARDS.
  5. Name the share: VMtest
  6. Click OK to save and close the settings window.
  7. Open a new terminal Ctrl+Alt+T. Create a mount folder: sudo mkdir -p /mnt/hgfs
  8. Fuse to this folder sudo vmhgfs-fuse .host:/YOUR-COPIED-PATH /mnt/hgfs -o allow_other. Don’t forget to modify the path to yours.
  9. Verify the files are visible: ls -l /mnt/hgfs
  10. Test if everything is fine: vmware-hgfsclient. If it returns nothing: VMware’s host side is not sending the folder to the virtual machine. Shut down the VM, remove the shared folder from settings, re-add it, and make sure it points to right folders and that you modified the paths correctly. First sudo umount /mnt/hgfs and then sudo mount /mnt/hgfs again.
  11. If everything goes fine you should see the changes you do in the folder /mnt/hgfs in your Windows Desktop VMTest folder.
  12. To copy files/folders use this command on your Linux terminal: First go to cd /mnt/hgfs and then cp -r PATH_TO-FOLDER-TOBE-COPIED . (The dot in the end means “here” in Linux).

Network is not working

Despite all the settings being correct, your VM seams to simply not have a network adapter? Or you can’t see anything in the wifi and network setting except proxy? Then this command in the terminal of the VM might help you:

sudo nmcli networking on

VMware freezes

It might be about the hardware resource usage of your host PC. You can try:

  1. Edit virtual machione settings > and reduce the number of cores to 4, and ram to 4 GB as well.
  2. Update the VMware tools: After starting your Ubuntu VM, open a new terminal and run these: 
    sudo apt update
sudo apt upgrade
sudo apt install -y open-vm-tools open-vm-tools-desktop
sudo reboot now
  3. Try another VM player. If you are running on version 17, just try 16 or 25. It will not affect what you have already done in your Ubuntu guest. You can change the VM Player/Workstation version anytime you want!

Matlab ROS Toolbox

As you will see later in this course, you can control and communicate with robots in ROS using Matlab, even if the MAtlab is running on your host PC and ROS is running in your virtual machine. For this, you will need Matlab installed of course, but not any version! To be able to communicate with ROS2 Foxy, you will need Matlab R2025a to R2026a (not older, not newer). You will also need to have MATLAB ROS Toolbox installed on your host PC. Please make sure that you have the toolbox installed: Home > Add-Ons > Manage Add-Ons.

Standalone installation

For those who don’t use the given virtual copy and choose to install the necessary software and packages by themselves use the following links: Ubuntu 24.04 LTS, ROS2 Jazzy and a lot of libraries. Please contact the course instructor if you choose to make a standalone installation, a list of requirements will be provided to you. But we cannot guarantee that it will work since we won’t have time to fully test your installation.