Skip to content

Instantly share code, notes, and snippets.

@Meltwin
Last active May 4, 2024 00:35
Show Gist options
  • Save Meltwin/fe2c15a5d7e6a8795911907f627255e0 to your computer and use it in GitHub Desktop.
Save Meltwin/fe2c15a5d7e6a8795911907f627255e0 to your computer and use it in GitHub Desktop.
Installing ROS1 Noetic on Ubuntu 22.04

The process is pretty similar to the standard installation from source except for some fixes that you will have to make during the installation. I will keep the same header so you can keep a track on both guide at the same time (follow the official website for more explication, I will only write the steps to make).

1 - Prerequisites

1.1 - Installing bootstrap dependencies

To install bootstrap dependencies

sudo apt-get install python3-rosdep python3-rosinstall-generator python3-vcstools python3-vcstool build-essential

1.X - Changing rosdep repository adress

The first problem that you will encounter while following the official guide is the lacking of some packages on the apt. In order to resolve this problem, do these steps:

  1. Init rosdep: sudo rosdep init
  2. Modify /etc/ros/rosdep/sources.list.d/20-default.list as following:
# os-specific listings first
yaml https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml osx

# generic
yaml <enter base.yaml address>
yaml https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/python.yaml
yaml https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml
gbpdistro https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml fuerte

# newer distributions (Groovy, Hydro, ...) must not be listed anymore, they are being fetched from the rosdistro index.yaml instead
  1. Go to this gist and click Raw. Replace <enter base.yaml address> in the file by the address of the raw file.
  2. Save the file (require sudo rights).

1.Y - HDDTemp can't be found

It can happens that the package hddtemp can't be found with an error message similar to this:

diagnostic_common_diagnostics: [hddtemp] defined as "not available" for OS version [*]

For Ubuntu 22.04, it is possible to install it thanks to an online archive. The solution I found was on this StackOverflow post. What you have to do is:

sudo add-apt-repository ppa:malcscott/ppa
sudo apt update 
sudo apt install hddtemp

1.2 - Initializing rosdep

rosdep update

2 - Installation

2.1 - Create a catkin Workspace

Place yourself in the working folder of your choice. Create a ROS Workspace:

mkdir ./noetic_ws
cd ./noetic_ws

Downloading ROS1 source code.

rosinstall_generator desktop --rosdistro noetic --deps --tar > noetic-desktop.rosinstall
mkdir ./src
vcs import --input noetic-desktop.rosinstall ./src

2.1.1 - Resolving Dependencies

Install all the dependencies with rosdep:

rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y

If you are on another distro than classical Ubuntu/Kubuntu/Xubuntu (e.g. Manjaro, Mint, ...), add --os=ubuntu:jammy at the end of the precendent command:

2.1.2 - Building the catkin Workspace

2.1.2.A Building from the source

Let's build the sources. Run the following commands.

./src/catkin/bin/catkin_make_isolated -DCMAKE_BUILD_TYPE=Release

It's likely that you will have some errors while building the sources. In the next subsections, you will have the needed steps to resolve the issue.

Don't worry about the warning and notes (especially about deprecated BOOST_PRAGMA_MESSAGE ), only focus on the errors.

2.1.2.B - Fixing rosconsole error

The second error that you will likely encounter is linked to rosconsole and log4cxx. It means that you are likely to have log4cxx 11 or 12. To fix that you need to follow the changes suggested on this PR and especially this commit. Here is a quick summary of what to do:

  • Open src/rosconsole/src/rosconsole/impl/rosconsole_log4cxx.cpp and replace its content by this version of the file
  • Same thing with src/rosconsole/test/thread_test.cpp with this version
  • Same thing with src/rosconsole/test/utest.cpp with this version
2.1.2.C - Fixing std::share_mutex error

The third error that you will likely encounter is a C++ compilation version. It's a problem where the packages wants to be compiled with C++11 and use objects from C++17.

The solution that I found was to change in every CMakeLists.txt of the packages that generate this errors the C++ version to use.

