Skip to content

INSTALLATION.md

Latest commit

 

History

History
89 lines (66 loc) · 2.64 KB

INSTALLATION.md

File metadata and controls

89 lines (66 loc) · 2.64 KB
Raw

Installation process for Dummies and Troubleshooting

Installation

Step-by-Step installation process and commands to avoid forgetting dependencies...

After installing it several times (beause of nvidia drivers issues destroying my ubuntu boot)
I preffer to report all the installation steps for future usage (even the most obvious, considering a fresh linux system)

Because of the previous Nvidia driver issues, I installed the Ubuntu OS without third party drivers, and then add the drivers manually following this tutorial by Nvidia

This steps works for me in an Ubnutu 24.04 OS, with a 6.14.0-33-generic linux kernel.

( Dell PRO Max 16 Laptop, NVIDIA RTX PRO 500 Blackwell Generation Laptop GPU, Intel Core Ultra 9,
x86_64 (AMD 64bit), in an Ubnutu 24.04 OS partition, with a 6.14.0-33-generic linux kernel)

First, building tools (Dummy reminder N.1)

Always remeber to update and upgrade when installing new software

sudo apt update

sudo apt upgrade

Install building tools

sudo apt install make

OpenGL Mathematics

sudo apt install libglm-dev

SDL 2

From SDL2 wiki

git clone https://github.com/libsdl-org/SDL.git -b SDL2
cd SDL
mkdir build
cd build
../configure
cmake ..
make -j$(nproc)
sudo make install

Note

I launch make with -j$(nproc) to use all cpu processors, use -jX to rely on X processors

FreeType

sudo apt install libfreetype6-dev

Don't worry if libfreetype-dev is installed instead of libfreetype6-dev

Finally, Stonefish

From official Stonefish documentation

git clone https://github.com/patrykcieslak/stonefish.git
cd stonefish
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Troubleshooting

List of problems encountered during the installation process and running tests.
Problems with uncorrect library installation, linker dependencies, CMakeLists, and nvidia-driver compatibility.

White Sensors Screen

This is related to the usage of the GPU with the Mesa Library.
I previously encountered this issue, but after setting up properly

  • Nvidia Driver
  • OpenGL usage of the Nvidia GPU

This code changes were no more required.

This problem compromise the visualization of sensors output on the Stonefish GUI, seeing white screen instead.
I found the solution to this bug on Issue#65 of the official stonefish repo. A PR is already open.