Skip to content

Commit

Permalink
Remove pre-configured Webots images for Rolling and Iron (#3794) (#3796)
Browse files Browse the repository at this point in the history
* remove pre-configured for iron and rolling

(cherry picked from commit a053856)

Co-authored-by: Yannick Goumaz <[email protected]>
  • Loading branch information
mergify[bot] and ygoumaz authored Jul 25, 2023
1 parent d5fd464 commit ca7a2c2
Showing 1 changed file with 0 additions and 24 deletions.
24 changes: 0 additions & 24 deletions source/Tutorials/Advanced/Simulators/Webots/Installation-MacOS.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@ A shared folder allows the script to transfer the world and other resource files

The following steps explain how to create the VM image with the installation of the ``webots_ros2`` released package.
It is also possible to install it from sources.
In the :ref:`Preconfigured Images` section, you can find already configured images for every release of Webots (starting from R2023a) to download.

1 Create the VM image
^^^^^^^^^^^^^^^^^^^^^^
Expand Down Expand Up @@ -207,26 +206,3 @@ Use the ROS 2 launch command to start demo packages (e.g. ``webots_ros2_universa
ros2 launch webots_ros2_universal_robot multirobot_launch.py
If Webots is closed or the ROS 2 process is interrupted, the local server will automatically wait for a new package launch and the shared folder will be cleaned for the next run.

.. _Preconfigured Images:

Pre-configured Images
-----------------------

If you don't want to setup the VM from scratch, the following links provide you with pre-configured UTM images for each version of Webots.
The ``webots_ros2`` version is installed from the official repository (not from sources) and is typically the first one that is compatible with the corresponding Webots version.
You are welcome to download an image and upgrade the package, or install it from sources if necessary.

* `Version 2023.0.2 for Webots R2023a <https://cyberbotics.com/files/ros2/webots_ros2_2023_0_2.utm.zip>`_ [6.6 GB]

When adding the downloaded image to the UTM software, you should also choose the path to the host shared folder before starting the VM in the drop-down menu (e.g. ``/Users/username/shared``).
Once the VM is started, the ``WEBOTS_SHARED_FOLDER`` environment variable must always be set for the package to work properly in the virtual machine (VM).
This variable specifies to the ``webots_ros2`` package the location of the shared folder that is used to exchange data between the host machine and the VM.
The value for this variable should be in the format of ``<host shared folder>:<VM shared folder>``, where ``<host shared folder>`` is the path to the shared folder on the host machine and ``<VM shared folder>`` is the path to the same shared folder on the VM.

In the pre-configured images, ``WEBOTS_SHARED_FOLDER`` is already set in ``~/.bashrc``.
You will need to update it to use the correct path for the host folder:

.. code-block:: console
export WEBOTS_SHARED_FOLDER=/Users/username/shared:/home/ubuntu/shared

0 comments on commit ca7a2c2

Please sign in to comment.