You can use this small python script to do that for you. Just place it at the root of your ROS workspace and run

python3 change_cpp.py
2.1.2.D - Installing noetic
Guide installation

If you want to install noetic in the working folder, run the installation with:

./src/catkin/bin/catkin_make_isolated --install -DCMAKE_BUILD_TYPE=Release
Opt folder installation (require sudo privileges)

If you want to install noetic in /opt/ros/noetic you can follow these steps:

  1. Run sudo mkdir /opt/ros/noetic
  2. Run sudo ./src/catkin/bin/catkin_make_isolated --install -DCMAKE_BUILD_TYPE=Release --install-space /opt/ros/noetic
@hejia-zhang
Copy link

Thanks for your detialed instructions!

I have successfully run ./src/catkin/bin/catkin_make_isolated -DCMAKE_BUILD_TYPE=Release

However, when I try to install it in /opt/ros/noetic, I got this error

CMake Error at /home/hejia/noetic_ws/build_isolated/actionlib_msgs/cmake/actionlib_msgs-genmsg.cmake:3 (message):
Could not find messages which
'/home/hejia/noetic_ws/src/common_msgs/actionlib_msgs/msg/GoalStatusArray.msg'
depends on. Did you forget to specify generate_messages(DEPENDENCIES ...)?

Cannot locate message [Header] in package [std_msgs] with paths
[['/home/hejia/noetic_ws/devel_isolated/std_msgs/share/std_msgs/cmake/../msg']]
Call Stack (most recent call first):
/home/hejia/noetic_ws/devel_isolated/genmsg/share/genmsg/cmake/genmsg-extras.cmake:307 (include)
CMakeLists.txt:12 (generate_messages)

Do you know how can I fix it?

@Enkrl-last
Copy link

Thanks for your detialed instructions!

I have successfully run ./src/catkin/bin/catkin_make_isolated -DCMAKE_BUILD_TYPE=Release

However, when I try to install it in /opt/ros/noetic, I got this error

CMake Error at /home/hejia/noetic_ws/build_isolated/actionlib_msgs/cmake/actionlib_msgs-genmsg.cmake:3 (message): Could not find messages which '/home/hejia/noetic_ws/src/common_msgs/actionlib_msgs/msg/GoalStatusArray.msg' depends on. Did you forget to specify generate_messages(DEPENDENCIES ...)?

Cannot locate message [Header] in package [std_msgs] with paths [['/home/hejia/noetic_ws/devel_isolated/std_msgs/share/std_msgs/cmake/../msg']] Call Stack (most recent call first): /home/hejia/noetic_ws/devel_isolated/genmsg/share/genmsg/cmake/genmsg-extras.cmake:307 (include) CMakeLists.txt:12 (generate_messages)

Do you know how can I fix it?

Seems both steps are NOT optional:

  • (Optional) Same thing with src/rosconsole/test/thread_test.cpp with this version
  • (Optional) Same thing with src/rosconsole/test/utest.cpp with this version

Delete the directories build/install and repeat the steps from now on. It helped me

@EdMlt
Copy link

EdMlt commented Mar 15, 2024

Hello, thank you for the detailed process, I got the same issue than @hejia-zhang the local installation ok but not in the opt folder, I tried the solution provided by @Enkrl-last but still not working for me.
Any other way found to fix the issue?
Thank you 👍

@KlrShaK
Copy link

KlrShaK commented Apr 2, 2024

rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y --os=ubuntu:jammy
executing command [sudo -H apt-get install -y python3-rospkg-modules]
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
E: Unable to locate package python3-rospkg-modules
ERROR: the following rosdeps failed to install
  apt: command [sudo -H apt-get install -y python3-rospkg-modules] failed

I get this error when running the line rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y can anyone help with this

@Meltwin
Copy link
Author

Meltwin commented Apr 4, 2024

I get this error when running the line rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y can anyone help with this

What OS are you using for the installation ?

@pk3012
Copy link

pk3012 commented Apr 4, 2024

I get this error when running the line rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y can anyone help with this

