Skip to content

Update ROS 2 install guide #3688

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jasonrandrews merged 2 commits into from
Aug 27, 2026
Merged

Update ROS 2 install guide #3688

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a13380f
Update ROS 2 install guide
jasonrandrews Aug 26, 2026
af882ca
Update DCPerf install guide
jasonrandrews Aug 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 7 additions & 17 deletions content/install-guides/dcperf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ DCPerf is an open-source benchmarking and microbenchmarking suite originally dev

You can use DCPerf to generate performance data to inform procurement decisions and for regression testing to detect changes in the environment, such as kernel and compiler changes.

DCPerf runs on Arm-based servers. The following examples have been tested on an Amazon EC2 `c7g.metal` instance running Ubuntu 22.04 LTS.
DCPerf runs on Arm-based servers. The following examples have been tested on an Amazon EC2 `c7g.metal` instance running Ubuntu 24.04 LTS.

{{% notice Note %}}
When running on a server provided by a cloud service, you have limited access to some parameters such as UEFI settings, which can affect performance.
Expand All @@ -41,20 +41,10 @@ sudo apt update
sudo apt install -y python-is-python3 python3-pip python3-venv git
```

We recommend that you install Python packages in a Python virtual environment.

Set up your virtual environment:

```bash
python3 -m venv venv
source venv/bin/activate
```
If requested, restart the recommended services.

Install the required packages:
Install the required Python packages. DCPerf runs benchmark installations as root, so install the packages system-wide:

```bash
pip3 install click pyyaml tabulate pandas
sudo pip3 install click pyyaml tabulate pandas --break-system-packages
```

Clone the repository:
Expand All @@ -64,7 +54,7 @@ git clone https://github.com/facebookresearch/DCPerf.git
cd DCPerf
```

## Run the MediaWiki benchmark
## Install the MediaWiki benchmark

DCPerf offers many benchmarks. To find a benchmark of your choice, see the [official documentation](https://github.com/facebookresearch/DCPerf?tab=readme-ov-file#install-and-run-benchmarks).

Expand Down Expand Up @@ -92,8 +82,8 @@ The output is similar to:

```output
HipHop VM 3.30.12 (rel)
Compiler: 1704922878_080332982
Repo schema: 4239d11395efb06bee3ab2923797fedfee64738e
Compiler: heads/main-0-g9308c3e3c404e0466f0a2929f15ddcf62b2215f6
Repo schema: da39a3ee5e6b4b0d3255bfef95601890afd80709
```

Confirm security-enhanced Linux (SELinux) is not enabled with the following commands:
Expand All @@ -117,7 +107,7 @@ You can automatically install all dependencies for each benchmark using the `ins
sudo ./benchpress_cli.py install oss_performance_mediawiki_mlp
```

This step may take several minutes to complete, depending on your system's download and setup speed.
This step can take several minutes to complete, depending on your system's download and setup speed.

## Run the MediaWiki benchmark

Expand Down
32 changes: 22 additions & 10 deletions content/install-guides/ros2.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ ROS 2 is the latest version, designed to enhance security, improve distributed s

## What do I need before installing ROS 2?

ROS 2 is available for Ubuntu Linux 22.04, 24.04, and Windows.
ROS 2 is available for Ubuntu Linux 22.04, 24.04, 26.04, and Windows.

This article provides a quick solution to install ROS 2 for Ubuntu on Arm. You can use Ubuntu 22.04 LTS or Ubuntu 24.04 LTS.
This article provides a quick solution to install ROS 2 for Ubuntu on Arm. You can use Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, or Ubuntu 26.04 LTS.

Confirm you are using an Arm machine by running:

Expand Down Expand Up @@ -72,16 +72,24 @@ sudo apt install -y \
python3-colcon-common-extensions
```

There are two LTS releases of ROS 2, Jazzy Jalisco and Humble Hawksbill, which you can install based on your Ubuntu version.
There are three LTS releases of ROS 2 that you can install based on your Ubuntu version.

- For Ubuntu Linux 24.04, you should install Jazzy Jalisco.
- For Ubuntu Linux 22.04, you should install Humble Hawksbill.
- For Ubuntu Linux 26.04, install Lyrical Luthenium.
- For Ubuntu Linux 24.04, install Jazzy Jalisco.
- For Ubuntu Linux 22.04, install Humble Hawksbill.

## How can I install ROS 2?

Install ROS 2 based on your Ubuntu version:

{{< tabpane code=true >}}
{{< tab header="Ubuntu 26.04" language="bash">}}
# Install ROS2 packages
sudo apt install -y ros-lyrical-desktop
# Initialize rosdep
sudo rosdep init
rosdep update
{{< /tab >}}
{{< tab header="Ubuntu 24.04" language="bash">}}
# Install ROS2 packages
sudo apt install -y ros-jazzy-desktop
Expand All @@ -103,6 +111,10 @@ Install ROS 2 based on your Ubuntu version:
Add ROS 2 setup to your shell startup script:

{{< tabpane code=true >}}
{{< tab header="Ubuntu 26.04" language="bash">}}
echo "source /opt/ros/lyrical/setup.bash" >> ~/.bashrc
source ~/.bashrc
{{< /tab >}}
{{< tab header="Ubuntu 24.04" language="bash">}}
echo "source /opt/ros/jazzy/setup.bash" >> ~/.bashrc
source ~/.bashrc
Expand All @@ -118,7 +130,7 @@ Confirm ROS 2 is installed by using printenv:
```console
printenv ROS_DISTRO
```
The output should print either `jazzy` or `humble`, depending on your Ubuntu version.
The output should print `lyrical`, `jazzy`, or `humble`, depending on your Ubuntu version.

## How can I test the ROS 2 installation?

Expand All @@ -128,7 +140,7 @@ In one terminal run a `talker`:
ros2 run demo_nodes_cpp talker
```

The output is similar to the messages shown below, indicating that ROS 2 is publishing the "hello world" string along with a sequence number.
The output is similar to the following, indicating that ROS 2 is publishing the "hello world" string along with a sequence number.

```output
[INFO] [1741389626.338343545] [talker]: Publishing: 'Hello World: 1'
Expand All @@ -150,7 +162,7 @@ Then, open another terminal and run the `listener`:
ros2 run demo_nodes_cpp listener
```

If you see "I heard [Hello World: ]" in the second terminal as shown below, it means ROS 2 has been successfully installed.
If you see "I heard [Hello World: ]" in the second terminal, ROS 2 is successfully installed.

```output
[INFO] [1741389927.137762134] [listener]: I heard: [Hello World: 1]
Expand All @@ -169,5 +181,5 @@ You are now ready to use ROS 2.

## Where can I learn more about ROS 2?

- Explore the [ROS 2 Tutorials](https://docs.ros.org/en/jazzy/Tutorials.html)
- Learn about [ROS 2 Command Line Tools](https://docs.ros.org/en/jazzy/Concepts/About-Command-Line-Tools.html)
- Explore the [ROS 2 Tutorials](https://docs.ros.org/en/lyrical/Tutorials.html)
- Learn about [ROS 2 Command Line Tools](https://docs.ros.org/en/lyrical/Concepts/About-Command-Line-Tools.html)
Loading