Skip to content

Latest commit

 

History

History
148 lines (93 loc) · 4.86 KB

RHEL-Install-Binary.rst

File metadata and controls

148 lines (93 loc) · 4.86 KB

RHEL (binary)

Table of Contents

This page explains how to install ROS 2 on RHEL from a pre-built binary package.

Note

The pre-built binary does not include all ROS 2 packages. All packages in the ROS base variant are included, and only a subset of packages in the ROS desktop variant are included. The exact list of packages are described by the repositories listed in this ros2.repos file.

There are also :doc:`RPM packages <../RHEL-Install-RPMs>` available.

System Requirements

We currently support RHEL 8 64-bit.

Enable required repositories

The rosdep database contains packages from the EPEL and PowerTools repositories, which are not enabled by default. They can be enabled by running:

sudo dnf install 'dnf-command(config-manager)' epel-release -y
sudo dnf config-manager --set-enabled powertools

Note

This step may be slightly different depending on the distribution you are using. Check the EPEL documentation

Installing prerequisites

There are a few packages that must be installed in order to get and unpack the binary release.

sudo dnf install tar bzip2 wget -y

Downloading ROS 2

  • Go to the releases page

  • Download the latest package for RHEL; let's assume that it ends up at ~/Downloads/ros2-package-linux-x86_64.tar.bz2.

    • Note: there may be more than one binary download option which might cause the file name to differ.

  • Unpack it:

    mkdir -p ~/ros2_{DISTRO}
cd ~/ros2_{DISTRO}
tar xf ~/Downloads/ros2-package-linux-x86_64.tar.bz2

Installing and initializing rosdep

sudo dnf install -y python3-rosdep
sudo rosdep init
rosdep update

Installing the missing dependencies

Set your rosdistro according to the release you downloaded.

rosdep install --from-paths ~/ros2_{DISTRO}/ros2-linux/share --ignore-src -y --skip-keys "asio cyclonedds fastcdr fastrtps ignition-cmake2 ignition-math6 python3-babeltrace python3-mypy rti-connext-dds-6.0.1 urdfdom_headers"

Install additional DDS implementations (optional)

If you would like to use another DDS or RTPS vendor besides the default, you can find instructions :doc:`here <../RMW-Implementations>`.

Environment setup

Source the setup script

Set up your environment by sourcing the following file.

 # Replace ".bash" with your shell if you're not using bash
 # Possible values are: setup.bash, setup.sh, setup.zsh
. ~/ros2_{DISTRO}/ros2-linux/setup.bash

Try some examples

In one terminal, source the setup file and then run a C++ talker:

. ~/ros2_{DISTRO}/ros2-linux/setup.bash
ros2 run demo_nodes_cpp talker

In another terminal source the setup file and then run a Python listener:

. ~/ros2_{DISTRO}/ros2-linux/setup.bash
ros2 run demo_nodes_py listener

You should see the talker saying that it's Publishing messages and the listener saying I heard those messages. This verifies both the C++ and Python APIs are working properly. Hooray!

Next steps after installing

Continue with the :doc:`tutorials and demos <../../Tutorials>` to configure your environment, create your own workspace and packages, and learn ROS 2 core concepts.

Additional RMW implementations (optional)

The default middleware that ROS 2 uses is Fast DDS, but the middleware (RMW) can be replaced at runtime. See the :doc:`guide <../../How-To-Guides/Working-with-multiple-RMW-implementations>` on how to work with multiple RMWs.

Troubleshooting

Troubleshooting techniques can be found :doc:`here <../../How-To-Guides/Installation-Troubleshooting>`.

Uninstall

  1. If you installed your workspace with colcon as instructed above, "uninstalling" could be just a matter of opening a new terminal and not sourcing the workspace's setup file. This way, your environment will behave as though there is no {DISTRO_TITLE} install on your system.

  2. If you're also trying to free up space, you can delete the entire workspace directory with:

    rm -rf ~/ros2_{DISTRO}