What OS are you using for the installation ?

Hi i used Ubuntu 22.04and got this error.

WARNING: given --rosdistro noetic but ROS_DISTRO is "iron". Ignoring environment.
ERROR: the following packages/stacks could not have their rosdep keys resolved
to system dependencies:
diagnostic_common_diagnostics: [hddtemp] defined as "not available" for OS version [*]

Also in the step sudo rosdep --init . i got this error

ERROR: default sources list file already exists:
/etc/ros/rosdep/sources.list.d/20-default.list
Please delete if you wish to re-initialize

Is it important. I am installing it as a ROS1 as i already have ROS2 in my PC

@Meltwin
Copy link
Author

Meltwin commented Apr 5, 2024

Ok, let's try some things.

WARNING: given --rosdistro noetic but ROS_DISTRO is "iron". Ignoring environment.

First, try without sourcing ROS2 in the terminal for the installation, maybe it will mess it up :/

Also in the step sudo rosdep --init . i got this error
ERROR: default sources list file already exists: /etc/ros/rosdep/sources.list.d/20-default.list Please delete if you wish to re-initialize

Did you modify it before running sudo rosdep --init ? Try deleting the file, launching the previous command, then modifying and finally updtating it.

rm -f /etc/ros/rosdep/sources.list.d/20-default.list
sudo rosdep --init
nano /etc/ros/rosdep/sources.list.d/20-default.list # Modify the file as precised here
rosdep update

And try again. Keep me informed if it works or not.

@sergio-contente
Copy link

I'm getting this error:

./src/catkin/bin/catkin_make_isolated -DCMAKE_BUILD_TYPE=Release
ImportError: "from catkin_pkg.topological_order import topological_order" failed: No module named 'catkin_pkg'
Make sure that you have installed "catkin_pkg", it is up to date and on the PYTHONPATH.

When I execute this command:

./src/catkin/bin/catkin_make_isolated -DCMAKE_BUILD_TYPE=Release

I've already installed "python3-catkin-pkg" with apt-get and it still not works. I'm using Ubuntu 22.04.
Do you know any solution to this problem?

@Meltwin
Copy link
Author

Meltwin commented Apr 5, 2024

I've already installed "python3-catkin-pkg" with apt-get and it still not works. I'm using Ubuntu 22.04.
Do you know any solution to this problem?

Seems like it doesn't find the package .. which is a bit weird. As I looked into the catkin_pkg repo, it seems that between the time I wrote this gist and now, they dropped the python2 version and switched to python3 and that might have make everything messy.
As the import is done with the condition on the ROS_PYTHON_VERSION environment variable, try running export ROS_PYTHON_VERSION=3 in the terminal before launching the command. I don't know if it will sort things out or not.

Else, try installing catkin_pkg though pip instead: python3 -m pip install catkin-pkg.

Others solutions could be found through this post on StackOverflow . If the previous ways doesn't works, try theses steps:

export PYTHONPATH="$PYTHONPATH:$(locate catkin_pkg -l)"
export PATH="$HOME/anaconda3/bin:$PATH"

@pk3012
Copy link

pk3012 commented Apr 24, 2024

SOLVED:)

Hi i am facing this error in 2.1.1 . You help solved the precious issue

ROS_DISTRO=ubuntu:jammy rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y
WARNING: given --rosdistro noetic but ROS_DISTRO is "ubuntu:jammy". Ignoring environment.
ERROR: the following packages/stacks could not have their rosdep keys resolved
to system dependencies:
diagnostic_common_diagnostics: [hddtemp] defined as "not available" for OS version [*]

earlier i tried this

rosdep install --from-paths ./src --ignore-packages-from-source --rosdistro noetic -y
ERROR: the following packages/stacks could not have their rosdep keys resolved
to system dependencies:
diagnostic_common_diagnostics: [hddtemp] defined as "not available" for OS version [*]

i still get same error

I use ubuntu22.04

Thanks in advance :)

SOLUTION: changed the base.yaml file to local directiory to fix it

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment