Skip to content

Commit

Permalink
Add in a possible troubleshooting solution for WSL2. (#3965) (#4003)
Browse files Browse the repository at this point in the history
Signed-off-by: Chris Lalancette <clalancette@gmail.com>
(cherry picked from commit 245730d)

Co-authored-by: Chris Lalancette <clalancette@gmail.com>
  • Loading branch information
mergify[bot] and clalancette authored Nov 6, 2023
1 parent 4f3d2b2 commit 4bfe5de
Showing 1 changed file with 21 additions and 0 deletions.
21 changes: 21 additions & 0 deletions source/How-To-Guides/Installation-Troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -339,3 +339,24 @@ Binary installation specific

* If your example does not start because of missing DLLs, please verify that all libraries from external dependencies such as OpenCV are located inside your ``PATH`` variable.
* If you forget to call the ``local_setup.bat`` file from your terminal, the demo programs will most likely crash immediately.

Running RViz with WSL2
^^^^^^^^^^^^^^^^^^^^^^

If you are using `WSL2 <https://learn.microsoft.com/en-us/windows/wsl/install>`__ to run ROS 2 on Windows, you may run into an issue running RViz that looks like:

.. code-block:: console
$ rviz2
[INFO] [1695823660.091830699] [rviz2]: Stereo is NOT SUPPORTED
[INFO] [1695823660.091943524] [rviz2]: OpenGl version: 4.1 (GLSL 4.1)
D3D12: Removing Device.
Segmentation fault
One possible solution to this is to force RViz to use software rendering:

.. code-block:: console
$ export LIBGL_ALWAYS_SOFTWARE=true
$ rviz2
[INFO] [1695823660.091830699] [rviz2]: Stereo is NOT SUPPORTED

0 comments on commit 4bfe5de

Please sign in to comment.